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](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-creating-agent) que se conecte a su contenedor. Antes de empezar, asegúrese de saber [cómo se DataSync accede a Azure Blob Storage](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access) y cómo funciona con los [niveles de acceso](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers) y los tipos de [blob](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#blob-types). ## 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](CommonParameters.md). La solicitud acepta los siguientes datos en formato JSON. ** [AccessTier](#API_CreateLocationAzureBlob_RequestSyntax) ** 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](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers). Tipo: cadena Valores válidos: `HOT | COOL | ARCHIVE` Obligatorio: no ** [AgentArns](#API_CreateLocationAzureBlob_RequestSyntax) ** (Opcional) Especifica el nombre de recurso de Amazon (ARN) del DataSync agente que se puede conectar con el contenedor de Azure Blob Storage. Si se configura una transferencia entre nubes sin agente, no es necesario 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](https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html). Asegúrese de configurar este parámetro correctamente cuando cree por primera vez la ubicación de almacenamiento. No es posible agregar 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 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 ** [AuthenticationType](#API_CreateLocationAzureBlob_RequestSyntax) ** 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](#API_CreateLocationAzureBlob_RequestSyntax) ** 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.](https://learn.microsoft.com/en-us/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs) Tipo: cadena Valores válidos: `BLOCK` Obligatorio: no ** [CmkSecretConfig](#API_CreateLocationAzureBlob_RequestSyntax) ** 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. Para obtener más información, consulte [Uso de un secreto administrado por el servicio cifrado con un código personalizado](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key Puede usar `CmkSecretConfig` (con `SasConfiguration`) o `CustomSecretConfig` (sin `SasConfiguration`) para proporcionar credenciales para una solicitud `CreateLocationAzureBlob`. No proporcione ambos parámetros para la misma solicitud. Tipo: objeto [CmkSecretConfig](API_CmkSecretConfig.md) Obligatorio: no ** [ContainerUrl](#API_CreateLocationAzureBlob_RequestSyntax) ** 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](#API_CreateLocationAzureBlob_RequestSyntax) ** Especifica la información de configuración de un secreto de Secrets Manager administrado por el cliente donde el token de autenticación de una ubicación AzureBlob de almacenamiento se almacena en texto plano, en Secrets Manager. Esta configuración incluye el ARN del secreto y el ARN de un rol de IAM que proporciona acceso al secreto. Para obtener más información, consulte [Uso de un secreto que usted administra](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Puede usar `CmkSecretConfig` (con `SasConfiguration`) o `CustomSecretConfig` (sin `SasConfiguration`) para proporcionar credenciales para una solicitud `CreateLocationAzureBlob`. No proporcione ambos parámetros para la misma solicitud. Tipo: objeto [CustomSecretConfig](API_CustomSecretConfig.md) Obligatorio: no ** [SasConfiguration](#API_CreateLocationAzureBlob_RequestSyntax) ** Especifica la configuración de SAS que permite acceder DataSync a su Azure Blob Storage. Si proporciona un token de autenticación utilizando`SasConfiguration`, pero no proporciona detalles de configuración secretos utilizando `CmkSecretConfig` o`CustomSecretConfig`, entonces DataSync almacena el token utilizando el secreto del administrador de secretos de su AWS cuenta. Tipo: objeto [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md) Obligatorio: no ** [Subdirectory](#API_CreateLocationAzureBlob_RequestSyntax) ** 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](#API_CreateLocationAzureBlob_RequestSyntax) ** 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](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_CreateLocationAzureBlob_ResponseSyntax) ** 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-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 [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/CreateLocationAzureBlob) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationAzureBlob)