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 ilAccountId
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 valoreNextToken
nell'argomentostarting-token
di un comando successivo. Non utilizzate l'elemento diNextToken
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: