DescribeInstances - Anti-DDoS

Menanyakan detail instans Anti-DDoS Proxy.

Deskripsi operasi

Operasi ini memungkinkan Anda menanyakan detail instans Anti-DDoS yang terkait dengan Akun Alibaba Cloud Anda secara berhalaman. Detail tersebut mencakup ID instans, versi, waktu kedaluwarsa, dan status penerusan lalu lintas layanan.

Batas QPS

Batas QPS untuk operasi ini adalah 10 per detik per pengguna. Jika jumlah panggilan melebihi batas tersebut, pembatasan kecepatan akan diterapkan dan dapat memengaruhi bisnis Anda. Oleh karena itu, pastikan Anda memanggil operasi ini dengan laju yang sesuai.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

yundun-ddoscoo:DescribeInstances

get

*All Resource

*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ResourceGroupId	string	No	ID kelompok sumber daya tempat instans Anti-DDoS Proxy berada di Resource Management. Jika Anda tidak menentukan parameter ini, kelompok sumber daya default akan digunakan.	rg-acfm2pz25js****
PageNumber	string	Yes	Nomor halaman. Halaman dimulai dari halaman 1.	1
PageSize	string	Yes	Jumlah entri per halaman. Nilai yang valid: 1 hingga 50.	10
Ip	string	No	Alamat IP instans Anti-DDoS yang ingin Anda tanyakan.	203.107.XX.XX
Remark	string	No	Keterangan instans Anti-DDoS Proxy yang ingin Anda tanyakan. Pencocokan fuzzy didukung.	doc-test
Edition	integer	No	Edisi instans Anti-DDoS Proxy yang ingin Anda tanyakan. Nilai yang valid: 0: Asuransi Proxy Anti-DDoS (Luar Daratan Tiongkok). 1: Anti-DDoS Proxy (Luar Daratan Tiongkok) Tanpa Batas. 2: Anti-DDoS Proxy (Luar Daratan Tiongkok) CMA. 9: Anti-DDoS Proxy (Tiongkok Daratan) Edisi Profesional.	9
Enabled	integer	No	Status penerusan lalu lintas layanan instans Anti-DDoS yang ingin Anda tanyakan. Nilai yang valid: 0: Penerusan lalu lintas layanan dihentikan. 1: Lalu lintas layanan sedang diteruskan secara normal.	1
ExpireStartTime	integer	No	Waktu kedaluwarsa paling awal instans Anti-DDoS yang ingin Anda tanyakan. Parameter ini digunakan untuk menanyakan instans Anti-DDoS Proxy yang kedaluwarsa setelah waktu yang ditentukan oleh ExpireStartTime. Nilainya berupa timestamp dalam milidetik.	1640361500000
ExpireEndTime	integer	No	Waktu kedaluwarsa paling akhir instans Anti-DDoS Proxy yang ingin Anda tanyakan. Parameter ini digunakan untuk menanyakan instans Anti-DDoS Proxy yang kedaluwarsa sebelum waktu yang ditentukan oleh ExpireEndTime. Nilainya berupa timestamp dalam milidetik.	1640361700000
InstanceIds	array	No	Daftar ID instans Anti-DDoS Proxy yang ingin Anda tanyakan. Anda dapat menentukan hingga 200 instans Anti-DDoS Proxy.
	string	No	ID instans Anti-DDoS Proxy yang ingin Anda tanyakan.	ddoscoo-cn-7pp2g9ed****
Status	array	No	Daftar status instans Anti-DDoS Proxy yang ingin Anda tanyakan. Anda dapat menentukan hingga dua status.
	integer	No	Status instans Anti-DDoS Proxy yang ingin Anda tanyakan. Nilai yang valid: 1: Normal. 2: Kedaluwarsa.	1
Tag	array<object>	No	Daftar tag yang dilampirkan pada instans Anti-DDoS Proxy yang ingin Anda tanyakan.
	object	No
Key	string	No	Kunci tag yang dilampirkan pada instans Anti-DDoS Proxy yang ingin Anda tanyakan. Nilai maksimum N adalah 200. Artinya, Anda dapat menentukan hingga 200 kunci tag. Aturan konfigurasinya sebagai berikut: Setiap tag terdiri atas kunci tag (Key) dan nilai tag (Value), dipisahkan oleh koma (,). Tag dipisahkan oleh koma (,). Catatan Kunci tag (Key) dan nilai tag (Value) harus muncul berpasangan.	test-key
Value	string	No	Nilai tag yang dilampirkan pada instans Anti-DDoS Proxy yang ingin Anda tanyakan. Nilai maksimum N adalah 200. Artinya, Anda dapat menentukan hingga 200 nilai tag. Aturan konfigurasinya sebagai berikut: Setiap tag terdiri atas kunci tag (Key) dan nilai tag (Value), dipisahkan oleh koma (,). Tag dipisahkan oleh koma (,). Catatan Kunci tag (Key) dan nilai tag (Value) harus muncul berpasangan.	test-value

Saat memanggil operasi ini, selain parameter spesifik operasi ini, Anda juga harus menentukan parameter permintaan umum. Untuk informasi selengkapnya, lihat Parameter Umum.

Untuk sintaksis permintaan, lihat bagian Contoh pada topik ini.

Elemen respons

Element	Type	Description	Example
	object
TotalCount	integer	Jumlah total instans Anti-DDoS Proxy yang ditanyakan.	1
RequestId	string	ID permintaan, yang digunakan untuk melacak dan memecahkan masalah.	A0AF40CC-814A-5A86-AEAA-6F19E88B8A39
Instances	array<object>	Detail instans Anti-DDoS Proxy.
	object
Status	integer	Status instans. Nilai yang valid: 1: Normal. 2: Kedaluwarsa.	1
IpMode	string	Mode penerusan IP instans. Nilai yang valid: fnat: Versi IP server origin sama dengan versi IP client. Artinya, permintaan dari client IPv4 diteruskan ke server origin IPv4, dan permintaan dari client IPv6 diteruskan ke server origin IPv6. v6tov4: Permintaan dari client IPv6 diteruskan ke server origin IPv4.	fnat
DebtStatus	integer	Status pembayaran tertunda instans. Nilainya tetap 0, yang menunjukkan tidak ada pembayaran tertunda. Hal ini karena layanan Anti-DDoS Proxy hanya mendukung metode penagihan langganan.	0
Edition	integer	Edisi instans. Nilai yang valid: 0: Anti-DDoS Proxy (Luar Daratan Tiongkok) Asuransi. 1: Anti-DDoS Proxy (Luar Daratan Tiongkok) Tanpa Batas. 2: Anti-DDoS Proxy (Luar Daratan Tiongkok) CMA. 9: Anti-DDoS Pro (Tiongkok Daratan) Edisi Profesional.	9
IpVersion	string	Versi protokol IP instans. Nilai yang valid: Ipv4: Protokol IPv4. Ipv6: Protokol IPv6.	Ipv4
ExpireTime	integer	Waktu kedaluwarsa instans. Nilainya berupa timestamp dalam milidetik.	1640361600000
Remark	string	Keterangan instans.	doc-test
CreateTime	integer	Waktu pembuatan instans. Nilainya berupa timestamp dalam milidetik.	1637751953000
Enabled	integer	Status penerusan lalu lintas layanan instans. Nilai yang valid: 0: Penerusan lalu lintas layanan dihentikan. 1: Lalu lintas layanan sedang diteruskan secara normal.	1
InstanceId	string	ID instans.	ddoscoo-cn-7pp2g9ed****
IsFirstOpenBw	integer	Menunjukkan apakah metode penagihan bandwidth bersih yang dapat ditingkatkan berbasis percentil ke-95 telah diaktifkan untuk instans tersebut. Nilai yang valid: 0: Metode penagihan belum diaktifkan. 1: Metode penagihan telah diaktifkan.	0
IsFirstOpenQps	integer	Menunjukkan apakah metode penagihan QPS burstable berbasis percentil ke-95 telah diaktifkan untuk instans tersebut. Nilai yang valid: 0: Metode penagihan belum diaktifkan. 1: Metode penagihan telah diaktifkan.	0
Ip	string	Alamat IP instans Anti-DDoS Proxy.	203.199.XX.XX

Contoh

Respons sukses

JSONformat

{
  "TotalCount": 1,
  "RequestId": "A0AF40CC-814A-5A86-AEAA-6F19E88B8A39",
  "Instances": [
    {
      "Status": 1,
      "IpMode": "fnat",
      "DebtStatus": 0,
      "Edition": 9,
      "IpVersion": "Ipv4",
      "ExpireTime": 1640361600000,
      "Remark": "doc-test",
      "CreateTime": 1637751953000,
      "Enabled": 1,
      "InstanceId": "ddoscoo-cn-7pp2g9ed****",
      "IsFirstOpenBw": 0,
      "IsFirstOpenQps": 0,
      "Ip": "203.199.XX.XX"
    }
  ]
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.