开发者社区 问答 正文

云解析怎么 添加域名分组



描述


根据传入参数添加域名分组。关于域名分组,详见 域名分组介绍

请求参数

名称类型是否必须描述
ActionString操作接口名,系统规定参数,取值:AddDomainGroup
GroupNameString域名分组名称


返回参数


公共返回参数,详见 公共返回参数
名称类型描述
RequestIdString唯一请求识别码
GroupIdString域名分组ID
GroupNameString域名分组名称


错误码


对于所有接口的通用性错误,请参考 错误代码表
错误代码描述HTTP 状态码语义
QuotaExceeded.GroupCountThe domain group count has been out of MAX count (100).400域名分组数量超过限制
QuotaExceeded.GroupNameLengthThe domain group name length has been out of MAX count (20).400分组名称长度超过限制
InvalidDomainGroup.DuplicateThe domain group name is duplicated.400分组名称已存在
InvalidDomainGroup.EmptyNameThe domain group name is empty.400分组名称为空


示例



请求示例

http://alidns.aliyuncs.com/?Action=AddDomainGroup&GroupName=MyGroup&<公共请求参数>

返回示例



XML格式

<AddDomainGroupResponse><RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId><GroupId>2223</GroupId><GroupName>NewName</GroupName></AddDomainGroupResponse>

JSON示例

{"RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382","GroupId": "2223","GroupName": "NewName"}

展开
收起
boxti 2017-10-18 10:29:12 1660 分享 版权
阿里云 AI 助理回答

您提到的是阿里云DNS(Alibaba Cloud DNS)服务中通过API添加域名分组的操作。下面是对您描述内容的解析和补充说明:

操作概述

该操作允许用户通过调用阿里云DNS API来创建一个新的域名分组,以便更好地组织和管理您的域名记录。域名分组是一种逻辑上的分类方式,可以帮助用户将具有相似特性的域名或其记录归类在一起,便于管理和配置。

请求参数详解

  • Action: 必须参数,固定值AddDomainGroup,表示执行添加域名分组的操作。
  • GroupName: 必须参数,类型为String,表示要创建的域名分组的名称。这个名称需要符合阿里云的规定,不能超过20个字符,并且不能与其他已存在的分组名称重复。

返回参数说明

  • RequestId: String类型,每次API请求的唯一标识。
  • GroupId: String类型,成功创建的域名分组ID,用于后续对这个分组进行操作时引用。
  • GroupName: String类型,返回创建成功的域名分组名称,确认操作结果。

错误码解释

  • QuotaExceeded.GroupCount: 当前账号下的域名分组数量已经达到最大限制100个时,会返回此错误码,HTTP状态码为400。
  • QuotaExceeded.GroupNameLength: 如果尝试设置的域名分组名称长度超过20个字符,会返回此错误码,HTTP状态码为400。
  • InvalidDomainGroup.Duplicate: 如果提供的域名分组名称已经存在,即尝试创建一个与现有分组同名的分组,会返回此错误码,HTTP状态码为400。
  • InvalidDomainGroup.EmptyName: 如果未提供域名分组名称或者名称为空,会返回此错误码,HTTP状态码为400。

示例请求

您给出的示例请求URL展示了如何通过HTTP GET方法调用此接口:

http://alidns.aliyuncs.com/?Action=AddDomainGroup&GroupName=YourGroupName

请注意,实际使用时,除了在URL中直接拼接参数外,更推荐使用POST方法并以JSON格式在请求体中传递参数,同时需要包含AccessKeyId、Signature、SignatureMethod、SignatureVersion、Timestamp等认证信息,确保请求的安全性和有效性。这些认证信息的生成通常依赖于阿里云提供的SDK或手动签名过程,具体可参考阿里云API签名机制。

希望以上信息能帮助您顺利完成域名分组的添加操作。如果有更多关于阿里云产品的问题,欢迎继续提问。

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