Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
DescribeLocationS3
Devuelve metadatos, como, por ejemplo, nombre del bucket, acerca de una ubicación de un bucket de Amazon S3.
Sintaxis de la solicitud
{
"LocationArn": "string
"
}
Parámetros de solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.
La solicitud acepta los siguientes datos en formato JSON.
- LocationArn
-
Es el nombre de recurso de Amazon (ARN) de la ubicación del bucket de Amazon S3 que se desea describir.
Tipo: String
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^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}$
Obligatorio: sí
Sintaxis de la respuesta
{
"AgentArns": [ "string" ],
"CreationTime": number,
"LocationArn": "string",
"LocationUri": "string",
"S3Config": {
"BucketAccessRoleArn": "string"
},
"S3StorageClass": "string"
}
Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
- AgentArns
-
Si utiliza DataSync en un AWS Outpost, el nombre de recurso de Amazon (ARN) de los agentes de EC2 desplegados en su Outpost. Para obtener más información sobre cómo lanzar un DataSync agente en un AWS puesto avanzado, consulta Despliega tu DataSync agente en AWS Outposts.
Tipo: matriz de cadenas
Miembros de la matriz: número mínimo de 1 elemento. Número máximo de 4 elementos.
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^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
-
La hora en que se creó la ubicación del bucket de Amazon S3.
Tipo: Timestamp
- LocationArn
-
Es el nombre de recurso de Amazon (ARN) del bucket de Amazon S3 o punto de acceso.
Tipo: String
Limitaciones de longitud: longitud máxima de 128 caracteres.
Patrón:
^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
-
La dirección URL de la ubicación de Amazon S3 que se ha descrito.
Tipo: String
Limitaciones de longitud: longitud máxima de 4360 caracteres.
Patrón:
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$
- S3Config
-
El nombre de recurso de Amazon (ARN) de un rol de AWS Identity and Access Management (IAM) que permite obtener acceso al bucket de Amazon S3.
Para obtener información detallada sobre el uso de este rol, consulte Creación de una ubicación para Amazon S3 en la Guía del usuario de AWS DataSync.
Tipo: objeto S3Config
- S3StorageClass
-
La clase de almacenamiento de Amazon S3 en la que ha elegido almacenar los archivos cuando se utiliza esta ubicación como destino de tarea. Para obtener más información acerca de las clases de almacenamiento de S3, consulte Clases de almacenamiento de Amazon S3
. Algunas clases de almacenamiento tienen comportamientos que pueden afectar al costo de almacenamiento de S3. Para obtener información detallada, consulte Consideraciones al trabajar con clases de almacenamiento de S3 en DataSync. Tipo: String
Valores válidos:
STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL
Errores
Para obtener información sobre los errores comunes a todas las acciones, consulteErrores comunes.
- InternalException
-
Esta excepción se produce cuando se produce un error en el AWS DataSync servicio.
Código de estado HTTP: 500
- InvalidRequestException
-
Esta excepción se produce cuando el cliente envía una solicitud con formato incorrecto.
Código de estado HTTP: 400
Ejemplos
Ejemplo
En el siguiente ejemplo, se devuelve información sobre la ubicación de S3 especificada en la solicitud de ejemplo.
Solicitud de muestra
{
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3"
}
Ejemplo
Este ejemplo ilustra un uso de DescribeLocation S3.
Respuesta de ejemplo
{
"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"
}
Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un lenguaje específico, consulte: