StartPrimaryEmailUpdate - AWS Gestion du compte

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

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 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 et l'organisation doit disposer d'un accès sécurisé activé pour le service de gestion des comptes, et éventuellement d'un compte administrateur délégué 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.

Note

Le compte de gestion ne peut pas spécifier le sienAccountId.

Type : chaîne

Modèle : ^\d{12}$

Obligatoire : oui

PrimaryEmail

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.

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

É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 Erreurs courantes.

AccessDeniedException

L'opération a échoué car l'identité de l'appelant ne dispose pas des autorisations minimales requises.

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. Cela se produit par exemple 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.

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.

Code d’état HTTP : 500

ResourceNotFoundException

L'opération a échoué car elle a spécifié une ressource introuvable.

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.

Code d’état HTTP : 429

ValidationException

L'opération a échoué car l'un des paramètres d'entrée n'était pas valide.

Code d’état HTTP : 400

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :