

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.

# PutAccountName
<a name="API_PutAccountName"></a>

Met à jour le nom du compte spécifié. Pour utiliser cette API, les principaux IAM doivent disposer de l'autorisation `account:PutAccountName` IAM. 

## Syntaxe de la demande
<a name="API_PutAccountName_RequestSyntax"></a>

```
POST /putAccountName HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "AccountName": "string"
}
```

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

La demande n’utilise pas de paramètres URI.

## Corps de la demande
<a name="API_PutAccountName_RequestBody"></a>

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

 ** [AccountId](#API_PutAccountName_RequestSyntax) **   <a name="accounts-PutAccountName-request-AccountId"></a>
Spécifie le numéro d'identification à 12 chiffres du AWS compte auquel vous souhaitez accéder ou modifier à l'aide de cette opération.  
Si vous ne spécifiez pas ce paramètre, il s'agit par défaut du AWS compte de l'identité utilisée pour appeler l'opération.  
Pour utiliser ce paramètre, l'appelant doit être une identité figurant dans le [compte de gestion de l'organisation](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) ou un compte administrateur délégué, et l'identifiant de compte spécifié doit être un compte membre de la même organisation. [Toutes les fonctionnalités de l'organisation doivent être activées](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) et l'organisation doit disposer d'un [accès sécurisé](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html) activé pour le service de gestion des comptes, et éventuellement d'un compte d'[administrateur délégué](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) attribué.  
Le compte de gestion ne peut pas spécifier le sien `AccountId` ; il doit appeler l'opération dans un contexte autonome en n'incluant pas le `AccountId` paramètre.
Pour effectuer cette opération sur un compte qui n'est pas membre d'une organisation, ne spécifiez pas ce paramètre et appelez l'opération en utilisant une identité appartenant au compte dont vous souhaitez récupérer ou modifier les contacts.  
Type : Chaîne  
Modèle : `\d{12}`   
Obligatoire : non

 ** [AccountName](#API_PutAccountName_RequestSyntax) **   <a name="accounts-PutAccountName-request-AccountName"></a>
Le nom du compte.  
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50.  
Modèle : `[ -;=?-~]+`   
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_PutAccountName_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Eléments de réponse
<a name="API_PutAccountName_ResponseElements"></a>

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

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

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Types d'erreurs courants](CommonErrors.md).

 ** AccessDeniedException **   
L'opération a échoué car l'identité de l'appelant ne dispose pas des autorisations minimales requises.    
 ** errorType **   
La valeur renseignée dans l'en-tête de `x-amzn-ErrorType` réponse par API Gateway.
Code d’état HTTP : 403

 ** InternalServerException **   
L'opération a échoué en raison d'une erreur interne à AWS. Réessayez l'opération ultérieurement.    
 ** errorType **   
La valeur renseignée dans l'en-tête de `x-amzn-ErrorType` réponse par API Gateway.
Code d’état HTTP : 500

 ** TooManyRequestsException **   
L'opération a échoué car elle a été appelée trop fréquemment et a dépassé la limite d'accélérateur.    
 ** errorType **   
La valeur renseignée dans l'en-tête de `x-amzn-ErrorType` réponse par API Gateway.
Code d’état HTTP : 429

 ** ValidationException **   
L'opération a échoué car l'un des paramètres d'entrée n'était pas valide.    
 ** fieldList **   
Champ dans lequel l'entrée non valide a été détectée.  
 ** message **   
Le message qui vous informe de ce qui n'était pas valide dans la demande.  
 ** reason **   
Raison pour laquelle la validation a échoué.
Code d’état HTTP : 400

## Exemples
<a name="API_PutAccountName_Examples"></a>

### Exemple 1
<a name="API_PutAccountName_Example_1"></a>

L'exemple suivant met à jour le nom du compte dont les informations d'identification sont utilisées pour appeler l'opération. 

#### Exemple de demande
<a name="API_PutAccountName_Example_1_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
                    
{
   "AccountName":"MyAccount"
}
```

#### Exemple de réponse
<a name="API_PutAccountName_Example_1_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
```

### Exemple 2
<a name="API_PutAccountName_Example_2"></a>

L'exemple suivant met à jour le nom du compte de membre spécifié dans une organisation. Vous devez utiliser les informations d'identification du compte de gestion de l'organisation ou du compte d'administrateur délégué du service de gestion des comptes. 

#### Exemple de demande
<a name="API_PutAccountName_Example_2_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
                    
{
   "AccountId": "123456789012",
   "AccountName": "MyMemberAccount"
}
```

#### Exemple de réponse
<a name="API_PutAccountName_Example_2_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
```

## consultez aussi
<a name="API_PutAccountName_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/account-2021-02-01/PutAccountName) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAccountName) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAccountName) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAccountName) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAccountName) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAccountName) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAccountName) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAccountName) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAccountName) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAccountName) 