Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

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

Actualiza el nombre de cuenta de la cuenta especificada. Para usar esta API, las entidades principales de IAM deben tener el permiso de `account:PutAccountName` IAM. 

## Sintaxis de la solicitud
<a name="API_PutAccountName_RequestSyntax"></a>

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

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

## Parámetros de solicitud del URI
<a name="API_PutAccountName_RequestParameters"></a>

La solicitud no utiliza ningún parámetro de URI.

## Cuerpo de la solicitud
<a name="API_PutAccountName_RequestBody"></a>

La solicitud acepta los siguientes datos en formato JSON.

 ** [AccountId](#API_PutAccountName_RequestSyntax) **   <a name="accounts-PutAccountName-request-AccountId"></a>
Especifica el número de ID de cuenta de 12 dígitos de la AWS cuenta a la que desea acceder o modificar con esta operación.  
Si no especifica este parámetro, el valor predeterminado será la AWS cuenta de la identidad utilizada para llamar a la operación.  
Para usar este parámetro, la persona que llama debe ser una identidad de la [cuenta de administración de la organización](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) o una cuenta de administrador delegado, y el ID de cuenta especificado debe ser una cuenta de miembro en la misma organización. La organización debe tener [todas las características habilitadas](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html), así como el [acceso de confianza](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html) habilitado para el servicio de administración de cuentas y, de manera opcional, puede tener asignada una cuenta de [administrador delegado](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin).  
La cuenta de administración no puede especificar su propio `AccountId`; debe llamar a la operación en un contexto independiente al no incluir el parámetro `AccountId`.
Para llamar a esta operación en una cuenta que no es miembro de una organización, no especifique este parámetro y llame a la operación con una identidad que pertenezca a la cuenta cuyos contactos desea recuperar o modificar.  
Tipo: cadena  
Patrón: `\d{12}`   
Obligatorio: no

 ** [AccountName](#API_PutAccountName_RequestSyntax) **   <a name="accounts-PutAccountName-request-AccountName"></a>
El nombre de la cuenta.  
Tipo: cadena  
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 50 caracteres.  
Patrón: `[ -;=?-~]+`   
Obligatorio: sí

## Sintaxis de la respuesta
<a name="API_PutAccountName_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementos de respuesta
<a name="API_PutAccountName_ResponseElements"></a>

Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.

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

Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md).

 ** AccessDeniedException **   
Se ha producido un error en la operación porque la identidad que ha realizado la llamada no tiene los permisos mínimos necesarios.    
 ** errorType **   
El valor que API Gateway rellena en el encabezado de respuesta de `x-amzn-ErrorType`.
Código de estado HTTP: 403

 ** InternalServerException **   
La operación falló debido a un error interno de AWS. Intente realizar la operación otra vez más tarde.    
 ** errorType **   
El valor que API Gateway rellena en el encabezado de respuesta de `x-amzn-ErrorType`.
Código de estado HTTP: 500

 ** TooManyRequestsException **   
Se ha producido un error en la operación porque se la ha llamado con demasiada frecuencia y ha superado la limitación.    
 ** errorType **   
El valor que API Gateway rellena en el encabezado de respuesta de `x-amzn-ErrorType`.
Código de estado HTTP: 429

 ** ValidationException **   
Se ha producido un error en la operación porque uno de los parámetros de entrada no era válido.    
 ** fieldList **   
El campo en el que se detectó la entrada no válida.  
 ** message **   
El mensaje donde se le informa qué no era válido en la solicitud.  
 ** reason **   
El motivo por el que se produjo un error en la validación.
Código de estado HTTP: 400

## Ejemplos
<a name="API_PutAccountName_Examples"></a>

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

En el siguiente ejemplo, se actualiza el nombre para la cuenta cuyas credenciales se utilizan para llamar a la operación. 

#### Solicitud de muestra
<a name="API_PutAccountName_Example_1_Request"></a>

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

#### Respuesta de ejemplo
<a name="API_PutAccountName_Example_1_Response"></a>

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

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

En el siguiente ejemplo, se actualiza el nombre de cuenta para la cuenta de miembro especificada en una organización. Debe usar las credenciales de la cuenta de administración de la organización o de la cuenta de administrador delegado del servicio de Account Management. 

#### Solicitud de muestra
<a name="API_PutAccountName_Example_2_Request"></a>

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

#### Respuesta de ejemplo
<a name="API_PutAccountName_Example_2_Response"></a>

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

## Véase también
<a name="API_PutAccountName_SeeAlso"></a>

Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
+  [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/PutAccountName) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAccountName) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAccountName) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAccountName) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAccountName) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAccountName) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAccountName) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAccountName) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAccountName) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAccountName)