CreateLocationObjectStorage - AWS DataSync

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.

CreateLocationObjectStorage

Crée un point de terminaison pour un système de stockage d'objets quiAWS DataSyncpeut y accéder pour un transfert. Pour de plus amples informations, veuillez consulterCréation d'un emplacement pour le stockage d'objets.

Syntaxe de la demande

{ "AccessKey": "string", "AgentArns": [ "string" ], "BucketName": "string", "SecretKey": "string", "ServerHostname": "string", "ServerPort": number, "ServerProtocol": "string", "Subdirectory": "string", "Tags": [ { "Key": "string", "Value": "string" } ] }

Paramètres de demande

Pour plus d'informations sur les paramètres communs à toutes les actions, voirParamètres courants.

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

AccessKey

Spécifie la clé d'accès (par exemple, un nom d'utilisateur) si les informations d'identification sont nécessaires pour s'authentifier auprès du serveur de stockage d'objets.

Type : Chaîne

Contraintes de longueur : Longueur minimale de 8. Longueur maximum de 200.

Modèle : ^.+$

Obligatoire Non

AgentArns

Spécifie les ARN (Amazon Resource Names) du DataSync agents capables de se connecter en toute sécurité à votre localisation.

Type : Tableau de chaînes

Membres de tableau : Nombre minimum de 1 élément. Nombre maximal de 4 éléments.

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

BucketName

Spécifie le nom du compartiment de stockage d'objets impliqué dans le transfert.

Type : Chaîne

Contraintes de longueur : Longueur minimale de 3. Longueur maximum de 63.

Modèle : ^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$

Obligatoire Oui

SecretKey

Spécifie la clé secrète (par exemple, un mot de passe) si des informations d'identification sont nécessaires pour s'authentifier auprès du serveur de stockage d'objets.

Type : Chaîne

Contraintes de longueur : Longueur minimale de 8. Longueur maximum de 200.

Modèle : ^.+$

Obligatoire Non

ServerHostname

Spécifie le nom de domaine ou l'adresse IP du serveur de stockage d'objets. UN DataSync Agent utilise ce nom d'hôte pour monter le serveur de stockage d'objets dans un réseau.

Type : Chaîne

Contraintes de longueur : Longueur maximale de 255.

Modèle : ^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$

Obligatoire Oui

ServerPort

Spécifie le port sur lequel votre serveur de stockage d'objets accepte le trafic réseau entrant (par exemple, port 443).

Type : Entier

Plage valide : Valeur minimale est 1. Valeur maximale fixée à 65536.

Obligatoire Non

ServerProtocol

Spécifie le protocole utilisé par votre serveur de stockage d'objets pour communiquer.

Type : Chaîne

Valeurs valides : HTTPS | HTTP

Obligatoire Non

Subdirectory

Spécifie le préfixe d'objet de votre serveur de stockage d'objets. S'il s'agit d'un emplacement source, DataSync ne copie que les objets avec ce préfixe. S'il s'agit d'un lieu de destination, DataSync écrit tous les objets avec ce préfixe.

Type : Chaîne

Contraintes de longueur : Longueur maximum de 4096.

Modèle : ^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$

Obligatoire Non

Tags

Spécifie la paire clé-valeur qui représente une balise que vous souhaitez ajouter à la ressource. Les balises peuvent vous aider à gérer, filtrer et rechercher vos ressources. Nous vous recommandons de créer une étiquette de nom pour votre emplacement.

Type : Array deTagListEntryobjets

Membres de tableau : Nombre minimal de 0 éléments. 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

Spécifie l'ARN de l'emplacement du système de stockage d'objets que vous créez.

Type : Chaîne

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 communes à toutes les actions, voirErreurs courantes.

InternalException

Cette exception est renvoyée lorsqu'une erreur se produit dans laAWS DataSyncservice.

Code d'état HTTP : 500

InvalidRequestException

Cette exception est renvoyé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 kits SDK AWS spécifiques au langage, consultez les ressources suivantes :