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á. # CreateLocationS3 Cria um *local* de transferência para um bucket do Amazon S3. O AWS DataSync pode usar esse local como origem ou destino para transferência de dados. **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) Para obter mais informações, consulte [Configurar transferências com o Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html). ## Sintaxe da solicitação ``` { "AgentArns": [ "string" ], "S3BucketArn": "string", "S3Config": { "BucketAccessRoleArn": "string" }, "S3StorageClass": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## Parâmetros da solicitação 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. ** [AgentArns](#API_CreateLocationS3_RequestSyntax) ** (Somente Amazon S3 em Outposts) Especifica o Amazon Resource Name (ARN) do agente em seu Outpost. DataSync Para obter mais informações, consulte [Implantar seu DataSync agente em AWS Outposts](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent). 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 ** [S3BucketArn](#API_CreateLocationS3_RequestSyntax) ** Especifica o ARN do bucket do S3 que você deseja usar como um local. (Ao criar sua DataSync tarefa posteriormente, você especifica se esse local é uma origem ou um destino de transferência.) Se seu bucket do S3 estiver localizado em um AWS Outposts recurso, você deverá especificar um ponto de acesso do Amazon S3. Para obter mais informações, consulte [Gerenciando o acesso a dados com o recurso Pontos de Acesso Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html) no *Guia do usuário do Amazon S3*. Tipo: string Restrições de comprimento: comprimento máximo de 268. Padrão: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$` Obrigatório: Sim ** [S3Config](#API_CreateLocationS3_RequestSyntax) ** 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: Sim ** [S3StorageClass](#API_CreateLocationS3_RequestSyntax) ** 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_CreateLocationS3_RequestSyntax) ** 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 ** [Tags](#API_CreateLocationS3_RequestSyntax) ** Especifica rótulos que ajudam você a categorizar, filtrar e pesquisar seus AWS recursos. Recomendamos criar pelo menos uma etiqueta de nome para seu local de transferência. 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 ``` { "LocationArn": "string" } ``` ## Elementos de resposta 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_CreateLocationS3_ResponseSyntax) ** O ARN do local do S3 que você criou. 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 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 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/CreateLocationS3) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationS3) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationS3) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationS3) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationS3) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationS3) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationS3)