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.

# GetGovCloudAccountInformation
<a name="API_GetGovCloudAccountInformation"></a>

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
<a name="API_GetGovCloudAccountInformation_RequestSyntax"></a>

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

{
   "StandardAccountId": "string"
}
```

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

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

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

La solicitud acepta los siguientes datos en formato JSON.

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

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

```
HTTP/1.1 200
Content-type: application/json

{
   "AccountState": "string",
   "GovCloudAccountId": "string"
}
```

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

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) **   <a name="accounts-GetGovCloudAccountInformation-response-AccountState"></a>
El estado de la GovCloud cuenta vinculada.  
Tipo: cadena  
Valores válidos: `PENDING_ACTIVATION | ACTIVE | SUSPENDED | CLOSED` 

 ** [GovCloudAccountId](#API_GetGovCloudAccountInformation_ResponseSyntax) **   <a name="accounts-GetGovCloudAccountInformation-response-GovCloudAccountId"></a>
El número de identificación de cuenta de 12 dígitos de la GovCloud cuenta vinculada.  
Tipo: cadena  
Patrón: `\d{12}` 

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

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

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

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

 ** 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
<a name="API_GetGovCloudAccountInformation_Examples"></a>

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

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
<a name="API_GetGovCloudAccountInformation_Example_1_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
                    
{}
```

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

```
HTTP/1.1 200 OK
Content-Type: application/json
                    
{
   "GovCloudAccountId": "123456789012",
   "AccountState": "ACTIVE"
}
```

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

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
<a name="API_GetGovCloudAccountInformation_Example_2_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
                    
{
   "StandardAccountId": "111111111111" 
}
```

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

```
HTTP/1.1 200 OK
Content-Type: application/json
                    
{
   "GovCloudAccountId": "123456789012",
   "AccountState": "ACTIVE"
}
```

### Ejemplo 3
<a name="API_GetGovCloudAccountInformation_Example_3"></a>

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
<a name="API_GetGovCloudAccountInformation_Example_3_Request"></a>

```
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
                    
{
   "StandardAccountId": "222222222222" 
}
```

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

```
HTTP/1.1 404
Content-Type: application/json
                    
{
   "message":"GovCloud Account ID not found for Standard Account - 222222222222."
}
```

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

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)