查詢站點下解析記錄列表,包括記錄值、優先級、認證配置等。支持根據記錄名稱、記錄類型等條件進行過濾。
接口說明
邊緣容器、邊緣函數與四層加速對應的 DNS 解析記錄,將不會在此 API 中返回。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
下表是API對應的授權信息,可以在RAM權限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調用此API的權限。具體說明如下:
- 操作:是指具體的權限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權的操作,用
全部資源
表示。
- 條件關鍵字:是指云產品自身定義的條件關鍵字。
- 關聯操作:是指成功執行操作所需要的其他權限。操作者必須同時具備關聯操作的權限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關鍵字 | 關聯操作 |
---|---|---|---|---|
esa:ListRecords | get | *Site acs:esa:{#regionId}:{#accountId}:site/{#SiteId} |
| 無 |
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
SiteId | long | 是 | 站點 ID,可通過調用 ListSites 接口獲取。 | 1234567890123 |
RecordName | string | 否 | 記錄名稱。用于查詢的過濾條件。 | www.example.com |
RecordMatchType | string | 否 | 記錄名稱的搜索匹配模式。默認為精確匹配,取值:
| fuzzy |
PageNumber | integer | 否 | 頁碼。默認值:1。 | 1 |
PageSize | integer | 否 | 分頁大小。默認值:500。 | 10 |
SourceType | string | 否 | 記錄的源站類型,用于查詢的過濾條件(僅 CNAME 記錄可以通過該字段篩選),取值:
| OSS |
BizName | string | 否 | 記錄加速時的業務場景,用于查詢的過濾條件,取值:
| web |
Proxied | boolean | 否 | 記錄是否開啟代理加速,用于查詢的過濾條件。取值:
| true |
Type | string | 否 | 記錄的 DNS 記錄類型,用于查詢的過濾條件。 | CNAME |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "15C66C7B-671A-4297-9187-2C4477247A74",
"PageNumber": 1,
"PageSize": 10,
"TotalCount": 20,
"Records": [
{
"BizName": "web",
"Data": {
"Value": "CNAME",
"Priority": 0,
"Flag": 128,
"Tag": "issue",
"Weight": 0,
"Port": 80,
"Type": 0,
"KeyTag": 0,
"Algorithm": 0,
"Certificate": "dGVzdGFkYWxrcw==",
"Usage": 0,
"Selector": 0,
"MatchingType": 0,
"Fingerprint": "abcdef1234567890"
},
"CreateTime": "2023-12-24T02:01:11Z",
"UpdateTime": "2023-06-07T10:02:59Z",
"Proxied": true,
"RecordId": 1234567890123,
"RecordSourceType": "OSS",
"RecordName": "a.example.com",
"RecordType": "A/AAAA",
"SiteId": 1234567890123,
"SiteName": "example.com",
"Ttl": 30,
"RecordCname": "a.example.com.cnamezone.com",
"Comment": "this is a remark.",
"AuthConf": {
"AuthType": "private",
"AccessKey": "u0Nkg5gBK***QF5wvKMM504JUHt",
"SecretKey": "VIxuvJSA2S03f***kp208dy5w7",
"Version": "v4",
"Region": "us-east-1"
},
"HostPolicy": "follow_origin_domain"
}
]
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | InternalException | Failed to call the service. Try again later or contact technical support. | 調用服務失敗,請稍后重試或聯系客服咨詢詳情。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內容概要 | 操作 |
---|---|---|
2024-11-19 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
2024-09-23 | OpenAPI 錯誤碼發生變更、OpenAPI 返回結構發生變更 | 查看變更詳情 |