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
Retorna metadados, como nome do bucket, sobre a localização de um bucket do Amazon S3.
Sintaxe da solicitação
{
"LocationArn": "string"
}Parâmetros de solicitação
Para obter informações sobre os parâmetros que são comuns a todas as ações, consulte Parâmetros comuns.
A solicitação aceita os dados a seguir no formato JSON.
- LocationArn
-
O nome de recurso da Amazon (ARN) do local do bucket do Amazon S3 a ser descrito.
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}$Obrigatório: 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 reenviará uma resposta HTTP 200.
Os dados a seguir são retornados no formato JSON pelo serviço.
- AgentArns
-
Se você estiver usando DataSync em um AWS posto avançado, o Amazon Resource Name (ARNs) dos agentes do EC2 implantados em seu posto avançado. Para obter mais informações sobre como lançar um DataSync agente em um AWS posto avançado, 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
-
A hora da criação do local do bucket do Amazon S3.
Tipo: Timestamp
- LocationArn
-
O nome de recurso da Amazon (ARN) do bucket do Amazon S3 ou ponto de acesso.
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
-
A URL da localização do Amazon S3 que foi descrita.
Tipo: String
Restrições de tamanho: tamanho máximo de 4360.
Padrão:
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$ - S3Config
-
O nome do recurso da Amazon (ARN) de uma função do AWS Identity and Access Management (IAM) usada para acessar o bucket do Amazon S3.
Para obter informações detalhadas sobre como usar essa função, consulte Criar um local para o Amazon S3 no Guia do usuário do AWS DataSync.
Tipo: objeto S3Config
- S3StorageClass
-
A classe de armazenamento do Amazon S3 na qual você escolheu armazenar seus arquivos quando esse local é usado como destino de tarefa. Para obter mais informações sobre classes de armazenamento do S3, consulte Classes de armazenamento do Amazon S3
. Algumas classes de armazenamento têm comportamentos que podem afetar o custo de armazenamento do S3. Para obter informações detalhadas, consulte Considerações ao trabalhar com classes de armazenamento do S3 no. DataSync 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 a todas as ações, consulteErros comuns.
- InternalException
-
Essa exceção é lançada quando ocorre um erro no AWS DataSync serviço.
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 S3 especificado na solicitação de amostra.
Exemplo de solicitação
{
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3"
}Exemplo
Este exemplo ilustra um uso do DescribeLocation S3.
Exemplo de resposta
{
"CreationTime": 1532660733.39,
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3",
"LocationUri": "MyBucket.",
"S3Config": {
"BucketAccessRoleArn": "arn:aws:iam::111222333444:role/MyBucketAccessRole",
}
"S3StorageClass": "STANDARD"
}Consulte também
Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos de linguagem, consulte o seguinte:
