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.
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. Vous avez également besoin d'un DataSync agent capable de se connecter à votre conteneur.
Syntaxe de la requête
{
"AccessTier": "string",
"AgentArns": [ "string" ],
"AuthenticationType": "string",
"BlobType": "string",
"ContainerUrl": "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 | ARCHIVEObligatoire : non
- AgentArns
-
Spécifie le nom de ressource Amazon (ARN) de l' DataSync agent qui peut se connecter à votre conteneur Azure Blob Storage.
Vous pouvez spécifier plusieurs agents. Pour plus d'informations, consultez la section Utilisation de plusieurs agents pour votre transfert.
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 : oui
- 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 :
SASObligatoire : 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 :
BLOCKObligatoire : 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
- SasConfiguration
-
Spécifie la configuration SAS qui permet d'accéder DataSync à votre Azure Blob Storage.
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 à classer, filtrer et rechercher vos AWS ressources. 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 :
