CreateLocationS3

Crea una ubicación de transferencia para un bucket de Amazon S3. AWS DataSync puede usar esta ubicación como fuente o destino para transferir datos.

importante

Antes de comenzar, asegúrese de haber leído los siguientes temas:

• Consideraciones sobre las clases de almacenamiento en las ubicaciones de Amazon S3

• Evaluar los costos de las solicitudes de S3 al usar DataSync

Para obtener más información, consulte Configuring transfers with 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 la 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

(Amazon S3 solo en Outposts) Especifica el nombre de recurso de Amazon (ARN) del DataSync agente de su Outpost.

Para obtener más información, consulte Implementar su agente en. DataSync AWS Outposts

Tipo: matriz de cadenas

Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es 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}$

Obligatorio: no

S3BucketArn

Especifica el ARN del bucket de S3 que desea usar como ubicación. (Al crear la DataSync tarea más adelante, debe especificar si esta ubicación es un origen o un destino de transferencia).

Si su bucket de S3 se encuentra en un AWS Outposts recurso, debe especificar un punto de acceso de Amazon S3. Para obtener más información, consulte Administración del acceso a datos con puntos de acceso de Amazon S3 en la Guía del usuario de Amazon S3.

Tipo: cadena

Limitaciones de longitud: longitud máxima de 268.

Patrón: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):s3:[a-z\-0-9]*:[0-9]{12}:accesspoint[/:][a-zA-Z0-9\-.]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):s3-outposts:[a-z\-0-9]+:[0-9]{12}:outpost[/:][a-zA-Z0-9\-]{1,63}[/:]accesspoint[/:][a-zA-Z0-9\-]{1,63}$|^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$

Obligatorio: sí

S3Config

Especifica el nombre de recurso de Amazon (ARN) del rol AWS Identity and Access Management (IAM) que se DataSync utiliza para acceder al bucket de S3.

Para obtener más información, consulte Proporcionar DataSync acceso a los buckets de S3.

Tipo: objeto S3Config

Obligatorio: sí

S3StorageClass

Especifica la clase de almacenamiento que desea que utilicen los objetos cuando Amazon S3 sea un destino de transferencia.

Para los depósitos incluidos Regiones de AWS, la clase de almacenamiento se establece de forma predeterminada en. STANDARD Para los depósitos activados AWS Outposts, la clase de almacenamiento se establece de forma predeterminada en. OUTPOSTS

Para obtener más información, consulte Storage class considerations with Amazon S3 transfers.

Tipo: cadena

Valores válidos: STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL

Obligatorio: no

Subdirectory

Especifica un prefijo en el depósito de S3 que DataSync lee o escribe en él (en función de si el depósito es una ubicación de origen o de destino).

nota

DataSync no puede transferir objetos con un prefijo que comience con una barra (/) o que incluya ///./, o patrones. /../ Por ejemplo:

• /photos

• photos//2006/January

• photos/./2006/February

• photos/../2006/March

Tipo: cadena

Limitaciones de longitud: longitud máxima de 4096 caracteres.

Patrón: ^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$

Obligatorio: no

Tags

Especifica etiquetas que le ayudan a clasificar, filtrar y buscar los recursos. AWS Le recomendamos crear al menos una etiqueta de nombre para su ubicación de transferencia.

Tipo: matriz de objetos TagListEntry

Miembros de la matriz: número mínimo de 0 artículos. Número máximo de 50 artículos.

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

El ARN de la ubicación de S3 que creó.

Tipo: cadena

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 acerca de los errores comunes a todas las acciones, consulte Errores comunes.

InternalException

Esta excepción se produce cuando se genera un error en el servicio AWS DataSync .

Código de estado HTTP: 500

InvalidRequestException

Esta excepción se produce cuando el cliente envía una solicitud con un formato incorrecto.

Código de estado HTTP: 400

Ejemplos

Paso 1. Permiso para que se asuma el rol de IAM necesario para escribir en el bucket

El siguiente ejemplo muestra la política más sencilla que concede 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": "amzn-s3-demo-bucket-access-role",
        "RoleId": "role-id",
        "Arn": "arn:aws:iam::account-id:role/amzn-s3-demo-bucket-access-role",
        "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. Permiso para que el rol de IAM creado escriba en el bucket.

Asocie una política que disponga de permisos suficientes para acceder el bucket al rol. Un ejemplo de esta política es la política administrada AWSDataSyncFullAccess.

Para obtener más información, consulte AWSDataSyncFullAccessen la consola de IAM.

No es necesario que usted cree esta política. Está gestionado por AWS, por lo que todo lo que tiene que hacer es especificar su ARN en el attach-role-policy comando.

IAM_POLICY_ARN='arn:aws:iam::aws:policy/AWSDataSyncFullAccess'

Paso 3. Creación de un punto de conexión para un bucket de Amazon S3.

El ejemplo a continuación crea un punto de conexión para un bucket de Amazon S3.

Cuando se crea el punto de conexión S3, una respuesta similar a la del segundo ejemplo siguiente devuelve el nombre de recurso de Amazon (ARN) de la nueva ubicación de Amazon S3.

Solicitud de muestra

{
  "S3BucketArn": "arn:aws:s3:::amzn-s3-demo-bucket",
  "S3Config": {
     "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/amzn-s3-demo-bucket-access-role",
    },
    "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 uno de los idiomas específicos AWS SDKs, consulta lo siguiente:

• Interfaz de la línea de comandos de AWS

• AWS SDK para .NET

• AWS SDK para C++

• AWS SDK para Go v2

• AWS SDK para Java V2

• AWS SDK para JavaScript V3

• AWS SDK para PHP V3

• AWS SDK para Python

• AWS SDK para Ruby V3