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à.

# PutAccountName
<a name="API_PutAccountName"></a>

Aggiorna il nome dell'account specificato. Per utilizzare questa API, i responsabili IAM devono disporre dell'autorizzazione `account:PutAccountName` IAM. 

## Sintassi della richiesta
<a name="API_PutAccountName_RequestSyntax"></a>

```
POST /putAccountName HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "AccountName": "string"
}
```

## Parametri della richiesta URI:
<a name="API_PutAccountName_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_PutAccountName_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [AccountId](#API_PutAccountName_RequestSyntax) **   <a name="accounts-PutAccountName-request-AccountId"></a>
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) **   <a name="accounts-PutAccountName-request-AccountName"></a>
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
<a name="API_PutAccountName_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_PutAccountName_ResponseElements"></a>

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

## Errori
<a name="API_PutAccountName_Errors"></a>

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
<a name="API_PutAccountName_Examples"></a>

### Esempio 1
<a name="API_PutAccountName_Example_1"></a>

L'esempio seguente aggiorna il nome dell'account le cui credenziali vengono utilizzate per chiamare l'operazione. 

#### Richiesta di esempio
<a name="API_PutAccountName_Example_1_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
                    
{
   "AccountName":"MyAccount"
}
```

#### Risposta di esempio
<a name="API_PutAccountName_Example_1_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
```

### Esempio 2
<a name="API_PutAccountName_Example_2"></a>

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
<a name="API_PutAccountName_Example_2_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
                    
{
   "AccountId": "123456789012",
   "AccountName": "MyMemberAccount"
}
```

#### Risposta di esempio
<a name="API_PutAccountName_Example_2_Response"></a>

```
HTTP/1.1 200 OK
Content-Type: application/json
```

## Vedi anche
<a name="API_PutAccountName_SeeAlso"></a>

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)