Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
GetGovCloudAccountInformation
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
POST /getGovCloudAccountInformation HTTP/1.1
Content-type: application/json
{
"StandardAccountId": "string"
}Parameter Permintaan URI
Permintaan tidak menggunakan parameter URI apa pun.
Isi Permintaan
Permintaan menerima data berikut dalam format JSON.
- StandardAccountId
-
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 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 akses tepercaya untuk layanan Manajemen Akun, dan secara opsional akun administrator yang didelegasikan ditetapkan.
catatan
Akun manajemen tidak dapat menentukan sendiri
AccountId; itu harus memanggil operasi dalam konteks mandiri dengan tidak menyertakanAccountIdparameter.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
HTTP/1.1 200
Content-type: application/json
{
"AccountState": "string",
"GovCloudAccountId": "string"
}Elemen Respons
Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200.
Layanan mengembalikan data berikut dalam format JSON.
- AccountState
-
Status akun dari GovCloud akun yang ditautkan.
Tipe: String
Nilai yang Valid:
PENDING_ACTIVATION | ACTIVE | SUSPENDED | CLOSED - GovCloudAccountId
-
Nomor ID akun 12 digit dari GovCloud akun yang ditautkan.
Tipe: String
Pola:
\d{12}
Kesalahan
Untuk informasi tentang kesalahan yang umum untuk semua tindakan, lihat Kesalahan Umum.
- AccessDeniedException
-
Operasi gagal karena identitas panggilan tidak memiliki izin minimum yang diperlukan.
- errorType
-
Nilai diisi ke header
x-amzn-ErrorTyperespons 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-ErrorTyperespons 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-ErrorTyperespons 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-ErrorTyperespons 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-ErrorTyperespons 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
Contoh 1
Contoh berikut mengambil informasi GovCloud akun tertaut untuk akun yang kredensialnya digunakan untuk memanggil operasi.
Permintaan Sampel
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
{}Contoh Respons
HTTP/1.1 200 OK
Content-Type: application/json
{
"GovCloudAccountId": "123456789012",
"AccountState": "ACTIVE"
}Contoh 2
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
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
{
"StandardAccountId": "111111111111"
}Contoh Respons
HTTP/1.1 200 OK
Content-Type: application/json
{
"GovCloudAccountId": "123456789012",
"AccountState": "ACTIVE"
}Contoh 3
Contoh berikut mencoba untuk mengambil informasi GovCloud akun tertaut untuk akun standar yang tidak ditautkan ke GovCloud akun.
Permintaan Sampel
POST / HTTP/1.1
X-Amz-Target: AWSAccountV20210201.GetGovCloudAccountInformation
{
"StandardAccountId": "222222222222"
}Contoh Respons
HTTP/1.1 404
Content-Type: application/json
{
"message":"GovCloud Account ID not found for Standard Account - 222222222222."
}Lihat Juga
Untuk informasi selengkapnya tentang penggunaan API ini di salah satu bahasa khusus AWS SDKs, lihat berikut ini:
