UpdateLocationObjectStorage - AWS DataSync
Syntaxe de la requêteParamètres de demandeÉlé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.

UpdateLocationObjectStorage

Modifie les paramètres de configuration suivants de l'emplacement de transfert du stockage d'objets que vous utilisez. AWS DataSync

Pour plus d'informations, consultez la section Configuration des DataSync transferts avec un système de stockage d'objets.

Syntaxe de la requête

{
   "AccessKey": "string",
   "AgentArns": [ "string" ],
   "LocationArn": "string",
   "SecretKey": "string",
   "ServerCertificate": blob,
   "ServerPort": number,
   "ServerProtocol": "string",
   "Subdirectory": "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.

AccessKey

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

Type : String

Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

Modèle : ^.*$

Obligatoire : non

AgentArns

Spécifie les Amazon Resource Names (ARNs) des DataSync agents qui peuvent se connecter à votre système de stockage d'objets.

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

LocationArn

Spécifie l'ARN de l'emplacement du système de stockage d'objets que vous mettez à jour.

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}$

Obligatoire : oui

SecretKey

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

Type : String

Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.

Modèle : ^.*$

Obligatoire : non

ServerCertificate

Spécifie une chaîne de certificats DataSync pour l'authentification auprès de votre système de stockage d'objets si celui-ci utilise une autorité de certification (CA) privée ou auto-signée. Vous devez spécifier un seul .pem fichier avec une chaîne de certificats complète (par exemple,file:///home/user/.ssh/object_storage_certificates.pem).

La chaîne de certificats peut inclure :

  • Le certificat du système de stockage d'objets

  • Tous les certificats intermédiaires (s'il y en a)

  • Le certificat racine de l'autorité de certification signataire

Vous pouvez concaténer vos certificats dans un .pem fichier (dont la taille peut atteindre 32 768 octets avant le codage base64). L'exemple de cat commande suivant crée un object_storage_certificates.pem fichier contenant trois certificats :

cat object_server_certificate.pem intermediate_certificate.pem ca_root_certificate.pem > object_storage_certificates.pem

Pour utiliser ce paramètre, configurez ServerProtocol surHTTPS.

La mise à jour de ce paramètre n'interfère pas avec les tâches en cours.

Type : objet de données binaires encodées en base64

Contraintes de longueur : longueur maximale de 32 768.

Obligatoire : non

ServerPort

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

Type : entier

Plage valide : valeur minimum de 1. Valeur maximale de 65536.

Obligatoire : non

ServerProtocol

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

Type : String

Valeurs valides : HTTPS | HTTP

Obligatoire : non

Subdirectory

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

Type : String

Contraintes de longueur : longueur maximale de 4096.

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

Obligatoire : non

Éléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.

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 :