Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà. # ListRegions Elenca tutte le regioni per un determinato account e i rispettivi stati di attivazione. Facoltativamente, questo elenco può essere filtrato in base al parametro. `region-opt-status-contains` ## Sintassi della richiesta ``` POST /listRegions HTTP/1.1 Content-type: application/json { "AccountId": "string", "MaxResults": number, "NextToken": "string", "RegionOptStatusContains": [ "string" ] } ``` ## Parametri della richiesta URI: La richiesta non utilizza parametri URI. ## Corpo della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [AccountId](#API_ListRegions_RequestSyntax) ** Specificare il numero ID dell'account a 12 cifre a Account AWS cui si desidera accedere o modificare con questa operazione. Se non specifichi questo parametro, il valore predefinito è l'account Amazon Web Services dell'identità utilizzata per chiamare l'operazione. Per utilizzare questo parametro, il chiamante deve essere un'identità nell'account [di gestione dell'organizzazione o un account](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) amministratore delegato. L'ID dell'account specificato deve essere un account membro della stessa organizzazione. L'organizzazione deve avere [tutte le funzionalità abilitate](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) e deve avere abilitato l'[accesso affidabile](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) per il servizio di gestione degli account e, facoltativamente, deve essere assegnato un account [amministratore delegato](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin). L'account di gestione non può specificare il proprio. `AccountId` Deve chiamare l'operazione in un contesto autonomo escludendo il `AccountId` parametro. Per chiamare questa operazione su un account che non è membro di un'organizzazione, non specificare questo parametro. Chiamate invece l'operazione utilizzando un'identità appartenente all'account di cui desiderate recuperare o modificare i contatti. Tipo: stringa Modello: `\d{12}` Obbligatorio: no ** [MaxResults](#API_ListRegions_RequestSyntax) ** Il numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è superiore al valore specificato, nell'output del comando `NextToken` viene fornito a. Per riprendere la paginazione, specifica il valore `NextToken` nell'argomento `starting-token` di un comando successivo. Non utilizzare l'elemento di `NextToken` risposta direttamente all'esterno della AWS CLI. Per esempi di utilizzo, consulta [Pagination](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html) nella * AWS Command Line Interface User Guide*. Tipo: numero intero Intervallo valido: valore minimo di 1. Valore massimo pari a 50. Obbligatorio: no ** [NextToken](#API_ListRegions_RequestSyntax) ** Un token utilizzato per specificare da dove iniziare l'impaginazione. Questo è il risultato `NextToken` di una risposta precedentemente troncata. Per esempi di utilizzo, vedere [Pagination](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html) nella * AWS Command Line* Interface User Guide. Tipo: String Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 1000. Obbligatorio: no ** [RegionOptStatusContains](#API_ListRegions_RequestSyntax) ** Un elenco di stati delle regioni (Enabling, Enabled, Disabling, Disabled, Enabled\$1by\$1default) da utilizzare per filtrare l'elenco delle regioni per un determinato account. Ad esempio, il passaggio del valore ENABLING restituirà solo un elenco di regioni con lo stato di regione abilitato. Tipo: array di stringhe Valori validi: `ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT` Campo obbligatorio: no ## Sintassi della risposta ``` HTTP/1.1 200 Content-type: application/json { "NextToken": "string", "Regions": [ { "RegionName": "string", "RegionOptStatus": "string" } ] } ``` ## Elementi di risposta Se l'operazione riesce, il servizio restituisce una risposta HTTP 200. I dati seguenti vengono restituiti in formato JSON mediante il servizio. ** [NextToken](#API_ListRegions_ResponseSyntax) ** Se ci sono più dati da restituire, questo verrà compilato. Dovrebbe essere passato al parametro di `next-token` richiesta di`list-regions`. Tipo: String ** [Regions](#API_ListRegions_ResponseSyntax) ** Questo è un elenco di regioni per un determinato account o, se è stato utilizzato il parametro filtrato, un elenco di regioni che corrispondono ai criteri di filtro impostati nel `filter` parametro. Tipo: matrice di oggetti [Region](API_Region.md) ## Errori Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md). ** AccessDeniedException ** L'operazione non è riuscita perché l'identità chiamante non dispone delle autorizzazioni minime richieste. ** errorType ** Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta da API Gateway. Codice di stato HTTP: 403 ** InternalServerException ** L'operazione non è riuscita a causa di un errore interno a. AWS Riprova l'operazione più tardi. ** errorType ** Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta da API Gateway. Codice di stato HTTP: 500 ** TooManyRequestsException ** L'operazione non è riuscita perché è stata chiamata troppo spesso e ha superato il limite di accelerazione. ** errorType ** Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta da API Gateway. Codice di stato HTTP: 429 ** ValidationException ** L'operazione non è riuscita perché uno dei parametri di input non era valido. ** fieldList ** Il campo in cui è stata rilevata la voce non valida. ** message ** Il messaggio che ti informa su cosa non era valido nella richiesta. ** reason ** Il motivo per cui la convalida non è riuscita. Codice di stato HTTP: 400 ## Vedi anche Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/ListRegions) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/ListRegions) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ListRegions) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/ListRegions) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ListRegions) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/ListRegions) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/ListRegions) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/ListRegions) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/ListRegions) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ListRegions)