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

# CreateLocationObjectStorage
<a name="API_CreateLocationObjectStorage"></a>

Cria um *local* de transferência para um sistema de armazenamento de objetos. AWS DataSync pode usar esse local como origem ou destino para transferir dados. Você pode fazer transferências com ou sem um [DataSyncagente](https://docs.aws.amazon.com/datasync/latest/userguide/do-i-need-datasync-agent.html#when-agent-required).

Antes de começar, certifique-se de compreender os [pré-requisitos](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html#create-object-location-prerequisites) para trabalhar com sistemas de DataSync armazenamento de objetos.

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

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

## Parâmetros da solicitação
<a name="API_CreateLocationObjectStorage_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_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-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_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-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.  
Certifique-se de configurar esse parâmetro corretamente ao criar ao local de armazenamento pela primeira vez. Você não pode adicionar ou remover atendentes de um local de armazenamento depois de criá-lo.
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

 ** [BucketName](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-BucketName"></a>
Especifica o nome do bucket de armazenamento de objetos envolvido na transferência.  
Tipo: string  
Restrições de tamanho: comprimento mínimo de 3. O comprimento máximo é 63.  
Padrão: `^[a-zA-Z0-9_\-\+\.\(\)\$\p{Zs}]+$`   
Obrigatório: Sim

 ** [CmkSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-CmkSecretConfig"></a>
Especifica as informações de configuração de um segredo DataSync gerenciado, que inclui o `SecretKey` que é DataSync usado para acessar um local específico de armazenamento de objetos, com um gerenciado pelo cliente. AWS KMS key  
Ao incluir esse parâmetro como parte de uma `CreateLocationObjectStorage` solicitação, você fornece somente o ARN da chave KMS. DataSync usa essa chave KMS junto com o valor que você especifica para o `SecretKey` parâmetro para criar um segredo DataSync gerenciado para armazenar as credenciais de acesso à localização.  
Verifique se ele DataSync tem permissão para acessar a chave KMS especificada. Para obter mais informações, consulte [Usando um segredo gerenciado pelo serviço criptografado com um personalizado](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key  
Você pode usar `CmkSecretConfig` (com `SecretKey`) ou `CustomSecretConfig` (sem `SecretKey`) para fornecer credenciais para uma solicitação `CreateLocationObjectStorage`. Não forneça os dois parâmetros para a mesma solicitação.
Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md)  
Obrigatório: não

 ** [CustomSecretConfig](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-CustomSecretConfig"></a>
Especifica as informações de configuração para um segredo do Secrets Manager gerenciado pelo cliente, em que a chave secreta de um local específico de armazenamento de objetos é armazenada em texto simples, no Secrets Manager. Essa configuração inclui o ARN secreto e o ARN de um perfil do IAM que fornece acesso ao segredo. Para obter mais informações, consulte [Usando um segredo que você gerencia](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key).  
Você pode usar `CmkSecretConfig` (com `SecretKey`) ou `CustomSecretConfig` (sem `SecretKey`) para fornecer credenciais para uma solicitação `CreateLocationObjectStorage`. Não forneça os dois parâmetros para a mesma solicitação.
Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md)  
Obrigatório: não

 ** [SecretKey](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-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_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-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`.  
Tipo: objeto de dados binários codificado pelo Base64  
Restrições de tamanho: tamanho máximo de 32768.  
Obrigatório: não

 ** [ServerHostname](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-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: Sim

 ** [ServerPort](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-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_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-ServerProtocol"></a>
Especifica o protocolo que o servidor de armazenamento de objetos utiliza para se comunicar. Se não for especificado, o valor padrão será `HTTPS`.  
Tipo: string  
Valores válidos: `HTTPS | HTTP`   
Obrigatório: não

 ** [Subdirectory](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-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

 ** [Tags](#API_CreateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-CreateLocationObjectStorage-request-Tags"></a>
Especifica o par de chave-valor que representa uma etiqueta que você deseja adicionar ao recurso. Tags ajudam a gerenciar, filtrar e procurar recursos. Recomendamos criar uma etiqueta de nome para a sua localização.  
Tipo: matriz de objetos [TagListEntry](API_TagListEntry.md)  
Membros da Matriz: número mínimo de 0 itens. Número máximo de 50 itens.  
Obrigatório: Não

## Sintaxe da resposta
<a name="API_CreateLocationObjectStorage_ResponseSyntax"></a>

```
{
   "LocationArn": "string"
}
```

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

Se a ação for bem-sucedida, o serviço retornará uma resposta HTTP 200.

Os dados a seguir são retornados no formato JSON pelo serviço.

 ** [LocationArn](#API_CreateLocationObjectStorage_ResponseSyntax) **   <a name="DataSync-CreateLocationObjectStorage-response-LocationArn"></a>
Especifica o ARN da localização do sistema de armazenamento de objetos que você cria.  
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}$` 

## Erros
<a name="API_CreateLocationObjectStorage_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_CreateLocationObjectStorage_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/CreateLocationObjectStorage) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationObjectStorage) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationObjectStorage)