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. # 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)