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" ] }

URIParametri della richiesta

La richiesta non utilizza alcun URI parametro.

Corpo della richiesta

La richiesta accetta i seguenti dati nel JSON formato.

AccountId

Speciifica il numero ID dell'account a 12 cifre del Account AWS a 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 utilizzate l'elemento di NextToken risposta direttamente al di fuori di AWS CLI. Per esempi di utilizzo, vedere Pagination in AWS Guida per l'utente dell'interfaccia a riga di comando.

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 in AWS Guida per l'utente dell'interfaccia a riga di comando.

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, se si inserisce un valore di, ENABLING verrà restituito solo un elenco di regioni con lo stato di Regione pari a. ENABLING

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'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.

I seguenti dati vengono restituiti in JSON formato dal 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.

HTTPCodice di stato: 403

InternalServerException

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

HTTPCodice di stato: 500

TooManyRequestsException

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

HTTPCodice di stato: 429

ValidationException

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

HTTPCodice di stato: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, vedi quanto segue: