Gunakan DescribeDnsProductInstances untuk mengkueri instans produk DNS berbayar - Alibaba Cloud DNS - Alibaba Cloud - Alibaba Cloud DNS

Mengambil daftar instance produk DNS berbayar yang sesuai dengan parameter yang ditentukan.

Deskripsi operasi

Catatan

Jika respons tidak mengandung nama domain, instance Alibaba Cloud DNS tidak terkait dengan nama domain apa pun.

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

alidns:DescribeDnsProductInstances

get

*Instance

acs:alidns:*:{#accountId}:instance/*

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Lang	string	No	Bahasa respons. Nilai yang valid: zh: Mandarin en: Inggris Nilai default: en	en
UserClientIp	string	No	Alamat IP klien.	192.0.2.0
PageNumber	integer	No	Nomor halaman. Halaman dimulai dari 1. Nilai default: 1.	1
PageSize	integer	No	Jumlah entri yang dikembalikan pada setiap halaman. Nilai maksimum: 100. Nilai default: 20.	20
VersionCode	string	No	Kode edisi instance Alibaba Cloud DNS.	version1
DomainType	string	No	Tipe nama domain. Parameter ini tidak peka huruf besar/kecil. Nilai yang valid: PUBLIC: nama domain otoritatif (default) CACHE: nama domain proksi otoritatif	PUBLIC
OrderBy	string	No	Field yang digunakan untuk mengurutkan hasil. Nilai yang valid: createDate: Mengurutkan hasil berdasarkan waktu pembuatan. Ini adalah nilai default. expireDate: Mengurutkan hasil berdasarkan waktu kedaluwarsa.	createDate
Direction	string	No	Urutan pengurutan. Nilai yang valid: DESC: Urutan menurun. Ini adalah nilai default. ASC: Urutan menaik.	DESC

Elemen respons

Element	Type	Description	Example
	object
TotalCount	integer	Jumlah total instance yang sesuai dengan kueri.	2
DomainType	string	Tipe nama domain. Nilai yang valid: PUBLIC: nama domain otoritatif (default) CACHE: nama domain proksi otoritatif	PUBLIC
PageSize	integer	Jumlah entri pada halaman saat ini.	2
RequestId	string	ID permintaan.	536E9CAD-DB30-4647-AC87-AA5CC38xxxxx
PageNumber	integer	Nomor halaman.	1
DnsProducts	object
DnsProduct	array<object>	Daftar instance Alibaba Cloud DNS.
	object
OverseaLine	string	The DNS resolution line for regions outside mainland China.	海外大洲
PaymentType	string	The billing method.	Subscription
MonitorNodeCount	integer	The number of monitoring nodes.	5
InBlackHole	boolean	Indicates whether the domain name is in a blackhole filtering state. true: The domain name is in a blackhole filtering state. false: The domain name is not in a blackhole filtering state.	false
BindDomainUsedCount	integer	The number of domain names that are associated with the instance. This parameter applies to the Personal and Ultimate editions.	3
ISPRegionLines	string	The ISP resolution lines by province. China Telecom (province) China Mobile (province) China Unicom (province) China Education and Research Network (province)	电信_浙江
TTLMinValue	integer	The minimum time to live (TTL) value, in seconds.	10
ISPLines	string	The ISP resolution lines. China Telecom China Mobile China Unicom China Education and Research Network China Broadcasting Network Dr. Peng	中国电信
SearchEngineLines	string	The search engine resolution lines. Google Baidu Bing Youdao	谷歌
EndTimestamp	integer	The expiration time of the instance, as a UNIX timestamp.	1474335170000
VersionName	string	The edition name of the Alibaba Cloud DNS instance.	企业旗舰版
VersionCode	string	The edition code of the Alibaba Cloud DNS instance.	version1
MonitorTaskCount	integer	The number of monitoring jobs.	2
BindUsedCount	integer	The number of times the domain name has been changed for the instance. This parameter applies to the Custom Edition.	1
Domain	string	The associated domain name.	example.com
MonitorFrequency	integer	The monitoring frequency, in minutes.	50
InClean	boolean	Indicates whether the domain name is in a traffic scrubbing state.	false
URLForwardCount	integer	The number of URL forwarding rules.	20
StartTimestamp	integer	The purchase time of the instance, as a UNIX timestamp.	1474335170000
DDosDefendQuery	integer	The DDoS protection capacity in queries per second (QPS). The value is in units of 10,000. This parameter applies to the Custom Edition.	50
InstanceId	string	The instance ID.	i-8fj
DDosDefendFlow	integer	The DDoS protection bandwidth, in GB.	50
BindCount	integer	The number of times the domain name can be changed for the instance. This parameter applies to the Custom Edition.	3
SubDomainLevel	integer	The number of supported subdomain levels.	6
BindDomainCount	integer	The number of domain names that can be associated with the instance. This parameter applies to the Personal and Ultimate editions.	5
EndTime	string	The expiration time of the instance.	2015-12-12T00:00Z
StartTime	string	The purchase time of the instance.	2015-11-12T09:23Z
OverseaDDosDefendFlow	integer	The DDoS protection bandwidth for traffic from outside mainland China, in GB.	1
RegionLines	boolean	Indicates whether regional resolution lines are supported. true: Regional resolution lines are supported. false: Regional resolution lines are not supported.	true
Gslb	boolean	Indicates whether Global Server Load Balancing (GSLB) is supported. true: GSLB is supported. false: GSLB is not supported.	true
DnsSecurity	string	The DNS security level. Valid values: no: not required basic: basic DNS attack protection advanced: advanced DNS attack protection	no
DnsSLBCount	integer	The Server Load Balancer (SLB) capacity. This is the number of IP addresses that can be configured for a single domain name on a single resolution line.	15
AutoRenewal	boolean	The auto-renewal status. true: Auto-renewal is enabled. false: Auto-renewal is disabled.	true

Contoh

Respons sukses

JSONformat

{
  "TotalCount": 2,
  "DomainType": "PUBLIC",
  "PageSize": 2,
  "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38xxxxx",
  "PageNumber": 1,
  "DnsProducts": {
    "DnsProduct": [
      {
        "OverseaLine": "海外大洲",
        "PaymentType": "Subscription",
        "MonitorNodeCount": 5,
        "InBlackHole": false,
        "BindDomainUsedCount": 3,
        "ISPRegionLines": "电信_浙江",
        "TTLMinValue": 10,
        "ISPLines": "中国电信",
        "SearchEngineLines": "谷歌",
        "EndTimestamp": 1474335170000,
        "VersionName": "企业旗舰版",
        "VersionCode": "version1",
        "MonitorTaskCount": 2,
        "BindUsedCount": 1,
        "Domain": "example.com",
        "MonitorFrequency": 50,
        "InClean": false,
        "URLForwardCount": 20,
        "StartTimestamp": 1474335170000,
        "DDosDefendQuery": 50,
        "InstanceId": "i-8fj",
        "DDosDefendFlow": 50,
        "BindCount": 3,
        "SubDomainLevel": 6,
        "BindDomainCount": 5,
        "EndTime": "2015-12-12T00:00Z",
        "StartTime": "2015-11-12T09:23Z",
        "OverseaDDosDefendFlow": 1,
        "RegionLines": true,
        "Gslb": true,
        "DnsSecurity": "no",
        "DnsSLBCount": 15,
        "AutoRenewal": true
      }
    ]
  }
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.