PutAccountName
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
POST /putAccountName HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"AccountName": "string"
}Parámetros de solicitud del URI
La solicitud no utiliza ningún parámetro de URI.
Cuerpo de la solicitud
La solicitud acepta los siguientes datos en formato JSON.
- AccountId
-
Especifica el número de ID de 12 dígitos de la cuenta de AWS a la que desea acceder o que desea modificar con esta operación.
Si no especifica este parámetro, el valor predeterminado será la cuenta de AWS 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 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, así como el acceso de confianza habilitado para el servicio de administración de cuentas y, de manera opcional, puede tener asignada una cuenta de administrador delegado.
nota
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ámetroAccountId.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
-
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
HTTP/1.1 200
Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- 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
-
Se ha producido un error en la operación 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
Ejemplo 1
En el siguiente ejemplo, se actualiza el nombre para la cuenta cuyas credenciales se utilizan para llamar a la operación.
Solicitud de muestra
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
{
"AccountName":"MyAccount"
}Respuesta de ejemplo
HTTP/1.1 200 OK
Content-Type: application/jsonEjemplo 2
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
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAccountName
{
"AccountId": "123456789012",
"AccountName": "MyMemberAccount"
}Respuesta de ejemplo
HTTP/1.1 200 OK
Content-Type: application/jsonVéase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
