CreateLocationAzureBlob - AWS DataSync
Sintaxis de la solicitudParámetros de la solicitudSintaxis de la respuestaElementos 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.

CreateLocationAzureBlob

Crea una ubicación de transferencia para un contenedor de Microsoft Azure Blob Storage. AWS DataSync puede usar esta ubicación como origen o destino de la transferencia. Puede realizar transferencias con o sin un DataSync agente que se conecte a su contenedor.

Antes de empezar, asegúrese de saber cómo se DataSync accede a Azure Blob Storage y cómo funciona con los niveles de acceso y los tipos de blob.

Sintaxis de la solicitud

{
   "AccessTier": "string",
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlobType": "string",
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "ContainerUrl": "string",
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "SasConfiguration": { 
      "Token": "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.

AccessTier

Especifica el nivel de acceso al que desea transferir sus objetos o archivos. Esto solo se aplica cuando se utiliza la ubicación como destino de transferencia. Para obtener más información, consulte Niveles de acceso.

Tipo: cadena

Valores válidos: HOT | COOL | ARCHIVE

Obligatorio: no

AgentArns

(Opcional) Especifica el nombre de recurso de Amazon (ARN) del DataSync agente que se puede conectar con el contenedor de Azure Blob Storage. Si va a configurar una transferencia entre nubes sin agente, no necesita especificar un valor para este parámetro.

Puede especificar más de un agente. Para obtener más información, consulte Using multiple agents for your transfer.

nota

Asegúrese de configurar este parámetro correctamente la primera vez que cree su ubicación de almacenamiento. No puede añadir ni eliminar agentes de una ubicación de almacenamiento después de crearla.

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

AuthenticationType

Especifica el método de autenticación que se DataSync utiliza para acceder a Azure Blob Storage. DataSync puede acceder al almacenamiento de blobs mediante una firma de acceso compartido (SAS).

Tipo: cadena

Valores válidos: SAS | NONE

Obligatorio: sí

BlobType

Especifica el tipo de blob que desea que tengan sus objetos o archivos al transferirlos a Azure Blob Storage. Actualmente, DataSync solo admite el traslado de datos a Azure Blob Storage como bloques blobs. Para obtener más información sobre los tipos de blobs, consulte la Documentación de Azure Blob Storage.

Tipo: cadena

Valores válidos: BLOCK

Obligatorio: no

CmkSecretConfig

Especifica la información de configuración de un secreto DataSync administrado, que incluye el token de autenticación que se DataSync utiliza para acceder a una ubicación de AzureBlob almacenamiento específica, con una ubicación administrada por el cliente. AWS KMS key

Cuando incluye este parámetro como parte de una CreateLocationAzureBlob solicitud, solo proporciona la clave KMS ARN. DataSync utiliza esta clave de KMS junto con el token de autenticación que especifique SasConfiguration para crear un secreto DataSync administrado que almacene las credenciales de acceso a la ubicación.

Asegúrese de que DataSync tiene permiso para acceder a la clave de KMS que especifique.

nota

Puede usar CmkSecretConfig (conSasConfiguration) o CustomSecretConfig (sinSasConfiguration) para proporcionar las credenciales para una CreateLocationAzureBlob solicitud. No proporciones ambos parámetros para la misma solicitud.

Tipo: objeto CmkSecretConfig

Obligatorio: no

ContainerUrl

Especifica la URL del contenedor de Azure Blob Storage implicado en la transferencia.

Tipo: cadena

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

Patrón: ^https:\/\/[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}\/[a-z0-9](-?[a-z0-9]){2,62}$

Obligatorio: sí

CustomSecretConfig

Especifica la información de configuración de un secreto de Secrets Manager administrado por el cliente en el que el token de autenticación de una ubicación AzureBlob de almacenamiento se almacena en texto plano. Esta configuración incluye el ARN secreto y el ARN de un rol de IAM que proporciona acceso al secreto.

nota

Puede utilizar CmkSecretConfig (conSasConfiguration) o CustomSecretConfig (sinSasConfiguration) para proporcionar las credenciales a una solicitud. CreateLocationAzureBlob No proporciones ambos parámetros para la misma solicitud.

Tipo: objeto CustomSecretConfig

Obligatorio: no

SasConfiguration

Especifica la configuración de SAS que permite acceder DataSync a su Azure Blob Storage.

nota

Si proporciona un token de autenticación utilizandoSasConfiguration, pero no proporciona detalles de configuración secretos utilizando CmkSecretConfig oCustomSecretConfig, entonces DataSync almacena el token utilizando el secreto del administrador de secretos de su AWS cuenta.

Tipo: objeto AzureBlobSasConfiguration

Obligatorio: no

Subdirectory

Especifica los segmentos de ruta si desea limitar su transferencia a un directorio virtual del contenedor (por ejemplo, /my/images).

Tipo: cadena

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

Patrón: ^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$

Obligatorio: no

Tags

Especifica las etiquetas que le ayudan a clasificar, filtrar y buscar sus recursos de 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

ARN de la ubicación de transferencia de Azure Blob Storage 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

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: