DescribeDomainRecords - - Alibaba Cloud Dokümantasyon Merkezi

Giriş parametrelerine göre belirtilen bir kök etki alanı için DNS kayıtlarını getirir.

Operation description

DNS kayıtlarının bir listesini getirmek için etki alanı adını (DomainName), sayfa numarasını (PageNumber) ve sayfa boyutunu (PageSize) belirtebilirsiniz.
Anahtar sözcüğü içeren DNS kayıtlarını sorgulamak için ana makine kaydı (RRKeyWord), kayıt türü (TypeKeyWord) veya kayıt değeri (ValueKeyWord) için bir anahtar sözcük belirtebilirsiniz.
Varsayılan olarak, DNS kayıtları eklendikleri zamana göre azalan sırada sıralanır.
Belirli bir gruptaki DNS kayıtlarını sorgulamak için bir etki alanı grubu kimliği (GroupId) belirtebilirsiniz.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.
API: The API that you can call to perform the action.
Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.
Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.
- For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.
- For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.
Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.
Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

alidns:DescribeDomainRecords

get

*Domain

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

None

Request parameters

Parameter	Type	Required	Description	Example
Lang	string	No	İstek ve yanıtın dili. Varsayılan değer: zh. Geçerli değerler: zh: Çince en: İngilizce	en
DomainName	string	Yes	Etki alanı adı. Daha fazla bilgi için bkz. DescribeDomains.	example.com
PageNumber	integer	No	Sayfa numarası. Değer 1'den başlar. Varsayılan değer: 1.	1
PageSize	integer	No	Sayfalanmış bir sorgu için her sayfada döndürülecek giriş sayısı. Maksimum değer: 500. Varsayılan değer: 20.	20
KeyWord	string	No	Anahtar sözcük.	test
RRKeyWord	string	No	Ana makine kaydı için anahtar sözcük. Arama, bulanık eşleştirme modeli kullanır ve büyük/küçük harfe duyarlı değildir.	www
TypeKeyWord	string	No	Kayıt türü için anahtar sözcük. Arama, tam eşleştirme kullanır ve büyük/küçük harfe duyarlı değildir.	MX
ValueKeyWord	string	No	Kayıt değeri için anahtar sözcük. Arama, bulanık eşleştirme modeli kullanır ve büyük/küçük harfe duyarlı değildir.	com
OrderBy	string	No	Sıralama yöntemi. Kayıtlar, eklendikleri zamana göre azalan sırada sıralanır.	default
Direction	string	No	Sıralama yönü. Geçerli değerler: DESC, ASC. Varsayılan değer: DESC.	DESC
SearchMode	string	No	Arama modu. Geçerli değerler: LIKE, EXACT, ADVANCED ve COMBINATION. Bu parametreyi LIKE veya EXACT olarak ayarlarsanız KeyWord parametresini kullanın. RRKeyWord, TypeKeyWord, ValueKeyWord, Type, Line ve Status parametreleri geçersizdir. Bu parametreyi ADVANCED olarak ayarlarsanız RRKeyWord, TypeKeyWord, ValueKeyWord, Type, Line ve Status parametrelerini kullanın. RRKeyWord ve ValueKeyWord parametreleri bulanık eşleştirmeyi destekler. Bu parametreyi COMBINATION olarak ayarlarsanız RRKeyWord, TypeKeyWord, ValueKeyWord, Type, Line ve Status parametrelerini kullanın. Bu parametrelerin tümü yalnızca tam eşleştirmeyi destekler. Bu parametreyi belirtmezseniz: keyWord parametresini belirtirseniz arama modu LIKE olarak ayarlanır. keyWord parametresini belirtmezseniz RRKeyWord ve ValueKeyWord bulanık eşleştirmeyi, TypeKeyWord, Type, Line ve Status ise tam eşleştirmeyi destekler.	LIKE
GroupId	integer	No	Etki alanı grubunun kimliği. GroupId parametresini belirtmezseniz sorgu tüm etki alanı adlarında gerçekleştirilir. GroupId değerini 0 olarak ayarlarsanız boş bir sonuç döndürülür. GroupId değerini -1 olarak ayarlarsanız sorgu varsayılan grupta gerçekleştirilir. Varsayılan grup, bir gruba atanmamış etki alanı adlarını içerir. GroupId değerini -2 olarak ayarlarsanız sorgu tüm etki alanı adlarında gerçekleştirilir. GroupId için başka bir değer belirtirseniz sorgu belirtilen grupta gerçekleştirilir. Daha fazla bilgi için bkz. DescribeDomainGroups.	2****
Type	string	No	DNS kaydının türü. Daha fazla bilgi için bkz.: DNS kayıt türleri	A
Line	string	No	DNS çözümleme hattı. Varsayılan değer: default. Daha fazla bilgi için bkz.: DNS çözümleme hatları listesi	cn_mobile_anhui
Status	string	No	DNS kaydının durumu. Geçerli değerler: Enable: DNS kaydı etkinleştirilmiştir. Disable: DNS kaydı duraklatılmıştır.	Enable

Response elements

Element	Type	Description	Example
	object
TotalCount	integer	DNS kayıtlarının toplam sayısı.	2
PageSize	integer	Bu sorguda döndürülen DNS kayıtlarının sayısı.	20
RequestId	string	İstek kimliği.	536E9CAD-DB30-4647-AC87-AA5CC38C5382
DomainRecords	object
Record	array<object>	DNS kayıtlarının listesi.
	object
Status	string	DNS kaydının durumu.	Enable
Type	string	Kayıt türü.	MX
Remark	string	Açıklamalar.	备注
TTL	integer	Yaşam süresi (TTL). Birim: saniye.	600
RecordId	string	DNS kaydının kimliği.	9*******
Priority	integer	MX kaydının önceliği.	5
RR	string	Ana makine kaydı.	www
DomainName	string	Etki alanı adı.	example.com
Weight	integer	Yük dengeleme için ağırlık.	2
Value	string	Kayıt değeri.	mail1.hichina.com
Line	string	DNS çözümleme hattı.	default
Locked	boolean	DNS kaydının kilit durumu.	false
CreateTimestamp	integer	Kaydın oluşturulduğu zaman. Bu bir UNIX zaman damgasıdır.	1666501957000
UpdateTimestamp	integer	Kaydın en son güncellendiği zaman. Bu bir UNIX zaman damgasıdır.	1676872961000
LbaStatus	boolean	Bir yük dengeleme politikasının yapılandırılıp yapılandırılmadığını gösterir. true: Ağırlık tabanlı false: Yoklama tabanlı	true
PageNumber	integer	Geçerli sayfa numarası.	1

Examples

Success response

JSON format

{
  "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
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.