文档

SaveSingleTaskForCreatingOrderActivate - 提交域名注册任务

更新时间:

调用SaveSingleTaskForCreatingOrderActivate提交域名注册任务。

接口说明

2022 年 3 月 1 日起,仅能通过已实名认证的域名信息模板注册域名,不再支持传入持有者信息注册域名。

注册域名需同时填写您想注册的域名、域名持有者信息及 DNS。您需要通过已实名认证的域名信息模板编号来关联域名的持有者信息,DNS 可以默认使用阿里云 DNS 或者填写自定义 DNS。

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

调试

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

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
domain:CreateOrderActivateWrite
  • 全部资源
    *

请求参数

名称类型必填描述示例值
ZhRegistrantNamestring

域名联系人(中文)。

说明 该参数仅适用于中国站。当未传入 RegistrantProfileId 参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
测试
Langstring

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

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

默认为 en

en
DomainNamestring

想要注册的域名。

说明 注册域名时必须指定域名持有者信息,不指定域名持有者信息会导致域名注册失败。您可以通过 RegistrantProfileId 参数指定信息模板定义域名持有者信息。
example.com
SubscriptionDurationinteger

购买周期,单位为。默认为1 年,最长可购买10 年

1
RegistrantProfileIdlong

域名信息模板编号(信息模板包含域名持有者名称、域名联系人、电话、邮箱等信息),仅能使用已实名认证的域名信息模板编号进行域名注册。如果您已经创建了域名注册信息模板,可通过调用 QueryRegistrantProfiles 接口查询域名信息模板编号。

说明 传入本参数后,无需再传入 RegistrantTypeZhRegistrantOrganizationZhRegistrantNameZhProvinceZhCityZhAddressRegistrantOrganizationRegistrantNameProvinceCityAddressPostalCodeCountryTelAreaTelephoneTelExtEmail 参数。
123
EnableDomainProxyboolean

是否开启域名隐私保护服务。取值:

  • true:开启。
  • false:不开启。

默认值为 true

false
PermitPremiumActivationboolean

是否允许注册白金词,取值:

  • false:不允许。
  • true:允许。

默认值为 false

false
AliyunDnsboolean

是否使用阿里云 DNS,取值为 true|false,默认为 true

说明
  • 取值为 true 时,您无需再传入 Dns1Dns2 参数,否则传入的 Dns1Dns2 参数不会生效。
    • 取值为 false 时,您还需要传入 Dns1Dns2 参数。
    true
    Dns1string

    自定义 DNS1。

    说明
  • AliyunDns 取值为 false 时,本参数才可用且必须传入。
    • 请务必确保自定义 DNS 的正确性,否则可能导致注册失败。
    ns1.aliyun.com
    UserClientIpstring

    用户 IP,可设置为127.0.0.1

    127.0.0.1
    ZhCitystring

    城市(中文)。

    说明 该参数仅适用于中国站。当未传入 RegistrantProfileId 参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
    北京市
    ZhRegistrantOrganizationstring

    域名持有者名称(中文)。

    说明 该参数仅适用于中国站。当未传入 RegistrantProfileId 参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
    测试
    Countrystring

    国家代码,例如 CN

    说明 当未传入 RegistrantProfileId 参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
    CN
    Dns2string

    自定义 DNS2。

    说明
  • AliyunDns 取值为 false 时,本参数才可用且必须传入。
    • 请务必确保自定义 DNS 的正确性,否则可能导致注册失败。
    ns2.aliyun.com
    ZhProvincestring

    省份(中文)。

    说明 该参数仅适用于中国站。当未传入 RegistrantProfileId 参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
    北京
    ZhAddressstring

    详细地址(中文)。

    说明 该参数仅适用于中国站。当未传入 RegistrantProfileId 参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
    朝阳区
    Citystring

    城市(英文)。

    说明 当未传入 RegistrantProfileId 参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
    bei jing shi
    RegistrantOrganizationstring

    域名持有者名称(英文)。

    说明 当未传入 RegistrantProfileId 参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
    ce shi
    RegistrantNamestring

    域名联系人(英文)。

    说明 当未传入 RegistrantProfileId 参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
    ce shi
    Provincestring

    省份(英文)。

    说明 当未传入 RegistrantProfileId 参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
    bei jing
    Addressstring

    详细地址(英文)。

    说明 当未传入 RegistrantProfileId 参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
    chao yang qu
    Emailstring

    电子邮箱。

    说明 当未传入 RegistrantProfileId 参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
    username@example.com
    PostalCodestring

    邮政编码。

    说明 当未传入 RegistrantProfileId 参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
    1234567
    TelAreastring

    电话国家代码,例如中国为 86

    说明 当未传入 RegistrantProfileId 参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
    86
    Telephonestring

    电话号码。

    说明 当未传入 RegistrantProfileId 参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
    12345678
    TelExtstring

    分机号码。

    说明 当未传入 RegistrantProfileId 参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
    1234
    RegistrantTypestring

    域名持有者类型。取值:

    • 1:个人。
    • 2:企业、组织等。
    说明 当未传入 RegistrantProfileId 参数时,本参数才可用且必须传入,如果不传入会导致域名注册失败。
    1
    TrademarkDomainActivationboolean

    是否允许注册商标词,取值:

    • false:不允许。
    • true:允许。
    false
    CouponNostring

    代金券编号,默认为字符串。

    123456
    UseCouponboolean

    是否使用代金券。取值:

    • true:使用
    • false:不使用

    默认值为 false

    false
    PromotionNostring

    优惠券编号。

    123123
    UsePromotionboolean

    是否使用优惠券,取值:

    • false:不允许。
    • true:允许。

    默认值为 false

    false
    ResourceGroupIdstring

    无。

    rg-XX

    返回参数

    名称类型描述示例值
    object
    RequestIdstring

    唯一请求识别码。

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

    任务编号。

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

    示例

    正常返回示例

    JSON格式

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

    错误码

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

    • 本页导读 (1)
    文档反馈