As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# UpdateLocationS3
<a name="API_UpdateLocationS3"></a>

Modifica os seguintes parâmetros de configuração do local de transferência do Amazon S3 com o qual você está usando. AWS DataSync

**Importante**  
Antes de começar, não deixe de ler os seguintes tópicos:  
 [Considerações sobre a classe de armazenamento com locais do Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) 
 [Avaliando os custos de solicitação do S3 ao usar DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) 

## Sintaxe da solicitação
<a name="API_UpdateLocationS3_RequestSyntax"></a>

```
{
   "LocationArn": "string",
   "S3Config": { 
      "BucketAccessRoleArn": "string"
   },
   "S3StorageClass": "string",
   "Subdirectory": "string"
}
```

## Parâmetros da solicitação
<a name="API_UpdateLocationS3_RequestParameters"></a>

Para obter informações sobre os parâmetros que são comuns em todas as ações, consulte [Parâmetros comuns](CommonParameters.md).

A solicitação aceita os dados a seguir no formato JSON.

 ** [LocationArn](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-LocationArn"></a>
Especifica o nome do recurso da Amazon (ARN) do local de transferência do Amazon S3 que você está atualizando.  
Tipo: string  
Restrições de tamanho: tamanho máximo de 128.  
Padrão: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$`   
Obrigatório: Sim

 ** [S3Config](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-S3Config"></a>
Especifica o Amazon Resource Name (ARN) AWS Identity and Access Management da função DataSync (IAM) usada para acessar seu bucket do S3.  
Para obter mais informações, consulte [Fornecendo DataSync acesso aos buckets do S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access).  
Tipo: objeto [S3Config](API_S3Config.md)  
Obrigatório: não

 ** [S3StorageClass](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-S3StorageClass"></a>
Especifica a classe de armazenamento que você deseja que seus objetos usem quando o Amazon S3 for um destino de transferência.  
Para buckets em Regiões da AWS, o padrão da classe de armazenamento é. `STANDARD` Para buckets ativados AWS Outposts, o padrão da classe de armazenamento é. `OUTPOSTS`  
Para obter mais informações, consulte [Considerações sobre classes de armazenamento com transferências do Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).  
Tipo: string  
Valores válidos: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL`   
Obrigatório: não

 ** [Subdirectory](#API_UpdateLocationS3_RequestSyntax) **   <a name="DataSync-UpdateLocationS3-request-Subdirectory"></a>
Especifica um prefixo no bucket do S3 que DataSync lê ou grava (dependendo se o bucket é um local de origem ou destino).  
DataSync não é possível transferir objetos com um prefixo que comece com uma barra (`/`) ou inclua `//``/./`, ou `/../` padrões. Por exemplo:  
+  `/photos` 
+  `photos//2006/January` 
+  `photos/./2006/February` 
+  `photos/../2006/March` 
Tipo: string  
Restrições de tamanho: tamanho máximo de 4.096.  
Padrão: `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Obrigatório: Não

## Elementos de resposta
<a name="API_UpdateLocationS3_ResponseElements"></a>

Se a ação for bem-sucedida, o serviço reenviará uma resposta 200 HTTP com um corpo HTTP vazio.

## Erros
<a name="API_UpdateLocationS3_Errors"></a>

Para obter informações sobre os erros comuns que todas as ações retornam, consulte [Tipos de erro comuns](CommonErrors.md).

 ** InternalException **   
Essa exceção é lançada quando ocorre um erro no serviço AWS DataSync .  
Código de status HTTP: 500

 ** InvalidRequestException **   
Essa exceção é lançada quando o cliente envia uma solicitação malformada.  
Código de Status HTTP: 400

## Consulte também
<a name="API_UpdateLocationS3_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationS3) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationS3)