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. # referencia de la API Las operaciones de la API en el espacio de nombres de Account Management (`account`) le permiten modificar su. Cuenta de AWS Every Cuenta de AWS admite metadatos con información sobre la cuenta, incluida información sobre hasta tres contactos alternativos asociados a la cuenta. Estos se suman a la dirección de correo electrónico asociada al [usuario raíz](root-user.md) de la cuenta. Puede especificar solo uno de los siguientes tipos de contacto asociados a una cuenta. + Contacto de facturación + Contacto de operaciones + Contacto de seguridad De forma predeterminada, las operaciones de la API que se describen en esta guía se aplican directamente a la cuenta que llama a la operación. La [identidad](https://docs.aws.amazon.com/IAM/latest/UserGuide/id.html) en la cuenta que llama a la operación suele ser un rol de IAM o un usuario de IAM y debe tener el permiso aplicado por una política de IAM para llamar a la operación de API. Como alternativa, puedes llamar a estas operaciones de la API desde una identidad de una cuenta de AWS Organizations administración y especificar el número de ID de la cuenta de cualquiera Cuenta de AWS que sea miembro de la organización. **Versión de la API** Esta versión de la referencia de la API de cuentas registra la versión 2021-02-01 de la API de Account Management. **nota** Como alternativa a usar la API directamente, puede usar una de las AWS SDKs, que consta de bibliotecas y código de muestra para varios lenguajes de programación y plataformas (Java, Ruby, .NET, iOS, Android y más). SDKs Proporcionan una forma cómoda de crear un acceso programático a AWS Organizations. Por ejemplo, se SDKs encargan de firmar criptográficamente las solicitudes, gestionar los errores y volver a intentar las solicitudes automáticamente. Para obtener más información acerca de AWS SDKs, incluida la forma de descargarlos e instalarlos, consulte [Herramientas para Amazon Web Services](https://console.aws.amazon.com/). Le recomendamos que lo utilice AWS SDKs para realizar llamadas programáticas a la API del servicio de administración de cuentas. Sin embargo, también puede usar la API de consulta de Account Management para realizar llamadas directas al servicio web de Account Management. Para obtener más información sobre la API de consultas de Account Management, consulte [Llamar a la API mediante solicitudes de consulta HTTP](query-requests.md) en la Guía del usuario de Account Management. Organizations admite solicitudes GET y POST para todas las acciones. Es decir, la API no requiere que utilice GET para algunas acciones y POST para otras. Sin embargo, las solicitudes GET están sujetas a las limitaciones de tamaño de una URL. Por lo tanto, para las operaciones que requieran tamaños más grandes, utilice una solicitud POST. **Firma de solicitudes** Cuando envíes solicitudes HTTP a AWS, debes firmarlas para AWS poder identificar quién las envió. Las solicitudes se firman con la clave de AWS acceso, que consta de un identificador de clave de acceso y una clave de acceso secreta. Le recomendamos no crear una clave de acceso para su cuenta raíz. Cualquier persona que tenga la clave de acceso de su cuenta raíz dispondrá de acceso ilimitado a todos los recursos de su cuenta. En su lugar, cree una clave de acceso para un usuario de IAM que tenga privilegios de administrador. Otra opción es utilizar el AWS Security Token Service para generar credenciales de seguridad temporales y utilizarlas para firmar las solicitudes. Para firmar solicitudes, le recomendamos que utilice la versión 4 de Signature. Si ya tiene una aplicación que utiliza la versión 2 de Signature, no tiene que actualizarla para utilizar la versión 4 de Signature. Sin embargo, algunas operaciones ahora requieren la versión 4 de Signature. En la documentación de las operaciones que requieren la versión 4, se indica este requisito. Para obtener más información, consulte [Firmar solicitudes de AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) en la *Guía del usuario de IAM*. Cuando utiliza la interfaz de línea de AWS comandos (AWS CLI) o una de ellas AWS SDKs para realizar solicitudes AWS, estas herramientas firman automáticamente las solicitudes por usted con la clave de acceso que especifique al configurar las herramientas. **Compatibilidad con Account Management y comentarios** Agradecemos sus comentarios. Envíe sus comentarios a [feedback-awsaccounts@amazon.com](mailto://feedback-awsaccounts@amazon.com) o publique sus comentarios y preguntas en el [foro de soporte de Account Management](https://forums.aws.amazon.com/forum.jspa?forumID=219). Para obtener más información sobre los foros de AWS soporte, consulte la [Ayuda de los foros](https://forums.aws.amazon.com/help.jspa). **Cómo se presentan los ejemplos** El JSON devuelto por Account Management como respuesta a sus solicitudes se devuelve como una sola cadena larga sin saltos de línea ni espacios en blanco de formato. Tanto los saltos de línea como los espacios en blanco se muestran en los ejemplos de esta guía para mejorar la legibilidad. Si los parámetros de entrada de ejemplo también dan como resultado cadenas largas que se extienden más allá de la pantalla, insertamos saltos de línea para mejorar la legibilidad. Siempre debe enviar la entrada como una sola cadena de texto JSON. **Registro de solicitudes de API** Account Management admite CloudTrail un servicio que registra sus llamadas a la AWS API Cuenta de AWS y entrega los archivos de registro a un bucket de Amazon S3. Al usar la información recopilada por CloudTrail, puede determinar qué solicitudes se realizaron correctamente a la administración de cuentas, quién realizó la solicitud, cuándo se realizó, etc. Para obtener más información sobre la administración de cuentas y su soporte CloudTrail, consulte[Registro de llamadas a la API de administración de AWS cuentas mediante AWS CloudTrail](monitoring-cloudtrail.md). Para obtener más información sobre CloudTrail cómo activarla y buscar los archivos de registro, consulta la [Guía del AWS CloudTrail usuario](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/). # 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) # Acciones relacionadas en otros AWS servicios Las siguientes operaciones están relacionadas con el espacio de AWS Organizations nombres AWS Account Management , pero forman parte de él: + [CreateAccount](API_CreateAccount.md) + [CreateGovCloudAccount](API_CreateGovCloudAccount.md) + [DescribeAccount](API_DescribeAccount.md) # CreateAccount La operación de `CreateAccount` API solo está disponible para su uso en el contexto de una organización gestionada por el AWS Organizations servicio. La operación de la API se define en el espacio de nombres de ese servicio. Para obtener más información, consulta [CreateAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_CreateAccount.html) en la *AWS Organizations Referencia de la API de *. # CreateGovCloudAccount La operación de `CreateGovCloudAccount` API solo está disponible para su uso en el contexto de una organización gestionada por el AWS Organizations servicio. La operación de la API se define en el espacio de nombres de ese servicio. Para obtener más información, consulta [CreateGovCloudAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_CreateGovCloudAccount.html) en la *AWS Organizations Referencia de la API de *. # DescribeAccount La operación de `DescribeAccount` API solo está disponible para su uso en el contexto de una organización gestionada por el AWS Organizations servicio. La operación de la API se define en el espacio de nombres de ese servicio. Para obtener más información, consulta [DescribeAccount](https://docs.aws.amazon.com/organizations/latest/APIReference/API_DescribeAccount.html) en la *AWS Organizations Referencia de la API de *. # Data Types Los siguientes tipos de datos son compatibles: + [AlternateContact](API_AlternateContact.md) + [ContactInformation](API_ContactInformation.md) + [Region](API_Region.md) + [ValidationExceptionField](API_ValidationExceptionField.md) # AlternateContact Estructura que contiene los detalles de un contacto alternativo asociado a una cuenta de AWS ## Contenido ** AlternateContactType ** El tipo de contacto alternativo. Tipo: cadena Valores válidos: `BILLING | OPERATIONS | SECURITY` Obligatorio: no ** EmailAddress ** La dirección de correo electrónico asociada a este 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: no ** Name ** El nombre asociado a este contacto alternativo. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64. Obligatorio: no ** PhoneNumber ** El número de teléfono asociado a este contacto alternativo. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 25 caracteres. Patrón: `[\s0-9()+-]+` Obligatorio: no ** Title ** El título asociado a este contacto alternativo. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 50 caracteres. Obligatorio: no ## 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 SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/AlternateContact) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/AlternateContact) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/AlternateContact) # ContactInformation Contiene los detalles de la información de contacto principal asociada a una Cuenta de AWS. ## Contenido ** AddressLine1 ** La primera línea de la dirección de contacto principal. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 60 caracteres. Obligatorio: sí ** City ** La ciudad de la dirección de contacto principal. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 50 caracteres. Obligatorio: sí ** CountryCode ** El código ISO-3166 de dos letras de la dirección de contacto principal. Tipo: cadena Restricciones de longitud: longitud fija de 2 caracteres. Obligatorio: sí ** FullName ** El nombre completo de la dirección de contacto principal. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 50 caracteres. Obligatorio: sí ** PhoneNumber ** El número de teléfono de la información de contacto principal. El número se validará y, en algunos países, se comprobará para su activación. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 20 caracteres. Patrón: `[+][\s0-9()-]+` Obligatorio: sí ** PostalCode ** El código postal de la dirección de contacto principal. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 20 caracteres. Obligatorio: sí ** AddressLine2 ** La segunda línea de la dirección de contacto principal, si la hubiera. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 60 caracteres. Obligatorio: no ** AddressLine3 ** La tercera línea de la dirección de contacto principal, si la hubiera. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 60 caracteres. Obligatorio: no ** CompanyName ** El nombre de la empresa asociada a la información de contacto principal, si la hubiera. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 50 caracteres. Obligatorio: no ** DistrictOrCounty ** El distrito o condado de la dirección de contacto principal, si la hubiera. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 50 caracteres. Obligatorio: no ** StateOrRegion ** El estado o la región de la dirección de contacto principal. Si la dirección postal se encuentra en los Estados Unidos (EE. UU.), el valor de este campo puede ser un código de estado de dos caracteres (por ejemplo, `NJ`) o el nombre completo del estado (por ejemplo, `New Jersey`). Este campo es obligatorio en los siguientes países: `US`, `CA`, `GB`, `DE`, `JP`, `IN` y `BR`. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 50 caracteres. Obligatorio: no ** WebsiteUrl ** La URL del sitio web asociado a la información de contacto principal, si la hubiera. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres. Obligatorio: no ## 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 SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ContactInformation) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ContactInformation) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ContactInformation) # Region Se trata de una estructura que expresa la región de una cuenta determinada y consta de un nombre y un estado de suscripción. ## Contenido ** RegionName ** El código de región de una región determinada (por ejemplo, `us-east-1`). Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 50 caracteres. Obligatorio: no ** RegionOptStatus ** 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` Obligatorio: no ## 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 SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/Region) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/Region) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/Region) # ValidationExceptionField La entrada no cumplía las restricciones especificadas por el AWS servicio en un campo específico. ## Contenido ** message ** Un mensaje sobre la excepción de validación. Tipo: cadena Obligatorio: sí ** name ** El nombre del campo en el que se detectó la entrada no válida. Tipo: cadena Obligatorio: sí ## 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 SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ValidationExceptionField) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ValidationExceptionField) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ValidationExceptionField) # Parámetros comunes La siguiente lista contiene los parámetros que utilizan todas las acciones para firmar solicitudes de Signature Version 4 con una cadena de consulta. Los parámetros específicos de acción se enumeran en el tema correspondiente a la acción. Para obtener más información sobre la versión 4 de Signature, consulte [Firmar solicitudes de AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) en la *Guía del usuario de IAM*. **X-Amz-Algorithm** El algoritmo de hash que utilizó para crear la solicitud de firma. Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP. Tipo: cadena Valores válidos: `AWS4-HMAC-SHA256` Obligatorio: condicional **X-Amz-Credential** El valor del ámbito de la credencial, que es una cadena que incluye la clave de acceso, la fecha, la región a la que se dirige, el servicio que solicita y una cadena de terminación (“aws4\$1request”). El valor se expresa en el siguiente formato: *access\$1key*/*AAAAMMDD*/*region*/*service*/aws4\$1request. Para obtener más información, consulte [Crear una solicitud de AWS API firmada](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) en la Guía del *usuario de IAM*. Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP. Tipo: cadena Obligatorio: condicional **X-Amz-Date** La fecha utilizada para crear la firma. El formato debe ser ISO 8601 formato básico (AAAAMMDD‘T’HHMMSS‘Z’). Por ejemplo, la siguiente fecha y hora es un X-Amz-Date valor válido:`20120325T120000Z`. Condición: X-Amz-Date es opcional en todas las solicitudes; puede utilizarse para anular la fecha empleada para firmar solicitudes. Si el encabezado de fecha se especifica en el formato básico ISO 8601, no X-Amz-Date es obligatorio. Cuando X-Amz-Date se usa, siempre anula el valor del encabezado de fecha. Para obtener más información, consulte [Elementos de la firma de una solicitud de AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html) en la Guía del *usuario de IAM*. Tipo: cadena Obligatorio: condicional **X-Amz-Security-Token** El token de seguridad temporal que se obtuvo mediante una llamada a AWS Security Token Service (AWS STS). Para obtener una lista de servicios compatibles con las credenciales de seguridad temporales de AWS STS, consulte [Servicios de AWS que funcionan con IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) en la *Guía del usuario de IAM*. Condición: si utilizas credenciales de seguridad temporales de AWS STS, debes incluir el token de seguridad. Tipo: cadena Obligatorio: condicional **X-Amz-Signature** Especifica la firma codificada hexadecimal que se calculó a partir de la cadena que se va a firmar y la clave de firma derivada. Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP. Tipo: cadena Obligatorio: condicional **X-Amz-SignedHeaders** Especifica todos los encabezados HTTP que se incluyeron como parte de la solicitud canónica. Para obtener más información sobre cómo especificar encabezados firmados, consulte [Crear una solicitud de AWS API firmada](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html) en la Guía del *usuario de IAM*. Condición: especifique este parámetro cuando incluya información de autenticación en una cadena de consulta en lugar de en el encabezado de autorización HTTP. Tipo: cadena Obligatorio: condicional # Tipos de errores comunes En esta sección se enumeran los tipos de errores más comunes que puede devolver este AWS servicio. No todos los servicios devuelven todos los tipos de errores que se indican aquí. En el caso de los errores específicos de una acción de la API de este servicio, consulte el tema de dicha acción de la API. **AccessDeniedException** No tiene permiso para realizar esta acción. Compruebe que su política de IAM incluya los permisos necesarios. Código de estado HTTP: 403 **ExpiredTokenException** El token de seguridad incluido en la solicitud ha caducado. Solicita un nuevo token de seguridad e inténtalo de nuevo. Código de estado HTTP: 403 **IncompleteSignature** La firma de la solicitud no cumple con los AWS estándares. Comprueba que utilizas AWS credenciales válidas y que tu solicitud tiene el formato correcto. Si utilizas un SDK, asegúrate de que esté actualizado. Código de estado HTTP: 403 **InternalFailure** La solicitud no se puede procesar en este momento debido a un problema interno del servidor. Inténtelo de nuevo más tarde. Si el problema persiste, ponte en contacto con AWS Support. Código de estado HTTP: 500 **MalformedHttpRequestException** No se puede procesar el cuerpo de la solicitud. Esto suele ocurrir cuando el cuerpo de la solicitud no se puede descomprimir mediante el algoritmo de codificación de contenido especificado. Compruebe que el encabezado de codificación del contenido coincide con el formato de compresión utilizado. Código de estado HTTP: 400 **NotAuthorized** No tienes permisos para realizar esta acción. Compruebe que su política de IAM incluya los permisos necesarios. Código de estado HTTP: 401 **OptInRequired** Tu AWS cuenta necesita una suscripción a este servicio. Comprueba que has activado el servicio en tu cuenta. Código de estado HTTP: 403 **RequestAbortedException** La solicitud se canceló antes de que se pudiera devolver una respuesta. Esto suele ocurrir cuando el cliente cierra la conexión. Código de estado HTTP: 400 **RequestEntityTooLargeException** La entidad de solicitud es demasiado grande. Reduce el tamaño del cuerpo de la solicitud e inténtalo de nuevo. Código de estado HTTP: 413 **RequestTimeoutException** Se agotó el tiempo de espera de la solicitud. El servidor no recibió la solicitud completa en el plazo previsto. Inténtelo de nuevo. Código de estado HTTP: 408 **ServiceUnavailable** El servicio no está disponible temporalmente. Inténtelo de nuevo más tarde. Código de estado HTTP: 503 **ThrottlingException** Tu porcentaje de solicitudes es demasiado alto. Reintentan AWS SDKs automáticamente las solicitudes que reciben esta excepción. Reduzca la frecuencia de las solicitudes. Código de estado HTTP: 400 **UnknownOperationException** No se reconoce la acción o la operación. Comprueba que el nombre de la acción está escrito correctamente y que es compatible con la versión de API que utilizas. Código de estado HTTP: 404 **UnrecognizedClientException** El identificador de clave de AWS acceso o certificado X.509 que has proporcionado no existe en nuestros registros. Compruebe que utiliza credenciales válidas y que no hayan caducado. Código de estado HTTP: 403 **ValidationError** La entrada no cumple con el formato o las restricciones requeridos. Compruebe que se incluyen todos los parámetros necesarios y que los valores son válidos. Código de estado HTTP: 400 # Llamar a la API mediante solicitudes de consulta HTTP Esta sección contiene información general sobre el uso de la API de consultas para la administración de AWS cuentas. Para obtener más información acerca de las operaciones y los errores de la API, consulte la [referencia de la API](api-reference.md). **nota** En lugar de realizar llamadas directas a la API de consultas de administración de AWS cuentas, puede utilizar una de las AWS SDKs. AWS SDKs Constan de bibliotecas y código de muestra para varios lenguajes de programación y plataformas (Java, Ruby, .NET, iOS, Android y más). SDKs Proporcionan una forma cómoda de crear un acceso programático a la administración de AWS cuentas y AWS. Por ejemplo, se SDKs encargan de tareas como firmar criptográficamente las solicitudes, gestionar los errores y volver a intentar las solicitudes automáticamente. Para obtener información sobre AWS SDKs, incluido cómo descargarlos e instalarlos, consulte [Herramientas para Amazon Web Services](https://aws.amazon.com/tools). Con la API de Query para la administración de AWS cuentas, puedes realizar acciones de servicio. Las solicitudes de la API de consulta son solicitudes HTTPS que deben contener un `Action` parámetro que indique la operación que se va a realizar. AWS La administración de cuentas admite `GET` y `POST` solicita todas las operaciones. Es decir, la API no requiere que use `GET` para algunas acciones y `POST` para otras. Sin embargo, las solicitudes `GET` están sujetas a las limitaciones de tamaño de una URL. Aunque este límite depende del navegador, suele ser de 2048 bytes. Por lo tanto, para las solicitudes de la API de consulta que requieran tamaños más grandes, debe utilizar una solicitud `POST`. La respuesta es un documento XML. Para obtener más información acerca de la respuesta, consulte las páginas de cada acción en la [referencia de la API](api-reference.md). **Topics** + [Puntos de conexión](#endpoints) + [HTTPS obligatorio](#IAMHTTPSRequired) + [Firmar las solicitudes de AWS la API de administración de cuentas](#SigVersion) ## Puntos de conexión AWS Account Management tiene un único punto final de API global que está alojado en el este de EE. UU. (Virginia del Norte) Región de AWS. Para obtener más información sobre AWS los puntos de enlace y las regiones de todos los servicios, consulte [Regiones y puntos de enlace](https://docs.aws.amazon.com/general/latest/gr/rande.html) en el. *Referencia general de AWS* ## HTTPS obligatorio Dado que la API de consulta puede devolver información confidencial como, por ejemplo, credenciales de seguridad, debe usar HTTPS para cifrar todas las solicitudes de la API. ## Firmar las solicitudes de AWS la API de administración de cuentas Las solicitudes deben firmarse con un ID de clave de acceso y una clave de acceso secreta. Te recomendamos encarecidamente que no utilices las credenciales de tu cuenta AWS raíz para el trabajo diario con la administración de AWS cuentas. Puedes usar las credenciales de un usuario AWS Identity and Access Management (de IAM) o credenciales temporales, como las que utilizas con un rol de IAM. Para firmar tus solicitudes de API, debes usar la versión 4 de AWS Signature. Para obtener información sobre el uso de la versión 4 de Signature, consulte [Firmar las solicitudes de AWS API](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html) en la *Guía del usuario de IAM*. Para obtener más información, consulte los siguientes temas: + [Credenciales de seguridad de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/security-creds.html): ofrece información general acerca de los tipos de credenciales que puede utilizar para acceder a  AWS. + [Prácticas recomendadas de seguridad en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html): ofrece sugerencias para usar el servicio de IAM para ayudar a proteger sus AWS recursos, incluidos los de la administración de AWS cuentas. + [Credenciales temporales de seguridad en IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html): describe cómo crear y utilizar las credenciales temporales de seguridad.