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.
CreateLocationS3
Una ubicación es un punto de enlace de un bucket de Amazon S3. AWS DataSyncpuede utilizar la ubicación como origen o destino para copiar datos.
importante
Antes de crear su ubicación, asegúrese de leer las siguientes secciones.
Para obtener más información, consulte Crear una ubicación de Amazon S3.
Sintaxis de la solicitud
{
"AgentArns": [ "string" ],
"S3BucketArn": "string",
"S3Config": {
"BucketAccessRoleArn": "string"
},
"S3StorageClass": "string",
"Subdirectory": "string",
"Tags": [
{
"Key": "string",
"Value": "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.
- AgentArns
-
Si lo utilizas DataSync en un AWS puesto de avanzada, especifica los nombres de recursos de Amazon (ARN) de los DataSync agentes desplegados en tu puesto de avanzada. 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 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}$Obligatorio: no
- S3BucketArn
-
El ARN del bucket de Amazon S3. Si el bucket está en un AWS Outpost, debe ser un ARN de punto de acceso.
Tipo: String
Limitaciones de longitud: longitud máxima longitud.
Patrón:
^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):(s3|s3-outposts):[a-z\-0-9]*:[0-9]*:.*$Obligatorio: sí
- 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
Obligatorio: sí
- S3StorageClass
-
La clase de almacenamiento de Amazon S3 en la que desea almacenar los archivos cuando se utiliza esta ubicación como destino de tarea. Para los buckets deRegiones de AWS, la clase de almacenamiento se establece de forma predeterminada en Estándar. Para los bucketsAWS Outposts, la clase de almacenamiento se establece de forma predeterminada en AWS S3 Outposts.
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, 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_RETRIEVALObligatorio: no
- Subdirectory
-
Un subdirectorio en el bucket de Amazon S3. Este subdirectorio de Amazon S3 se utiliza para leer datos de la ubicación de origen de S3 o escribir datos en el destino de S3.
Tipo: String
Limitaciones de longitud: longitud máxima longitud.
Patrón:
^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$Obligatorio: no
- Tags
-
El par clave-valor que representa la etiqueta que desea agregar a la ubicación. El valor puede ser una cadena vacía. Le recomendamos que utilice etiquetas para asignar nombres a sus recursos.
Tipo: Matriz de objetos TagListEntry
Miembros de la matriz: número mínimo de 0 elementos. Número máximo de 50 elementos.
Obligatorio: no
Sintaxis de la respuesta
{
"LocationArn": "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.
- LocationArn
-
Nombre de recurso de Amazon (ARN) de la ubicación del bucket de Amazon S3 de origen.
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}$
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
Paso 1. Permiten asumir la función de IAM necesaria para escribir en el bucket.
El siguiente ejemplo muestra la política más simple que otorga los permisos necesarios para acceder AWS DataSync a un bucket de Amazon S3 de destino, seguida de una función de IAM a la que se ha asociado la create-location-s3-iam-role política.
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "datasync.amazonaws.com" }, "Action": "sts:AssumeRole" } ] }
"Role": { "Path": "/", "RoleName": "MyBucketAccessRole", "RoleId": "role-id", "Arn": "arn:aws:iam::account-id:role/MyBucketAccessRole", "CreateDate": "2018-07-27T02:49:23.117Z", "AssumeRolePolicyDocument": { "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "datasync.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } } }
Paso 2. Permita que la función de IAM creada escriba en el bucket.
Adjunte al rol una política que tenga permisos suficientes para acceder al bucket. Un ejemplo de dicha política es la política AWSDataSyncFullAccess gestionada.
Para obtener más información, consulte AWSDataSyncFullAccess
No es necesario crear esta política. Está administrado porAWS, por lo que todo lo que necesita hacer es especificar su ARN en el attach-role-policy comando.
IAM_POLICY_ARN='arn:aws:iam::aws:policy/AWSDataSyncFullAccess'
Paso 3. Crear un punto de enlace para un bucket de Amazon S3.
En el siguiente ejemplo se crea un punto de enlace para un bucket de Amazon S3.
Cuando se crea el endpoint de S3, una respuesta similar a la del segundo ejemplo siguiente devuelve el nombre del recurso de Amazon (ARN) de la nueva ubicación de Amazon S3.
Solicitud de muestra
{
"S3BucketArn": "arn:aws:s3:::MyBucket",
"S3Config": {
"BucketAccessRoleArn": "arn:aws:iam::111222333444:role/MyBucketAccessRole",
},
"S3StorageClass": "STANDARD",
"Subdirectory": "/MyFolder",
"Tags": [
{
"Key": "Name",
"Value": "s3Bucket-1"
}
]
}Respuesta de ejemplo
{
"LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3"
}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:
