CreateLocationAzureBlob - AWS DataSync
Syntaxe de la requêteParamètres de demandeSyntaxe de la réponseEléments de réponseErreursconsultez aussi

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 connecté à votre conteneur.

Avant de commencer, assurez-vous de savoir comment DataSync accéder à Azure Blob Storage et comment utiliser les niveaux d'accès et les types de blob.

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.

Cette demande accepte les données suivantes au format JSON.

AccessTier

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.

Type : String

Valeurs valides : HOT | COOL | ARCHIVE

Obligatoire : non

AgentArns

(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.

Note

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 4 articles.

Contraintes de longueur : Longueur maximum de 128.

Modèle : ^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}$

Obligatoire : non

AuthenticationType

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

Valeurs valides : SAS | NONE

Obligatoire : oui

BlobType

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.

Type : String

Valeurs valides : BLOCK

Obligatoire : non

CmkSecretConfig

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' DataSync il est autorisé à accéder à la clé KMS que vous spécifiez.

Note

Vous pouvez utiliser CmkSecretConfig (avecSasConfiguration) ou CustomSecretConfig (sansSasConfiguration) 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

Obligatoire : non

ContainerUrl

Spécifie l'URL du conteneur Azure Blob Storage impliqué dans votre transfert.

Type : String

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

Spécifie les informations de configuration d'un secret du Gestionnaire de Secrets Manager géré par le client dans lequel le jeton d'authentification d'un emplacement AzureBlob de stockage est stocké en texte brut. Cette configuration inclut l'ARN secret et l'ARN d'un rôle IAM qui donne accès au secret.

Note

Vous pouvez utiliser CmkSecretConfig (avecSasConfiguration) ou CustomSecretConfig (sansSasConfiguration) 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

Obligatoire : non

SasConfiguration

Spécifie la configuration SAS qui permet d'accéder DataSync à votre stockage Azure Blob.

Note

Si vous fournissez un jeton d'authentification en utilisantSasConfiguration, sans fournir de détails de configuration secrets, en utilisant CmkSecretConfig ouCustomSecretConfig, puis que vous DataSync stockez le jeton en utilisant le secret du gestionnaire de secrets de votre AWS compte.

Type : objet AzureBlobSasConfiguration

Obligatoire : non

Subdirectory

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

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

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

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

L'ARN de l'emplacement de transfert Azure Blob Storage que vous avez créé.

Type : String

Contraintes de longueur : Longueur maximum de 128.

Modèle : ^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}$

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

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

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :