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.
# Référence d’API
Les opérations d'API dans l'espace de noms Account Management (`account`) vous permettent de modifier votre Compte AWS.
Chacun Compte AWS prend en charge les métadonnées contenant des informations sur le compte, y compris des informations sur un maximum de trois contacts alternatifs associés au compte. Elles s'ajoutent à l'adresse e-mail associée à l'[utilisateur root](root-user.md) du compte. Vous ne pouvez spécifier qu'un seul des types de contact suivants associés à un compte.
+ Contact de facturation
+ Contact des opérations
+ Contact en matière de sécurité
Par défaut, les opérations d'API décrites dans ce guide s'appliquent directement au compte qui appelle l'opération. L'[identité](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html) du compte qui appelle l'opération est généralement un rôle IAM ou un utilisateur IAM et doit être autorisée par une politique IAM pour appeler l'opération d'API. Vous pouvez également appeler ces opérations d'API à partir d'une identité enregistrée dans un compte de AWS Organizations gestion et spécifier le numéro d'identification du compte pour tous Compte AWS les membres de l'organisation.
**Version de l'API**
Cette version de la référence de l'API des comptes documente la version de l'API de gestion des comptes 2021-02-01.
**Note**
Au lieu d'utiliser directement l'API, vous pouvez utiliser l'une d'entre elles AWS SDKs, qui comprend des bibliothèques et des exemples de code pour différents langages de programmation et plateformes (Java, Ruby, .NET, iOS, Android, etc.). Ils SDKs fournissent un moyen pratique de créer un accès programmatique aux AWS Organizations. Par exemple, ils s' SDKs occupent de signer les demandes de manière cryptographique, de gérer les erreurs et de réessayer automatiquement les demandes. Pour plus d'informations sur les AWS SDKs, notamment sur la manière de les télécharger et de les installer, consultez la section [Outils pour Amazon Web Services](https://console.aws.amazon.com/).
Nous vous recommandons d'utiliser le AWS SDKs pour effectuer des appels d'API programmatiques au service de gestion des comptes. Toutefois, vous pouvez également utiliser l'API Account Management Query pour passer des appels directs au service Web de gestion des comptes. Pour en savoir plus sur l'API Account Management Query, consultez [Appel de l'API à l'aide de demandes de requête HTTP](query-requests.md) le guide de l'utilisateur de Account Management. Organizations prend en charge les requêtes GET et POST pour toutes les actions. Autrement dit, l'API ne requiert pas l'utilisation de GET pour certaines actions et de POST pour d'autres. Toutefois, les demandes GET sont soumises aux limitations de taille d'une URL. Par conséquent, pour les opérations nécessitant des tailles plus importantes, utilisez une requête POST.
**Signature des requêtes**
Lorsque vous envoyez des requêtes HTTP à AWS, vous devez les signer AWS afin d'identifier leur expéditeur. Vous signez les demandes avec votre clé AWS d'accès, qui se compose d'un identifiant de clé d'accès et d'une clé d'accès secrète. Nous vous recommandons vivement de ne pas créer de clé d'accès pour votre compte root. Toute personne disposant de la clé d'accès à votre compte root a un accès illimité à toutes les ressources de votre compte. Créez plutôt une clé d'accès pour un utilisateur IAM disposant de privilèges administratifs. Une autre option consiste à utiliser le AWS Security Token Service pour générer des informations d'identification de sécurité temporaires et à utiliser ces informations d'identification pour signer les demandes.
Pour signer les demandes, nous vous recommandons d'utiliser la version 4 de Signature. Si vous possédez déjà une application qui utilise la version 2 de Signature, il n'est pas nécessaire de la mettre à jour pour utiliser la version 4 de Signature. Toutefois, certaines opérations nécessitent désormais la version 4 de Signature. La documentation relative aux opérations qui nécessitent la version 4 indique cette exigence. Pour plus d'informations, consultez la section [Signature des demandes AWS d'API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) dans le *guide de l'utilisateur IAM*.
Lorsque vous utilisez l'interface de ligne de AWS commande (AWS CLI) ou l'une des interfaces AWS SDKs pour envoyer des demandes AWS, ces outils signent automatiquement les demandes à votre place avec la clé d'accès que vous spécifiez lors de la configuration des outils.
**Support et commentaires pour la gestion des comptes**
Nous apprécions vos commentaires. Envoyez vos commentaires à [feedback-awsaccounts@amazon.com](mailto://feedback-awsaccounts@amazon.com) ou publiez vos commentaires et questions sur le [forum d'assistance à la gestion des comptes](https://forums.aws.amazon.com/forum.jspa?forumID=219). Pour plus d'informations sur les forums AWS d'assistance, consultez l'[aide des forums](https://forums.aws.amazon.com/help.jspa).
**Comment les exemples sont présentés**
Le JSON renvoyé par la gestion du compte en réponse à vos demandes est renvoyé sous la forme d'une longue chaîne unique sans sauts de ligne ni espaces de formatage. Les sauts de ligne et les espaces blancs sont présentés dans les exemples de ce guide pour améliorer la lisibilité. Lorsque les exemples de paramètres d'entrée se traduisent également par de longues chaînes qui s'étendent au-delà de l'écran, nous insérons des sauts de ligne pour améliorer la lisibilité. Vous devez toujours soumettre l'entrée sous forme de chaîne de texte JSON unique.
**Enregistrement des demandes d'API**
Account Management prend CloudTrail en charge un service qui enregistre les appels d' AWS API pour vous Compte AWS et fournit des fichiers journaux à un compartiment Amazon S3. En utilisant les informations collectées par CloudTrail, vous pouvez déterminer quelles demandes ont été adressées avec succès à la gestion du compte, qui a fait la demande, quand elle a été faite, etc. Pour en savoir plus sur la gestion des comptes et sa prise en charge CloudTrail, consultez[Enregistrement des appels d'API de gestion de AWS compte à l'aide de AWS CloudTrail](monitoring-cloudtrail.md). Pour en savoir plus CloudTrail, notamment comment l'activer et trouver vos fichiers journaux, consultez le [guide de l'AWS CloudTrail utilisateur](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
# 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)
# Actions connexes dans d'autres AWS services
Les opérations suivantes sont liées à l'espace de AWS Organizations noms Gestion de compte AWS mais en font partie :
+ [CreateAccount](API_CreateAccount.md)
+ [CreateGovCloudAccount](API_CreateGovCloudAccount.md)
+ [DescribeAccount](API_DescribeAccount.md)
# CreateAccount
L'opération d'`CreateAccount`API ne peut être utilisée que dans le contexte d'une organisation gérée par le AWS Organizations service. L'opération d'API est définie dans l'espace de noms de ce service.
Pour plus d’informations, consultez [CreateAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_CreateAccount.html) dans la *Référence d’API AWS Organizations *.
# CreateGovCloudAccount
L'opération d'`CreateGovCloudAccount`API ne peut être utilisée que dans le contexte d'une organisation gérée par le AWS Organizations service. L'opération d'API est définie dans l'espace de noms de ce service.
Pour plus d’informations, consultez [CreateGovCloudAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_CreateGovCloudAccount.html) dans la *Référence d’API AWS Organizations *.
# DescribeAccount
L'opération d'`DescribeAccount`API ne peut être utilisée que dans le contexte d'une organisation gérée par le AWS Organizations service. L'opération d'API est définie dans l'espace de noms de ce service.
Pour plus d’informations, consultez [DescribeAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_DescribeAccount.html) dans la *Référence d’API AWS Organizations *.
# Types de données
Les types de données suivants sont pris en charge :
+ [AlternateContact](API_AlternateContact.md)
+ [ContactInformation](API_ContactInformation.md)
+ [Region](API_Region.md)
+ [ValidationExceptionField](API_ValidationExceptionField.md)
# AlternateContact
Structure contenant les détails d'un contact alternatif associé à un AWS compte
## Table des matières
** AlternateContactType **
Type de contact alternatif.
Type : Chaîne
Valeurs valides : `BILLING | OPERATIONS | SECURITY`
Obligatoire : non
** EmailAddress **
Adresse e-mail associée à cet autre contact.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 254.
Modèle : `[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*`
Obligatoire : non
** Name **
Le nom associé à cet autre contact.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 64 caractères.
Obligatoire : non
** PhoneNumber **
Le numéro de téléphone associé à cet autre contact.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 25
Modèle : `[\s0-9()+-]+`
Obligatoire : non
** Title **
Titre associé à ce contact alternatif.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50.
Obligatoire : non
## 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 SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/AlternateContact)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/AlternateContact)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/AlternateContact)
# ContactInformation
Contient les détails des informations de contact principales associées à un Compte AWS.
## Table des matières
** AddressLine1 **
La première ligne de l'adresse du contact principal.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 60.
Obligatoire : oui
** City **
Ville de l'adresse de contact principale.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50.
Obligatoire : oui
** CountryCode **
Le code de pays à deux lettres ISO-3166 pour l'adresse de contact principale.
Type : Chaîne
Contraintes de longueur : longueur fixe de 2.
Obligatoire : oui
** FullName **
Nom complet de l'adresse de contact principale.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50.
Obligatoire : oui
** PhoneNumber **
Le numéro de téléphone des coordonnées principales. Le numéro sera validé et, dans certains pays, vérifié pour l'activation.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 20.
Modèle : `[+][\s0-9()-]+`
Obligatoire : oui
** PostalCode **
Le code postal de l'adresse de contact principale.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 20.
Obligatoire : oui
** AddressLine2 **
Deuxième ligne de l'adresse du contact principal, le cas échéant.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 60.
Obligatoire : non
** AddressLine3 **
Troisième ligne de l'adresse du contact principal, le cas échéant.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 60.
Obligatoire : non
** CompanyName **
Le nom de l'entreprise associée aux coordonnées principales, le cas échéant.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50.
Obligatoire : non
** DistrictOrCounty **
Le district ou le comté de l'adresse de contact principale, le cas échéant.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50.
Obligatoire : non
** StateOrRegion **
État ou région de l'adresse du contact principal. Si l'adresse postale se trouve aux États-Unis d'Amérique, la valeur de ce champ peut être un code d'État à deux caractères (par exemple`NJ`,) ou le nom complet de l'État (par exemple`New Jersey`,). Ce champ est obligatoire dans les pays suivants : `US``CA`,`GB`,`DE`,`JP`,`IN`, et`BR`.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50.
Obligatoire : non
** WebsiteUrl **
URL du site Web associée aux coordonnées principales, le cas échéant.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 256.
Obligatoire : non
## 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 SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ContactInformation)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ContactInformation)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ContactInformation)
# Region
Il s'agit d'une structure qui exprime la région pour un compte donné, composée d'un nom et d'un statut d'opt-in.
## Table des matières
** RegionName **
Le code de région d'une région donnée (par exemple,`us-east-1`).
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 50.
Obligatoire : non
** RegionOptStatus **
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`
Obligatoire : non
## 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 SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/Region)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/Region)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/Region)
# ValidationExceptionField
L'entrée n'a pas satisfait aux contraintes spécifiées par le AWS service dans un champ spécifié.
## Table des matières
** message **
Un message concernant l'exception de validation.
Type : Chaîne
Obligatoire : oui
** name **
Nom du champ dans lequel l'entrée non valide a été détectée.
Type : Chaîne
Obligatoire : oui
## 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 SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ValidationExceptionField)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ValidationExceptionField)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ValidationExceptionField)
# Paramètres communs
La liste suivante contient les paramètres que toutes les actions utilisent pour signer les demandes Signature Version 4 à l'aide d'une chaîne de requête. Tous les paramètres spécifiques d'une action particulière sont énumérées dans le sujet consacré à cette action. Pour plus d'informations sur la version 4 de Signature, consultez [la section Signing AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) du *guide de l'utilisateur IAM*.
**X-Amz-Algorithm**
Algorithme de hachage que vous avez utilisé pour créer la signature de la demande.
Condition : spécifiez ce paramètre lorsque vous incluez des informations d'authentification dans une chaîne de requête plutôt que dans l'en-tête d'autorisation HTTP.
Type : chaîne
Valeurs valides : `AWS4-HMAC-SHA256`
Obligatoire : Conditionnelle
**X-Amz-Credential**
Valeur de la portée des informations d'identification, qui est une chaîne incluant votre clé d'accès, la date, la région cible, le service demandé et une chaîne de terminaison (« aws4\$1request »). Spécifiez la valeur au format suivant : *access\$1key*/*AAAAMMJJ*/*région*/*service*/aws4\$1request.
Pour plus d'informations, consultez la section [Création d'une demande d' AWS API signée](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) dans le *guide de l'utilisateur IAM*.
Condition : spécifiez ce paramètre lorsque vous incluez des informations d'authentification dans une chaîne de requête plutôt que dans l'en-tête d'autorisation HTTP.
Type : chaîne
Obligatoire : Conditionnelle
**X-Amz-Date**
La date utilisée pour créer la signature. Le format doit être au format de base ISO 8601 (AAAAMMJJ'T'HHMMSS'Z'). Par exemple, la date et l'heure suivantes sont une X-Amz-Date valeur valide :`20120325T120000Z`.
Condition : X-Amz-Date est un en-tête facultatif pour toutes les demandes. Il peut être utilisé pour signer les demandes. Si l'en-tête Date est spécifié au format de base ISO 8601, X-Amz-Date il n'est pas obligatoire. Lorsqu'il X-Amz-Date est utilisé, il remplace toujours la valeur de l'en-tête Date. Pour plus d'informations, consultez la section [Éléments d'une signature de demande d' AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) dans le *Guide de l'utilisateur IAM*.
Type : chaîne
Obligatoire : Conditionnelle
**X-Amz-Security-Token**
Le jeton de sécurité temporaire obtenu par un appel à AWS Security Token Service (AWS STS). Pour obtenir la liste des services prenant en charge les informations d'identification de sécurité temporaires d' AWS STS, consultez [Services AWS qui fonctionnent avec IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) dans le *Guide de l'utilisateur IAM*.
Condition : Si vous utilisez des informations d'identification de sécurité temporaires provenant de AWS STS, vous devez inclure le jeton de sécurité.
Type : chaîne
Obligatoire : Conditionnelle
**X-Amz-Signature**
Spécifie la signature codée en hexadécimal qui a été calculée à partir de la chaîne à signer et de la clé de signature dérivée.
Condition : spécifiez ce paramètre lorsque vous incluez des informations d'authentification dans une chaîne de requête plutôt que dans l'en-tête d'autorisation HTTP.
Type : chaîne
Obligatoire : Conditionnelle
**X-Amz-SignedHeaders**
Spécifie tous les en-têtes HTTP qui ont été inclus dans la demande canonique. Pour plus d'informations sur la spécification d'en-têtes signés, consultez la section [Créer une demande d' AWS API signée](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) dans le guide de l'*utilisateur IAM*.
Condition : spécifiez ce paramètre lorsque vous incluez des informations d'authentification dans une chaîne de requête plutôt que dans l'en-tête d'autorisation HTTP.
Type : chaîne
Obligatoire : Conditionnelle
# Types d'erreurs courants
Cette section répertorie les types d'erreurs courants que ce AWS service peut renvoyer. Tous les services ne renvoient pas tous les types d'erreur répertoriés ici. Pour les erreurs spécifiques à une action d’API pour ce service, consultez la rubrique pour cette action d’API.
**AccessDeniedException**
Vous n'êtes pas autorisé à effectuer cette action. Vérifiez que votre politique IAM inclut les autorisations requises.
Code d’état HTTP : 403
**ExpiredTokenException**
Le jeton de sécurité inclus dans la demande a expiré. Demandez un nouveau jeton de sécurité et réessayez.
Code d’état HTTP : 403
**IncompleteSignature**
La signature de la demande n'est pas conforme aux AWS normes. Vérifiez que vous utilisez des AWS informations d'identification valides et que votre demande est correctement formatée. Si vous utilisez un SDK, assurez-vous qu'il est à jour.
Code d’état HTTP : 403
**InternalFailure**
La demande ne peut pas être traitée pour le moment en raison d'un problème interne au serveur. Réessayez ultérieurement. Si le problème persiste, contactez le AWS Support.
Code d’état HTTP : 500
**MalformedHttpRequestException**
Le corps de la demande ne peut pas être traité. Cela se produit généralement lorsque le corps de la demande ne peut pas être décompressé à l'aide de l'algorithme de codage de contenu spécifié. Vérifiez que l'en-tête de codage du contenu correspond au format de compression utilisé.
Code d’état HTTP : 400
**NotAuthorized**
Vous n'êtes pas autorisé à effectuer cette action. Vérifiez que votre politique IAM inclut les autorisations requises.
Code d'état HTTP : 401
**OptInRequired**
Votre AWS compte nécessite un abonnement pour ce service. Vérifiez que vous avez activé le service dans votre compte.
Code d’état HTTP : 403
**RequestAbortedException**
La demande a été abandonnée avant qu'une réponse ne puisse être renvoyée. Cela se produit généralement lorsque le client ferme la connexion.
Code d’état HTTP : 400
**RequestEntityTooLargeException**
L'entité de demande est trop grande. Réduisez la taille du corps de la demande et réessayez.
Code d’état HTTP : 413
**RequestTimeoutException**
Le délai imparti pour la demande a expiré. Le serveur n'a pas reçu la demande complète dans le délai prévu. Réessayez.
Code d’état HTTP : 408
**ServiceUnavailable**
Le service est temporairement indisponible. Réessayez ultérieurement.
HTTP Status Code: 503
**ThrottlingException**
Votre taux de demandes est trop élevé. Les demandes de nouvelle tentative AWS SDKs automatique qui reçoivent cette exception. Réduisez la fréquence des requêtes.
Code d’état HTTP : 400
**UnknownOperationException**
L'action ou l'opération n'est pas reconnue. Vérifiez que le nom de l'action est correctement orthographié et qu'il est compatible avec la version de l'API que vous utilisez.
Code d’état HTTP :404
**UnrecognizedClientException**
Le certificat X.509 ou l'identifiant de clé d' AWS accès que vous avez fourni n'existe pas dans nos archives. Vérifiez que vous utilisez des informations d'identification valides et qu'elles n'ont pas expiré.
Code d’état HTTP : 403
**ValidationError**
L'entrée ne répond pas au format ou aux contraintes requis. Vérifiez que tous les paramètres requis sont inclus et que les valeurs sont valides.
Code d’état HTTP : 400
# Appel de l'API à l'aide de demandes de requête HTTP
Cette section contient des informations générales sur l'utilisation de l'API de requête pour la gestion des AWS comptes. Pour plus d'informations sur le fonctionnement de l'API et les erreurs, consultez le [Référence d’API](api-reference.md).
**Note**
Au lieu de passer des appels directs à l'API de requête de gestion des AWS comptes, vous pouvez utiliser l'un des AWS SDKs. Il AWS SDKs s'agit de bibliothèques et d'exemples de code pour différents langages de programmation et plateformes (Java, Ruby, .NET, iOS, Android, etc.). Ils SDKs fournissent un moyen pratique de créer un accès programmatique à la gestion des AWS comptes et AWS. Par exemple, ils se SDKs chargent de tâches telles que la signature cryptographique des demandes, la gestion des erreurs et le renouvellement automatique des demandes. Pour plus d'informations AWS SDKs, notamment sur la manière de les télécharger et de les installer, consultez la section [Outils pour Amazon Web Services](https://aws.amazon.com/tools).
Avec l'API de requête pour la gestion des AWS comptes, vous pouvez appeler des actions de service. Les requêtes de l'API de requête sont des requêtes HTTPS qui doivent contenir un `Action` paramètre pour indiquer l'opération à effectuer. AWS La gestion des comptes prend en charge `GET` et `POST` demande toutes les opérations. En d'autres termes, l'API ne vous oblige pas à l'utiliser `GET` pour certaines actions et `POST` pour d'autres. Toutefois, les `GET` demandes sont soumises à la limite de taille d'une URL. Bien que cette limite dépend du navigateur, elle est généralement de 2 048 octets. Par conséquent, pour les demandes d'API de requête qui nécessitent des tailles plus importantes, vous devez utiliser une `POST` demande.
Vous obtenez une réponse sous la forme d'un document XML. Pour plus d'informations sur la réponse, consultez les pages d'actions individuelles dans le [Référence d’API](api-reference.md).
**Topics**
+ [Points de terminaison](#endpoints)
+ [HTTPS requis](#IAMHTTPSRequired)
+ [Signature des demandes de l'API de gestion des AWS comptes](#SigVersion)
## Points de terminaison
AWS Account Management dispose d'un point de terminaison API mondial unique hébergé dans l'est des États-Unis (Virginie du Nord) Région AWS.
Pour plus d'informations sur les AWS points de terminaison et les régions pour tous les services, voir [Régions et points de terminaison](https://docs.aws.amazon.com/general/latest/gr/rande.html) dans le. *Références générales AWS*
## HTTPS requis
Étant donné que l'API Query peut renvoyer des informations sensibles telles que les informations d'identification de sécurité, vous devez utiliser le protocole HTTPS pour chiffrer toutes les demandes d'API.
## Signature des demandes de l'API de gestion des AWS comptes
Les demandes doivent être signées à l'aide d'un identifiant de la clé d'accès et d'une clé d'accès secrète. Nous vous recommandons vivement de ne pas utiliser les informations d'identification de votre compte AWS root dans le cadre de vos tâches quotidiennes liées à la gestion des AWS comptes. Vous pouvez utiliser les informations d'identification d'un utilisateur Gestion des identités et des accès AWS (IAM) ou des informations d'identification temporaires, comme celles que vous utilisez avec un rôle IAM.
Pour signer vos demandes d'API, vous devez utiliser AWS Signature Version 4. Pour plus d'informations sur l'utilisation de Signature version 4, consultez [la section Signing AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) du *guide de l'utilisateur IAM*.
Pour plus d’informations, consultez les ressources suivantes :
+ [Informations d'identification de sécuritéAWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html) : fournit des informations générales sur les types d'informations d'identification que vous pouvez utiliser pour accéder à AWS.
+ [Bonnes pratiques de sécurité dans le domaine de l'IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) : propose des suggestions d'utilisation du service IAM afin de sécuriser vos AWS ressources, y compris celles relatives à la gestion des AWS comptes.
+ [Informations d'identification de sécurité temporaires dans IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) : décrit comment créer et utiliser des informations d'identification de sécurité temporaires.