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à.
GetGovCloudAccountInformation
Recupera le informazioni sull' GovCloud account collegato all'account standard specificato (se esiste), inclusi l'ID e lo stato dell' GovCloud account. Per utilizzare questa API, un utente o un ruolo IAM deve disporre dell'autorizzazione account:GetGovCloudAccountInformation IAM.
Sintassi della richiesta
POST /getGovCloudAccountInformation HTTP/1.1
Content-type: application/json
{
"StandardAccountId": "string"
}Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
- StandardAccountId
-
Speciifica il numero ID dell'account a 12 cifre dell' AWS account a cui desideri accedere o modificare con questa operazione.
Se non si specifica questo parametro, per impostazione predefinita viene utilizzato l' AWS account 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 e 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 parametro.AccountIdPer richiamare questa operazione su un account che non è membro di un'organizzazione, non specificate questo parametro e richiamate l'operazione utilizzando un'identità appartenente all'account di cui desiderate recuperare o modificare i contatti.
Tipo: stringa
Modello:
\d{12}Campo obbligatorio: no
Sintassi della risposta
HTTP/1.1 200
Content-type: application/json
{
"AccountState": "string",
"GovCloudAccountId": "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.
- AccountState
-
Lo stato dell' GovCloud account collegato.
Tipo: stringa
Valori validi:
PENDING_ACTIVATION | ACTIVE | SUSPENDED | CLOSED - GovCloudAccountId
-
Il numero ID dell'account a 12 cifre dell'account collegato GovCloud .
Tipo: stringa
Modello:
\d{12}
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
- ResourceNotFoundException
-
L'operazione non è riuscita perché ha specificato una risorsa che non può essere trovata.
- errorType
-
Il valore inserito nell'intestazione di
x-amzn-ErrorTyperisposta da API Gateway.
Codice di stato HTTP: 404
- ResourceUnavailableException
-
L'operazione non è riuscita perché ha specificato una risorsa che non è attualmente disponibile.
- errorType
-
Il valore inserito nell'intestazione di
x-amzn-ErrorTyperisposta da API Gateway.
Codice di stato HTTP: 424
- 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
Esempi
Esempio 1
L'esempio seguente recupera le informazioni sull' GovCloud account collegato per l'account le cui credenziali vengono utilizzate per chiamare l'operazione.
Richiesta di esempio
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
{}Risposta di esempio
HTTP/1.1 200 OK
Content-Type: application/json
{
"GovCloudAccountId": "123456789012",
"AccountState": "ACTIVE"
}Esempio 2
L'esempio seguente recupera le informazioni sull' GovCloud account collegato per l'account membro specificato in un'organizzazione. È necessario utilizzare le credenziali dell'account di gestione dell'organizzazione o dell'account amministratore delegato del servizio di gestione degli account.
Richiesta di esempio
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
{
"StandardAccountId": "111111111111"
}Risposta di esempio
HTTP/1.1 200 OK
Content-Type: application/json
{
"GovCloudAccountId": "123456789012",
"AccountState": "ACTIVE"
}Esempio 3
L'esempio seguente tenta di recuperare le informazioni sull' GovCloud account collegato per un account standard che non è collegato a un account. GovCloud
Richiesta di esempio
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
{
"StandardAccountId": "222222222222"
}Risposta di esempio
HTTP/1.1 404
Content-Type: application/json
{
"message":"GovCloud Account ID not found for Standard Account - 222222222222."
}Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
