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á.

# UpdateLocationObjectStorage
<a name="API_UpdateLocationObjectStorage"></a>

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

Para obter mais informações, consulte [Configurando DataSync transferências com um sistema de armazenamento de objetos](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html).

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

```
{
   "AccessKey": "string",
   "AgentArns": [ "string" ],
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "LocationArn": "string",
   "SecretKey": "string",
   "ServerCertificate": blob,
   "ServerHostname": "string",
   "ServerPort": number,
   "ServerProtocol": "string",
   "Subdirectory": "string"
}
```

## Parâmetros da solicitação
<a name="API_UpdateLocationObjectStorage_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.

 ** [AccessKey](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-AccessKey"></a>
Especifica a chave de acesso (por exemplo, um nome de usuário) se as credenciais forem necessárias para autenticação no servidor de armazenamento de objetos.  
Tipo: string  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.  
Padrão: `^.*$`   
Obrigatório: não

 ** [AgentArns](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-AgentArns"></a>
(Opcional) Especifica os nomes de recursos da Amazon (ARNs) dos DataSync agentes que podem se conectar ao seu sistema de armazenamento de objetos. Se você estiver configurando uma transferência entre nuvens sem atendente, não precisará especificar um valor para esse parâmetro.  
Você não pode adicionar ou remover atendentes de um local de armazenamento depois de criá-lo inicialmente.
Tipo: matriz de strings  
Membros da matriz: número mínimo de 1 item. Número máximo de 8 itens.  
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}:agent/agent-[0-9a-z]{17}$`   
Obrigatório: não

 ** [CmkSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-CmkSecretConfig"></a>
Especifica as informações de configuração DataSync de um segredo gerenciado, como um token de autenticação ou conjunto de credenciais DataSync usado para acessar um local de transferência específico e um gerenciado pelo cliente. AWS KMS key  
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obrigatório: não

 ** [CustomSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-CustomSecretConfig"></a>
Especifica as informações de configuração de um segredo gerenciado pelo cliente, como um token de autenticação ou conjunto de credenciais DataSync usado para acessar um local de transferência específico e uma função gerenciada pelo cliente AWS Identity and Access Management (IAM) que fornece acesso ao segredo.  
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obrigatório: não

 ** [LocationArn](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-LocationArn"></a>
Especifica o ARN do local do sistema de armazenamento de objetos 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

 ** [SecretKey](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-SecretKey"></a>
Especifica a chave secreta (por exemplo, uma senha) se as credenciais forem necessárias para autenticação no servidor de armazenamento de objetos.  
Se você fornecer um segredo usando`SecretKey`, mas não fornecer detalhes de configuração secreta usando `CmkSecretConfig` ou`CustomSecretConfig`, então DataSync armazena o token usando o segredo do Secrets Manager da sua AWS conta.
Tipo: string  
Restrições de tamanho: tamanho mínimo 0. Tamanho máximo de 200.  
Padrão: `^.*$`   
Obrigatório: não

 ** [ServerCertificate](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerCertificate"></a>
Especifica uma cadeia de certificados DataSync para autenticação em seu sistema de armazenamento de objetos se o sistema usar uma autoridade de certificação (CA) privada ou autoassinada. Você deve especificar um único arquivo `.pem` com uma cadeia de certificados completa (por exemplo, `file:///home/user/.ssh/object_storage_certificates.pem`).  
A cadeia de certificados pode incluir:  
+ O certificado do sistema de armazenamento de objetos
+ Todos os certificados intermediários (se for o caso)
+ O certificado-raiz da CA assinante
Você pode concatenar os certificados em um arquivo `.pem` (que pode ter até 32.768 bytes antes da codificação base64). O exemplo de comando `cat` a seguir cria um arquivo `object_storage_certificates.pem` que inclui três certificados:  
 `cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem`   
Para usar esse parâmetro, configure `ServerProtocol` para `HTTPS`.  
A atualização desse parâmetro não interfere nas tarefas que estão em andamento.  
Tipo: Objeto de dados binários codificado em Base64  
Restrições de tamanho: tamanho máximo de 32768.  
Obrigatório: não

 ** [ServerHostname](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerHostname"></a>
Especifica o nome de domínio ou endereço IP (IPv4 ou IPv6) do servidor de armazenamento de objetos ao qual seu DataSync agente se conecta.  
Tipo: string  
Restrições de tamanho: tamanho máximo de 255.  
Padrão: `^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-:]*[A-Za-z0-9])$`   
Obrigatório: não

 ** [ServerPort](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerPort"></a>
Especifica a porta em que o servidor de armazenamento de objetos aceita o tráfego de rede de entrada (por exemplo, a porta 443).  
Tipo: inteiro  
Intervalo válido: valor mínimo de 1. Valor máximo de 65536.  
Obrigatório: não

 ** [ServerProtocol](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerProtocol"></a>
Especifica o protocolo que o servidor de armazenamento de objetos utiliza para se comunicar.  
Tipo: string  
Valores válidos: `HTTPS | HTTP`   
Obrigatório: não

 ** [Subdirectory](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-Subdirectory"></a>
Especifica o prefixo de objeto do servidor de armazenamento de objetos. Se esse for um local de origem, DataSync copiará somente objetos com esse prefixo. Se for um local de destino, DataSync grava todos os objetos com esse prefixo.  
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_UpdateLocationObjectStorage_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_UpdateLocationObjectStorage_Errors"></a>

Para obter informações sobre os erros comuns que todas as ações retornam, consulte [Erros 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_UpdateLocationObjectStorage_SeeAlso"></a>

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