调用AddDomain添加域名_云解析DNS(DNS)-阿里云帮助中心

接口说明

域名合法性判断参见：域名合法性。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

alidns:AddDomain

create

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
Lang	string	否	返回值语言，取值： zh：中文 en：英文默认：en	en
DomainName	string	是	域名名称。	example.com
GroupId	string	否	指域名分组 ID。如不填或传空字符或传 defaultGroup，将添加在默认分组下。可通过调用 AddDomainGroup 获取。	defaultGroup
ResourceGroupId	string	否	域名在资源管理产品中所属的资源组 ID。默认为空，即属于默认资源组。	******resourcegroupid

返回参数

名称	类型	描述	示例值
	object
GroupName	string	域名分组名称。	MyGroup
DomainId	string	域名 ID。	xxxxx6615cf240c697f9f7e207xxxxxx
RequestId	string	请求 ID。	xxx508EF-00FD-xxx9-95A4-1E10BACxxxxx
DomainName	string	域名名称。	example.com
PunyCode	string	只针对中文域名返回 punycode 码。	xn--fsq270a.com
DnsServers	object
DnsServer	array	域名在解析系统中的 DNS 列表。
	string	域名当前设置的 DNS 服务器名称。	{"DnsServer": ["ns1.alidns.com","ns2.alidns.com"]}
GroupId	string	域名分组 ID。	defaultGroup

示例

正常返回示例

JSON格式

{
  "GroupName": "MyGroup",
  "DomainId": "xxxxx6615cf240c697f9f7e207xxxxxx",
  "RequestId": "xxx508EF-00FD-xxx9-95A4-1E10BACxxxxx",
  "DomainName": "example.com",
  "PunyCode": "xn--fsq270a.com",
  "DnsServers": {
    "DnsServer": [
      "{\"DnsServer\": [\"ns1.alidns.com\",\"ns2.alidns.com\"]}"
    ]
  },
  "GroupId": "defaultGroup"
}

错误码

访问错误中心查看更多错误码。

变更历史

更多信息，参考变更详情。