查詢DNS授權規則。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
請求參數
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
IoTCloudConnectorId | string | 是 | 云連接器實例 ID。 | iotcc-1y6h8z7imd2yu4**** |
DNSServiceRuleIds | array | 否 | DNS 授權規則 ID。 | |
string | 否 | DNS 授權規則 ID。最多支持輸入 20 個規則 ID。 | ar-c1dk4jb73j5791**** | |
ServiceType | string | 否 | DNS 授權規則的目標類型。取值:
| Normal |
Destination | array | 否 | 目標 DNS 授權規則 IP 地址。 | |
string | 否 | 重定向后的 DNS 服務地址。最多支持輸入 20 個目標 IP 地址。 說明
當 ServiceType 參數取值為 DNSRedirect 時,該參數必選。
| 192.168.0.2 | |
DNSServiceRuleStatus | array | 否 | DNS 授權規則的狀態。 | |
string | 否 | DNS 授權規則的狀態。最多支持輸入 20 個 DNS 授權規則狀態。取值:
| Created | |
DNSServiceRuleName | array | 否 | DNS 授權規則名稱。最多支持輸入 20 個規則名稱。 | |
string | 否 | DNS 授權規則名稱。最多支持輸入 20 個規則名稱。 長度為 2~128 個英文或中文字符,開頭必須為大小寫英文字母或中文,可包含數字、半角句號(.)、下劃線(_)和短劃線(-)。 | test | |
Source | array | 否 | 源 DNS 授權規則 IP 地址。 | |
string | 否 | 源 DNS IP 地址。最多支持輸入 20 個源 IP 地址。包括但不限于以下取值: 100.100.2.136,100.100.2.137,100.100.2.138,114.114.114.114,8.8.8.8,8.8.4.4,223.5.5.5,223.6.6.6,221.5.88.88,116.116.116.116,221.228.15.26,61.139.2.69,218.6.200.139,119.29.29.29,218.2.2.2,208.67.220.220,208.67.222.222,218.4.4.4。 除以上默認的 DNS 授權規則的 IP,如有其他 DNS 授權規則的 IP 訴求,請提交工單,并在工單中附上需要申請的 DNS 授權規則的 IP。 | 100.100.2.138 | |
NextToken | string | 否 | 是否擁有下一次查詢的令牌(Token)。取值:
| FFmyTO70tTpLG6I3FmYAXGKPd**** |
MaxResults | integer | 否 | 分批次查詢時每次顯示的條目數。取值:1~50。默認值:10。 | 10 |
RegionId | string | 是 | 云連接器實例所在的地域 ID。 您可以通過調用 DescribeRegions 接口獲取地域 ID。 | cn-hangzhou |
返回參數
示例
正常返回示例
JSON
格式
{
"RequestId": "4A63118E-B375-5718-8F03-30F6804E1DCD",
"TotalCount": 10,
"NextToken": "FFmyTO70tTpLG6I3FmYAXGKPd****",
"MaxResults": 10,
"DNSServiceRules": [
{
"IoTCloudConnectorId": "iotcc-1y6h8z7imd2yu4****",
"ServiceType": "Normal",
"Source": "100.100.2.138",
"Destination": "192.168.0.2",
"DNSServiceRuleStatus": "Created",
"DNSServiceRuleName": "test",
"DNSServiceRuleDescription": "description",
"DNSServiceRuleId": "ar-c1dk4jb73j5791****"
}
]
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | Forbidden.RAM | Ram user does not have permission to perform this operation. | RAM用戶無權限執行此操作。 |
400 | ResourceNotFound.IoTCloudConnector | The param of IoTCloudConnectorId is illegal. | IoTCloudConnectorId參數非法 |
訪問錯誤中心查看更多錯誤碼。