更新时间：2025-09-23 GMT+08:00
申请域名
功能介绍
为指定集群申请域名。
调用方法
请参见如何调用API。
URI
POST /v1.0/{project_id}/clusters/{cluster_id}/dns
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
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 | 服务不可用。 |
父主题：连接管理
