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à.
# Documentazione di riferimento delle API
Le operazioni API nello spazio dei nomi Account Management (`account`) consentono di modificare le proprie. Account AWS
Every Account AWS supporta metadati con informazioni sull'account, incluse informazioni su un massimo di tre contatti alternativi associati all'account. Questi si aggiungono all'indirizzo e-mail associato all'[utente root dell'](root-user.md)account. È possibile specificare solo uno dei seguenti tipi di contatto associati a un account.
+ Contatto di fatturazione
+ Contatto operativo
+ Contatto di sicurezza
Per impostazione predefinita, le operazioni API illustrate in questa guida si applicano direttamente all'account che chiama l'operazione. L'[identità dell'](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html)account che chiama l'operazione è in genere un ruolo IAM o un utente IAM e deve avere l'autorizzazione applicata da una policy IAM per richiamare l'operazione API. In alternativa, puoi richiamare queste operazioni API da un'identità in un account di AWS Organizations gestione e specificare il numero ID dell'account per qualsiasi Account AWS membro dell'organizzazione.
**Versione dell'API**
Questa versione dell'Accounts API Reference documenta la versione dell'API di gestione degli account 2021-02-01.
**Nota**
In alternativa all'utilizzo diretto dell'API, puoi utilizzarne una AWS SDKs, che consiste in librerie e codice di esempio per vari linguaggi e piattaforme di programmazione (Java, Ruby, .NET, iOS, Android e altri). SDKs Forniscono un modo conveniente per creare un accesso programmatico alle AWS Organizzazioni. Ad esempio, SDKs si occupano di firmare crittograficamente le richieste, gestire gli errori e riprovare automaticamente le richieste. Per ulteriori informazioni su AWS SDKs, incluso come scaricarli e installarli, consulta [Tools for Amazon Web Services](https://console.aws.amazon.com/).
Ti consigliamo di utilizzare il AWS SDKs per effettuare chiamate API programmatiche al servizio di gestione degli account. Tuttavia, puoi anche utilizzare l'API Account Management Query per effettuare chiamate dirette al servizio web Account Management. Per ulteriori informazioni sull'API Account Management Query, consulta [Chiamata dell'API tramite richieste di query HTTP](query-requests.md) la Guida per l'utente di Account Management. Organizations supporta le richieste GET e POST per tutte le azioni. Questo significa che l'API non richiede l'uso di GET per alcune operazioni e di POST per altre. Tuttavia, le richieste GET sono soggette alla limitazione delle dimensioni di un URL. Pertanto, per le operazioni che richiedono dimensioni maggiori, utilizzate una richiesta POST.
**Firma delle richieste**
Quando invii richieste HTTP a AWS, devi firmare le richieste in modo da AWS poter identificare chi le ha inviate. Le richieste vengono firmate con la chiave di AWS accesso, che consiste in un ID chiave di accesso e una chiave di accesso segreta. Ti consigliamo vivamente di non creare una chiave di accesso per il tuo account root. Chiunque disponga della chiave di accesso per il tuo account root ha accesso illimitato a tutte le risorse del tuo account. Crea invece una chiave di accesso per un utente IAM con privilegi amministrativi. Come altra opzione, usa AWS Security Token Service per generare credenziali di sicurezza temporanee e usa tali credenziali per firmare le richieste.
Per firmare le richieste, ti consigliamo di utilizzare la versione 4 di Signature. Se disponi di un'applicazione esistente che utilizza Signature Version 2, non è necessario aggiornarla per utilizzare Signature Version 4. Tuttavia, alcune operazioni ora richiedono Signature Version 4. La documentazione per le operazioni che richiedono la versione 4 indica questo requisito. Per ulteriori informazioni, consulta [Signing AWS API request](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) nella *IAM User Guide*.
Quando utilizzi l'interfaccia a riga di AWS comando (AWS CLI) o una delle altre AWS SDKs per effettuare richieste AWS, questi strumenti firmano automaticamente le richieste per te con la chiave di accesso specificata durante la configurazione degli strumenti.
**Support e feedback per la gestione degli account**
Apprezziamo il tuo feedback. Invia i tuoi commenti a [feedback-awsaccounts@amazon.com](mailto://feedback-awsaccounts@amazon.com) o pubblica commenti e domande nel [forum di supporto per la gestione degli account](https://forums.aws.amazon.com/forum.jspa?forumID=219). Per ulteriori informazioni sui forum di AWS supporto, consulta la sezione [Aiuto dei forum](https://forums.aws.amazon.com/help.jspa).
**Come vengono presentati gli esempi**
Il codice JSON restituito dalla gestione dell'account come risposta alle richieste viene restituito come una singola stringa lunga senza interruzioni di riga o spazi bianchi di formattazione. Sia le interruzioni di riga che gli spazi bianchi sono mostrati negli esempi di questa guida per migliorare la leggibilità. Quando alcuni parametri di input generano anche stringhe lunghe che si estendono oltre lo schermo, inseriamo interruzioni di riga per migliorare la leggibilità. Dovresti sempre inviare l'input come singola stringa di testo JSON.
**Registrazione delle richieste API**
Supporta Account Management CloudTrail, un servizio che registra le chiamate AWS API per te Account AWS e invia i file di log a un bucket Amazon S3. Utilizzando le informazioni raccolte da CloudTrail, puoi determinare quali richieste sono state inoltrate correttamente a Account Management, chi ha effettuato la richiesta, quando è stata effettuata e così via. Per ulteriori informazioni sulla gestione degli account e sul relativo supporto CloudTrail, vedere[Registrazione delle chiamate API di gestione dell' AWS account tramite AWS CloudTrail](monitoring-cloudtrail.md). Per ulteriori informazioni CloudTrail, incluso come attivarlo e trovare i file di registro, consulta la [Guida per l'AWS CloudTrail utente](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/).
# Azioni
Sono supportate le operazioni seguenti:
+ [AcceptPrimaryEmailUpdate](API_AcceptPrimaryEmailUpdate.md)
+ [DeleteAlternateContact](API_DeleteAlternateContact.md)
+ [DisableRegion](API_DisableRegion.md)
+ [EnableRegion](API_EnableRegion.md)
+ [GetAccountInformation](API_GetAccountInformation.md)
+ [GetAlternateContact](API_GetAlternateContact.md)
+ [GetContactInformation](API_GetContactInformation.md)
+ [GetGovCloudAccountInformation](API_GetGovCloudAccountInformation.md)
+ [GetPrimaryEmail](API_GetPrimaryEmail.md)
+ [GetRegionOptStatus](API_GetRegionOptStatus.md)
+ [ListRegions](API_ListRegions.md)
+ [PutAccountName](API_PutAccountName.md)
+ [PutAlternateContact](API_PutAlternateContact.md)
+ [PutContactInformation](API_PutContactInformation.md)
+ [StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md)
# AcceptPrimaryEmailUpdate
Accetta la richiesta originata da [StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md) per aggiornare l'indirizzo e-mail principale (noto anche come indirizzo e-mail dell'utente root) per l'account specificato.
## Sintassi della richiesta
```
POST /acceptPrimaryEmailUpdate HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"Otp": "string",
"PrimaryEmail": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [AccountId](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **
Specificate il numero ID dell'account a 12 cifre a Account AWS cui desiderate accedere o modificare con questa operazione. Per utilizzare questo parametro, il chiamante deve avere un'identità nell'account di [gestione dell'organizzazione o un account amministratore](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) delegato. L'ID dell'account specificato deve essere un account membro della stessa organizzazione. L'organizzazione deve avere [tutte le funzionalità abilitate](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) e deve avere abilitato l'[accesso affidabile](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) per il servizio di gestione degli account e, facoltativamente, deve essere assegnato un account [amministratore delegato](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin).
Questa operazione può essere richiamata solo dall'account di gestione o dall'account amministratore delegato di un'organizzazione per un account membro.
L'account di gestione non può specificare il proprio. `AccountId`
Tipo: stringa
Modello: `\d{12}`
Obbligatorio: sì
** [Otp](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **
Il codice OTP inviato all'indirizzo `PrimaryEmail` specificato nella chiamata `StartPrimaryEmailUpdate` API.
Tipo: stringa
Modello: `[a-zA-Z0-9]{6}`
Obbligatorio: sì
** [PrimaryEmail](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **
Il nuovo indirizzo e-mail principale da utilizzare con l'account specificato. Deve corrispondere `PrimaryEmail` a quello della chiamata `StartPrimaryEmailUpdate` API.
Tipo: String
Vincoli di lunghezza: lunghezza minima di 5. La lunghezza massima è 64 caratteri.
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"Status": "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.
** [Status](#API_AcceptPrimaryEmailUpdate_ResponseSyntax) **
Recupera lo stato della richiesta di aggiornamento e-mail principale accettata.
Tipo: String
Valori validi: `PENDING | ACCEPTED`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non è riuscita perché l'identità chiamante non dispone delle autorizzazioni minime richieste.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta da API Gateway.
Codice di stato HTTP: 403
** ConflictException **
La richiesta non può essere elaborata a causa di un conflitto nello stato corrente della risorsa. Ad esempio, ciò accade se si tenta di abilitare una regione attualmente disabilitata (con lo stato di DISABILITAZIONE) o se si tenta di modificare l'e-mail dell'utente root di un account con un indirizzo e-mail già in uso.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta da API Gateway.
Codice di stato HTTP: 409
** InternalServerException **
L'operazione non è riuscita a causa di un errore interno a. AWS Ripetere l'operazione più tardi.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta 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-ErrorType` risposta da API Gateway.
Codice di stato HTTP: 404
** 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-ErrorType` risposta 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:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/AcceptPrimaryEmailUpdate)
# DeleteAlternateContact
Elimina il contatto alternativo specificato da un. Account AWS
Per dettagli completi su come utilizzare le operazioni relative ai contatti alternativi, vedi [Aggiornare i contatti alternativi per il tuo](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html). Account AWS
**Nota**
Prima di poter aggiornare le informazioni di contatto alternative per un Account AWS account gestito da AWS Organizations, devi prima abilitare l'integrazione tra AWS Account Management e Organizations. Per ulteriori informazioni, consulta [Abilitare l'accesso affidabile per la gestione degli AWS account](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html).
## Sintassi della richiesta
```
POST /deleteAlternateContact HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"AlternateContactType": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [AccountId](#API_DeleteAlternateContact_RequestSyntax) **
Specificate il numero ID dell'account a 12 cifre dell' AWS account a cui desiderate 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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) e deve avere abilitato l'[accesso affidabile](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html) per il servizio di gestione degli account e, facoltativamente, deve essere assegnato un account amministratore [delegato](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin).
L'account di gestione non può specificare il proprio`AccountId`; deve chiamare l'operazione in un contesto autonomo escludendo il parametro. `AccountId`
Per 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}`
Obbligatorio: no
** [AlternateContactType](#API_DeleteAlternateContact_RequestSyntax) **
Speciifica quali contatti alternativi eliminare.
Tipo: String
Valori validi: `BILLING | OPERATIONS | SECURITY`
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non è riuscita perché l'identità chiamante non dispone delle autorizzazioni minime richieste.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta 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-ErrorType` risposta 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-ErrorType` risposta da API Gateway.
Codice di stato HTTP: 404
** 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-ErrorType` risposta 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 elimina il contatto alternativo di sicurezza per l'account le cui credenziali vengono utilizzate per chiamare l'operazione.
#### Richiesta di esempio
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact
{
"AccountName":"MyAccount"
}
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
Content-Type: application/json
```
### Esempio 2
L'esempio seguente elimina il contatto alternativo di fatturazione 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.DeleteAlternateContact
{
"AccountId":"123456789012",
"AlternateContactType":"BILLING"
}
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
Content-Type: application/json
```
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/DeleteAlternateContact)
# DisableRegion
Disattiva (disattiva) una particolare regione per un account.
**Nota**
La disattivazione di una regione rimuoverà tutti gli accessi IAM a tutte le risorse che risiedono in quella regione.
## Sintassi della richiesta
```
POST /disableRegion HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"RegionName": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [AccountId](#API_DisableRegion_RequestSyntax) **
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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) amministratore delegato. L'ID dell'account specificato deve essere un account membro della stessa organizzazione. L'organizzazione deve avere [tutte le funzionalità abilitate](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) e deve avere abilitato l'[accesso affidabile](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) per il servizio di gestione degli account e, facoltativamente, deve essere assegnato un account [amministratore delegato](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin).
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}`
Obbligatorio: no
** [RegionName](#API_DisableRegion_RequestSyntax) **
Specificate il codice regionale per un determinato nome di regione (ad esempio,). `af-south-1` Quando disabiliti una regione, AWS esegue azioni per disattivare quella regione nel tuo account, come la distruzione delle risorse IAM nella regione. Questo processo richiede pochi minuti per la maggior parte degli account, ma potrebbero essere necessarie anche diverse ore. Non puoi abilitare la regione fino al completamento del processo di disabilitazione.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 50 caratteri.
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non è riuscita perché l'identità chiamante non dispone delle autorizzazioni minime richieste.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta da API Gateway.
Codice di stato HTTP: 403
** ConflictException **
La richiesta non può essere elaborata a causa di un conflitto nello stato corrente della risorsa. Ad esempio, ciò accade se si tenta di abilitare una regione attualmente disabilitata (con lo stato di DISABILITAZIONE) o se si tenta di modificare l'e-mail dell'utente root di un account con un indirizzo e-mail già in uso.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta da API Gateway.
Codice di stato HTTP: 409
** 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-ErrorType` risposta 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-ErrorType` risposta 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:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/DisableRegion)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/DisableRegion)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/DisableRegion)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/DisableRegion)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/DisableRegion)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/DisableRegion)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/DisableRegion)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/DisableRegion)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/DisableRegion)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/DisableRegion)
# EnableRegion
Abilita (attiva) una regione particolare per un account.
## Sintassi della richiesta
```
POST /enableRegion HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"RegionName": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [AccountId](#API_EnableRegion_RequestSyntax) **
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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) amministratore delegato. L'ID dell'account specificato deve essere un account membro della stessa organizzazione. L'organizzazione deve avere [tutte le funzionalità abilitate](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) e deve avere abilitato l'[accesso affidabile](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) per il servizio di gestione degli account e, facoltativamente, deve essere assegnato un account [amministratore delegato](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin).
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}`
Obbligatorio: no
** [RegionName](#API_EnableRegion_RequestSyntax) **
Specificate il codice regionale per un determinato nome di regione (ad esempio,). `af-south-1` Quando si abilita una regione, AWS esegue delle operazioni per preparare l'account in quella regione, ad esempio distribuendo le risorse IAM nella regione. Questo processo richiede alcuni minuti per la maggior parte degli account, ma può richiedere diverse ore. Non è possibile utilizzare la regione finché il processo viene completato. Inoltre, non è possibile disabilitare la regione fino al completamento del processo di abilitazione.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 50 caratteri.
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non è riuscita perché l'identità chiamante non dispone delle autorizzazioni minime richieste.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta da API Gateway.
Codice di stato HTTP: 403
** ConflictException **
La richiesta non può essere elaborata a causa di un conflitto nello stato corrente della risorsa. Ad esempio, ciò accade se si tenta di abilitare una regione attualmente disabilitata (con lo stato di DISABILITAZIONE) o se si tenta di modificare l'e-mail dell'utente root di un account con un indirizzo e-mail già in uso.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta da API Gateway.
Codice di stato HTTP: 409
** 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-ErrorType` risposta 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-ErrorType` risposta 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:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/EnableRegion)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/EnableRegion)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/EnableRegion)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/EnableRegion)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/EnableRegion)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/EnableRegion)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/EnableRegion)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/EnableRegion)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/EnableRegion)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/EnableRegion)
# GetAccountInformation
Recupera informazioni sull'account specificato, tra cui il nome dell'account, l'ID dell'account e la data e l'ora di creazione dell'account. Per utilizzare questa API, un utente o un ruolo IAM deve disporre dell'autorizzazione `account:GetAccountInformation` IAM.
## Sintassi della richiesta
```
POST /getAccountInformation HTTP/1.1
Content-type: application/json
{
"AccountId": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [AccountId](#API_GetAccountInformation_RequestSyntax) **
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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) e deve avere abilitato l'[accesso affidabile](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html) per il servizio di gestione degli account e, facoltativamente, deve essere assegnato un account amministratore [delegato](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin).
L'account di gestione non può specificare il proprio`AccountId`; deve chiamare l'operazione in un contesto autonomo escludendo il parametro. `AccountId`
Per 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}`
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"AccountCreatedDate": "string",
"AccountId": "string",
"AccountName": "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.
** [AccountCreatedDate](#API_GetAccountInformation_ResponseSyntax) **
La data e l'ora di creazione dell'account.
Tipo: Timestamp
** [AccountId](#API_GetAccountInformation_ResponseSyntax) **
Specificare il numero ID dell'account a 12 cifre a Account AWS cui si desidera accedere o modificare con questa operazione. Per utilizzare questo parametro, il chiamante deve avere un'identità nell'account di [gestione dell'organizzazione o un account amministratore](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) delegato. L'ID dell'account specificato deve essere un account membro della stessa organizzazione. L'organizzazione deve avere [tutte le funzionalità abilitate](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) e deve avere abilitato l'[accesso affidabile](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) per il servizio di gestione degli account e, facoltativamente, deve essere assegnato un account [amministratore delegato](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin).
Questa operazione può essere richiamata solo dall'account di gestione o dall'account amministratore delegato di un'organizzazione per un account membro.
L'account di gestione non può specificare il proprio. `AccountId`
Tipo: stringa
Modello: `\d{12}`
** [AccountName](#API_GetAccountInformation_ResponseSyntax) **
Il nome dell'account.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 50 caratteri.
Modello: `[ -;=?-~]+`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non è riuscita perché l'identità chiamante non dispone delle autorizzazioni minime richieste.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta 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-ErrorType` risposta 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-ErrorType` risposta 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'account le cui credenziali vengono utilizzate per chiamare l'operazione.
#### Richiesta di esempio
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAccountInformation
{}
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"AccountId": "123456789012",
"AccountName": "MyAccount",
"AccountCreatedDate": "2020-11-30T17:44:37Z"
}
```
### Esempio 2
L'esempio seguente recupera le informazioni sull'account dell'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.GetAccountInformation
{
"AccountId": "123456789012"
}
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"AccountId": "123456789012",
"AccountName": "MyMemberAccount",
"AccountCreatedDate": "2020-11-30T17:44:37Z"
}
```
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetAccountInformation)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAccountInformation)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAccountInformation)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAccountInformation)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAccountInformation)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAccountInformation)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAccountInformation)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAccountInformation)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAccountInformation)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAccountInformation)
# GetAlternateContact
Recupera il contatto alternativo specificato collegato a un. Account AWS
Per dettagli completi su come utilizzare le operazioni relative ai contatti alternativi, vedi [Aggiornare i contatti alternativi per il tuo](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html). Account AWS
**Nota**
Prima di poter aggiornare le informazioni di contatto alternative per un Account AWS account gestito da AWS Organizations, devi prima abilitare l'integrazione tra AWS Account Management e Organizations. Per ulteriori informazioni, consulta [Abilitare l'accesso affidabile per la gestione degli AWS account](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html).
## Sintassi della richiesta
```
POST /getAlternateContact HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"AlternateContactType": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [AccountId](#API_GetAlternateContact_RequestSyntax) **
Specificate il numero ID dell'account a 12 cifre dell' AWS account a cui desiderate 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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) e deve avere abilitato l'[accesso affidabile](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html) per il servizio di gestione degli account e, facoltativamente, deve essere assegnato un account amministratore [delegato](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin).
L'account di gestione non può specificare il proprio`AccountId`; deve chiamare l'operazione in un contesto autonomo escludendo il parametro. `AccountId`
Per 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}`
Obbligatorio: no
** [AlternateContactType](#API_GetAlternateContact_RequestSyntax) **
Specificate quale contatto alternativo desiderate recuperare.
Tipo: String
Valori validi: `BILLING | OPERATIONS | SECURITY`
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"AlternateContact": {
"AlternateContactType": "string",
"EmailAddress": "string",
"Name": "string",
"PhoneNumber": "string",
"Title": "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.
** [AlternateContact](#API_GetAlternateContact_ResponseSyntax) **
Una struttura che contiene i dettagli per il contatto alternativo specificato.
Tipo: oggetto [AlternateContact](API_AlternateContact.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non è riuscita perché l'identità chiamante non dispone delle autorizzazioni minime richieste.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta 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-ErrorType` risposta 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-ErrorType` risposta da API Gateway.
Codice di stato HTTP: 404
** 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-ErrorType` risposta 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 il contatto alternativo di sicurezza per l'account le cui credenziali vengono utilizzate per chiamare l'operazione.
#### Richiesta di esempio
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAlternateContact
{
"AlternateContactType":"SECURITY"
}
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"AlternateContact":{
"Name":"Anika",
"Title":"COO",
"EmailAddress":"anika@example.com",
"PhoneNumber":"206-555-0198",
"AlternateContactType":"Security"
}
}
```
### Esempio 2
L'esempio seguente recupera il contatto alternativo operativo 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.GetAlternateContact
{
"AccountId":"123456789012",
"AlternateContactType":"Operations"
}
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"AlternateContact":{
"Name":"Anika",
"Title":"COO",
"EmailAddress":"anika@example.com",
"PhoneNumber":"206-555-0198",
"AlternateContactType":"Operations"
}
}
```
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetAlternateContact)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAlternateContact)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAlternateContact)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAlternateContact)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAlternateContact)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAlternateContact)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAlternateContact)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAlternateContact)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAlternateContact)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAlternateContact)
# GetContactInformation
Recupera le informazioni di contatto principali di un Account AWS.
Per dettagli completi su come utilizzare le operazioni di contatto principale, vedi [Aggiornare il contatto principale per il tuo Account AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html).
## Sintassi della richiesta
```
POST /getContactInformation HTTP/1.1
Content-type: application/json
{
"AccountId": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [AccountId](#API_GetContactInformation_RequestSyntax) **
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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) amministratore delegato. L'ID dell'account specificato deve essere un account membro della stessa organizzazione. L'organizzazione deve avere [tutte le funzionalità abilitate](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) e deve avere abilitato l'[accesso affidabile](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) per il servizio di gestione degli account e, facoltativamente, deve essere assegnato un account [amministratore delegato](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin).
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}`
Obbligatorio: no
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"ContactInformation": {
"AddressLine1": "string",
"AddressLine2": "string",
"AddressLine3": "string",
"City": "string",
"CompanyName": "string",
"CountryCode": "string",
"DistrictOrCounty": "string",
"FullName": "string",
"PhoneNumber": "string",
"PostalCode": "string",
"StateOrRegion": "string",
"WebsiteUrl": "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.
** [ContactInformation](#API_GetContactInformation_ResponseSyntax) **
Contiene i dettagli delle informazioni di contatto principali associate a un Account AWS.
Tipo: oggetto [ContactInformation](API_ContactInformation.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non è riuscita perché l'identità chiamante non dispone delle autorizzazioni minime richieste.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta 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-ErrorType` risposta 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-ErrorType` risposta da API Gateway.
Codice di stato HTTP: 404
** 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-ErrorType` risposta 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:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetContactInformation)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetContactInformation)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetContactInformation)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetContactInformation)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetContactInformation)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetContactInformation)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetContactInformation)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetContactInformation)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetContactInformation)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetContactInformation)
# 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](#API_GetGovCloudAccountInformation_RequestSyntax) **
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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) e deve avere abilitato l'[accesso affidabile](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html) per il servizio di gestione degli account e, facoltativamente, deve essere assegnato un account amministratore [delegato](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin).
L'account di gestione non può specificare il proprio`AccountId`; deve chiamare l'operazione in un contesto autonomo escludendo il parametro. `AccountId`
Per 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}`
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](#API_GetGovCloudAccountInformation_ResponseSyntax) **
Lo stato dell' GovCloud account collegato.
Tipo: String
Valori validi: `PENDING_ACTIVATION | ACTIVE | SUSPENDED | CLOSED`
** [GovCloudAccountId](#API_GetGovCloudAccountInformation_ResponseSyntax) **
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 [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non è riuscita perché l'identità chiamante non dispone delle autorizzazioni minime richieste.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta 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-ErrorType` risposta 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-ErrorType` risposta 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-ErrorType` risposta 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-ErrorType` risposta 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:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetGovCloudAccountInformation)
# GetPrimaryEmail
Recupera l'indirizzo e-mail principale per l'account specificato.
## Sintassi della richiesta
```
POST /getPrimaryEmail HTTP/1.1
Content-type: application/json
{
"AccountId": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [AccountId](#API_GetPrimaryEmail_RequestSyntax) **
Specificare il numero ID dell'account a 12 cifre a Account AWS cui si desidera accedere o modificare con questa operazione. Per utilizzare questo parametro, il chiamante deve avere un'identità nell'account di [gestione dell'organizzazione o un account amministratore](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) delegato. L'ID dell'account specificato deve essere un account membro della stessa organizzazione. L'organizzazione deve avere [tutte le funzionalità abilitate](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) e deve avere abilitato l'[accesso affidabile](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) per il servizio di gestione degli account e, facoltativamente, deve essere assegnato un account [amministratore delegato](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin).
Questa operazione può essere richiamata solo dall'account di gestione o dall'account amministratore delegato di un'organizzazione per un account membro.
L'account di gestione non può specificare il proprio. `AccountId`
Tipo: stringa
Modello: `\d{12}`
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"PrimaryEmail": "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.
** [PrimaryEmail](#API_GetPrimaryEmail_ResponseSyntax) **
Recupera l'indirizzo e-mail principale associato all'account specificato.
Tipo: String
Vincoli di lunghezza: lunghezza minima di 5. La lunghezza massima è 64 caratteri.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non è riuscita perché l'identità chiamante non dispone delle autorizzazioni minime richieste.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta 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-ErrorType` risposta 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-ErrorType` risposta da API Gateway.
Codice di stato HTTP: 404
** 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-ErrorType` risposta 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:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetPrimaryEmail)
# GetRegionOptStatus
Recupera lo stato di attivazione di una particolare regione.
## Sintassi della richiesta
```
POST /getRegionOptStatus HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"RegionName": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [AccountId](#API_GetRegionOptStatus_RequestSyntax) **
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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) amministratore delegato. L'ID dell'account specificato deve essere un account membro della stessa organizzazione. L'organizzazione deve avere [tutte le funzionalità abilitate](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) e deve avere abilitato l'[accesso affidabile](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) per il servizio di gestione degli account e, facoltativamente, deve essere assegnato un account [amministratore delegato](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin).
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}`
Obbligatorio: no
** [RegionName](#API_GetRegionOptStatus_RequestSyntax) **
Specificate il codice regionale per un determinato nome di regione (ad esempio,). `af-south-1` Questa funzione restituirà lo stato di qualsiasi regione passata a questo parametro.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 50 caratteri.
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"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.
** [RegionName](#API_GetRegionOptStatus_ResponseSyntax) **
Il codice regionale che è stato passato.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 50 caratteri.
** [RegionOptStatus](#API_GetRegionOptStatus_ResponseSyntax) **
Uno dei potenziali stati a cui può sottostare una regione (Enabled, Enabling, Disabled, Disabling, Enabled\$1By\$1Default).
Tipo: String
Valori validi: `ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non è riuscita perché l'identità chiamante non dispone delle autorizzazioni minime richieste.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta 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-ErrorType` risposta 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-ErrorType` risposta 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:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetRegionOptStatus)
# 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](#API_ListRegions_RequestSyntax) **
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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) amministratore delegato. L'ID dell'account specificato deve essere un account membro della stessa organizzazione. L'organizzazione deve avere [tutte le funzionalità abilitate](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) e deve avere abilitato l'[accesso affidabile](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) per il servizio di gestione degli account e, facoltativamente, deve essere assegnato un account [amministratore delegato](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin).
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}`
Obbligatorio: no
** [MaxResults](#API_ListRegions_RequestSyntax) **
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](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html) nella * AWS Command Line Interface User Guide*.
Tipo: numero intero
Intervallo valido: valore minimo di 1. Valore massimo pari a 50.
Obbligatorio: no
** [NextToken](#API_ListRegions_RequestSyntax) **
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](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html) nella * AWS Command Line* Interface User Guide.
Tipo: String
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 1000.
Obbligatorio: no
** [RegionOptStatusContains](#API_ListRegions_RequestSyntax) **
Un elenco di stati delle regioni (Enabling, Enabled, Disabling, Disabled, Enabled\$1by\$1default) 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: array 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](#API_ListRegions_ResponseSyntax) **
Se ci sono più dati da restituire, questo verrà compilato. Dovrebbe essere passato al parametro di `next-token` richiesta di`list-regions`.
Tipo: String
** [Regions](#API_ListRegions_ResponseSyntax) **
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](API_Region.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non è riuscita perché l'identità chiamante non dispone delle autorizzazioni minime richieste.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta 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-ErrorType` risposta 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-ErrorType` risposta 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:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/ListRegions)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/ListRegions)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ListRegions)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/ListRegions)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ListRegions)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/ListRegions)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/ListRegions)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/ListRegions)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/ListRegions)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ListRegions)
# PutAccountName
Aggiorna il nome dell'account specificato. Per utilizzare questa API, i responsabili IAM devono disporre dell'autorizzazione `account:PutAccountName` IAM.
## Sintassi della richiesta
```
POST /putAccountName HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"AccountName": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [AccountId](#API_PutAccountName_RequestSyntax) **
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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) e deve avere abilitato l'[accesso affidabile](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html) per il servizio di gestione degli account e, facoltativamente, deve essere assegnato un account amministratore [delegato](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin).
L'account di gestione non può specificare il proprio`AccountId`; deve chiamare l'operazione in un contesto autonomo escludendo il parametro. `AccountId`
Per 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}`
Obbligatorio: no
** [AccountName](#API_PutAccountName_RequestSyntax) **
Il nome dell'account.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 50 caratteri.
Modello: `[ -;=?-~]+`
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non è riuscita perché l'identità chiamante non dispone delle autorizzazioni minime richieste.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta da API Gateway.
Codice di stato HTTP: 403
** InternalServerException **
L'operazione non è riuscita a causa di un errore interno a. AWS Ripetere l'operazione più tardi.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta 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-ErrorType` risposta 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 aggiorna il nome dell'account le cui credenziali vengono utilizzate per chiamare l'operazione.
#### Richiesta di esempio
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
{
"AccountName":"MyAccount"
}
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
Content-Type: application/json
```
### Esempio 2
L'esempio seguente aggiorna il nome dell'account dell'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.PutAccountName
{
"AccountId": "123456789012",
"AccountName": "MyMemberAccount"
}
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
Content-Type: application/json
```
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutAccountName)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAccountName)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAccountName)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAccountName)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAccountName)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAccountName)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAccountName)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAccountName)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAccountName)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAccountName)
# PutAlternateContact
Modifica il contatto alternativo specificato collegato a un. Account AWS
Per dettagli completi su come utilizzare le operazioni relative ai contatti alternativi, vedi [Aggiornare i contatti alternativi per il tuo](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html). Account AWS
**Nota**
Prima di poter aggiornare le informazioni di contatto alternative per un Account AWS account gestito da AWS Organizations, devi prima abilitare l'integrazione tra AWS Account Management e Organizations. Per ulteriori informazioni, consulta [Abilitare l'accesso affidabile per la gestione degli AWS account](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html).
## Sintassi della richiesta
```
POST /putAlternateContact HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"AlternateContactType": "string",
"EmailAddress": "string",
"Name": "string",
"PhoneNumber": "string",
"Title": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [AccountId](#API_PutAlternateContact_RequestSyntax) **
Specificate il numero ID dell'account a 12 cifre dell' AWS account a cui desiderate 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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) e deve avere abilitato l'[accesso affidabile](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html) per il servizio di gestione degli account e, facoltativamente, deve essere assegnato un account amministratore [delegato](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin).
L'account di gestione non può specificare il proprio`AccountId`; deve chiamare l'operazione in un contesto autonomo escludendo il parametro. `AccountId`
Per 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}`
Obbligatorio: no
** [AlternateContactType](#API_PutAlternateContact_RequestSyntax) **
Specificate il contatto alternativo che desiderate creare o aggiornare.
Tipo: String
Valori validi: `BILLING | OPERATIONS | SECURITY`
Obbligatorio: sì
** [EmailAddress](#API_PutAlternateContact_RequestSyntax) **
Specificate un indirizzo e-mail per il contatto alternativo.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 254.
Modello: `[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*`
Obbligatorio: sì
** [Name](#API_PutAlternateContact_RequestSyntax) **
Specificate un nome per il contatto alternativo.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Obbligatorio: sì
** [PhoneNumber](#API_PutAlternateContact_RequestSyntax) **
Specificate un numero di telefono per il contatto alternativo.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 25.
Modello: `[\s0-9()+-]+`
Obbligatorio: sì
** [Title](#API_PutAlternateContact_RequestSyntax) **
Specificate un titolo per il contatto alternativo.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 50 caratteri.
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non è riuscita perché l'identità chiamante non dispone delle autorizzazioni minime richieste.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta da API Gateway.
Codice di stato HTTP: 403
** InternalServerException **
L'operazione non è riuscita a causa di un errore interno a. AWS Ripetere l'operazione più tardi.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta 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-ErrorType` risposta 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 imposta il contatto alternativo di fatturazione per l'account le cui credenziali vengono utilizzate per chiamare l'operazione.
#### Richiesta di esempio
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAlternateContact
{
"AlternateContactType": "Billing",
"Name": "Carlos Salazar",
"Title": "CFO",
"EmailAddress": "carlos@example.com",
"PhoneNumber": "206-555-0199"
}
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
Content-Type: application/json
```
### Esempio 2
L'esempio seguente imposta o sovrascrive il contatto alternativo di fatturazione 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.PutAlternateContact
{
"AccountId": "123456789012",
"AlternateContactType": "Billing",
"Name": "Carlos Salazar",
"Title": "CFO",
"EmailAddress": "carlos@example.com",
"PhoneNumber": "206-555-0199"
}
```
#### Risposta di esempio
```
HTTP/1.1 200 OK
Content-Type: application/json
```
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutAlternateContact)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAlternateContact)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAlternateContact)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAlternateContact)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAlternateContact)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAlternateContact)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAlternateContact)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAlternateContact)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAlternateContact)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAlternateContact)
# PutContactInformation
Aggiorna le informazioni di contatto principali di un Account AWS.
Per i dettagli completi su come utilizzare le operazioni di contatto principale, vedi [Aggiornare il contatto principale per il tuo Account AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html).
## Sintassi della richiesta
```
POST /putContactInformation HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"ContactInformation": {
"AddressLine1": "string",
"AddressLine2": "string",
"AddressLine3": "string",
"City": "string",
"CompanyName": "string",
"CountryCode": "string",
"DistrictOrCounty": "string",
"FullName": "string",
"PhoneNumber": "string",
"PostalCode": "string",
"StateOrRegion": "string",
"WebsiteUrl": "string"
}
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [AccountId](#API_PutContactInformation_RequestSyntax) **
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](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) amministratore delegato. L'ID dell'account specificato deve essere un account membro della stessa organizzazione. L'organizzazione deve avere [tutte le funzionalità abilitate](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) e deve avere abilitato l'[accesso affidabile](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html) per il servizio di gestione degli account e, facoltativamente, deve essere assegnato un account [amministratore delegato](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin).
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}`
Obbligatorio: no
** [ContactInformation](#API_PutContactInformation_RequestSyntax) **
Contiene i dettagli delle informazioni di contatto principali associate a un Account AWS.
Tipo: oggetto [ContactInformation](API_ContactInformation.md)
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
```
## Elementi di risposta
Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non è riuscita perché l'identità chiamante non dispone delle autorizzazioni minime richieste.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta 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-ErrorType` risposta 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-ErrorType` risposta 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:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutContactInformation)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutContactInformation)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutContactInformation)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutContactInformation)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutContactInformation)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutContactInformation)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutContactInformation)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutContactInformation)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutContactInformation)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutContactInformation)
# StartPrimaryEmailUpdate
Avvia il processo di aggiornamento dell'indirizzo e-mail principale per l'account specificato.
## Sintassi della richiesta
```
POST /startPrimaryEmailUpdate HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"PrimaryEmail": "string"
}
```
## Parametri della richiesta URI:
La richiesta non utilizza parametri URI.
## Corpo della richiesta
La richiesta accetta i seguenti dati in formato JSON.
** [AccountId](#API_StartPrimaryEmailUpdate_RequestSyntax) **
Specificate il numero ID dell'account a 12 cifre a Account AWS cui desiderate accedere o modificare con questa operazione. Per utilizzare questo parametro, il chiamante deve avere un'identità nell'account di [gestione dell'organizzazione o un account amministratore](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) delegato. L'ID dell'account specificato deve essere un account membro della stessa organizzazione. L'organizzazione deve avere [tutte le funzionalità abilitate](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) e deve avere abilitato l'[accesso affidabile](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_integrate_services.html) per il servizio di gestione degli account e, facoltativamente, deve essere assegnato un account [amministratore delegato](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin).
Questa operazione può essere richiamata solo dall'account di gestione o dall'account amministratore delegato di un'organizzazione per un account membro.
L'account di gestione non può specificare il proprio. `AccountId`
Tipo: stringa
Modello: `\d{12}`
Obbligatorio: sì
** [PrimaryEmail](#API_StartPrimaryEmailUpdate_RequestSyntax) **
Il nuovo indirizzo e-mail principale (noto anche come indirizzo e-mail dell'utente root) da utilizzare nell'account specificato.
Tipo: String
Vincoli di lunghezza: lunghezza minima di 5. La lunghezza massima è 64 caratteri.
Obbligatorio: sì
## Sintassi della risposta
```
HTTP/1.1 200
Content-type: application/json
{
"Status": "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.
** [Status](#API_StartPrimaryEmailUpdate_ResponseSyntax) **
Lo stato della richiesta di aggiornamento e-mail principale.
Tipo: String
Valori validi: `PENDING | ACCEPTED`
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).
** AccessDeniedException **
L'operazione non è riuscita perché l'identità chiamante non dispone delle autorizzazioni minime richieste.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta da API Gateway.
Codice di stato HTTP: 403
** ConflictException **
La richiesta non può essere elaborata a causa di un conflitto nello stato corrente della risorsa. Ad esempio, ciò accade se si tenta di abilitare una regione attualmente disabilitata (con lo stato di DISABILITAZIONE) o se si tenta di modificare l'e-mail dell'utente root di un account con un indirizzo e-mail già in uso.
** errorType **
Il valore inserito nell'intestazione di `x-amzn-ErrorType` risposta da API Gateway.
Codice di stato HTTP: 409
** 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-ErrorType` risposta 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-ErrorType` risposta da API Gateway.
Codice di stato HTTP: 404
** 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-ErrorType` risposta 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:
+ [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/StartPrimaryEmailUpdate)
# Azioni correlate in altri AWS servizi
Le seguenti operazioni sono correlate Gestione dell'account AWS ma fanno parte del AWS Organizations namespace:
+ [CreateAccount](API_CreateAccount.md)
+ [CreateGovCloudAccount](API_CreateGovCloudAccount.md)
+ [DescribeAccount](API_DescribeAccount.md)
# CreateAccount
L'operazione `CreateAccount` API può essere utilizzata solo nel contesto di un'organizzazione gestita dal AWS Organizations servizio. L'operazione API è definita nello spazio dei nomi di quel servizio.
Per ulteriori informazioni, consulta [CreateAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_CreateAccount.html) nella *documentazione di riferimento dell’API AWS Organizations *.
# CreateGovCloudAccount
L'operazione `CreateGovCloudAccount` API può essere utilizzata solo nel contesto di un'organizzazione gestita dal AWS Organizations servizio. L'operazione API è definita nello spazio dei nomi di quel servizio.
Per ulteriori informazioni, consulta [CreateGovCloudAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_CreateGovCloudAccount.html) nella *documentazione di riferimento dell’API AWS Organizations *.
# DescribeAccount
L'operazione `DescribeAccount` API può essere utilizzata solo nel contesto di un'organizzazione gestita dal AWS Organizations servizio. L'operazione API è definita nello spazio dei nomi di quel servizio.
Per ulteriori informazioni, consulta [DescribeAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_DescribeAccount.html) nella *documentazione di riferimento dell’API AWS Organizations *.
# Tipi di dati
Sono supportati i tipi di dati seguenti:
+ [AlternateContact](API_AlternateContact.md)
+ [ContactInformation](API_ContactInformation.md)
+ [Region](API_Region.md)
+ [ValidationExceptionField](API_ValidationExceptionField.md)
# AlternateContact
Una struttura che contiene i dettagli di un contatto alternativo associato a un account AWS
## Indice
** AlternateContactType **
Il tipo di contatto alternativo.
Tipo: String
Valori validi: `BILLING | OPERATIONS | SECURITY`
Campo obbligatorio: no
** EmailAddress **
L'indirizzo e-mail associato a questo contatto alternativo.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 254.
Modello: `[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*`
Obbligatorio: no
** Name **
Il nome associato a questo contatto alternativo.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Obbligatorio: no
** PhoneNumber **
Il numero di telefono associato a questo contatto alternativo.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 25.
Modello: `[\s0-9()+-]+`
Obbligatorio: no
** Title **
Il titolo associato a questo contatto alternativo.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 50 caratteri.
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/AlternateContact)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/AlternateContact)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/AlternateContact)
# ContactInformation
Contiene i dettagli delle informazioni di contatto principali associate a un Account AWS.
## Indice
** AddressLine1 **
La prima riga dell'indirizzo di contatto principale.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 60.
Obbligatorio: sì
** City **
La città dell'indirizzo di contatto principale.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 50 caratteri.
Obbligatorio: sì
** CountryCode **
Il codice del paese a due lettere ISO-3166 per l'indirizzo di contatto principale.
Tipo: String
Vincoli di lunghezza: lunghezza fissa di 2.
Obbligatorio: sì
** FullName **
Il nome completo dell'indirizzo di contatto principale.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 50 caratteri.
Obbligatorio: sì
** PhoneNumber **
Il numero di telefono delle informazioni di contatto principali. Il numero verrà convalidato e, in alcuni paesi, verificata l'attivazione.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 20.
Modello: `[+][\s0-9()-]+`
Obbligatorio: sì
** PostalCode **
Il codice postale dell'indirizzo di contatto principale.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 20.
Obbligatorio: sì
** AddressLine2 **
La seconda riga dell'indirizzo di contatto principale, se presente.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 60.
Obbligatorio: no
** AddressLine3 **
La terza riga dell'indirizzo di contatto principale, se presente.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. Lunghezza massima di 60.
Obbligatorio: no
** CompanyName **
Il nome dell'azienda associato alle informazioni di contatto principali, se presenti.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 50 caratteri.
Obbligatorio: no
** DistrictOrCounty **
Il distretto o la contea dell'indirizzo di contatto principale, se esistente.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 50 caratteri.
Obbligatorio: no
** StateOrRegion **
Lo stato o la regione dell'indirizzo di contatto principale. Se l'indirizzo postale si trova negli Stati Uniti d'America (USA), il valore in questo campo può essere un codice di stato a due caratteri (ad esempio,`NJ`) o il nome completo dello stato (ad esempio,`New Jersey`). Questo campo è obbligatorio nei seguenti Paesi:`US`, `CA``GB`,`DE`, `JP``IN`, e`BR`.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 50 caratteri.
Obbligatorio: no
** WebsiteUrl **
L'URL del sito Web associato alle informazioni di contatto principali, se presenti.
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ContactInformation)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ContactInformation)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ContactInformation)
# Region
Si tratta di una struttura che esprime la Regione per un determinato account, costituita da un nome e da uno stato di attivazione.
## Indice
** RegionName **
Il codice regionale di una determinata regione (ad esempio,`us-east-1`).
Tipo: String
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 50 caratteri.
Obbligatorio: no
** RegionOptStatus **
Uno dei potenziali stati a cui può sottostare una regione (Enabled, Enabling, Disabled, Disabling, Enabled\$1By\$1Default).
Tipo: String
Valori validi: `ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT`
Campo obbligatorio: no
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue: AWS SDKs
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/Region)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/Region)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/Region)
# ValidationExceptionField
L'input non è riuscito a soddisfare i vincoli specificati dal AWS servizio in un campo specificato.
## Indice
** message **
Un messaggio sull'eccezione di convalida.
Tipo: stringa
Obbligatorio: sì
** name **
Il nome del campo in cui è stata rilevata la voce non valida.
Tipo: stringa
Obbligatorio: sì
## Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+ [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ValidationExceptionField)
+ [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ValidationExceptionField)
+ [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ValidationExceptionField)
# Parametri comuni
L'elenco seguente contiene i parametri utilizzati da tutte le azioni per firmare le richieste di Signature Version 4 con una stringa di query. Qualsiasi parametro specifico di un'operazione è riportato nell'argomento relativo all'operazione. Per ulteriori informazioni sulla versione 4 di Signature, consulta [Signing AWS API requests](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) nella *IAM User Guide*.
**X-Amz-Algorithm**
Algoritmo hash utilizzato per creare la firma della richiesta.
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.
Tipo: stringa
Valori validi: `AWS4-HMAC-SHA256`
Obbligatorio: condizionale
**X-Amz-Credential**
Il valore dell'ambito delle credenziali, che è una stringa che include la chiave di accesso, la data, la regione di destinazione, il servizio richiesto e una stringa di terminazione ("aws4\$1request"). Il valore viene espresso nel seguente formato: *chiave\$1accesso*/*AAAAMMGG*/*regione*/*servizio*/aws4\$1request.
Per ulteriori informazioni, consulta [Creare una richiesta AWS API firmata](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) nella *Guida per l'utente IAM*.
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.
Tipo: stringa
Obbligatorio: condizionale
**X-Amz-Date**
La data utilizzata per creare la firma. Il formato deve essere il formato di base ISO 8601 (YYYYMMDD'T'HHMMSS'Z'). Per esempio, la data e l'ora seguenti è un X-Amz-Date valore valido:`20120325T120000Z`.
Condizione: X-Amz-Date è facoltativa per tutte le richieste; può essere utilizzata per sovrascrivere la data utilizzata per firmare le richieste. Se l'intestazione Date è specificata nel formato base ISO 8601, non X-Amz-Date è obbligatoria. Quando X-Amz-Date viene utilizzata, sovrascrive sempre il valore dell'intestazione Date. Per ulteriori informazioni, consulta [Elementi di una firma di richiesta AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) nella Guida per l'utente *IAM*.
Tipo: stringa
Obbligatorio: condizionale
**X-Amz-Security-Token**
Il token di sicurezza temporaneo ottenuto tramite una chiamata a AWS Security Token Service (AWS STS). Per un elenco di servizi che supportano le credenziali di sicurezza temporanee da AWS STS, consulta la pagina [Servizi AWS che funzionano con IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) nella *Guida per l'utente di IAM*.
Condizione: se utilizzi credenziali di sicurezza temporanee di AWS STS, devi includere il token di sicurezza.
Tipo: stringa
Obbligatorio: condizionale
**X-Amz-Signature**
Specifica la firma con codifica esadecimale calcolata dalla stringa da firmare e dalla chiave di firma derivata.
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.
Tipo: stringa
Obbligatorio: condizionale
**X-Amz-SignedHeaders**
Specifica tutte le intestazioni HTTP incluse come parte della richiesta canonica. Per ulteriori informazioni sulla specificazione delle intestazioni firmate, consulta [Creare una richiesta AWS API firmata](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) nella Guida per l'utente *IAM*.
Condition: specifica questo parametro quando includi le informazioni di autenticazione in una stringa di query anziché nell'intestazione di autorizzazione HTTP.
Tipo: stringa
Obbligatorio: condizionale
# Tipi di errore comuni
Questa sezione elenca i tipi di errore più comuni che questo AWS servizio può restituire. Non tutti i servizi restituiscono tutti i tipi di errore elencati qui. Per gli errori specifici di un'azione API per questo servizio, consulta l'argomento per quell'azione API.
**AccessDeniedException**
Non sei autorizzato a eseguire questa azione. Verifica che la tua policy IAM includa le autorizzazioni richieste.
Codice di stato HTTP: 403
**ExpiredTokenException**
Il token di sicurezza incluso nella richiesta è scaduto. Richiedi un nuovo token di sicurezza e riprova.
Codice di stato HTTP: 403
**IncompleteSignature**
La firma della richiesta non è conforme agli AWS standard. Verifica di utilizzare AWS credenziali valide e che la richiesta sia formattata correttamente. Se utilizzi un SDK, assicurati che sia aggiornato.
Codice di stato HTTP: 403
**InternalFailure**
La richiesta non può essere elaborata in questo momento a causa di un problema interno del server. Riprova più tardi. Se il problema persiste, contatta l' AWS assistenza.
Codice di stato HTTP: 500
**MalformedHttpRequestException**
Il corpo della richiesta non può essere elaborato. Ciò accade in genere quando il corpo della richiesta non può essere decompresso utilizzando l'algoritmo di codifica del contenuto specificato. Verifica che l'intestazione di codifica del contenuto corrisponda al formato di compressione utilizzato.
Codice di stato HTTP: 400
**NotAuthorized**
Non disponi delle autorizzazioni necessarie per eseguire questa azione. Verifica che la tua policy IAM includa le autorizzazioni richieste.
Codice di stato HTTP: 401
**OptInRequired**
Il tuo AWS account richiede un abbonamento per questo servizio. Verifica di aver abilitato il servizio nel tuo account.
Codice di stato HTTP: 403
**RequestAbortedException**
La richiesta è stata interrotta prima che potesse essere restituita una risposta. Ciò accade in genere quando il client chiude la connessione.
Codice di stato HTTP: 400
**RequestEntityTooLargeException**
L'entità della richiesta è troppo grande. Riduci le dimensioni del corpo della richiesta e riprova.
Codice di stato HTTP: 413
**RequestTimeoutException**
La richiesta è scaduta. Il server non ha ricevuto la richiesta completa entro il periodo di tempo previsto. Riprovare.
Codice di stato HTTP: 408
**ServiceUnavailable**
Il servizio è temporaneamente non disponibile. Riprova più tardi.
Codice di stato HTTP: 503
**ThrottlingException**
La frequenza delle richieste è troppo alta. Riprovano AWS SDKs automaticamente le richieste che ricevono questa eccezione. Riduci la frequenza delle richieste.
Codice di stato HTTP: 400
**UnknownOperationException**
L'azione o l'operazione non viene riconosciuta. Verifica che il nome dell'azione sia digitato correttamente e che sia supportato dalla versione dell'API che stai utilizzando.
Codice di stato HTTP: 404
**UnrecognizedClientException**
Il certificato X.509 o AWS l'ID della chiave di accesso che hai fornito non esiste nei nostri archivi. Verifica di utilizzare credenziali valide e che non siano scadute.
Codice di stato HTTP: 403
**ValidationError**
L'input non soddisfa il formato o i vincoli richiesti. Verifica che tutti i parametri obbligatori siano inclusi e che i valori siano validi.
Codice di stato HTTP: 400
# Chiamata dell'API tramite richieste di query HTTP
Questa sezione contiene informazioni generali sull'utilizzo dell'API Query per la gestione degli AWS account. Per ulteriori informazioni sulle operazioni delle API e sugli errori, consulta la [Documentazione di riferimento delle API](api-reference.md).
**Nota**
Invece di effettuare chiamate dirette all'API AWS Account Management Query, puoi utilizzare una delle AWS SDKs. AWS SDKs Sono costituiti da librerie e codice di esempio per vari linguaggi e piattaforme di programmazione (Java, Ruby, .NET, iOS, Android e altri). SDKs Forniscono un modo conveniente per creare un accesso programmatico alla gestione degli AWS account e. AWS Ad esempio, SDKs si occupano di attività come la firma crittografica delle richieste, la gestione degli errori e il ritentativo automatico delle richieste. Per informazioni su AWS SDKs, incluso come scaricarli e installarli, consulta [Tools for Amazon Web Services](https://aws.amazon.com/tools).
Con l'API Query per la gestione degli AWS account, puoi richiamare azioni di servizio. Le richieste Query API sono richieste HTTPS che devono contenere un `Action` parametro per indicare l'operazione da eseguire. AWS Supporti `GET` e `POST` richieste di Account Management per tutte le operazioni. Cioè, l'API non richiede l'utilizzo `GET` per alcune azioni e `POST` per altre. Tuttavia, `GET` le richieste sono soggette alla limitazione delle dimensioni di un URL. Sebbene questo limite dipenda dal browser, un limite tipico è di 2.048 byte. Pertanto, per le richieste Query API che richiedono dimensioni maggiori, è necessario utilizzare una richiesta. `POST`
La risposta è un documento XML. Per ulteriori informazioni sulla risposta, consultare le singole pagine delle operazioni nella [Documentazione di riferimento delle API](api-reference.md).
**Topics**
+ [Endpoints](#endpoints)
+ [HTTPS obbligatorio](#IAMHTTPSRequired)
+ [Richieste API per la gestione AWS degli account di firma](#SigVersion)
## Endpoints
AWS Account Management dispone di un unico endpoint API globale ospitato negli Stati Uniti orientali (Virginia settentrionale). Regione AWS
Per ulteriori informazioni sugli AWS endpoint e sulle regioni per tutti i servizi, consulta [Regioni ed endpoint](https://docs.aws.amazon.com/general/latest/gr/rande.html) nel. *Riferimenti generali di AWS*
## HTTPS obbligatorio
Poiché l'API Query può restituire informazioni sensibili come le credenziali di sicurezza, è necessario utilizzare HTTPS per crittografare tutte le richieste API.
## Richieste API per la gestione AWS degli account di firma
Le richieste devono essere firmate usando un ID chiave di accesso e una Secret Access Key. Ti consigliamo vivamente di non utilizzare le credenziali dell'account AWS root per il lavoro quotidiano con AWS Account Management. Puoi utilizzare le credenziali di un utente AWS Identity and Access Management (IAM) o credenziali temporanee come quelle che usi con un ruolo IAM.
Per firmare le tue richieste API, devi utilizzare AWS Signature Version 4. Per informazioni sull'utilizzo della versione 4 di Signature, consulta [Signing AWS API requests](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) nella *IAM User Guide*.
Per ulteriori informazioni, consulta gli argomenti seguenti:
+ [Credenziali di sicurezza AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html): fornisce informazioni generali sui tipi di credenziali che puoi usare per accedere ad AWS
+ [Best practice di sicurezza in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html): offre suggerimenti per l'utilizzo del servizio IAM per proteggere le AWS risorse, comprese quelle di AWS Account Management.
+ [Credenziali di sicurezza temporanee in IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html): descrive come creare e usare credenziali di sicurezza temporanee.