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
<a name="API_UpdateLocationObjectStorage"></a>

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](https://docs.aws.amazon.com/datasync/latest/userguide/create-object-location.html).

## Syntaxe de la requête
<a name="API_UpdateLocationObjectStorage_RequestSyntax"></a>

```
{
   "AccessKey": "string",
   "AgentArns": [ "string" ],
   "CmkSecretConfig": { 
      "KmsKeyArn": "string",
      "SecretArn": "string"
   },
   "CustomSecretConfig": { 
      "SecretAccessRoleArn": "string",
      "SecretArn": "string"
   },
   "LocationArn": "string",
   "SecretKey": "string",
   "ServerCertificate": blob,
   "ServerHostname": "string",
   "ServerPort": number,
   "ServerProtocol": "string",
   "Subdirectory": "string"
}
```

## Paramètres de demande
<a name="API_UpdateLocationObjectStorage_RequestParameters"></a>

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.

 ** [AccessKey](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-AccessKey"></a>
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 : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.  
Modèle : `^.*$`   
Obligatoire : non

 ** [AgentArns](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-AgentArns"></a>
(Facultatif) Spécifie les Amazon Resource Names (ARNs) des DataSync agents qui peuvent se connecter à votre système de stockage d'objets. Si vous configurez un transfert cross-cloud sans agent, il n'est pas nécessaire de spécifier une valeur pour ce paramètre.  
Il est impossible d'ajouter ou de supprimer des agents d'un emplacement de stockage après l'avoir initialement 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

 ** [CmkSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-CmkSecretConfig"></a>
Spécifie les informations de configuration pour un secret DataSync géré, tel qu'un jeton d'authentification ou un ensemble d'informations d'identification DataSync utilisé pour accéder à un lieu de transfert spécifique, et un secret géré par le client AWS KMS key.  
Type : objet [CmkSecretConfig](API_CmkSecretConfig.md)  
Obligatoire : non

 ** [CustomSecretConfig](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-CustomSecretConfig"></a>
Spécifie les informations de configuration pour un secret géré par le client, tel qu'un jeton d'authentification ou un ensemble d'informations d'identification DataSync permettant d'accéder à un lieu de transfert spécifique, et un rôle géré par le client Gestion des identités et des accès AWS (IAM) qui fournit l'accès au secret.  
Type : objet [CustomSecretConfig](API_CustomSecretConfig.md)  
Obligatoire : non

 ** [LocationArn](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-LocationArn"></a>
Spécifie l'ARN de l'emplacement du système de stockage d'objets que vous mettez à jour.  
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}$`   
Obligatoire : oui

 ** [SecretKey](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-SecretKey"></a>
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.  
Si vous fournissez un code secret en utilisant `CmkSecretConfig` ou`SecretKey`, si vous ne fournissez pas de détails de configuration secrets`CustomSecretConfig`, vous DataSync stockez le jeton en utilisant le secret du Gestionnaire de Secrets Manager de votre AWS compte.
Type : Chaîne  
Contraintes de longueur : longueur minimum de 0. Longueur maximum de 200.  
Modèle : `^.*$`   
Obligatoire : non

 ** [ServerCertificate](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerCertificate"></a>
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` sur`HTTPS`.  
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

 ** [ServerHostname](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerHostname"></a>
Spécifie le nom de domaine ou l'adresse IP (IPv4 ou IPv6) du serveur de stockage d'objets auquel votre DataSync agent se connecte.  
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 : non

 ** [ServerPort](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerPort"></a>
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](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-ServerProtocol"></a>
Spécifie le protocole utilisé par votre serveur de stockage d'objets pour communiquer.  
Type : Chaîne  
Valeurs valides : `HTTPS | HTTP`   
Obligatoire : non

 ** [Subdirectory](#API_UpdateLocationObjectStorage_RequestSyntax) **   <a name="DataSync-UpdateLocationObjectStorage-request-Subdirectory"></a>
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 : Chaîne  
Contraintes de longueur : longueur maximale de 4096.  
Modèle : `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$`   
Obligatoire : non

## Éléments de réponse
<a name="API_UpdateLocationObjectStorage_ResponseElements"></a>

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

## Erreurs
<a name="API_UpdateLocationObjectStorage_Errors"></a>

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
<a name="API_UpdateLocationObjectStorage_SeeAlso"></a>

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/UpdateLocationObjectStorage) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationObjectStorage) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationObjectStorage)