Todos os produtos
Search
Central de documentação

Domain Names:SaveSingleTaskForCreatingOrderActivate

Última atualização: Jun 27, 2026

Envia uma tarefa para registrar um nome de domínio.

Descrição

Desde 1º de março de 2022, o registro de nomes de domínio exige um perfil de registrante com verificação de nome real aprovada. Não é mais possível registrar domínios informando diretamente os dados do registrante.

Para registrar um nome de domínio, especifique o nome do domínio, o registrante e o servidor DNS (Domain Name System). Defina o registrante por meio do ID de um perfil de registrante. Por padrão, o sistema utiliza os servidores DNS da Alibaba Cloud, mas você também pode configurar servidores DNS personalizados.

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. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente o código de exemplo da operação para diferentes SDKs.

Parâmetros da solicitação

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

Action

String

Sim

SaveSingleTaskForCreatingOrderActivate

A operação a ser executada. Defina o valor como SaveSingleTaskForCreatingOrderActivate.

DomainName

String

Sim

example.com

O nome de domínio a ser registrado.

Nota

Especifique o registrante do nome de domínio durante o registro. O registro falhará se nenhum registrante for definido. Utilize o parâmetro RegistrantProfileId para indicar o ID do perfil de registrante correspondente.

RegistrantProfileId

Long

Não

123

O ID do perfil de registrante. Este perfil contém informações como nome do registrante do domínio, contato, telefone e endereço de e-mail. Identifique o registrante exclusivamente pelo ID do perfil. Caso já possua um perfil criado, chame a operação QueryRegistrantProfiles para obter o ID desejado.

Nota

Ao especificar este parâmetro, não é necessário preencher os seguintes campos: RegistrantType, ZhRegistrantOrganization, ZhRegistrantName, ZhProvince, ZhCity, ZhAddress, RegistrantOrganization, RegistrantName, Province, City, Address, PostalCode, Country, TelArea, Telephone, TelExt e Email.

RegistrantType

String

Não

1

O tipo de registrante do nome de domínio. Valores válidos:

  • 1: pessoa física

  • 2: empresa ou organização

Nota

Este parâmetro só tem efeito quando RegistrantProfileId não é especificado. Nessas condições, seu preenchimento é obrigatório. A ausência deste parâmetro causa falha no registro do domínio.

ZhRegistrantOrganization

String

Não

Test

O nome em chinês do registrante do domínio.

Nota

Aplicável apenas ao serviço de Domínios no site da China da Alibaba Cloud (aliyun.com). Só produz efeito se RegistrantProfileId não for informado. Nesse cenário, o campo torna-se obrigatório e a falta dele impede a conclusão do registro.

ZhRegistrantName

String

Não

Test

O nome em chinês do contato do domínio.

Nota

Restrito ao serviço de Domínios do site da China da Alibaba Cloud (aliyun.com). Válido somente na ausência de RegistrantProfileId. Quando aplicável, é obrigatório; caso contrário, o registro do domínio falhará.

ZhProvince

String

Não

Bei Jing

A província onde o registrante está localizado, em chinês.

Nota

Utilizado exclusivamente no serviço de Domínios do site da China da Alibaba Cloud (aliyun.com). Requerido apenas se RegistrantProfileId não estiver definido. A omissão deste dado resulta em erro no registro.

ZhCity

String

Não

Bei Jing

A cidade onde o registrante está localizado, em chinês.

Nota

Válido apenas para o serviço de Domínios no site da China da Alibaba Cloud (aliyun.com). Torna-se obrigatório quando RegistrantProfileId não é fornecido. Se não especificado nessas condições, o registro não será concluído.

ZhAddress

String

Não

Chao Yang

O endereço do registrante do domínio, em chinês.

Nota

Aplica-se somente ao serviço de Domínios do site da China da Alibaba Cloud (aliyun.com). Preencha este campo se RegistrantProfileId não for utilizado. A falta desta informação causa falha no registro.

RegistrantOrganization

String

Não

Test

O nome em inglês do registrante do domínio.

Nota

Tem efeito apenas se RegistrantProfileId não for especificado. Nessa situação, o campo é obrigatório e sua ausência impede o registro do domínio.

RegistrantName

String

Não

Test

O nome em inglês do contato do domínio.

Nota

Funciona apenas quando RegistrantProfileId não é fornecido. Se esse for o caso, preencha este campo obrigatoriamente para evitar falhas no registro.

Province

String

Não

Bei Jing

A província onde o registrante está localizado, em inglês.

Nota

Relevante apenas se RegistrantProfileId não estiver definido. Quando aplicável, é obrigatório; a omissão resulta em erro no processo de registro.

City

String

Não

Bei Jing

A cidade onde o registrante está localizado, em inglês.

Nota

Necessário apenas na ausência de RegistrantProfileId. Certifique-se de preenchê-lo nessas circunstâncias, pois o registro falhará sem essa informação.

Address

String

Não

Chao Yang

O endereço do registrante do domínio, em inglês.

Nota

Aplica-se somente quando RegistrantProfileId não é especificado. Nesse caso, o preenchimento é obrigatório para garantir o sucesso do registro.

PostalCode

String

Não

1234567

O código postal da região onde o registrante está localizado.

Nota

Este campo só é considerado se RegistrantProfileId não for informado. Quando necessário, sua ausência provoca falha no registro do domínio.

Country

String

Não

CN

O código do país ou região onde o registrante está localizado, como CN.

Nota

Válido apenas se RegistrantProfileId não for definido. Nessas condições, especifique este código para evitar erros no registro.

TelArea

String

Não

86

O código telefônico internacional do país ou região do contato do domínio. Por exemplo, o código da China é 86.

Nota

Produz efeito apenas quando RegistrantProfileId não é especificado. Se aplicável, o preenchimento é obrigatório para o sucesso do registro.

Telephone

String

Não

12345678

O número de telefone do registrante do domínio.

Nota

Considerado apenas na ausência de RegistrantProfileId. Quando necessário, preencha-o obrigatoriamente para evitar falhas no registro.

TelExt

String

Não

1234

O ramal do número de telefone do registrante do domínio.

Nota

Aplicável somente se RegistrantProfileId não for fornecido. Nessas situações, é um campo obrigatório e sua omissão causa erro no registro.

Email

String

Não

username@example.com

O endereço de e-mail do registrante do domínio.

Nota

Só tem efeito quando RegistrantProfileId não é especificado. Caso se aplique, preencha-o obrigatoriamente para garantir a conclusão do registro.

AliyunDns

Boolean

Não

true

Define se os servidores DNS da Alibaba Cloud serão utilizados. Valores válidos: true e false. Valor padrão: true.

Nota
  • Se definido como true, os parâmetros Dns1 e Dns2 são ignorados mesmo que especificados.

  • Se definido como false, informe os parâmetros Dns1 e Dns2.

Dns1

String

Não

ns1.aliyun.com

O primeiro servidor DNS personalizado.

Nota
  • Requerido apenas quando AliyunDns for definido como false.

  • Certifique-se de que o servidor DNS personalizado seja válido para evitar falhas no registro.

Dns2

String

Não

ns2.aliyun.com

O segundo servidor DNS personalizado.

Nota
  • Necessário apenas se AliyunDns for definido como false.

  • Valide o servidor DNS personalizado antes de enviar a solicitação, pois configurações incorretas podem causar falha no registro.

PermitPremiumActivation

Boolean

Não

false

Define se o registro de domínios contendo palavras premium é permitido. Valores válidos:

  • false: permite o registro de domínios com palavras premium.

  • true: bloqueia o registro de domínios com palavras premium.

Valor padrão: false.

PromotionNo

String

Não

123123

O ID do cupom a ser utilizado.

SubscriptionDuration

Integer

Não

1

A duração da assinatura do nome de domínio. Unidade: anos. Valor padrão: 1. Valor máximo: 10.

EnableDomainProxy

Boolean

Não

false

Defina se o serviço de proxy de domínio será ativado para este domínio. Valores válidos:

  • true: ative o serviço de proxy de domínio.

  • false: desativa o serviço de proxy de domínio.

Valor padrão: true.

UsePromotion

Boolean

Não

false

Define se um cupom será utilizado. Valores válidos:

  • false: utiliza um cupom.

  • true: não utiliza um cupom.

Valor padrão: false.

TrademarkDomainActivation

Boolean

Não

false

Define se o registro de domínios contendo marcas registradas é permitido. Valores válidos:

  • false: permite o registro de domínios com marcas registradas.

  • true: bloqueia o registro de domínios com marcas registradas.

UseCoupon

Boolean

Não

false

Define se um voucher será utilizado. Valores válidos:

  • true: utiliza um voucher.

  • false: não utiliza um voucher.

Valor padrão: false.

CouponNo

String

Não

123456

O ID do voucher a ser utilizado. Por padrão, o valor deste parâmetro é uma string.

Lang

String

Não

en

O idioma no qual o sistema retorna a mensagem de erro. Valores válidos:

  • zh: Chinês

  • en: Inglês

Valor padrão: en.

UserClientIp

String

Não

127.0.0.1

O endereço IP do cliente usado para registrar o domínio. Defina este parâmetro como 127.0.0.1.

Parâmetros de resposta

Parâmetro

Tipo

Exemplo

Descrição

RequestId

String

40F46D3D-F4F3-4CCB-AC30-2DD20E32E528

O ID da solicitação.

TaskNo

String

3cb1adc3-20e8-44ae-9e76-e812fa6fc9d8

O ID da tarefa.

Exemplos

Exemplos de solicitações

http://domain.aliyuncs.com/?Action=SaveSingleTaskForCreatingOrderActivate
&RegistrantProfileId=123
&DomainName=example.com
&<Common request parameters>

Exemplos de respostas de sucesso

Formato XML

<SaveSingleTaskForCreatingOrderActivateResponse>
      <TaskNo>3cb1adc3-20e8-44ae-9e76-e812fa6fc9d8</TaskNo>
      <RequestId>40F46D3D-F4F3-4CCB-AC30-2DD20E32E528</RequestId>
</SaveSingleTaskForCreatingOrderActivateResponse>

Formato JSON

{    
  "TaskNo": "3cb1adc3-20e8-44ae-9e76-e812fa6fc9d8",
  "RequestId": "40F46D3D-F4F3-4CCB-AC30-2DD20E32E528"
}

Códigos de erro

Para obter uma lista de códigos de erro, visite o API Error Center.