Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

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

Mengambil informasi tentang GovCloud akun yang ditautkan ke akun standar yang ditentukan (jika ada) termasuk ID GovCloud akun dan status. Untuk menggunakan API ini, pengguna atau peran IAM harus memiliki izin `account:GetGovCloudAccountInformation` IAM. 

## Minta Sintaks
<a name="API_GetGovCloudAccountInformation_RequestSyntax"></a>

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

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

## Parameter Permintaan URI
<a name="API_GetGovCloudAccountInformation_RequestParameters"></a>

Permintaan tidak menggunakan parameter URI apa pun.

## Isi Permintaan
<a name="API_GetGovCloudAccountInformation_RequestBody"></a>

Permintaan menerima data berikut dalam format JSON.

 ** [StandardAccountId](#API_GetGovCloudAccountInformation_RequestSyntax) **   <a name="accounts-GetGovCloudAccountInformation-request-StandardAccountId"></a>
Menentukan 12 digit nomor ID akun AWS akun yang ingin Anda akses atau modifikasi dengan operasi ini.  
Jika Anda tidak menentukan parameter ini, itu default ke AWS akun identitas yang digunakan untuk memanggil operasi.  
Untuk menggunakan parameter ini, pemanggil harus berupa identitas di [akun manajemen organisasi atau akun](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#account) administrator yang didelegasikan, dan ID akun yang ditentukan harus berupa akun anggota di organisasi yang sama. Organisasi harus mengaktifkan [semua fitur, dan organisasi harus mengaktifkan](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_manage_org_support-all-features.html) [akses tepercaya](https://docs.aws.amazon.com/organizations/latest/userguide/services-that-can-integrate-account.html) untuk layanan Manajemen Akun, dan secara opsional akun [administrator yang didelegasikan](https://docs.aws.amazon.com/organizations/latest/userguide/orgs_getting-started_concepts.html#delegated-admin) ditetapkan.  
Akun manajemen tidak dapat menentukan sendiri`AccountId`; itu harus memanggil operasi dalam konteks mandiri dengan tidak menyertakan `AccountId` parameter.
Untuk memanggil operasi ini pada akun yang bukan anggota organisasi, maka jangan tentukan parameter ini, dan panggil operasi menggunakan identitas milik akun yang kontaknya ingin Anda ambil atau ubah.  
Tipe: String  
Pola: `\d{12}`   
Diperlukan: Tidak

## Sintaksis Respons
<a name="API_GetGovCloudAccountInformation_ResponseSyntax"></a>

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

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

## Elemen Respons
<a name="API_GetGovCloudAccountInformation_ResponseElements"></a>

Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.

Layanan mengembalikan data berikut dalam format JSON.

 ** [AccountState](#API_GetGovCloudAccountInformation_ResponseSyntax) **   <a name="accounts-GetGovCloudAccountInformation-response-AccountState"></a>
Status akun dari GovCloud akun yang ditautkan.  
Tipe: String  
Nilai yang Valid: `PENDING_ACTIVATION | ACTIVE | SUSPENDED | CLOSED` 

 ** [GovCloudAccountId](#API_GetGovCloudAccountInformation_ResponseSyntax) **   <a name="accounts-GetGovCloudAccountInformation-response-GovCloudAccountId"></a>
Nomor ID akun 12 digit dari GovCloud akun yang ditautkan.  
Tipe: String  
Pola: `\d{12}` 

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

Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat [Jenis Kesalahan Umum](CommonErrors.md).

 ** AccessDeniedException **   
Operasi gagal karena identitas panggilan tidak memiliki izin minimum yang diperlukan.    
 ** errorType **   
Nilai diisi ke header `x-amzn-ErrorType` respons oleh API Gateway.
Kode Status HTTP: 403

 ** InternalServerException **   
Operasi gagal karena kesalahan internal ke AWS. Coba operasi Anda lagi nanti.    
 ** errorType **   
Nilai diisi ke header `x-amzn-ErrorType` respons oleh API Gateway.
Kode Status HTTP: 500

 ** ResourceNotFoundException **   
Operasi gagal karena menentukan sumber daya yang tidak dapat ditemukan.    
 ** errorType **   
Nilai diisi ke header `x-amzn-ErrorType` respons oleh API Gateway.
Kode Status HTTP: 404

 ** ResourceUnavailableException **   
Operasi gagal karena ditentukan sumber daya yang saat ini tidak tersedia.    
 ** errorType **   
Nilai diisi ke header `x-amzn-ErrorType` respons oleh API Gateway.
Kode Status HTTP: 424

 ** TooManyRequestsException **   
Operasi gagal karena dipanggil terlalu sering dan melebihi batas throttle.    
 ** errorType **   
Nilai diisi ke header `x-amzn-ErrorType` respons oleh API Gateway.
Kode Status HTTP: 429

 ** ValidationException **   
Operasi gagal karena salah satu parameter input tidak valid.    
 ** fieldList **   
Bidang tempat entri yang tidak valid terdeteksi.  
 ** message **   
Pesan yang memberi tahu Anda tentang apa yang tidak valid tentang permintaan tersebut.  
 ** reason **   
Alasan mengapa validasi gagal.
Kode Status HTTP: 400

## Contoh
<a name="API_GetGovCloudAccountInformation_Examples"></a>

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

Contoh berikut mengambil informasi GovCloud akun tertaut untuk akun yang kredensialnya digunakan untuk memanggil operasi. 

#### Permintaan Sampel
<a name="API_GetGovCloudAccountInformation_Example_1_Request"></a>

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

#### Contoh Respons
<a name="API_GetGovCloudAccountInformation_Example_1_Response"></a>

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

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

Contoh berikut mengambil informasi GovCloud akun tertaut untuk akun anggota yang ditentukan dalam suatu organisasi. Anda harus menggunakan kredensi dari akun manajemen organisasi atau dari akun admin yang didelegasikan oleh layanan Manajemen Akun. 

#### Permintaan Sampel
<a name="API_GetGovCloudAccountInformation_Example_2_Request"></a>

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

#### Contoh Respons
<a name="API_GetGovCloudAccountInformation_Example_2_Response"></a>

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

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

Contoh berikut mencoba untuk mengambil informasi GovCloud akun tertaut untuk akun standar yang tidak ditautkan ke GovCloud akun. 

#### Permintaan Sampel
<a name="API_GetGovCloudAccountInformation_Example_3_Request"></a>

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

#### Contoh Respons
<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."
}
```

## Lihat Juga
<a name="API_GetGovCloudAccountInformation_SeeAlso"></a>

Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
+  [AWS Antarmuka Baris Perintah V2](https://docs.aws.amazon.com/goto/cli2/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK untuk V3 JavaScript ](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 for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/GetGovCloudAccountInformation) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/GetGovCloudAccountInformation)