调用SaveDomainGroup创建、更新域名分组。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 SaveDomainGroup

系统规定参数。取值：SaveDomainGroup。

DomainGroupId Long 否 123456

域名分组编号，当不传该参数时为创建分组，传该参数时更新域名分组名称。
DomainGroupName String 否 测试分组

域名分组名称。
Lang String 否 en

接口返回错误信息语言。取值：

  • zh：中文；
  • en：英文。

默认为en。

UserClientIp String 否 127.0.0.1

用户IP。

返回数据

名称 类型 示例值 描述
BeingDeleted Boolean false

是否正在删除中。

说明 超过1000个域名的分组删除为异步过程，需要系统处理一段时间，在此期间内该字段为true。
CreationDate String 2018-04-02 15:59:06

域名分组创建时间。
DomainGroupId Long 123456

域名分组编号。
DomainGroupName String 测试分组

域名分组名称。
DomainGroupStatus String COMPLETE

域名分组状态。取值：

  • PROCESSING：处理中；
  • COMPLETE：已完成。
说明 通过文件设置分组、替换超过1000个域名的分组等情况下为异步过程，需要等待系统处理，此状态下该字段为PROCESSING。
ModificationDate String 2018-04-02 15:59:06

域名分组修改时间。
RequestId String 80011ABC-F573-4795-B0E8-377BFBBA3422

唯一请求标识码。
TotalNumber Integer 20

域名数量。

示例

请求示例


http(s)://[Endpoint]/?Action=SaveDomainGroup
&<公共请求参数>

正常返回示例

XML 格式 

<SaveDomainGroupResponse>
    <DomainGroupId>1234567</DomainGroupId>
    <BeingDeleted>false</BeingDeleted>
    <DomainGroupName>测试分组1</DomainGroupName>
    <RequestId>A6145E95-96BA-4B17-B891-9CF3C4FBBA35</RequestId>
    <ModificationDate>2018-04-27 14:57:25</ModificationDate>
    <CreationDate>2018-04-27 14:57:25</CreationDate>
    <TotalNumber>0</TotalNumber>
    <DomainGroupStatus>COMPLETE</DomainGroupStatus>
</SaveDomainGroupResponse>

JSON 格式 

{
	"DomainGroupId":123456,
	"BeingDeleted":false,
	"RequestId":"3ADCCF7B-7D2B-4B2E-9154-3C0B6D43287A",
	"DomainGroupName":"测试分组",
	"ModificationDate":"2018-04-27 14:53:55",
	"TotalNumber":0,
	"CreationDate":"2018-04-27 14:53:55",
	"DomainGroupStatus":"COMPLETE"
}

错误码

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