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 Crea una *ubicación* de transferencia para un bucket de Amazon S3. AWS DataSync puede usar esta ubicación como origen 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](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes) [Evaluación de los costos de las solicitudes de S3 cuando se usa DataSync](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-s3-requests) Para obtener más información, consulte [Configuring transfers with Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html). ## 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](CommonParameters.md). La solicitud acepta los siguientes datos en formato JSON. ** [AgentArns](#API_CreateLocationS3_RequestSyntax) ** (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](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent) Tipo: matriz de cadenas Miembros de la matriz: número mínimo de 1 artículo. La cantidad máxima es de 8 elementos. Limitaciones de longitud: longitud máxima de 128 caracteres. Patrón: `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$` Obligatorio: no ** [S3BucketArn](#API_CreateLocationS3_RequestSyntax) ** 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](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html) 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-eusc|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-eusc|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-eusc|aws-iso|aws-iso-b):s3:::[a-zA-Z0-9.\-_]{1,255}$` Obligatorio: sí ** [S3Config](#API_CreateLocationS3_RequestSyntax) ** 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](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access). Tipo: objeto [S3Config](API_S3Config.md) Obligatorio: sí ** [S3StorageClass](#API_CreateLocationS3_RequestSyntax) ** 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](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes). Tipo: cadena Valores válidos: `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` Obligatorio: no ** [Subdirectory](#API_CreateLocationS3_RequestSyntax) ** 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). 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](#API_CreateLocationS3_RequestSyntax) ** 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](API_TagListEntry.md) 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](#API_CreateLocationS3_ResponseSyntax) ** 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-eusc|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 [Tipos de errores comunes](CommonErrors.md). ** 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 ## 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: + [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationS3) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationS3) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationS3) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationS3) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationS3) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationS3) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationS3) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationS3)