更新时间:2025-09-18 GMT+08:00

申请域名

功能介绍

为指定集群申请域名。

调用方法

请参见如何调用API

URI

POST /v1.0/{project_id}/clusters/{cluster_id}/dns

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID。获取方法请参见获取项目ID

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

cluster_id

String

参数解释

集群ID。获取方法请参见获取集群ID

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

name

String

参数解释

待创建的域名。

取值范围

不涉及。

type

String

参数解释

域名类型。

取值范围

public:公网域名。

private:内网域名。

ttl

Integer

参数解释

用于填写默认生成的SOA记录中有效缓存时间,以秒为单位。默认值为300s。

取值范围

300~2147483647。

响应参数

状态码:200

申请域名成功。

请求示例

申请公网域名demo,默认生成的SOA记录中有效缓存时间为300s。

POST https://{Endpoint}/v1.0/89cd04f168b84af6be287f71730fdb4b/clusters/b5c45780-1006-49e3-b2d5-b3229975bbc7/dns

{
  "name" : "demo",
  "type" : "public",
  "ttl" : 300
}

响应示例

状态码

状态码

描述

200

申请域名成功。

400

请求错误。

401

鉴权失败。

403

没有操作权限。

404

找不到资源。

500

服务内部错误。

503

服务不可用。