ListRegions - AWS Pengelolaan Akun
Sintaks PermintaanURIParameter PermintaanIsi PermintaanSintaksis ResponsElemen ResponsKesalahanLihat Juga

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.

Sintaks Permintaan

POST /listRegions HTTP/1.1
Content-type: application/json

{
   "AccountId": "string",
   "MaxResults": number,
   "NextToken": "string",
   "RegionOptStatusContains": [ "string" ]
}

URIParameter Permintaan

Permintaan tidak menggunakan URI parameter apa pun.

Isi Permintaan

Permintaan menerima data berikut dalam JSON format.

AccountId

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 administrator yang didelegasikan. 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 admin yang didelegasikan ditetapkan.

catatan

Akun manajemen tidak dapat menentukan sendiriAccountId. 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

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 di AWS Panduan Pengguna Antarmuka Baris Perintah.

Jenis: Integer

Rentang yang Valid: Nilai minimum 1. Nilai maksimum 50.

Wajib: Tidak

NextToken

Token yang digunakan untuk menentukan di mana harus memulai paginating. Ini adalah NextToken dari respons yang sebelumnya terpotong. Untuk contoh penggunaan, lihat Pagination di AWS Panduan Pengguna Antarmuka Baris Perintah.

Tipe: String

Batasan Panjang: Panjang minimum sebesar 0. Panjang maksimum sebesar 1000.

Wajib: Tidak

RegionOptStatusContains

Daftar status Region (Mengaktifkan, Diaktifkan, Menonaktifkan, Dinonaktifkan, Enabled_BY_DEFAULT) untuk digunakan untuk memfilter daftar Wilayah untuk akun tertentu. Misalnya, meneruskan nilai hanya ENABLING akan mengembalikan daftar Wilayah dengan status RegionENABLING.

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.

Data berikut dikembalikan dalam JSON format oleh layanan.

NextToken

Jika ada lebih banyak data yang akan dikembalikan, ini akan diisi. Itu harus diteruskan ke parameter next-token permintaanlist-regions.

Tipe: String

Regions

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

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.

HTTPKode Status: 403

InternalServerException

Operasi gagal karena kesalahan internal AWS. Coba operasi Anda lagi nanti.

HTTPKode Status: 500

TooManyRequestsException

Operasi gagal karena dipanggil terlalu sering dan melebihi batas throttle.

HTTPKode Status: 429

ValidationException

Operasi gagal karena salah satu parameter input tidak valid.

HTTPKode Status: 400

Lihat Juga

Untuk informasi lebih lanjut tentang menggunakan ini API di salah satu bahasa khusus AWS SDKs, lihat yang berikut ini: