Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # CreateLocationAzureBlob Crée un *emplacement* de transfert pour un conteneur Microsoft Azure Blob Storage. AWS DataSync peut utiliser cet emplacement comme source ou destination de transfert. Vous pouvez effectuer des transferts avec ou sans [DataSync agent](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-creating-agent) connecté à votre conteneur. Avant de commencer, assurez-vous de savoir [comment DataSync accéder à Azure Blob Storage](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access) et comment utiliser les [niveaux d'accès](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers) et les types de [blob](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#blob-types). ## Syntaxe de la requête ``` { "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" } ] } ``` ## Paramètres de demande Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md). Cette demande accepte les données suivantes au format JSON. ** [AccessTier](#API_CreateLocationAzureBlob_RequestSyntax) ** Spécifie le niveau d'accès vers lequel vous souhaitez transférer vos objets ou fichiers. Cela s'applique uniquement lorsque l'emplacement est utilisé comme destination de transfert. Pour plus d'informations, consultez la section [Niveaux d'accès](https://docs.aws.amazon.com/datasync/latest/userguide/creating-azure-blob-location.html#azure-blob-access-tiers). Type : Chaîne Valeurs valides : `HOT | COOL | ARCHIVE` Obligatoire : non ** [AgentArns](#API_CreateLocationAzureBlob_RequestSyntax) ** (Facultatif) Spécifie le nom de ressource Amazon (ARN) de l' DataSync agent qui peut se connecter à votre conteneur Azure Blob Storage. Si vous configurez un transfert cross-cloud sans agent, il n'est pas nécessaire de spécifier une valeur pour ce paramètre. Vous pouvez spécifier plusieurs agents. Pour plus d'informations, consultez la section [Utilisation de plusieurs agents pour votre transfert](https://docs.aws.amazon.com/datasync/latest/userguide/multiple-agents.html). Assurez-vous de configurer correctement ce paramètre lorsque vous créez votre emplacement de stockage pour la première fois. Il est impossible d'ajouter ou de supprimer des agents d'un emplacement de stockage après l'avoir créé. Type : tableau de chaînes Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 8 articles. Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` Obligatoire : non ** [AuthenticationType](#API_CreateLocationAzureBlob_RequestSyntax) ** Spécifie la méthode d'authentification DataSync utilisée pour accéder à votre Azure Blob Storage. DataSync peut accéder au stockage blob à l'aide d'une signature d'accès partagé (SAS). Type : Chaîne Valeurs valides : `SAS | NONE` Obligatoire : oui ** [BlobType](#API_CreateLocationAzureBlob_RequestSyntax) ** Spécifie le type de blob que vous souhaitez attribuer à vos objets ou fichiers lorsque vous les transférez dans Azure Blob Storage. Actuellement, DataSync ne prend en charge le transfert de données vers Azure Blob Storage que sous forme de blobs de blocs. Pour plus d'informations sur les types de blob, consultez la documentation [Azure Blob Storage](https://learn.microsoft.com/en-us/rest/api/storageservices/understanding-block-blobs--append-blobs--and-page-blobs). Type : Chaîne Valeurs valides : `BLOCK` Obligatoire : non ** [CmkSecretConfig](#API_CreateLocationAzureBlob_RequestSyntax) ** Spécifie les informations de configuration pour un secret DataSync géré, qui inclut le jeton d'authentification DataSync utilisé pour accéder à un emplacement de AzureBlob stockage spécifique, avec un code géré par le client AWS KMS key. Lorsque vous incluez ce paramètre dans le cadre d'une `CreateLocationAzureBlob` demande, vous ne fournissez que l'ARN de la clé KMS. DataSync utilise cette clé KMS avec le jeton d'authentification que vous spécifiez `SasConfiguration` pour créer un secret DataSync géré afin de stocker les informations d'accès à la localisation. Assurez-vous qu'il DataSync est autorisé à accéder à la clé KMS que vous spécifiez. Pour plus d'informations, consultez la section [Utilisation d'un secret géré par un service chiffré avec un code personnalisé](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key Vous pouvez utiliser `CmkSecretConfig` (avec`SasConfiguration`) ou `CustomSecretConfig` (sans`SasConfiguration`) pour fournir des informations d'identification pour une `CreateLocationAzureBlob` demande. Ne fournissez pas les deux paramètres pour la même demande. Type : objet [CmkSecretConfig](API_CmkSecretConfig.md) Obligatoire : non ** [ContainerUrl](#API_CreateLocationAzureBlob_RequestSyntax) ** Spécifie l'URL du conteneur Azure Blob Storage impliqué dans votre transfert. Type : Chaîne Contraintes de longueur : longueur maximale de 325. Modèle : `^https:\/\/[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}\/[a-z0-9](-?[a-z0-9]){2,62}$` Obligatoire : oui ** [CustomSecretConfig](#API_CreateLocationAzureBlob_RequestSyntax) ** Spécifie les informations de configuration pour un secret du Gestionnaire de secrets géré par le client dans lequel le jeton d'authentification d'un emplacement AzureBlob de stockage est stocké en texte brut, dans Secrets Manager. Cette configuration inclut l'ARN secret et l'ARN d'un rôle IAM qui donne accès au secret. Pour plus d'informations, consultez la section [Utilisation d'un secret que vous gérez](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key). Vous pouvez utiliser `CmkSecretConfig` (avec`SasConfiguration`) ou `CustomSecretConfig` (sans`SasConfiguration`) pour fournir des informations d'identification pour une `CreateLocationAzureBlob` demande. Ne fournissez pas les deux paramètres pour la même demande. Type : objet [CustomSecretConfig](API_CustomSecretConfig.md) Obligatoire : non ** [SasConfiguration](#API_CreateLocationAzureBlob_RequestSyntax) ** Spécifie la configuration SAS qui permet d'accéder DataSync à votre stockage Azure Blob. Si vous fournissez un jeton d'authentification en utilisant`SasConfiguration`, sans fournir de détails de configuration secrets, en utilisant `CmkSecretConfig` ou`CustomSecretConfig`, puis que vous DataSync stockez le jeton en utilisant le secret du gestionnaire de secrets de votre AWS compte. Type : objet [AzureBlobSasConfiguration](API_AzureBlobSasConfiguration.md) Obligatoire : non ** [Subdirectory](#API_CreateLocationAzureBlob_RequestSyntax) ** Spécifie les segments de chemin si vous souhaitez limiter votre transfert vers un répertoire virtuel de votre conteneur (par exemple,`/my/images`). Type : Chaîne Contraintes de longueur : longueur maximum de 1 024. Modèle : `^[\p{L}\p{M}\p{Z}\p{S}\p{N}\p{P}\p{C}]*$` Obligatoire : non ** [Tags](#API_CreateLocationAzureBlob_RequestSyntax) ** Spécifie des étiquettes qui vous aident à catégoriser, filtrer et rechercher vos ressources AWS . Nous vous recommandons de créer au moins une étiquette nominative pour votre lieu de transfert. Type : tableau d’objets [TagListEntry](API_TagListEntry.md) Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments. Obligatoire : non ## Syntaxe de la réponse ``` { "LocationArn": "string" } ``` ## Eléments de réponse Si l’action aboutit, le service renvoie une réponse HTTP 200. Les données suivantes sont renvoyées au format JSON par le service. ** [LocationArn](#API_CreateLocationAzureBlob_ResponseSyntax) ** L'ARN de l'emplacement de transfert Azure Blob Storage que vous avez créé. Type : Chaîne Contraintes de longueur : Longueur maximum de 128. Modèle : `^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}$` ## Erreurs Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md). ** InternalException ** Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service. Code d’état HTTP : 500 ** InvalidRequestException ** Cette exception est levée lorsque le client soumet une demande mal formée. Code d’état HTTP : 400 ## Voir aussi Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit : + [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationAzureBlob) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationAzureBlob)