DescribeLocationS3
Fornece detalhes sobre como um local de transferência do AWS DataSync 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
-
Os ARNs dos agentes do DataSync implantados no seu Outpost ao trabalhar com o Amazon S3 no Outposts.
Para obter mais informações, consulte Deploy your DataSync agent on 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 nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) usado pelo DataSync para acessar o bucket do S3.
Para obter mais informações, consulte Como fornecer ao 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 DescribeLocationS3.
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 um dos SDKs específicos de linguagem AWS, consulte:
