ListRegions - AWS Gestione dell'account

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

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 amministratore delegato. L'ID dell'account specificato deve essere un account membro della stessa organizzazione. L'organizzazione deve avere tutte le funzionalità abilitate e deve avere abilitato l'accesso affidabile per il servizio di gestione degli account e, facoltativamente, deve essere assegnato un account amministratore delegato.

Nota

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}$

Campo obbligatorio: no

MaxResults

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 nella AWS Command Line Interface User Guide.

Tipo: integer

Intervallo valido: valore minimo di 1. Valore massimo pari a 50.

Campo obbligatorio: no

NextToken

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 nella AWS Command Line Interface User Guide.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 1000.

Campo obbligatorio: no

RegionOptStatusContains

Un elenco di stati delle regioni (Enabling, Enabled, Disabling, Disabled, Enabled_by_default) 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: matrice 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

Se ci sono più dati da restituire, questo verrà compilato. Dovrebbe essere passato al parametro di next-token richiesta dilist-regions.

Tipo: stringa

Regions

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

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

AccessDeniedException

L'operazione non è riuscita perché l'identità chiamante non dispone delle autorizzazioni minime richieste.

Codice di stato HTTP: 403

InternalServerException

L'operazione non è riuscita a causa di un errore interno a AWS. Riprova l'operazione più tardi.

Codice di stato HTTP: 500

TooManyRequestsException

L'operazione non è riuscita perché è stata chiamata troppo spesso e ha superato il limite di accelerazione.

Codice di stato HTTP: 429

ValidationException

L'operazione non è riuscita perché uno dei parametri di input non era valido.

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: