Todos los productos
Search
Centro de documentos

Domain Names:SaveSingleTaskForCreatingOrderActivate

Última actualización: Sep 03, 2026

Envía una tarea para registrar un nombre de dominio.

Descripción

Desde el 1 de marzo de 2022, solo puede registrar nombres de dominio mediante un perfil de registrante que haya aprobado la verificación de nombre real. Ya no es posible registrar nombres de dominio al especificar directamente la información del registrante.

Para registrar un nombre de dominio, debe especificar el nombre de dominio, el registrante y el servidor del sistema de nombres de dominio (DNS). Puede indicar el registrante mediante el ID de un perfil de registrante. De forma predeterminada, se utilizan los servidores DNS de Alibaba Cloud, aunque también puede usar servidores DNS personalizados.

Puede llamar a la operación QueryTaskDetailList para consultar el resultado de la ejecución de la tarea.

Depuración

OpenAPI Explorer calcula automáticamente el valor de la firma. Para su comodidad, le recomendamos llamar a esta operación en OpenAPI Explorer. OpenAPI Explorer genera dinámicamente el código de ejemplo de la operación para diferentes SDK.

Parámetros de solicitud

Parámetro

Tipo

Obligatorio

Ejemplo

Descripción

Action

String

Sí

SaveSingleTaskForCreatingOrderActivate

La operación que desea ejecutar. Establezca el valor en SaveSingleTaskForCreatingOrderActivate.

DomainName

String

Sí

example.com

El nombre de dominio que desea registrar.

Nota

Debe especificar el registrante del nombre de dominio al registrar un dominio. El registro fallará si no se especifica un registrante. Puede indicar el registrante mediante el ID de un perfil de registrante en el parámetro RegistrantProfileId.

RegistrantProfileId

Long

No

123

El ID del perfil de registrante. Este perfil incluye información como el nombre del registrante del dominio, el contacto del dominio, el número de teléfono y la dirección de correo electrónico. Solo puede especificar el registrante del dominio mediante el ID del perfil de registrante. Si ya creó un perfil de registrante, puede llamar a la operación QueryRegistrantProfiles para consultar el ID del perfil de registrante.

Nota

Si se especifica este parámetro, no es necesario especificar los siguientes parámetros: RegistrantType, ZhRegistrantOrganization, ZhRegistrantName, ZhProvince, ZhCity, ZhAddress, RegistrantOrganization, RegistrantName, Province, City, Address, PostalCode, Country, TelArea, Telephone, TelExt y Email.

RegistrantType

String

No

1

El tipo de registrante del nombre de dominio. Valores válidos:

  • 1: individual

  • 2: empresa u organización

Nota

Este parámetro solo surte efecto cuando no se especifica el parámetro RegistrantProfileId. En este caso, debe especificar este parámetro. El registro del nombre de dominio fallará si no se especifica este parámetro.

ZhRegistrantOrganization

String

No

Test

El nombre en chino del registrante del nombre de dominio.

Nota

Este parámetro solo aplica al servicio Domains en el sitio de China de Alibaba Cloud (aliyun.com). Este parámetro solo surte efecto cuando no se especifica el parámetro RegistrantProfileId. En este caso, debe especificar este parámetro. El registro del nombre de dominio fallará si no se especifica este parámetro.

ZhRegistrantName

String

No

Test

El nombre en chino del contacto del nombre de dominio.

Nota

Este parámetro solo aplica al servicio Domains en el sitio de China de Alibaba Cloud (aliyun.com). Este parámetro solo surte efecto cuando no se especifica el parámetro RegistrantProfileId. En este caso, debe especificar este parámetro. El registro del nombre de dominio fallará si no se especifica este parámetro.

ZhProvince

String

No

Bei Jing

La provincia where se encuentra el registrante del nombre de dominio, en chino.

Nota

Este parámetro solo aplica al servicio Domains en el sitio de China de Alibaba Cloud (aliyun.com). Este parámetro solo surte efecto cuando no se especifica el parámetro RegistrantProfileId. En este caso, debe especificar este parámetro. El registro del nombre de dominio fallará si no se especifica este parámetro.

ZhCity

String

No

Bei Jing

La ciudad where se encuentra el registrante del nombre de dominio, en chino.

Nota

Este parámetro solo aplica al servicio Domains en el sitio de China de Alibaba Cloud (aliyun.com). Este parámetro solo surte efecto cuando no se especifica el parámetro RegistrantProfileId. En este caso, debe especificar este parámetro. El registro del nombre de dominio fallará si no se especifica este parámetro.

ZhAddress

String

No

Chao Yang

La dirección del registrante del nombre de dominio, en chino.

Nota

Este parámetro solo aplica al servicio Domains en el sitio de China de Alibaba Cloud (aliyun.com). Este parámetro solo surte efecto cuando no se especifica el parámetro RegistrantProfileId. En este caso, debe especificar este parámetro. El registro del nombre de dominio fallará si no se especifica este parámetro.

RegistrantOrganization

String

No

Test

El nombre en inglés del registrante del nombre de dominio.

Nota

Este parámetro solo surte efecto cuando no se especifica el parámetro RegistrantProfileId. En este caso, debe especificar este parámetro. El registro del nombre de dominio fallará si no se especifica este parámetro.

RegistrantName

String

No

Test

El nombre en inglés del contacto del nombre de dominio.

Nota

Este parámetro solo surte efecto cuando no se especifica el parámetro RegistrantProfileId. En este caso, debe especificar este parámetro. El registro del nombre de dominio fallará si no se especifica este parámetro.

Province

String

No

Bei Jing

La provincia where se encuentra el registrante del nombre de dominio, en inglés.

Nota

Este parámetro solo surte efecto cuando no se especifica el parámetro RegistrantProfileId. En este caso, debe especificar este parámetro. El registro del nombre de dominio fallará si no se especifica este parámetro.

City

String

No

Bei Jing

La ciudad where se encuentra el registrante del nombre de dominio, en inglés.

Nota

Este parámetro solo surte efecto cuando no se especifica el parámetro RegistrantProfileId. En este caso, debe especificar este parámetro. El registro del nombre de dominio fallará si no se especifica este parámetro.

Address

String

No

Chao Yang

La dirección del registrante del nombre de dominio, en inglés.

Nota

Este parámetro solo surte efecto cuando no se especifica el parámetro RegistrantProfileId. En este caso, debe especificar este parámetro. El registro del nombre de dominio fallará si no se especifica este parámetro.

PostalCode

String

No

1234567

El código postal del área where se encuentra el registrante del nombre de dominio.

Nota

Este parámetro solo surte efecto cuando no se especifica el parámetro RegistrantProfileId. En este caso, debe especificar este parámetro. El registro del nombre de dominio fallará si no se especifica este parámetro.

Country

String

No

CN

El código del país o región where se encuentra el registrante del nombre de dominio, por ejemplo, CN.

Nota

Este parámetro solo surte efecto cuando no se especifica el parámetro RegistrantProfileId. En este caso, debe especificar este parámetro. El registro del nombre de dominio fallará si no se especifica este parámetro.

TelArea

String

No

86

El código telefónico internacional del país o región where se encuentra el contacto del nombre de dominio. Por ejemplo, el código telefónico internacional de China es 86.

Nota

Este parámetro solo surte efecto cuando no se especifica el parámetro RegistrantProfileId. En este caso, debe especificar este parámetro. El registro del nombre de dominio fallará si no se especifica este parámetro.

Telephone

String

No

12345678

El número de teléfono del registrante del nombre de dominio.

Nota

Este parámetro solo surte efecto cuando no se especifica el parámetro RegistrantProfileId. En este caso, debe especificar este parámetro. El registro del nombre de dominio fallará si no se especifica este parámetro.

TelExt

String

No

1234

El número de extensión del teléfono del registrante del nombre de dominio.

Nota

Este parámetro solo surte efecto cuando no se especifica el parámetro RegistrantProfileId. En este caso, debe especificar este parámetro. El registro del nombre de dominio fallará si no se especifica este parámetro.

Email

String

No

username@example.com

La dirección de correo electrónico del registrante del nombre de dominio.

Nota

Este parámetro solo surte efecto cuando no se especifica el parámetro RegistrantProfileId. En este caso, debe especificar este parámetro. El registro del nombre de dominio fallará si no se especifica este parámetro.

AliyunDns

Boolean

No

true

Especifica si se deben usar los servidores DNS de Alibaba Cloud. Valores válidos: true y false. Valor predeterminado: true.

Nota
  • Si este parámetro se establece en true, no es necesario especificar el parámetro Dns1 o Dns2. En este caso, si se especifica el parámetro Dns1 o Dns2, no surtirá efecto.

  • Si este parámetro se establece en false, debe especificar los parámetros Dns1 y Dns2.

Dns1

String

No

ns1.aliyun.com

El servidor DNS personalizado 1.

Nota
  • Este parámetro solo surte efecto cuando el parámetro AliyunDns se establece en false. En este caso, debe especificar este parámetro.

  • Asegúrese de que el servidor DNS personalizado sea válido. De lo contrario, el registro podría fallar.

Dns2

String

No

ns2.aliyun.com

El servidor DNS personalizado 2.

Nota
  • Este parámetro solo surte efecto cuando el parámetro AliyunDns se establece en false. En este caso, debe especificar este parámetro.

  • Asegúrese de que el servidor DNS personalizado sea válido. De lo contrario, el registro podría fallar.

PermitPremiumActivation

Boolean

No

false

Especifica si se permite el registro de nombres de dominio que contienen palabras premium. Valores válidos:

  • false: permite el registro de nombres de dominio que contienen palabras premium.

  • true: no permite el registro de nombres de dominio que contienen palabras premium.

Valor predeterminado: false.

PromotionNo

String

No

123123

El ID del cupón que desea utilizar.

SubscriptionDuration

Integer

No

1

La duración de la suscripción del nombre de dominio. Unidad: años. Valor predeterminado: 1. Valor máximo: 10.

EnableDomainProxy

Boolean

No

false

Especifica si se debe habilitar el servicio de proxy de nombre de dominio para el dominio. Valores válidos:

  • true: habilita el servicio de proxy de nombre de dominio para el dominio.

  • false: deshabilita el servicio de proxy de nombre de dominio para el dominio.

Valor predeterminado: true.

UsePromotion

Boolean

No

false

Especifica si se debe usar un cupón. Valores válidos:

  • false: usa un cupón.

  • true: no usa un cupón.

Valor predeterminado: false.

TrademarkDomainActivation

Boolean

No

false

Especifica si se permite el registro de nombres de dominio que contienen palabras de marcas registradas. Valores válidos:

  • false: permite el registro de nombres de dominio que contienen palabras de marcas registradas.

  • true: no permite el registro de nombres de dominio que contienen palabras de marcas registradas.

UseCoupon

Boolean

No

false

Especifica si se debe usar un vale. Valores válidos:

  • true: usa un vale.

  • false: no usa un vale.

Valor predeterminado: false.

CouponNo

String

No

123456

El ID del vale que desea utilizar. De forma predeterminada, el valor de este parámetro es una cadena.

Lang

String

No

en

El idioma en el que el sistema devuelve el mensaje de error. Valores válidos:

  • zh: chino

  • en: inglés

Valor predeterminado: en.

UserClientIp

String

No

127.0.0.1

La dirección IP del cliente que utiliza para registrar el nombre de dominio. Puede establecer este parámetro en 127.0.0.1.

Parámetros de respuesta

Parámetro

Tipo

Ejemplo

Descripción

RequestId

String

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

El ID de la solicitud.

TaskNo

String

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

El ID de la tarea.

Ejemplos

Solicitudes de ejemplo

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

Respuestas de éxito de ejemplo

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 error

Para obtener una lista de códigos de error, visite el Centro de errores de API.