UpdateLocationS3 - AWS DataSync
Sintaxis de la solicitudParámetros de la solicitudElementos de respuestaErroresVéase también

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.

UpdateLocationS3

Modifica los siguientes parámetros de configuración de la ubicación de transferencia de Amazon S3 con AWS DataSync la que está utilizando.

importante

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

Sintaxis de la solicitud

{
   "LocationArn": "string",
   "S3Config": { 
      "BucketAccessRoleArn": "string"
   },
   "S3StorageClass": "string",
   "Subdirectory": "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.

LocationArn

Especifica el nombre de recurso de Amazon (ARN) de la ubicación de transferencia de Amazon S3 que está actualizando.

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}$

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: no

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

Elementos de respuesta

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

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

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: