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.
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
-
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 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 et l'organisation doit disposer d'un accès sécurisé activé pour le service de gestion des comptes, et éventuellement d'un compte administrateur délégué attribué.
Note
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 leAccountIdparamè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 : String
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
-
Date et heure de création du compte.
Type : Timestamp
- AccountId
-
Spécifie le numéro d'identification à 12 chiffres du compte Compte AWS auquel vous souhaitez accéder ou modifier lors de cette opération. Pour utiliser ce paramètre, l'appelant doit être une identité enregistrée dans le compte de gestion de l'organisation ou un compte d'administrateur délégué. L'identifiant de compte spécifié doit être un compte membre de la même organisation. Toutes les fonctionnalités de l'organisation doivent être activées et l'organisation doit disposer d'un accès sécurisé activé pour le service de gestion des comptes, et éventuellement d'un compte administrateur délégué attribué.
Cette opération ne peut être appelée que depuis le compte de gestion ou le compte administrateur délégué d'une organisation pour un compte membre.
Note
Le compte de gestion ne peut pas spécifier le sien
AccountId.Type : String
Modèle :
^\d{12}$ - AccountName
-
Le nom du compte.
Type : String
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 Erreurs courantes.
- AccessDeniedException
-
L'opération a échoué car l'identité de l'appelant ne dispose pas des autorisations minimales requises.
Code d’état HTTP : 403
- InternalServerException
-
L'opération a échoué en raison d'une erreur interne à AWS. Réessayez l'opération ultérieurement.
Code d’état HTTP : 500
- TooManyRequestsException
-
L'opération a échoué car elle a été appelée trop fréquemment et a dépassé la limite d'accélérateur.
Code d’état HTTP : 429
- ValidationException
-
L'opération a échoué car l'un des paramètres d'entrée n'était pas valide.
Code d’état HTTP : 400
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 extrait 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 :
