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.
# Actions
Les actions suivantes sont prises en charge :
+ [AcceptPrimaryEmailUpdate](API_AcceptPrimaryEmailUpdate.md)
+ [DeleteAlternateContact](API_DeleteAlternateContact.md)
+ [DisableRegion](API_DisableRegion.md)
+ [EnableRegion](API_EnableRegion.md)
+ [GetAccountInformation](API_GetAccountInformation.md)
+ [GetAlternateContact](API_GetAlternateContact.md)
+ [GetContactInformation](API_GetContactInformation.md)
+ [GetGovCloudAccountInformation](API_GetGovCloudAccountInformation.md)
+ [GetPrimaryEmail](API_GetPrimaryEmail.md)
+ [GetRegionOptStatus](API_GetRegionOptStatus.md)
+ [ListRegions](API_ListRegions.md)
+ [PutAccountName](API_PutAccountName.md)
+ [PutAlternateContact](API_PutAlternateContact.md)
+ [PutContactInformation](API_PutContactInformation.md)
+ [StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md)
# AcceptPrimaryEmailUpdate
Accepte la demande provenant de la mise [StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md) à jour de l'adresse e-mail principale (également appelée adresse e-mail de l'utilisateur root) pour le compte spécifié.
## Syntaxe de la demande
```
POST /acceptPrimaryEmailUpdate HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"Otp": "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_AcceptPrimaryEmailUpdate_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 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
** [Otp](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **
Le code OTP envoyé au `PrimaryEmail` spécifié lors de l'appel `StartPrimaryEmailUpdate` d'API.
Type : Chaîne
Modèle : `[a-zA-Z0-9]{6}`
Obligatoire : oui
** [PrimaryEmail](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **
La nouvelle adresse e-mail principale à utiliser avec le compte spécifié. Cela doit correspondre à celui `PrimaryEmail` de l'appel `StartPrimaryEmailUpdate` d'API.
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_AcceptPrimaryEmailUpdate_ResponseSyntax) **
Récupère le statut de la demande de mise à jour par e-mail principale acceptée.
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. 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.
** 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/AcceptPrimaryEmailUpdate)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/AcceptPrimaryEmailUpdate)
# DeleteAlternateContact
Supprime le contact alternatif spécifié d'un Compte AWS.
Pour plus de détails sur l'utilisation des opérations de contact secondaires, voir [Mettre à jour les contacts secondaires pour votre Compte AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html).
**Note**
Avant de pouvoir mettre à jour les informations de contact secondaires d'une Compte AWS personne gérée par AWS Organizations, vous devez d'abord activer l'intégration entre AWS Account Management et Organizations. Pour plus d'informations, voir [Activer l'accès sécurisé pour la gestion des AWS comptes](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html).
## Syntaxe de la demande
```
POST /deleteAlternateContact HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"AlternateContactType": "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_DeleteAlternateContact_RequestSyntax) **
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
** [AlternateContactType](#API_DeleteAlternateContact_RequestSyntax) **
Spécifie les contacts alternatifs à supprimer.
Type : Chaîne
Valeurs valides : `BILLING | OPERATIONS | SECURITY`
Obligatoire : oui
## Syntaxe de la réponse
```
HTTP/1.1 200
```
## Elé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 [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
** 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
## Exemples
### Exemple 1
L'exemple suivant supprime le contact secondaire de sécurité pour le compte dont les informations d'identification sont utilisées pour appeler l'opération.
#### Exemple de demande
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact
{
"AccountName":"MyAccount"
}
```
#### Exemple de réponse
```
HTTP/1.1 200 OK
Content-Type: application/json
```
### Exemple 2
L'exemple suivant supprime le contact alternatif de facturation pour le 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
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact
{
"AccountId":"123456789012",
"AlternateContactType":"BILLING"
}
```
#### Exemple de réponse
```
HTTP/1.1 200 OK
Content-Type: application/json
```
## 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 :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/DeleteAlternateContact)
# DisableRegion
Désactive (désactive) une région spécifique pour un compte.
**Note**
La désactivation d'une région supprimera tout accès IAM à toutes les ressources résidant dans cette région.
## Syntaxe de la demande
```
POST /disableRegion HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"RegionName": "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_DisableRegion_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. Si vous ne spécifiez pas ce paramètre, il s'agit par défaut du compte Amazon Web Services associé à l'identité utilisée pour appeler l'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é.
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 appeler cette opération sur un compte qui n'est pas membre d'une organisation, ne spécifiez pas ce paramètre. Appelez plutôt 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
** [RegionName](#API_DisableRegion_RequestSyntax) **
Spécifie le code de région pour un nom de région donné (par exemple,`af-south-1`). Lorsque vous désactivez une région, AWS exécute des actions pour la désactiver dans votre compte, par exemple en détruisant les ressources IAM de la région. Ce processus prend quelques minutes pour la plupart des comptes, mais cela peut prendre plusieurs heures. Vous ne pouvez pas activer la région tant que le processus de désactivation n'est pas complètement terminé.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50.
Obligatoire : oui
## Syntaxe de la réponse
```
HTTP/1.1 200
```
## Elé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 [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
** 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/DisableRegion)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/DisableRegion)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/DisableRegion)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/DisableRegion)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/DisableRegion)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/DisableRegion)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/DisableRegion)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/DisableRegion)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/DisableRegion)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/DisableRegion)
# EnableRegion
Active (opte) une région particulière pour un compte.
## Syntaxe de la demande
```
POST /enableRegion HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"RegionName": "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_EnableRegion_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. Si vous ne spécifiez pas ce paramètre, il s'agit par défaut du compte Amazon Web Services associé à l'identité utilisée pour appeler l'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é.
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 appeler cette opération sur un compte qui n'est pas membre d'une organisation, ne spécifiez pas ce paramètre. Appelez plutôt 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
** [RegionName](#API_EnableRegion_RequestSyntax) **
Spécifie le code de région pour un nom de région donné (par exemple,`af-south-1`). Lorsque vous activez une région, AWS effectue des actions pour préparer votre compte dans cette région, telles que la distribution de vos ressources pour la région. Ce processus prend quelques minutes pour la plupart des comptes, mais peut prendre plusieurs heures. Vous ne pouvez pas utiliser la région tant que ce processus n'est pas terminé. En outre, vous ne pouvez pas désactiver la région tant que le processus d'activation n'est pas complètement terminé.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50.
Obligatoire : oui
## Syntaxe de la réponse
```
HTTP/1.1 200
```
## Elé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 [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. 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.
** 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
** 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/EnableRegion)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/EnableRegion)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/EnableRegion)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/EnableRegion)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/EnableRegion)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/EnableRegion)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/EnableRegion)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/EnableRegion)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/EnableRegion)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/EnableRegion)
# GetAccountInformation
Récupère des informations sur le compte spécifié, notamment son nom de compte, son identifiant de compte, ainsi que la date et l'heure de création du compte. Pour utiliser cette API, un utilisateur ou un rôle IAM doit disposer de l'autorisation `account:GetAccountInformation` IAM.
## Syntaxe de la demande
```
POST /getAccountInformation HTTP/1.1
Content-type: application/json
{
"AccountId": "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_GetAccountInformation_RequestSyntax) **
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
## Syntaxe de la réponse
```
HTTP/1.1 200
Content-type: application/json
{
"AccountCreatedDate": "string",
"AccountId": "string",
"AccountName": "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.
** [AccountCreatedDate](#API_GetAccountInformation_ResponseSyntax) **
Date et heure de création du compte.
Type : Timestamp
** [AccountId](#API_GetAccountInformation_ResponseSyntax) **
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}`
** [AccountName](#API_GetAccountInformation_ResponseSyntax) **
Le nom du compte.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50.
Modèle : `[ -;=?-~]+`
## 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
** 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
### Exemple 1
L'exemple suivant récupère les informations de compte pour le compte dont les informations d'identification sont utilisées pour appeler l'opération.
#### Exemple de demande
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAccountInformation
{}
```
#### Exemple de réponse
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"AccountId": "123456789012",
"AccountName": "MyAccount",
"AccountCreatedDate": "2020-11-30T17:44:37Z"
}
```
### Exemple 2
L'exemple suivant permet de récupérer les informations de compte pour le 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
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAccountInformation
{
"AccountId": "123456789012"
}
```
#### Exemple de réponse
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"AccountId": "123456789012",
"AccountName": "MyMemberAccount",
"AccountCreatedDate": "2020-11-30T17:44:37Z"
}
```
## 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 :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetAccountInformation)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAccountInformation)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAccountInformation)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAccountInformation)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAccountInformation)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAccountInformation)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAccountInformation)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAccountInformation)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAccountInformation)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAccountInformation)
# GetAlternateContact
Récupère le contact alternatif spécifié attaché à un Compte AWS.
Pour plus de détails sur l'utilisation des opérations de contact secondaires, voir [Mettre à jour les contacts secondaires pour votre Compte AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html).
**Note**
Avant de pouvoir mettre à jour les informations de contact secondaires d'une Compte AWS personne gérée par AWS Organizations, vous devez d'abord activer l'intégration entre AWS Account Management et Organizations. Pour plus d'informations, voir [Activer l'accès sécurisé pour la gestion des AWS comptes](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html).
## Syntaxe de la demande
```
POST /getAlternateContact HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"AlternateContactType": "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_GetAlternateContact_RequestSyntax) **
Spécifie le numéro d'identification à 12 chiffres du AWS compte auquel vous souhaitez accéder ou modifier avec 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
** [AlternateContactType](#API_GetAlternateContact_RequestSyntax) **
Spécifie le contact alternatif que vous souhaitez récupérer.
Type : Chaîne
Valeurs valides : `BILLING | OPERATIONS | SECURITY`
Obligatoire : oui
## Syntaxe de la réponse
```
HTTP/1.1 200
Content-type: application/json
{
"AlternateContact": {
"AlternateContactType": "string",
"EmailAddress": "string",
"Name": "string",
"PhoneNumber": "string",
"Title": "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.
** [AlternateContact](#API_GetAlternateContact_ResponseSyntax) **
Structure contenant les détails du contact alternatif spécifié.
Type : objet [AlternateContact](API_AlternateContact.md)
## 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
** 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
## Exemples
### Exemple 1
L'exemple suivant récupère le contact de sécurité alternatif pour le compte dont les informations d'identification sont utilisées pour appeler l'opération.
#### Exemple de demande
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAlternateContact
{
"AlternateContactType":"SECURITY"
}
```
#### Exemple de réponse
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"AlternateContact":{
"Name":"Anika",
"Title":"COO",
"EmailAddress":"anika@example.com",
"PhoneNumber":"206-555-0198",
"AlternateContactType":"Security"
}
}
```
### Exemple 2
L'exemple suivant permet de récupérer le contact alternatif des opérations pour le compte 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
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAlternateContact
{
"AccountId":"123456789012",
"AlternateContactType":"Operations"
}
```
#### Exemple de réponse
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"AlternateContact":{
"Name":"Anika",
"Title":"COO",
"EmailAddress":"anika@example.com",
"PhoneNumber":"206-555-0198",
"AlternateContactType":"Operations"
}
}
```
## 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 :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetAlternateContact)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAlternateContact)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAlternateContact)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAlternateContact)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAlternateContact)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAlternateContact)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAlternateContact)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAlternateContact)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAlternateContact)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAlternateContact)
# GetContactInformation
Récupère les informations de contact principales d'un Compte AWS.
Pour plus de détails sur l'utilisation des opérations du contact principal, voir [Mettre à jour le contact principal pour votre Compte AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html).
## Syntaxe de la demande
```
POST /getContactInformation HTTP/1.1
Content-type: application/json
{
"AccountId": "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_GetContactInformation_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. Si vous ne spécifiez pas ce paramètre, il s'agit par défaut du compte Amazon Web Services associé à l'identité utilisée pour appeler l'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é.
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 appeler cette opération sur un compte qui n'est pas membre d'une organisation, ne spécifiez pas ce paramètre. Appelez plutôt 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
## Syntaxe de la réponse
```
HTTP/1.1 200
Content-type: application/json
{
"ContactInformation": {
"AddressLine1": "string",
"AddressLine2": "string",
"AddressLine3": "string",
"City": "string",
"CompanyName": "string",
"CountryCode": "string",
"DistrictOrCounty": "string",
"FullName": "string",
"PhoneNumber": "string",
"PostalCode": "string",
"StateOrRegion": "string",
"WebsiteUrl": "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.
** [ContactInformation](#API_GetContactInformation_ResponseSyntax) **
Contient les détails des informations de contact principales associées à un Compte AWS.
Type : objet [ContactInformation](API_ContactInformation.md)
## 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
** 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/GetContactInformation)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetContactInformation)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetContactInformation)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetContactInformation)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetContactInformation)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetContactInformation)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetContactInformation)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetContactInformation)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetContactInformation)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetContactInformation)
# GetGovCloudAccountInformation
Récupère des informations sur le GovCloud compte lié au compte standard spécifié (s'il existe), y compris l'identifiant et l'état du GovCloud compte. Pour utiliser cette API, un utilisateur ou un rôle IAM doit disposer de l'autorisation `account:GetGovCloudAccountInformation` IAM.
## Syntaxe de la demande
```
POST /getGovCloudAccountInformation HTTP/1.1
Content-type: application/json
{
"StandardAccountId": "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.
** [StandardAccountId](#API_GetGovCloudAccountInformation_RequestSyntax) **
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
## Syntaxe de la réponse
```
HTTP/1.1 200
Content-type: application/json
{
"AccountState": "string",
"GovCloudAccountId": "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.
** [AccountState](#API_GetGovCloudAccountInformation_ResponseSyntax) **
État du GovCloud compte associé.
Type : Chaîne
Valeurs valides : `PENDING_ACTIVATION | ACTIVE | SUSPENDED | CLOSED`
** [GovCloudAccountId](#API_GetGovCloudAccountInformation_ResponseSyntax) **
Le numéro d'identification à 12 chiffres du GovCloud compte associé.
Type : Chaîne
Modèle : `\d{12}`
## 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
** 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
** ResourceUnavailableException **
L'opération a échoué car elle a spécifié une ressource qui n'est pas disponible actuellement.
** errorType **
La valeur renseignée dans l'en-tête de `x-amzn-ErrorType` réponse par API Gateway.
Code d'état HTTP : 424
** 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
### Exemple 1
L'exemple suivant récupère les informations du GovCloud compte lié pour le compte dont les informations d'identification sont utilisées pour appeler l'opération.
#### Exemple de demande
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
{}
```
#### Exemple de réponse
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"GovCloudAccountId": "123456789012",
"AccountState": "ACTIVE"
}
```
### Exemple 2
L'exemple suivant extrait les informations du GovCloud compte lié pour le compte 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
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
{
"StandardAccountId": "111111111111"
}
```
#### Exemple de réponse
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"GovCloudAccountId": "123456789012",
"AccountState": "ACTIVE"
}
```
### Exemple 3
L'exemple suivant tente de récupérer les informations du GovCloud compte lié pour un compte standard qui n'est pas lié à un GovCloud compte.
#### Exemple de demande
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
{
"StandardAccountId": "222222222222"
}
```
#### Exemple de réponse
```
HTTP/1.1 404
Content-Type: application/json
{
"message":"GovCloud Account ID not found for Standard Account - 222222222222."
}
```
## 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 :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetGovCloudAccountInformation)
# GetPrimaryEmail
Récupère l'adresse e-mail principale du compte spécifié.
## Syntaxe de la demande
```
POST /getPrimaryEmail HTTP/1.1
Content-type: application/json
{
"AccountId": "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_GetPrimaryEmail_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 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
## Syntaxe de la réponse
```
HTTP/1.1 200
Content-type: application/json
{
"PrimaryEmail": "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.
** [PrimaryEmail](#API_GetPrimaryEmail_ResponseSyntax) **
Récupère l'adresse e-mail principale associée au compte spécifié.
Type : Chaîne
Contraintes de longueur : longueur minimale de 5. Longueur maximale de 64 caractères.
## 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
** 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/GetPrimaryEmail)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetPrimaryEmail)
# GetRegionOptStatus
Récupère le statut d'opt-in d'une région donnée.
## Syntaxe de la demande
```
POST /getRegionOptStatus HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"RegionName": "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_GetRegionOptStatus_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. Si vous ne spécifiez pas ce paramètre, il s'agit par défaut du compte Amazon Web Services associé à l'identité utilisée pour appeler l'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é.
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 appeler cette opération sur un compte qui n'est pas membre d'une organisation, ne spécifiez pas ce paramètre. Appelez plutôt 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
** [RegionName](#API_GetRegionOptStatus_RequestSyntax) **
Spécifie le code de région pour un nom de région donné (par exemple,`af-south-1`). Cette fonction renverra le statut de la région que vous passez dans ce paramètre.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50.
Obligatoire : oui
## Syntaxe de la réponse
```
HTTP/1.1 200
Content-type: application/json
{
"RegionName": "string",
"RegionOptStatus": "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.
** [RegionName](#API_GetRegionOptStatus_ResponseSyntax) **
Le code de région qui a été transmis.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50.
** [RegionOptStatus](#API_GetRegionOptStatus_ResponseSyntax) **
L'un des statuts potentiels qu'une région peut subir (Activé, Activant, Désactivé, Désactivant, Enabled\$1By\$1Default).
Type : Chaîne
Valeurs valides : `ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT`
## 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
** 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
## 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/GetRegionOptStatus)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetRegionOptStatus)
# ListRegions
Répertorie toutes les régions associées à un compte donné et leurs statuts d'inscription respectifs. Cette liste peut éventuellement être filtrée par le `region-opt-status-contains` paramètre.
## Syntaxe de la demande
```
POST /listRegions HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"MaxResults": number,
"NextToken": "string",
"RegionOptStatusContains": [ "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_ListRegions_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. Si vous ne spécifiez pas ce paramètre, il s'agit par défaut du compte Amazon Web Services associé à l'identité utilisée pour appeler l'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é.
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 appeler cette opération sur un compte qui n'est pas membre d'une organisation, ne spécifiez pas ce paramètre. Appelez plutôt 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
** [MaxResults](#API_ListRegions_RequestSyntax) **
Le nombre total d'éléments à renvoyer dans la sortie de la commande. Si le nombre total d'éléments disponibles est supérieur à la valeur spécifiée, un `NextToken` est fourni dans la sortie de la commande. Pour reprendre la pagination, fournissez la valeur de `NextToken` dans l'argument `starting-token` d'une commande suivante. N'utilisez pas l'élément de `NextToken` réponse directement en dehors de la AWS CLI. Pour des exemples d'utilisation, voir [Pagination](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html) dans le *guide de l'utilisateur de l'interface de ligne de AWS commande*.
Type : entier
Plage valide : valeur minimum de 1. Valeur maximale de 50.
Obligatoire : non
** [NextToken](#API_ListRegions_RequestSyntax) **
Un jeton utilisé pour indiquer où commencer la pagination. C'est le résultat `NextToken` d'une réponse tronquée précédemment. Pour des exemples d'utilisation, voir [Pagination](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html) dans le *guide de l'utilisateur de l'interface de ligne de AWS commande*.
Type : Chaîne
Contraintes de longueur : longueur minimale de 0. Longueur maximale de 1 000 caractères.
Obligatoire : non
** [RegionOptStatusContains](#API_ListRegions_RequestSyntax) **
Liste des statuts des régions (Activation, Activé, Désactivé, Désactivé, Activé par défaut) à utiliser pour filtrer la liste des régions pour un compte donné. Par exemple, la transmission d'une valeur ENABLING renverra uniquement une liste de régions dont le statut de région est ENABLING.
Type : tableau de chaînes
Valeurs valides : `ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT`
Obligatoire : non
## Syntaxe de la réponse
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Regions": [
{
"RegionName": "string",
"RegionOptStatus": "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.
** [NextToken](#API_ListRegions_ResponseSyntax) **
Si d'autres données doivent être renvoyées, elles seront renseignées. Il doit être transmis dans le paramètre de `next-token` requête de`list-regions`.
Type : Chaîne
** [Regions](#API_ListRegions_ResponseSyntax) **
Il s'agit d'une liste de régions pour un compte donné ou, si le paramètre filtré a été utilisé, d'une liste de régions correspondant aux critères de filtre définis dans le `filter` paramètre.
Type : tableau d’objets [Region](API_Region.md)
## 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
** 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
## 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/ListRegions)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/ListRegions)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ListRegions)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/ListRegions)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ListRegions)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/ListRegions)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/ListRegions)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/ListRegions)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/ListRegions)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ListRegions)
# PutAccountName
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
```
POST /putAccountName HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"AccountName": "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_PutAccountName_RequestSyntax) **
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) **
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
```
HTTP/1.1 200
```
## Elé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 [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
### Exemple 1
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
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
{
"AccountName":"MyAccount"
}
```
#### Exemple de réponse
```
HTTP/1.1 200 OK
Content-Type: application/json
```
### Exemple 2
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
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
{
"AccountId": "123456789012",
"AccountName": "MyMemberAccount"
}
```
#### Exemple de réponse
```
HTTP/1.1 200 OK
Content-Type: application/json
```
## 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 :
+ [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)
# PutAlternateContact
Modifie le contact alternatif spécifié attaché à un Compte AWS.
Pour plus de détails sur l'utilisation des opérations de contact secondaires, voir [Mettre à jour les contacts secondaires pour votre Compte AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html).
**Note**
Avant de pouvoir mettre à jour les informations de contact secondaires d'une Compte AWS personne gérée par AWS Organizations, vous devez d'abord activer l'intégration entre AWS Account Management et Organizations. Pour plus d'informations, voir [Activer l'accès sécurisé pour la gestion des AWS comptes](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html).
## Syntaxe de la demande
```
POST /putAlternateContact HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"AlternateContactType": "string",
"EmailAddress": "string",
"Name": "string",
"PhoneNumber": "string",
"Title": "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_PutAlternateContact_RequestSyntax) **
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
** [AlternateContactType](#API_PutAlternateContact_RequestSyntax) **
Spécifie le contact alternatif que vous souhaitez créer ou mettre à jour.
Type : Chaîne
Valeurs valides : `BILLING | OPERATIONS | SECURITY`
Obligatoire : oui
** [EmailAddress](#API_PutAlternateContact_RequestSyntax) **
Spécifie l'adresse e-mail de l'autre contact.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 254
Modèle : `[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*`
Obligatoire : oui
** [Name](#API_PutAlternateContact_RequestSyntax) **
Spécifie le nom de l'autre contact.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.
Obligatoire : oui
** [PhoneNumber](#API_PutAlternateContact_RequestSyntax) **
Spécifie le numéro de téléphone de l'autre contact.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 25
Modèle : `[\s0-9()+-]+`
Obligatoire : oui
** [Title](#API_PutAlternateContact_RequestSyntax) **
Spécifie le titre de l'autre contact.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50.
Obligatoire : oui
## Syntaxe de la réponse
```
HTTP/1.1 200
```
## Elé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 [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
### Exemple 1
L'exemple suivant définit le contact alternatif de facturation pour le compte dont les informations d'identification sont utilisées pour appeler l'opération.
#### Exemple de demande
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAlternateContact
{
"AlternateContactType": "Billing",
"Name": "Carlos Salazar",
"Title": "CFO",
"EmailAddress": "carlos@example.com",
"PhoneNumber": "206-555-0199"
}
```
#### Exemple de réponse
```
HTTP/1.1 200 OK
Content-Type: application/json
```
### Exemple 2
L'exemple suivant définit ou remplace le contact de facturation alternatif pour le 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
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAlternateContact
{
"AccountId": "123456789012",
"AlternateContactType": "Billing",
"Name": "Carlos Salazar",
"Title": "CFO",
"EmailAddress": "carlos@example.com",
"PhoneNumber": "206-555-0199"
}
```
#### Exemple de réponse
```
HTTP/1.1 200 OK
Content-Type: application/json
```
## 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 :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutAlternateContact)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAlternateContact)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAlternateContact)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAlternateContact)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAlternateContact)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAlternateContact)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAlternateContact)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAlternateContact)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAlternateContact)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAlternateContact)
# PutContactInformation
Met à jour les informations de contact principales d'un Compte AWS.
Pour plus de détails sur l'utilisation des opérations du contact principal, voir [Mettre à jour le contact principal pour votre Compte AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html).
## Syntaxe de la demande
```
POST /putContactInformation HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"ContactInformation": {
"AddressLine1": "string",
"AddressLine2": "string",
"AddressLine3": "string",
"City": "string",
"CompanyName": "string",
"CountryCode": "string",
"DistrictOrCounty": "string",
"FullName": "string",
"PhoneNumber": "string",
"PostalCode": "string",
"StateOrRegion": "string",
"WebsiteUrl": "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_PutContactInformation_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. Si vous ne spécifiez pas ce paramètre, il s'agit par défaut du compte Amazon Web Services associé à l'identité utilisée pour appeler l'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/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 appeler cette opération sur un compte qui n'est pas membre d'une organisation, ne spécifiez pas ce paramètre. Appelez plutôt 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
** [ContactInformation](#API_PutContactInformation_RequestSyntax) **
Contient les détails des informations de contact principales associées à un Compte AWS.
Type : objet [ContactInformation](API_ContactInformation.md)
Obligatoire : oui
## Syntaxe de la réponse
```
HTTP/1.1 200
```
## Elé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 [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
## 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/PutContactInformation)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutContactInformation)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutContactInformation)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutContactInformation)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutContactInformation)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutContactInformation)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutContactInformation)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutContactInformation)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutContactInformation)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutContactInformation)
# 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)