调用SaveSingleTaskForAddingDSRecord提交创建DS记录任务。

任务执行结果请通过QueryTaskDetailList接口查询。

调试

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

请求参数

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

系统规定参数。取值:SaveSingleTaskForAddingDSRecord

Algorithm Integer 1

加密算法编号,详见Domain Name System Security (DNSSEC) Algorithm Numbers。取值:

  • 1:RSA/MD5。
  • 2:Diffie-Hellman。
  • 3:DSA/SHA-1。
  • 5:RSA/SHA-1。
  • 6:DSA-NSEC3-SHA1。
  • 7:RSASHA1-NSEC3-SHA1。
  • 8:RSA/SHA-256。
  • 10:RSA/SHA-512。
  • 12:GOST R 34.10-2001。
  • 13:ECDSA Curve P-256 with SHA-256。
  • 14:ECDSA Curve P-384 with SHA-384。
  • 15:Ed2551916 Ed448。
  • 252:Reserved for Indirect Keys。
  • 253:private algorithm。
  • 254:private algorithm OID。
Digest String f58fa917424383934c7b0cf1a90f61d692745680fa06f5ecdbe0924e86de9598

摘要。

DigestType Integer 2

摘要算法类型,详见Delegation Signer (DS) Resource Record (RR) Type Digest Algorithms。取值:

  • 1:SHA-1;
  • 2:SHA-256;
  • 3:GOST R 34.11-94;
  • 4:SHA-384。
DomainName String example.com

域名。

KeyTag Integer 1

密钥标签,用于标识DNSSEC记录,为小于65536的整数值。

Lang String en

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

  • zh:中文;
  • en:英文。

默认为en

UserClientIp String 127.0.0.1

用户IP,可以设置为127.0.0.1

返回数据

名称 类型 示例值 描述
RequestId String E2598CAF-DBFE-494E-95EF-B42A33C178AA

唯一请求识别码。

TaskNo String e893148f-6343-4ae1-9eba-6e2a4116e142

任务编号。

示例

请求示例

http(s)://[Endpoint]/?Action=SaveSingleTaskForAddingDSRecord
&Algorithm=1
&Digest=f58fa917424383934c7b0cf1a90f61d692745680fa06f5ecdbe0924e86de9598
&DigestType=2
&DomainName=example.com
&KeyTag=1
&<公共请求参数>

正常返回示例

XML格式

<SaveSingleTaskForAddingDSRecordResponse>
    <TaskNo>3cbc5b9f-080d-4b5f-a04b-29f54bffdeab</TaskNo>
    <RequestId>722D0361-93BD-4289-824F-D17B218D8BF4</RequestId>
</SaveSingleTaskForAddingDSRecordResponse>

JSON格式

{
    "RequestId":"E2598CAF-DBFE-494E-95EF-B42A33C178AA",
    "TaskNo":"e893148f-6343-4ae1-9eba-6e2a4116e142"
}

错误码

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