Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # ListRegions Daftar semua Wilayah untuk akun tertentu dan status keikutsertaannya masing-masing. Secara opsional, daftar ini dapat difilter oleh `region-opt-status-contains` parameter. ## Minta Sintaks ``` POST /listRegions HTTP/1.1 Content-type: application/json { "AccountId": "string", "MaxResults": number, "NextToken": "string", "RegionOptStatusContains": [ "string" ] } ``` ## Parameter Permintaan URI Permintaan tidak menggunakan parameter URI apa pun. ## Isi Permintaan Permintaan menerima data berikut dalam format JSON. ** [AccountId](#API_ListRegions_RequestSyntax) ** Menentukan 12 digit nomor ID akun Akun AWS yang ingin Anda akses atau modifikasi dengan operasi ini. Jika Anda tidak menentukan parameter ini, parameter ini default ke akun Amazon Web Services dari 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. 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/orgs_integrate_services.html) untuk layanan Manajemen Akun, dan secara opsional akun [admin 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`. Ini harus memanggil operasi dalam konteks mandiri dengan tidak menyertakan `AccountId` parameter. Untuk memanggil operasi ini pada akun yang bukan anggota organisasi, jangan tentukan parameter ini. Sebagai gantinya, panggil operasi menggunakan identitas milik akun yang kontaknya ingin Anda ambil atau modifikasi. Tipe: String Pola: `\d{12}` Wajib: Tidak ** [MaxResults](#API_ListRegions_RequestSyntax) ** Jumlah total item yang akan dikembalikan dalam output perintah. Jika jumlah total item yang tersedia lebih dari nilai yang ditentukan, a `NextToken` disediakan dalam output perintah. Untuk melanjutkan pemberian nomor halaman, berikan nilai `NextToken` dalam argumen `starting-token` dari perintah berikutnya. Jangan gunakan elemen `NextToken` respons langsung di luar AWS CLI. Untuk contoh penggunaan, lihat [Pagination](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html) di *Panduan Pengguna Antarmuka Baris AWS Perintah*. Tipe: Bilangan Bulat Rentang yang Valid: Nilai minimum 1. Nilai maksimum 50. Wajib: Tidak ** [NextToken](#API_ListRegions_RequestSyntax) ** Token yang digunakan untuk menentukan di mana harus memulai paginating. Ini adalah `NextToken` dari respons yang sebelumnya terpotong. Untuk contoh penggunaan, lihat [Pagination](https://docs.aws.amazon.com/cli/latest/userguide/pagination.html) di *Panduan Pengguna Antarmuka Baris AWS Perintah*. Tipe: String Batasan Panjang: Panjang minimum sebesar 0. Panjang maksimum sebesar 1000. Wajib: Tidak ** [RegionOptStatusContains](#API_ListRegions_RequestSyntax) ** Daftar status Region (Mengaktifkan, Diaktifkan, Menonaktifkan, Dinonaktifkan, Enabled\$1BY\$1DEFAULT) untuk digunakan untuk memfilter daftar Wilayah untuk akun tertentu. Misalnya, meneruskan nilai ENABLING hanya akan mengembalikan daftar Wilayah dengan status Region ENABLING. Tipe: Array string Nilai yang Valid: `ENABLED | ENABLING | DISABLING | DISABLED | ENABLED_BY_DEFAULT` Wajib: Tidak ## Sintaksis Respons ``` HTTP/1.1 200 Content-type: application/json { "NextToken": "string", "Regions": [ { "RegionName": "string", "RegionOptStatus": "string" } ] } ``` ## Elemen Respons Jika tindakan berhasil, layanan mengirimkan kembali respons HTTP 200. Layanan mengembalikan data berikut dalam format JSON. ** [NextToken](#API_ListRegions_ResponseSyntax) ** Jika ada lebih banyak data yang akan dikembalikan, ini akan diisi. Itu harus diteruskan ke parameter `next-token` permintaan`list-regions`. Tipe: String ** [Regions](#API_ListRegions_ResponseSyntax) ** Ini adalah daftar Wilayah untuk akun tertentu, atau jika parameter yang difilter digunakan, daftar Wilayah yang cocok dengan kriteria filter yang ditetapkan dalam `filter` parameter. Tipe: Array objek [Region](API_Region.md) ## Kesalahan 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 ** 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 validasi gagal. Kode Status HTTP: 400 ## Lihat Juga 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/ListRegions) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/account-2021-02-01/ListRegions) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/account-2021-02-01/ListRegions) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/account-2021-02-01/ListRegions) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/account-2021-02-01/ListRegions) + [AWS SDK untuk V3 JavaScript ](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 for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/account-2021-02-01/ListRegions) + [AWS SDK untuk Python](https://docs.aws.amazon.com/goto/boto3/account-2021-02-01/ListRegions) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/account-2021-02-01/ListRegions)