开发者社区 问答 正文

云解析怎么获取域名分组列表



描述


根据传入参数获取所有分组列表。

请求参数

名称类型是否必须描述
ActionString操作接口名,系统规定参数,取值:DescribeDomainGroups
PageNumberLong当前页数,起始值为1,默认为1
PageSizeLong分页查询时设置的每页行数,最大值100,默认为20
KeyWordString组名关键字,按照”%KeyWord%”模式搜索,不区分大小写


返回参数


公共返回参数,详见 公共返回参数
名称类型描述
RequestIdString唯一请求识别码
TotalCountLong域名分组数量
PageNumberLong当前页码
PageSizeLong本次查询获取的域名分组数量
DomainGroupsDomainGroupType域名分组结构列表


错误码


对于所有接口的通用性错误,请参考 错误代码表

示例



请求示例

http://alidns.aliyuncs.com/?Action=DescribeDomainGroups&PageNumber=1&PangeSize=20&KeyWord=Group&<公共请求参数>

返回示例



XML格式

<DescribeDomainGroupsResponse><RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId><TotalCount>1</TotalCount><PageNumber>1</PageNumber><PageSize>2</PageSize><DomainGroups><DomainGroup><GroupId>2223</GroupId><GroupName>MyGroup</GroupName></DomainGroup></DomainGroups></DescribeDomainGroupsResponse>

JSON示例

{"RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382","TotalCount": 1,"PageNumber": 1,"PageSize": 2,"DomainGroups": {"DomainGroup": [{"GroupId": "2223","GroupName": "MyGroup"}]}}

展开
收起
boxti 2017-10-18 10:38:46 2027 分享 版权
阿里云 AI 助理回答

您描述的是阿里云DNS(Alibaba Cloud DNS)服务中查询域名分组列表的API接口——DescribeDomainGroups。这个接口允许用户根据指定的参数获取其在阿里云DNS服务下所有域名分组的信息。下面是对您提供的信息的一个详细解析和补充说明:

请求参数

  1. Action (String, 必须): 接口操作名,固定值为DescribeDomainGroups,表示请求获取域名分组列表。

  2. PageNumber (Long, 非必须): 当前页数,起始值为1,默认为1。用于分页查询时指定从哪一页开始显示结果。

  3. PageSize (Long, 非必须): 分页查询时每页显示的行数,最大值为100,默认为20。用来控制每次请求返回的结果数量。

  4. KeyWord (String, 非必须): 组名关键字,按照”%KeyWord%”模式进行模糊搜索,不区分大小写。如果提供此参数,将只返回名称中包含该关键字的域名分组。

返回参数

  • RequestId (String): 每次API请求的唯一识别码,用于问题排查。

  • TotalCount (Long): 域名分组的总数,即满足条件的分组数量。

  • PageNumber (Long): 实际返回结果的当前页码。

  • PageSize (Long): 本次查询实际返回的域名分组数量。

  • DomainGroups (DomainGroupType List): 域名分组结构列表,包含了每个分组的具体信息,如分组ID、分组名称等。

错误码

除了特定于该接口的错误外,还应参考阿里云API通用错误代码表,这些错误代码提供了关于请求失败原因的详细信息,帮助用户诊断问题。

示例请求

您给出的示例请求URL展示了如何调用此接口:

http://alidns.aliyuncs.com/?Action=DescribeDomainGroups

请注意,实际使用时,特别是通过程序调用,还需要设置AccessKeyId、AccessKeySecret以及签名等认证信息,并且可能需要通过POST方法提交JSON格式的请求体,具体构造方法和要求请参照阿里云官方文档中的API调用指南。

确保在调用任何阿里云API之前,已经熟悉了相关的安全最佳实践,比如使用RAM角色而非直接暴露AccessKey,以及合理设置API调用的权限策略。

有帮助
无帮助
AI 助理回答生成答案可能存在不准确,仅供参考
0 条回答
写回答
取消 提交回答