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.
# Acciones
Se admiten las siguientes acciones:
+ [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
Acepta la solicitud originada por [StartPrimaryEmailUpdate](API_StartPrimaryEmailUpdate.md) para actualizar la dirección de correo electrónico principal (también conocida como dirección de correo electrónico del usuario raíz) de la cuenta especificada.
## Sintaxis de la solicitud
```
POST /acceptPrimaryEmailUpdate HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"Otp": "string",
"PrimaryEmail": "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](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **
Especifica el número de ID de cuenta de 12 dígitos al Cuenta de AWS que desea acceder o modificar con esta 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. 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/orgs_integrate_services.html) habilitado para el servicio de Account Management 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).
Esta operación solo se puede realizar desde la cuenta de administración o desde la cuenta de administrador delegado de una organización para una cuenta de miembro.
La cuenta de administración no puede especificar su propio `AccountId`.
Tipo: cadena
Patrón: `\d{12}`
Obligatorio: sí
** [Otp](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **
El código OTP enviado al`PrimaryEmail` especificada en la llamada a la API `StartPrimaryEmailUpdate`.
Tipo: cadena
Patrón: `[a-zA-Z0-9]{6}`
Obligatorio: sí
** [PrimaryEmail](#API_AcceptPrimaryEmailUpdate_RequestSyntax) **
La dirección de correo electrónico principal para la cuenta especificada. Debe coincidir con la `PrimaryEmail` de la llamada a la API `StartPrimaryEmailUpdate`.
Tipo: cadena
Restricciones de longitud: longitud mínima de 5 caracteres. La longitud máxima es de 64.
Obligatorio: sí
## Sintaxis de la respuesta
```
HTTP/1.1 200
Content-type: application/json
{
"Status": "string"
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [Status](#API_AcceptPrimaryEmailUpdate_ResponseSyntax) **
Recupera el estado de la solicitud de actualización del correo electrónico principal aceptada.
Tipo: cadena
Valores válidos: `PENDING | ACCEPTED`
## Errores
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
** ConflictException **
No se pudo procesar la solicitud debido a un conflicto en el estado actual del recurso. Esto ocurre, por ejemplo, si intenta activar una región que está deshabilitada actualmente (en estado EN PROCESO DE DESHABILITACIÓN) o si intenta cambiar el correo electrónico del usuario raíz de una cuenta por una dirección de correo electrónico que ya esté en uso.
** errorType **
El valor que API Gateway rellena en el encabezado de respuesta de `x-amzn-ErrorType`.
Código de estado HTTP: 409
** 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
** ResourceNotFoundException **
Se ha producido un error en la operación porque se ha especificado un recurso que no se encuentra.
** errorType **
El valor que API Gateway rellena en el encabezado de respuesta de `x-amzn-ErrorType`.
Código de estado HTTP: 404
** 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
## Véase también
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/AcceptPrimaryEmailUpdate)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/AcceptPrimaryEmailUpdate)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/AcceptPrimaryEmailUpdate)
# DeleteAlternateContact
Elimina el contacto alternativo especificado de un Cuenta de AWS.
Para obtener detalles sobre cómo utilizar las operaciones de contacto alternativo, consulte [Actualizar los contactos alternativos para su Cuenta de AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html).
**nota**
Antes de poder actualizar la información de contacto alternativa de una Cuenta de AWS empresa gestionada por AWS Organizations, primero debe habilitar la integración entre AWS Account Management y Organizations. Para obtener más información, consulte [Habilitación del acceso de confianza para la administración de la cuenta de AWS](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html).
## Sintaxis de la solicitud
```
POST /deleteAlternateContact HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"AlternateContactType": "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](#API_DeleteAlternateContact_RequestSyntax) **
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
** [AlternateContactType](#API_DeleteAlternateContact_RequestSyntax) **
Especifica cuáles de los contactos alternativos se van a eliminar.
Tipo: cadena
Valores válidos: `BILLING | OPERATIONS | SECURITY`
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 [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
** ResourceNotFoundException **
Se ha producido un error en la operación porque se ha especificado un recurso que no se encuentra.
** errorType **
El valor que API Gateway rellena en el encabezado de respuesta de `x-amzn-ErrorType`.
Código de estado HTTP: 404
** 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 elimina el contacto alternativo de seguridad de la cuenta cuyas credenciales se utilizan para llamar a la operación.
#### Solicitud de muestra
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.DeleteAlternateContact
{
"AccountName":"MyAccount"
}
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
Content-Type: application/json
```
### Ejemplo 2
En el siguiente ejemplo, se elimina el contacto alternativo de facturación de 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.DeleteAlternateContact
{
"AccountId":"123456789012",
"AlternateContactType":"BILLING"
}
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
Content-Type: application/json
```
## Véase también
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/DeleteAlternateContact)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/DeleteAlternateContact)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/DeleteAlternateContact)
# DisableRegion
Deshabilita (excluye) una región determinada de una cuenta.
**nota**
La deshabilitación de una región eliminará todo acceso de IAM a cualquier recurso que resida en esa región.
## Sintaxis de la solicitud
```
POST /disableRegion HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"RegionName": "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](#API_DisableRegion_RequestSyntax) **
Especifica el número de ID de cuenta de 12 dígitos al Cuenta de AWS que desea acceder o modificar con esta operación. Si no especifica este parámetro, el valor predeterminado será la cuenta de Amazon Web Services 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. 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/orgs_integrate_services.html) habilitado para el servicio de Account Management 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. En su lugar, 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
** [RegionName](#API_DisableRegion_RequestSyntax) **
Especifica el código de región de un nombre de región determinado (por ejemplo, `af-south-1`). Al deshabilitar una región, AWS realiza acciones para desactivarla en su cuenta, como destruir los recursos de IAM de la región. Este proceso tarda unos minutos para la mayoría de las cuentas, pero puede tardar varias horas. No puede habilitar la región hasta que el proceso de deshabilitación se haya realizado por completo.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 50 caracteres.
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 [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
** ConflictException **
No se pudo procesar la solicitud debido a un conflicto en el estado actual del recurso. Esto ocurre, por ejemplo, si intenta activar una región que está deshabilitada actualmente (en estado EN PROCESO DE DESHABILITACIÓN) o si intenta cambiar el correo electrónico del usuario raíz de una cuenta por una dirección de correo electrónico que ya esté en uso.
** errorType **
El valor que API Gateway rellena en el encabezado de respuesta de `x-amzn-ErrorType`.
Código de estado HTTP: 409
** 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
## Véase también
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/DisableRegion)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/DisableRegion)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/DisableRegion)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/DisableRegion)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/DisableRegion)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/DisableRegion)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/DisableRegion)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/DisableRegion)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/DisableRegion)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/DisableRegion)
# EnableRegion
Habilita (suscribe) una región en particular para una cuenta.
## Sintaxis de la solicitud
```
POST /enableRegion HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"RegionName": "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](#API_EnableRegion_RequestSyntax) **
Especifica el número de ID de cuenta de 12 dígitos al Cuenta de AWS que desea acceder o modificar con esta operación. Si no especifica este parámetro, el valor predeterminado será la cuenta de Amazon Web Services 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. 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/orgs_integrate_services.html) habilitado para el servicio de Account Management 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. En su lugar, 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
** [RegionName](#API_EnableRegion_RequestSyntax) **
Especifica el código de región de un nombre de región determinado (por ejemplo, `af-south-1`). Al activar una región, AWS realiza acciones para preparar su cuenta en dicha región, como la distribución de sus recursos de IAM a la región. Este proceso tarda unos minutos para la mayoría de las cuentas, pero puede tardar varias horas. No puede utilizar la región hasta que este proceso finalice. Además, no puede deshabilitar la región hasta que el proceso de habilitación se haya realizado por completo.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 50 caracteres.
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 [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
** ConflictException **
No se pudo procesar la solicitud debido a un conflicto en el estado actual del recurso. Esto ocurre, por ejemplo, si intenta activar una región que está deshabilitada actualmente (en estado EN PROCESO DE DESHABILITACIÓN) o si intenta cambiar el correo electrónico del usuario raíz de una cuenta por una dirección de correo electrónico que ya esté en uso.
** errorType **
El valor que API Gateway rellena en el encabezado de respuesta de `x-amzn-ErrorType`.
Código de estado HTTP: 409
** 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
## Véase también
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/EnableRegion)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/EnableRegion)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/EnableRegion)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/EnableRegion)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/EnableRegion)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/EnableRegion)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/EnableRegion)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/EnableRegion)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/EnableRegion)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/EnableRegion)
# GetAccountInformation
Recupera información sobre la cuenta especificada, incluidos el nombre, el identificador y la fecha y hora de creación de la cuenta. Para usar esta API, un rol o usuario de IAM deben tener el permiso de `account:GetAccountInformation` IAM.
## Sintaxis de la solicitud
```
POST /getAccountInformation HTTP/1.1
Content-type: application/json
{
"AccountId": "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](#API_GetAccountInformation_RequestSyntax) **
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
## Sintaxis de la respuesta
```
HTTP/1.1 200
Content-type: application/json
{
"AccountCreatedDate": "string",
"AccountId": "string",
"AccountName": "string"
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [AccountCreatedDate](#API_GetAccountInformation_ResponseSyntax) **
La fecha y hora de creación de la cuenta.
Tipo: marca temporal
** [AccountId](#API_GetAccountInformation_ResponseSyntax) **
Especifica el número de ID de cuenta de 12 dígitos a la Cuenta de AWS que desea acceder o modificar con esta 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. 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/orgs_integrate_services.html) habilitado para el servicio de Account Management 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).
Esta operación solo se puede realizar desde la cuenta de administración o desde la cuenta de administrador delegado de una organización para una cuenta de miembro.
La cuenta de administración no puede especificar su propio `AccountId`.
Tipo: cadena
Patrón: `\d{12}`
** [AccountName](#API_GetAccountInformation_ResponseSyntax) **
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: `[ -;=?-~]+`
## Errores
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 **
Se produjo un error en la operación debido a AWS un error interno. 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 recupera la información de cuenta de la cuenta cuyas credenciales se utilizan para llamar a la operación.
#### Solicitud de muestra
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAccountInformation
{}
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"AccountId": "123456789012",
"AccountName": "MyAccount",
"AccountCreatedDate": "2020-11-30T17:44:37Z"
}
```
### Ejemplo 2
En el siguiente ejemplo, se recupera la información de cuenta de 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.GetAccountInformation
{
"AccountId": "123456789012"
}
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"AccountId": "123456789012",
"AccountName": "MyMemberAccount",
"AccountCreatedDate": "2020-11-30T17:44:37Z"
}
```
## Véase también
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/GetAccountInformation)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAccountInformation)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAccountInformation)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAccountInformation)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAccountInformation)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAccountInformation)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAccountInformation)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAccountInformation)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAccountInformation)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAccountInformation)
# GetAlternateContact
Recupera el contacto alternativo especificado adjunto a un Cuenta de AWS.
Para obtener detalles sobre cómo utilizar las operaciones de contacto alternativo, consulte [Actualizar los contactos alternativos para su Cuenta de AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html).
**nota**
Antes de poder actualizar la información de contacto alternativa de una Cuenta de AWS empresa gestionada por AWS Organizations, primero debe habilitar la integración entre AWS Account Management y Organizations. Para obtener más información, consulte [Habilitación del acceso de confianza para la administración de la cuenta de AWS](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html).
## Sintaxis de la solicitud
```
POST /getAlternateContact HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"AlternateContactType": "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](#API_GetAlternateContact_RequestSyntax) **
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
** [AlternateContactType](#API_GetAlternateContact_RequestSyntax) **
Especifica qué contacto alternativo desea recuperar.
Tipo: cadena
Valores válidos: `BILLING | OPERATIONS | SECURITY`
Obligatorio: sí
## Sintaxis de la respuesta
```
HTTP/1.1 200
Content-type: application/json
{
"AlternateContact": {
"AlternateContactType": "string",
"EmailAddress": "string",
"Name": "string",
"PhoneNumber": "string",
"Title": "string"
}
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [AlternateContact](#API_GetAlternateContact_ResponseSyntax) **
Una estructura que contiene los detalles del contacto alternativo especificado.
Tipo: objeto [AlternateContact](API_AlternateContact.md)
## Errores
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
** ResourceNotFoundException **
Se ha producido un error en la operación porque se ha especificado un recurso que no se encuentra.
** errorType **
El valor que API Gateway rellena en el encabezado de respuesta de `x-amzn-ErrorType`.
Código de estado HTTP: 404
** 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 recupera el contacto alternativo de seguridad de la cuenta cuyas credenciales se utilizan para llamar a la operación.
#### Solicitud de muestra
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetAlternateContact
{
"AlternateContactType":"SECURITY"
}
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"AlternateContact":{
"Name":"Anika",
"Title":"COO",
"EmailAddress":"anika@example.com",
"PhoneNumber":"206-555-0198",
"AlternateContactType":"Security"
}
}
```
### Ejemplo 2
En el siguiente ejemplo, se recupera el contacto alternativo de operaciones 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.GetAlternateContact
{
"AccountId":"123456789012",
"AlternateContactType":"Operations"
}
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"AlternateContact":{
"Name":"Anika",
"Title":"COO",
"EmailAddress":"anika@example.com",
"PhoneNumber":"206-555-0198",
"AlternateContactType":"Operations"
}
}
```
## Véase también
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/GetAlternateContact)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetAlternateContact)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetAlternateContact)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetAlternateContact)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetAlternateContact)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetAlternateContact)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetAlternateContact)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetAlternateContact)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetAlternateContact)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetAlternateContact)
# GetContactInformation
Recupera la información de contacto principal de una Cuenta de AWS.
Para obtener detalles sobre cómo utilizar las operaciones de contacto principal, consulte [Actualizar el contacto principal para su Cuenta de AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html).
## Sintaxis de la solicitud
```
POST /getContactInformation HTTP/1.1
Content-type: application/json
{
"AccountId": "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](#API_GetContactInformation_RequestSyntax) **
Especifica el número de ID de cuenta de 12 dígitos al Cuenta de AWS que desea acceder o modificar con esta operación. Si no especifica este parámetro, el valor predeterminado será la cuenta de Amazon Web Services 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. 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/orgs_integrate_services.html) habilitado para el servicio de Account Management 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. En su lugar, 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
## Sintaxis de la respuesta
```
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"
}
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [ContactInformation](#API_GetContactInformation_ResponseSyntax) **
Contiene los detalles de la información de contacto principal asociada a una Cuenta de AWS.
Tipo: objeto [ContactInformation](API_ContactInformation.md)
## Errores
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
** ResourceNotFoundException **
Se ha producido un error en la operación porque se ha especificado un recurso que no se encuentra.
** errorType **
El valor que API Gateway rellena en el encabezado de respuesta de `x-amzn-ErrorType`.
Código de estado HTTP: 404
** 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
## Véase también
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/GetContactInformation)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetContactInformation)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetContactInformation)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetContactInformation)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetContactInformation)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetContactInformation)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetContactInformation)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetContactInformation)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetContactInformation)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetContactInformation)
# GetGovCloudAccountInformation
Recupera información sobre la GovCloud cuenta vinculada a la cuenta estándar especificada (si existe), incluidos el ID y el estado de la GovCloud cuenta. Para usar esta API, un rol o usuario de IAM deben tener el permiso de `account:GetGovCloudAccountInformation` IAM.
## Sintaxis de la solicitud
```
POST /getGovCloudAccountInformation HTTP/1.1
Content-type: application/json
{
"StandardAccountId": "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.
** [StandardAccountId](#API_GetGovCloudAccountInformation_RequestSyntax) **
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
## Sintaxis de la respuesta
```
HTTP/1.1 200
Content-type: application/json
{
"AccountState": "string",
"GovCloudAccountId": "string"
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [AccountState](#API_GetGovCloudAccountInformation_ResponseSyntax) **
El estado de la GovCloud cuenta vinculada.
Tipo: cadena
Valores válidos: `PENDING_ACTIVATION | ACTIVE | SUSPENDED | CLOSED`
** [GovCloudAccountId](#API_GetGovCloudAccountInformation_ResponseSyntax) **
El número de identificación de cuenta de 12 dígitos de la GovCloud cuenta vinculada.
Tipo: cadena
Patrón: `\d{12}`
## Errores
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
** ResourceNotFoundException **
Se ha producido un error en la operación porque se ha especificado un recurso que no se encuentra.
** errorType **
El valor que API Gateway rellena en el encabezado de respuesta de `x-amzn-ErrorType`.
Código de estado HTTP: 404
** ResourceUnavailableException **
Se produjo un error en la operación porque especificó un recurso que no está disponible actualmente.
** errorType **
El valor que API Gateway rellena en el encabezado de respuesta de `x-amzn-ErrorType`.
Código de estado HTTP: 424
** 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 recupera la información de la GovCloud cuenta vinculada cuyas credenciales se utilizan para llamar a la operación.
#### Solicitud de muestra
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
{}
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"GovCloudAccountId": "123456789012",
"AccountState": "ACTIVE"
}
```
### Ejemplo 2
El siguiente ejemplo recupera la información de la GovCloud cuenta vinculada de 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.GetGovCloudAccountInformation
{
"StandardAccountId": "111111111111"
}
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
Content-Type: application/json
{
"GovCloudAccountId": "123456789012",
"AccountState": "ACTIVE"
}
```
### Ejemplo 3
En el siguiente ejemplo, se intenta recuperar la información de la GovCloud cuenta vinculada de una cuenta estándar que no está vinculada a ninguna GovCloud cuenta.
#### Solicitud de muestra
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
{
"StandardAccountId": "222222222222"
}
```
#### Respuesta de ejemplo
```
HTTP/1.1 404
Content-Type: application/json
{
"message":"GovCloud Account ID not found for Standard Account - 222222222222."
}
```
## Véase también
Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulta lo siguiente:
+ [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetGovCloudAccountInformation)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetGovCloudAccountInformation)
# GetPrimaryEmail
Recupera la dirección de correo electrónico principal para la cuenta especificada.
## Sintaxis de la solicitud
```
POST /getPrimaryEmail HTTP/1.1
Content-type: application/json
{
"AccountId": "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](#API_GetPrimaryEmail_RequestSyntax) **
Especifica el número de ID de cuenta de 12 dígitos al Cuenta de AWS que desea acceder o modificar con esta 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. 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/orgs_integrate_services.html) habilitado para el servicio de Account Management 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).
Esta operación solo se puede realizar desde la cuenta de administración o desde la cuenta de administrador delegado de una organización para una cuenta de miembro.
La cuenta de administración no puede especificar su propio `AccountId`.
Tipo: cadena
Patrón: `\d{12}`
Obligatorio: sí
## Sintaxis de la respuesta
```
HTTP/1.1 200
Content-type: application/json
{
"PrimaryEmail": "string"
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [PrimaryEmail](#API_GetPrimaryEmail_ResponseSyntax) **
Recupera la dirección de correo electrónico principal asociada a la cuenta especificada.
Tipo: cadena
Restricciones de longitud: longitud mínima de 5 caracteres. La longitud máxima es de 64.
## Errores
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
** ResourceNotFoundException **
Se ha producido un error en la operación porque se ha especificado un recurso que no se encuentra.
** errorType **
El valor que API Gateway rellena en el encabezado de respuesta de `x-amzn-ErrorType`.
Código de estado HTTP: 404
** 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
## Véase también
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/GetPrimaryEmail)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetPrimaryEmail)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetPrimaryEmail)
# GetRegionOptStatus
Recupera el estado de suscripción de una región determinada.
## Sintaxis de la solicitud
```
POST /getRegionOptStatus HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"RegionName": "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](#API_GetRegionOptStatus_RequestSyntax) **
Especifica el número de ID de cuenta de 12 dígitos al Cuenta de AWS que desea acceder o modificar con esta operación. Si no especifica este parámetro, el valor predeterminado será la cuenta de Amazon Web Services 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. 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/orgs_integrate_services.html) habilitado para el servicio de Account Management 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. En su lugar, 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
** [RegionName](#API_GetRegionOptStatus_RequestSyntax) **
Especifica el código de región de un nombre de región determinado (por ejemplo, `af-south-1`). Esta función devolverá el estado de cualquier región que introduzca en este parámetro.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 50 caracteres.
Obligatorio: sí
## Sintaxis de la respuesta
```
HTTP/1.1 200
Content-type: application/json
{
"RegionName": "string",
"RegionOptStatus": "string"
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [RegionName](#API_GetRegionOptStatus_ResponseSyntax) **
El código de región que se introdujo.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 50 caracteres.
** [RegionOptStatus](#API_GetRegionOptStatus_ResponseSyntax) **
Uno de los posibles estados que puede alcanzar una región (Habilitada, En proceso de habilitación, Deshabilitada, En proceso de deshabilitación, Habilitada por defecto).
Tipo: cadena
Valores válidos: `ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT`
## Errores
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
## Véase también
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/GetRegionOptStatus)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetRegionOptStatus)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetRegionOptStatus)
# ListRegions
Muestra todas las regiones de una cuenta determinada y sus respectivos estados de suscripción. Opcionalmente, esta lista se puede filtrar por el parámetro `region-opt-status-contains`.
## Sintaxis de la solicitud
```
POST /listRegions HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"MaxResults": number,
"NextToken": "string",
"RegionOptStatusContains": [ "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](#API_ListRegions_RequestSyntax) **
Especifica el número de ID de cuenta de 12 dígitos al Cuenta de AWS que desea acceder o modificar con esta operación. Si no especifica este parámetro, el valor predeterminado será la cuenta de Amazon Web Services 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. 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/orgs_integrate_services.html) habilitado para el servicio de Account Management 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. En su lugar, 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
** [MaxResults](#API_ListRegions_RequestSyntax) **
El número total de elementos que se devuelven en la salida del comando. Si el número total de elementos disponible es mayor que el valor especificado, se proporciona un `NextToken` en la salida del comando. Para reanudar la paginación, proporcione el valor de `NextToken` en el argumento `starting-token` de un comando posterior. No utilice el elemento de `NextToken` respuesta directamente fuera de la AWS CLI. Para ver ejemplos de uso, consulte [Paginación](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html) en la *Guía del usuario de la interfaz de línea de AWS comandos*.
Tipo: entero
Rango válido: valor mínimo de 1. Valor máximo de 50.
Obligatorio: no
** [NextToken](#API_ListRegions_RequestSyntax) **
Un token destinado a especificar dónde iniciar la paginación. Es el `NextToken` de una respuesta truncada anteriormente. Para ver ejemplos de uso, consulte [Paginación](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html) en la Guía del *usuario de la interfaz de línea de AWS comandos*.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 0. La longitud máxima es de 1000 caracteres.
Obligatorio: no
** [RegionOptStatusContains](#API_ListRegions_RequestSyntax) **
Una lista de estados de región (habilitando, habilitada, deshabilitando, deshabilitada, habilitada por defecto) que se puede usar para filtrar la lista de regiones de una cuenta determinada. Por ejemplo, si se introduce un valor de HABILITANDO, solo se mostrará una lista de regiones con el estado de HABILITANDO.
Tipo: matriz de cadenas
Valores válidos: `ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT`
Obligatorio: no
## Sintaxis de la respuesta
```
HTTP/1.1 200
Content-type: application/json
{
"NextToken": "string",
"Regions": [
{
"RegionName": "string",
"RegionOptStatus": "string"
}
]
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [NextToken](#API_ListRegions_ResponseSyntax) **
Si hay más datos que devolver, se rellenarán. Debe pasarse al parámetro de solicitud `next-token` de `list-regions`.
Tipo: cadena
** [Regions](#API_ListRegions_ResponseSyntax) **
Esta es una lista de regiones para una cuenta determinada o, si se utilizó el parámetro filtrado, una lista de regiones que coinciden con los criterios de filtro establecidos en el parámetro `filter`.
Tipo: matriz de objetos [Region](API_Region.md)
## Errores
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
## Véase también
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/ListRegions)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/ListRegions)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ListRegions)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/ListRegions)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ListRegions)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/ListRegions)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/ListRegions)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/ListRegions)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/ListRegions)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ListRegions)
# 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](#API_PutAccountName_RequestSyntax) **
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) **
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 [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
### 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/json
```
### Ejemplo 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/json
```
## Véase también
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)
# PutAlternateContact
Modifica el contacto alternativo especificado adjunto a un Cuenta de AWS.
Para obtener detalles sobre cómo utilizar las operaciones de contacto alternativo, consulte [Actualizar los contactos alternativos para su Cuenta de AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-alternate.html).
**nota**
Antes de poder actualizar la información de contacto alternativa de una Cuenta de AWS empresa gestionada por AWS Organizations, primero debe habilitar la integración entre AWS Account Management y Organizations. Para obtener más información, consulte [Habilitación del acceso de confianza para la administración de la cuenta de AWS](https://docs.aws.amazon.com/accounts/latest/reference/using-orgs-trusted-access.html).
## Sintaxis de la solicitud
```
POST /putAlternateContact HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"AlternateContactType": "string",
"EmailAddress": "string",
"Name": "string",
"PhoneNumber": "string",
"Title": "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](#API_PutAlternateContact_RequestSyntax) **
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
** [AlternateContactType](#API_PutAlternateContact_RequestSyntax) **
Especifica qué contacto alternativo desea crear o actualizar.
Tipo: cadena
Valores válidos: `BILLING | OPERATIONS | SECURITY`
Obligatorio: sí
** [EmailAddress](#API_PutAlternateContact_RequestSyntax) **
Especifica una dirección de correo electrónico para el contacto alternativo.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 254 caracteres.
Patrón: `[\s]*[\w+=.#|!&-]+@[\w.-]+\.[\w]+[\s]*`
Obligatorio: sí
** [Name](#API_PutAlternateContact_RequestSyntax) **
Especifica un nombre para el contacto alternativo.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Obligatorio: sí
** [PhoneNumber](#API_PutAlternateContact_RequestSyntax) **
Especifica un número de teléfono para el contacto alternativo.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 25 caracteres.
Patrón: `[\s0-9()+-]+`
Obligatorio: sí
** [Title](#API_PutAlternateContact_RequestSyntax) **
Especifica un título para el contacto alternativo.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 50 caracteres.
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 [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 **
Se produjo 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 establece el contacto alternativo de facturación para la cuenta cuyas credenciales se utilizan para llamar a la operación.
#### Solicitud de muestra
```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.PutAlternateContact
{
"AlternateContactType": "Billing",
"Name": "Carlos Salazar",
"Title": "CFO",
"EmailAddress": "carlos@example.com",
"PhoneNumber": "206-555-0199"
}
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
Content-Type: application/json
```
### Ejemplo 2
En el siguiente ejemplo, se establece o sobrescribe el contacto alternativo de facturación 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.PutAlternateContact
{
"AccountId": "123456789012",
"AlternateContactType": "Billing",
"Name": "Carlos Salazar",
"Title": "CFO",
"EmailAddress": "carlos@example.com",
"PhoneNumber": "206-555-0199"
}
```
#### Respuesta de ejemplo
```
HTTP/1.1 200 OK
Content-Type: application/json
```
## Véase también
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/PutAlternateContact)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutAlternateContact)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutAlternateContact)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutAlternateContact)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutAlternateContact)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutAlternateContact)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutAlternateContact)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutAlternateContact)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutAlternateContact)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutAlternateContact)
# PutContactInformation
Actualiza la información de contacto principal de una Cuenta de AWS.
Para obtener detalles sobre cómo utilizar las operaciones de contacto principal, consulte [Actualizar el contacto principal para su Cuenta de AWS](https://docs.aws.amazon.com/accounts/latest/reference/manage-acct-update-contact-primary.html).
## Sintaxis de la solicitud
```
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"
}
}
```
## 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](#API_PutContactInformation_RequestSyntax) **
Especifica el número de ID de cuenta de 12 dígitos al Cuenta de AWS que desea acceder o modificar con esta operación. Si no especifica este parámetro, el valor predeterminado será la cuenta de Amazon Web Services 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. 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. En su lugar, 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
** [ContactInformation](#API_PutContactInformation_RequestSyntax) **
Contiene los detalles de la información de contacto principal asociada a una Cuenta de AWS.
Tipo: objeto [ContactInformation](API_ContactInformation.md)
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 [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
## Véase también
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/PutContactInformation)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/PutContactInformation)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/PutContactInformation)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/PutContactInformation)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/PutContactInformation)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/PutContactInformation)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/PutContactInformation)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/PutContactInformation)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/PutContactInformation)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/PutContactInformation)
# StartPrimaryEmailUpdate
Inicia el proceso de actualización de la dirección de correo electrónico primaria de la cuenta especificada.
## Sintaxis de la solicitud
```
POST /startPrimaryEmailUpdate HTTP/1.1
Content-type: application/json
{
"AccountId": "string",
"PrimaryEmail": "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](#API_StartPrimaryEmailUpdate_RequestSyntax) **
Especifica el número de ID de cuenta de 12 dígitos al Cuenta de AWS que desea acceder o modificar con esta 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. 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/orgs_integrate_services.html) habilitado para el servicio de Account Management 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).
Esta operación solo se puede realizar desde la cuenta de administración o desde la cuenta de administrador delegado de una organización para una cuenta de miembro.
La cuenta de administración no puede especificar su propio `AccountId`.
Tipo: cadena
Patrón: `\d{12}`
Obligatorio: sí
** [PrimaryEmail](#API_StartPrimaryEmailUpdate_RequestSyntax) **
La nueva dirección de correo electrónico principal (también conocida como dirección de correo electrónico del usuario raíz) que se utilizará en la cuenta especificada.
Tipo: cadena
Restricciones de longitud: longitud mínima de 5 caracteres. La longitud máxima es de 64.
Obligatorio: sí
## Sintaxis de la respuesta
```
HTTP/1.1 200
Content-type: application/json
{
"Status": "string"
}
```
## Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
** [Status](#API_StartPrimaryEmailUpdate_ResponseSyntax) **
El estado de la solicitud de actualización del correo electrónico principal.
Tipo: cadena
Valores válidos: `PENDING | ACCEPTED`
## Errores
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
** ConflictException **
No se pudo procesar la solicitud debido a un conflicto en el estado actual del recurso. Esto ocurre, por ejemplo, si intenta activar una región que está deshabilitada actualmente (en estado EN PROCESO DE DESHABILITACIÓN) o si intenta cambiar el correo electrónico del usuario raíz de una cuenta por una dirección de correo electrónico que ya esté en uso.
** errorType **
El valor que API Gateway rellena en el encabezado de respuesta de `x-amzn-ErrorType`.
Código de estado HTTP: 409
** 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
** ResourceNotFoundException **
Se ha producido un error en la operación porque se ha especificado un recurso que no se encuentra.
** errorType **
El valor que API Gateway rellena en el encabezado de respuesta de `x-amzn-ErrorType`.
Código de estado HTTP: 404
** 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
## Véase también
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/StartPrimaryEmailUpdate)
+ [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/StartPrimaryEmailUpdate)
+ [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/StartPrimaryEmailUpdate)