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.
# StartPrimaryEmailUpdate
Lance le processus de mise à jour de l'adresse e-mail principale du compte spécifié.
## Syntaxe de la demande
```
POST /startPrimaryEmailUpdate HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"PrimaryEmail": "string"
}
```
## Paramètres de demande URI
La demande n’utilise pas de paramètres URI.
## Corps de la demande
Cette demande accepte les données suivantes au format JSON.
** [AccountId](#API_StartPrimaryEmailUpdate_RequestSyntax) **
Spécifie le numéro d'identification à 12 chiffres du compte Compte AWS auquel vous souhaitez accéder ou modifier lors de cette opération. Pour utiliser ce paramètre, l'appelant doit être une identité enregistrée dans le compte [de gestion de l'organisation ou un compte](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) d'administrateur délégué. 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/orgs_integrate_services.html) activé pour le service de gestion des comptes, et éventuellement d'un compte [administrateur délégué](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) attribué.
Cette opération ne peut être appelée que depuis le compte de gestion ou le compte d'administrateur délégué d'une organisation pour un compte membre.
Le compte de gestion ne peut pas spécifier le sien`AccountId`.
Type : Chaîne
Modèle : `\d{12}`
Obligatoire : oui
** [PrimaryEmail](#API_StartPrimaryEmailUpdate_RequestSyntax) **
La nouvelle adresse e-mail principale (également appelée adresse e-mail de l'utilisateur root) à utiliser dans le compte spécifié.
Type : Chaîne
Contraintes de longueur : longueur minimale de 5. Longueur maximale de 64 caractères.
Obligatoire : oui
## Syntaxe de la réponse
```
HTTP/1.1 200
Content-type: application/json
{
"Status": "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.
** [Status](#API_StartPrimaryEmailUpdate_ResponseSyntax) **
État de la demande de mise à jour par e-mail principale.
Type : Chaîne
Valeurs valides : `PENDING | ACCEPTED`
## Erreurs
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
** ConflictException **
La demande n'a pas pu être traitée en raison d'un conflit dans l'état actuel de la ressource. Par exemple, cela se produit si vous essayez d'activer une région actuellement désactivée (dont le statut est DÉSACTIVÉ) ou si vous essayez de remplacer l'adresse e-mail de l'utilisateur root d'un compte par une adresse e-mail déjà utilisée.
** errorType **
La valeur renseignée dans l'en-tête de `x-amzn-ErrorType` réponse par API Gateway.
Code d’état HTTP : 409
** 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
** ResourceNotFoundException **
L'opération a échoué car elle a spécifié une ressource introuvable.
** errorType **
La valeur renseignée dans l'en-tête de `x-amzn-ErrorType` réponse par API Gateway.
Code d’état HTTP :404
** 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
## Voir aussi
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/StartPrimaryEmailUpdate)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/StartPrimaryEmailUpdate)