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.
# 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)