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á.
DescribeLocationS3
Fornece detalhes sobre como um local AWS DataSync de transferência para um bucket do S3 é configurado.
Sintaxe da Solicitação
{
"LocationArn": "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.
A solicitação aceita os dados a seguir no formato JSON.
- LocationArn
-
O nome do recurso da Amazon (ARN) do local do Amazon S3.
Tipo: String
Restrições de tamanho: tamanho máximo de 128.
Padrão:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$Exigido: Sim
Sintaxe da Resposta
{
"AgentArns": [ "string" ],
"CreationTime": number,
"LocationArn": "string",
"LocationUri": "string",
"S3Config": {
"BucketAccessRoleArn": "string"
},
"S3StorageClass": "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.
- AgentArns
-
O ARNs dos DataSync agentes implantados em seu Outpost ao trabalhar com o Amazon S3 em Outposts.
Para obter mais informações, consulte Implantar seu DataSync agente em AWS Outposts.
Tipo: matriz de strings
Membros da matriz: número mínimo de 1 item. Número máximo de 4 itens.
Restrições de Tamanho: Tamanho máximo de 128.
Padrão:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$ - CreationTime
-
O horário em que o local do bucket da Amazon S3 foi criado.
Tipo: Timestamp
- LocationArn
-
O ARN do local do Amazon S3.
Tipo: String
Restrições de tamanho: tamanho máximo de 128.
Padrão:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$ - LocationUri
-
O URL do local do Amazon S3 que foi descrito.
Tipo: String
Restrições de tamanho: tamanho máximo de 4.360.
Padrão:
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$ - S3Config
-
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.
Tipo: objeto S3Config
- S3StorageClass
-
Quando o Amazon S3 é um local de destino, essa é a classe de armazenamento que você escolheu para seus objetos.
Algumas classes de armazenamento têm comportamentos que podem afetar os custos de armazenamento do Amazon S3. Para obter mais informações, consulte Considerações sobre classes de armazenamento com transferências do Amazon S3.
Tipo: String
Valores Válidos:
STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL
Erros
Para obter informações sobre os erros comuns que todas as ações retornam, consulte Erros comuns.
- 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
Exemplos
Exemplo
O exemplo a seguir retorna informações sobre o local do Amazon S3 especificado no exemplo de solicitação.
Exemplo de solicitação
{
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3"
}Exemplo
Este exemplo ilustra um uso do DescribeLocation S3.
Resposta da amostra
{
"CreationTime": 1532660733.39,
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3",
"LocationUri": "s3://amzn-s3-demo-bucket",
"S3Config": {
"BucketAccessRoleArn": "arn:aws:iam::111222333444:role/amzn-s3-demo-bucket-access-role",
}
"S3StorageClass": "STANDARD"
}Consulte também
Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
