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.
AccountIdDeve chiamare l'operazione in un contesto autonomo escludendo ilAccountIdparametro.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
NextTokenviene fornito a. Per riprendere la paginazione, specifica il valoreNextTokennell'argomentostarting-tokendi un comando successivo. Non utilizzare l'elemento diNextTokenrisposta 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
NextTokendi 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_DEFAULTCampo 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-tokenrichiesta 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
filterparametro.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.
- errorType
-
Il valore inserito nell'intestazione di
x-amzn-ErrorTyperisposta 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-ErrorTyperisposta 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-ErrorTyperisposta 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:
