Todos os produtos
Search
Central de documentação

Domain Names:SaveSingleTaskForAddingDSRecord

Última atualização: Jun 27, 2026

Envia uma tarefa para crie o registro delegation signer (DS) de um nome de domínio.

Chame a operação QueryTaskDetailList para consultar o resultado da execução da tarefa.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Recomendamos chamar esta operação no OpenAPI Explorer, que gera dinamicamente códigos de exemplo para diferentes SDKs.

Parâmetros da solicitação

Parâmetro Tipo Obrigatório Exemplo Descrição
Action String Sim SaveSingleTaskForAddingDSRecord

Operação a ser executada. Defina o valor como SaveSingleTaskForAddingDSRecord.

Algorithm Integer Sim 1

Número do algoritmo de criptografia em uso. Para obter mais informações, consulte Números de Algoritmos de Segurança do Sistema de Nomes de Domínio (DNSSEC). Valores válidos:

  • 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: reservado para chaves indiretas
  • 253: algoritmo privado
  • 254: OID de algoritmo privado
Digest String Sim f58fa917424383934c7b0cf1a90f61d692745680fa06f5ecdbe0924e86de9598

Resumo (digest) do resultado da tarefa.

DigestType Integer Sim 2

Tipo do algoritmo de resumo. Para obter mais informações, consulte Algoritmos de Resumo de Tipos de Registro de Recursos (RR) Delegation Signer (DS). Valores válidos:

  • 1: SHA-1
  • 2: SHA-256
  • 3: GOST R 34,11-94
  • 4: SHA-384
DomainName String Sim example.com

Nome de domínio.

KeyTag Integer Sim 1

Tag de chave usada para identificar o registro DNSSEC. Valores válidos: inteiros entre 0 e 65536.

Lang String Não en

Idioma da mensagem de erro retornada pelo sistema. Valores válidos:

  • zh: Chinês
  • en: Inglês

Valor padrão: en

UserClientIp String Não 127.0.0.1

Endereço IP do cliente. Defina o valor como 127.0.0.1.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

E2598CAF-DBFE-494E-95EF-B42A33C178AA

ID da solicitação.

TaskNo

String

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

ID da tarefa.

Exemplos

Exemplos de solicitações

http(s)://[Endpoint]/?Action=SaveSingleTaskForAddingDSRecord
&Algorithm=1
&Digest=f58fa917424383934c7b0cf1a90f61d692745680fa06f5ecdbe0924e86de9598
&DigestType=2
&DomainName=example.com
&KeyTag=1
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

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

Formato JSON

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

Códigos de erro

Para obter uma lista de códigos de erro, visite a Central de Erros de API.