DescribeDomainRecords -

Mengambil Rekaman DNS untuk domain root yang ditentukan berdasarkan parameter input.

Deskripsi operasi

Anda dapat menentukan nama domain (DomainName), nomor halaman (PageNumber), dan ukuran halaman (PageSize) untuk mengambil daftar Rekaman DNS.
Anda dapat menentukan kata kunci untuk rekaman host (RRKeyWord), tipe catatan (TypeKeyWord), atau nilai catatan (ValueKeyWord) guna mengkueri Rekaman DNS yang mengandung kata kunci tersebut.
Secara default, Rekaman DNS diurutkan secara menurun berdasarkan waktu penambahan.
Anda dapat menentukan ID kelompok domain (GroupId) untuk mengkueri Rekaman DNS dalam kelompok tertentu.

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:DescribeDomainRecords

get

*Domain

acs:alidns::{#accountId}:domain/{#DomainName}

None

Parameter permintaan

Parameter	Type	Required	Description	Example
Lang	string	No	Bahasa permintaan dan respons. Nilai default: zh. Nilai yang valid: zh: Bahasa Tiongkok en: Bahasa Inggris	en
DomainName	string	Yes	Nama domain. Untuk informasi selengkapnya, lihat DescribeDomains.	example.com
PageNumber	integer	No	Nomor halaman. Nilai dimulai dari 1. Nilai default: 1.	1
PageSize	integer	No	Jumlah entri yang dikembalikan pada setiap halaman untuk kueri terpaginasi. Nilai maksimum: 500. Nilai default: 20.	20
KeyWord	string	No	Kata kunci.	test
RRKeyWord	string	No	Kata kunci untuk rekaman host. Pencarian menggunakan pola pencocokan fuzzy dan tidak peka huruf besar/kecil.	www
TypeKeyWord	string	No	Kata kunci untuk tipe catatan. Pencarian menggunakan pencocokan eksak dan tidak peka huruf besar/kecil.	MX
ValueKeyWord	string	No	Kata kunci untuk nilai catatan. Pencarian menggunakan pola pencocokan fuzzy dan tidak peka huruf besar/kecil.	com
OrderBy	string	No	Metode pengurutan. Catatan diurutkan secara menurun berdasarkan waktu penambahan.	default
Direction	string	No	Arah pengurutan. Nilai yang valid: DESC, ASC. Nilai default: DESC.	DESC
SearchMode	string	No	Mode pencarian. Nilai yang valid: LIKE, EXACT, ADVANCED, dan COMBINATION. Jika Anda mengatur parameter ini ke LIKE atau EXACT, gunakan parameter KeyWord. Parameter RRKeyWord, TypeKeyWord, ValueKeyWord, Type, Line, dan Status tidak berlaku. Jika Anda mengatur parameter ini ke ADVANCED, gunakan parameter RRKeyWord, TypeKeyWord, ValueKeyWord, Type, Line, dan Status. Parameter RRKeyWord dan ValueKeyWord mendukung pencocokan fuzzy. Jika Anda mengatur parameter ini ke COMBINATION, gunakan parameter RRKeyWord, TypeKeyWord, ValueKeyWord, Type, Line, dan Status. Semua parameter ini hanya mendukung pencocokan eksak. Jika Anda tidak menentukan parameter ini: Jika Anda menentukan parameter keyWord, mode pencarian diatur ke LIKE. Jika Anda tidak menentukan parameter keyWord, RRKeyWord dan ValueKeyWord mendukung pencocokan fuzzy, sedangkan TypeKeyWord, Type, Line, dan Status mendukung pencocokan eksak.	LIKE
GroupId	integer	No	ID kelompok domain. Jika Anda tidak menentukan GroupId, kueri dilakukan pada semua nama domain. Jika Anda mengatur GroupId ke 0, hasil kosong dikembalikan. Jika Anda mengatur GroupId ke -1, kueri dilakukan pada kelompok default. Kelompok default mencakup nama domain yang tidak ditetapkan ke kelompok mana pun. Jika Anda mengatur GroupId ke -2, kueri dilakukan pada semua nama domain. Jika Anda menentukan nilai lain untuk GroupId, kueri dilakukan pada kelompok yang ditentukan. Untuk informasi selengkapnya, lihat DescribeDomainGroups.	2****
Type	string	No	Tipe Rekaman DNS. Untuk informasi selengkapnya, lihat: Tipe Rekaman DNS	A
Line	string	No	Jalur resolusi DNS. Nilai default: default. Untuk informasi selengkapnya, lihat: Enumerasi jalur resolusi DNS	cn_mobile_anhui
Status	string	No	Status Rekaman DNS. Nilai yang valid: Enable: Rekaman DNS diaktifkan. Disable: Rekaman DNS dijeda.	Enable

Elemen respons

Element	Type	Description	Example
	object
TotalCount	integer	Jumlah total Rekaman DNS.	2
PageSize	integer	Jumlah Rekaman DNS yang dikembalikan dalam kueri ini.	20
RequestId	string	ID permintaan.	536E9CAD-DB30-4647-AC87-AA5CC38C5382
DomainRecords	object
Record	array<object>	Daftar Rekaman DNS.
	object
Status	string	Status Rekaman DNS.	Enable
Type	string	Tipe catatan.	MX
Remark	string	Catatan.	备注
TTL	integer	Masa hidup data (TTL). Satuan: detik.	600
RecordId	string	ID Rekaman DNS.	9*******
Priority	integer	Prioritas Rekaman MX.	5
RR	string	Rekaman host.	www
DomainName	string	Nama domain.	example.com
Weight	integer	Bobot untuk penyeimbangan beban.	2
Value	string	Nilai catatan.	mail1.hichina.com
Line	string	Jalur resolusi DNS.	default
Locked	boolean	Status kunci Rekaman DNS.	false
CreateTimestamp	integer	Waktu pembuatan catatan. Ini adalah Stempel waktu UNIX.	1666501957000
UpdateTimestamp	integer	Waktu pembaruan terakhir catatan. Ini adalah Stempel waktu UNIX.	1676872961000
LbaStatus	boolean	Menunjukkan apakah kebijakan penyeimbangan beban telah dikonfigurasi. true: Berbasis bobot false: Berbasis polling	true
PageNumber	integer	Nomor halaman saat ini.	1

Contoh

Respons sukses

JSONformat

{
  "TotalCount": 2,
  "PageSize": 20,
  "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
  "DomainRecords": {
    "Record": [
      {
        "Status": "Enable",
        "Type": "MX",
        "Remark": "备注",
        "TTL": 600,
        "RecordId": "9*******",
        "Priority": 5,
        "RR": "www",
        "DomainName": "example.com",
        "Weight": 2,
        "Value": "mail1.hichina.com",
        "Line": "default",
        "Locked": false,
        "CreateTimestamp": 1666501957000,
        "UpdateTimestamp": 1676872961000,
        "LbaStatus": true
      }
    ]
  },
  "PageNumber": 1
}

Kode kesalahan

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.