更新时间:2026-08-24 GMT+08:00
分享

CLI命令参考

版本管理

API名称

命令

描述

操作

查询API版本信息列表

hcloud DNS ListApiVersions

查询云解析服务支持的所有API版本信息列表。

去调试

查询指定版本号的API版本信息

hcloud DNS ShowApiInfo

查询指定版本号的云解析服务API版本信息。

去调试

公网域名管理

API名称

命令

描述

操作

查询公网域名列表

hcloud DNS ListPublicZones

当您的公网域名创建成功后,您可以通过调用此接口查询所有公网域名信息,包括域名、ID、状态、记录集个数、企业项目、标签、TTL、创建时间、修改时间、描述等。

去调试

查询公网域名

hcloud DNS ShowPublicZone

当您的公网域名创建成功后,您可以通过调用此接口查询单个公网域名信息,包括域名、ID、状态、记录集个数、企业项目、标签、TTL、创建时间、修改时间、描述等。

去调试

查询公网域名的名称服务器

hcloud DNS ShowPublicZoneNameServer

当您的公网域名创建成功后,您可以通过调用此接口查询公网域名的名称服务器信息,包括主机名、优先级等。

去调试

删除公网域名

hcloud DNS DeletePublicZone

当您的公网域名不再使用时,您可以通过调用此接口将其删除。

去调试

修改公网域名

hcloud DNS UpdatePublicZone

当您的公网域名创建成功后,您可以通过调用此接口修改公网域名的基本信息,包括TTL、描述等。

去调试

设置公网域名状态

hcloud DNS UpdatePublicZoneStatus

当您的公网域名创建成功后,您可以通过调用此接口设置公网域名的状态,包括暂停、启用。

去调试

创建公网域名

hcloud DNS CreatePublicZone

您在使用华为云云解析服务为自己注册的域名配置DNS解析之前,需要先将域名添加至云解析服务控制台。

去调试

创建公网域名找回

hcloud DNS CreateRetrieval

创建公网域名找回请求。

去调试

查询公网域名找回

hcloud DNS ShowRetrieval

查询公网域名找回请求。

去调试

验证公网域名找回

hcloud DNS CreateRetrievalVerification

验证公网域名找回。

去调试

查询公网域名找回结果

hcloud DNS ShowRetrievalVerification

查询公网域名找回结果。

去调试

创建公网子域名授权

hcloud DNS CreateAuthorizeTxtRecord

当创建子域名时提示“域名与其他租户冲突,你需要添加TXT授权校验”,通过调用当前接口生成子域名授权的TXT记录验证信息。

去调试

查询公网子域名授权

hcloud DNS ShowAuthorizeTxtRecord

查询已生成的子域名授权TXT记录验证信息。

去调试

验证公网子域名授权

hcloud DNS CreateAuthorizeTxtRecordVerification

用户在主域名所属DNS服务商处添加TXT类型解析记录后,调用当前接口验证子域名授权状态。

去调试

内网域名管理

API名称

命令

描述

操作

创建内网域名

hcloud DNS CreatePrivateZone

内网域名是指在VPC中生效的域名,内网域名创建后,用户可以将其与私网IP地址相关联,为云服务提供VPC内的内网域名解析服务。

去调试

在内网域名上关联VPC

hcloud DNS AssociateRouter

当您的内网域名创建完成后,可以通过调用此接口为内网域名关联新的VPC。

去调试

在内网域名上解关联VPC

hcloud DNS DisassociateRouter

当您的内网域名创建完成后,可以通过调用此接口为内网域名解除已关联的VPC。

去调试

查询内网域名

hcloud DNS ShowPrivateZone

当您的内网域名创建成功后,您可以通过调用此接口查询单个内网域名信息,包括域名、ID、状态、记录集个数、企业项目、标签、TTL、创建时间、修改时间、描述等。

去调试

查询内网域名列表

hcloud DNS ListPrivateZones

当您的内网域名创建成功后,您可以通过调用此接口查询单个内网域名信息,包括域名、ID、状态、记录集个数、企业项目、标签、TTL、创建时间、修改时间、描述等。

去调试

查询内网域名的名称服务器

hcloud DNS ShowPrivateZoneNameServer

当您的内网域名创建成功后,您可以通过调用此接口查询内网域名的名称服务器信息,包括优先级、DNS服务器地址等。

去调试

删除内网域名

hcloud DNS DeletePrivateZone

当您的内网域名不再使用时,您可以通过调用此接口将其删除。

去调试

修改内网域名

hcloud DNS UpdatePrivateZone

当您的内网域名创建成功后,您可以通过调用此接口修改内网域名的基本信息,包括TTL、描述等。

去调试

设置内网域名状态

hcloud DNS UpdatePrivateZoneStatus

当您的内网域名创建成功后,您可以通过调用此接口设置内网域名的状态,包括暂停、启用。

去调试

设置内网域名的子域名递归解析代理

hcloud DNS SetPrivateZoneProxyPattern

当您的内网域名创建成功后,您可以通过调用此接口设置开启或者关闭内网域名的子域名递归解析代理。

去调试

记录集管理(v2)

API名称

命令

描述

操作

创建记录集

hcloud DNS CreateRecordSet

记录集是指一组资源记录的集合,这些资源记录属于同一域名,用于定义域名支持的解析类型以及解析值。您的域名创建完成后,可以通过调用此接口为域名添加不同类型的记录集。

去调试

查询域名下的记录集列表

hcloud DNS ListRecordSetsByZone

当您的记录集创建成功后,您可以通过调用此接口查询指定域名下的所有记录集信息,包括名称、ID、状态、所属域名、解析记录值、标签、TTL、创建时间、修改时间、描述等。

去调试

查询记录集

hcloud DNS ShowRecordSet

当您的记录集创建成功后,您可以通过调用此接口查询指定域名下的所有记录集信息,包括名称、ID、状态、所属域名、解析记录值、标签、TTL、创建时间、修改时间、描述等。

去调试

查询租户记录集列表

hcloud DNS ListRecordSets

当您的记录集创建成功后,您可以通过调用此接口查询所有记录集信息,包括名称、ID、状态、所属域名、解析记录值、标签、TTL、创建时间、修改时间、描述等。

去调试

删除记录集

hcloud DNS DeleteRecordSet

当您的记录集不再使用时,您可以通过调用此接口将其删除。

去调试

修改记录集

hcloud DNS UpdateRecordSet

当您的记录集创建成功后,您可以通过调用此接口修改记录集的信息,包括域名、类型、记录值、TTL、描述等。

去调试

记录集管理(v2.1)

API名称

命令

描述

操作

创建记录集

hcloud DNS CreateRecordSetWithLine

记录集是指一组资源记录的集合,这些资源记录属于同一域名,用于定义域名支持的解析类型以及解析值。您的域名创建完成后,可以通过调用此接口为域名添加不同类型的记录集。

去调试

批量删除域名下的记录集

hcloud DNS BatchDeleteRecordSetWithLine

批量删除域名下的记录集,当删除的资源不存在时,则默认删除成功。

去调试

批量修改记录集

hcloud DNS BatchUpdateRecordSetWithLine

批量修改记录集。属于原子性操作,请求记录集将全部完成修改,或不做任何修改。

去调试

查询记录集

hcloud DNS ShowRecordSetWithLine

当您的记录集创建成功后,您可以通过调用此接口查询单个记录集信息,包括名称、ID、状态、所属域名、解析记录值、标签、TTL、创建时间、修改时间、描述等。

去调试

查询租户记录集列表

hcloud DNS ListRecordSetsWithLine

当您的记录集创建成功后,您可以通过调用此接口查询所有记录集信息,包括名称、ID、状态、所属域名、解析记录值、标签、TTL、创建时间、修改时间、描述等。

去调试

批量线路创建记录集

hcloud DNS CreateRecordSetWithBatchLines

批量线路创建记录集。属于原子性操作,如果存在一个参数校验不通过,则创建失败。仅公网域名支持。

去调试

查询域名下的记录集列表

hcloud DNS ShowRecordSetByZone

当您的记录集创建成功后,您可以通过调用此接口查询指定域名下的所有记录集信息,包括名称、ID、状态、所属域名、解析记录值、标签、TTL、创建时间、修改时间、描述等。

去调试

删除记录集

hcloud DNS DeleteRecordSets

当您的记录集不再使用时,您可以通过调用此接口将其删除。

去调试

修改记录集

hcloud DNS UpdateRecordSets

当您的记录集创建成功后,您可以通过调用此接口修改记录集的信息,包括域名、类型、记录值、TTL、描述等。

去调试

设置记录集状态

hcloud DNS SetRecordSetsStatus

当您的记录集创建成功后,您可以通过调用此接口设置记录集的状态,包括暂停、启用。

去调试

查询公网域名的线路列表

hcloud DNS ListPublicZoneLines

公网域名支持设置线路解析,当您的公网域名创建完成并添加记录集时,可通过调用此接口查询公网域名的所有解析线路。

去调试

批量创建记录集

hcloud DNS BatchCreateRecordSetsTask

提交批量创建记录集任务,返回任务ID。

去调试

查询批量创建记录集任务

hcloud DNS ShowBatchCreateRecordSetsTask

查询批量创建记录集任务,分页返回失败条目。

去调试

删除批量创建记录集任务

hcloud DNS DeleteBatchCreateRecordSetsTask

删除批量创建记录集任务。

去调试

查询系统线路

hcloud DNS ListSystemLines

查询系统预置解析线路。

去调试

反向解析管理(v2)

API名称

命令

描述

操作

设置弹性公网IP的反向解析记录

hcloud DNS CreateEipRecordSet

设置弹性公网IP的反向解析记录。

去调试

查询弹性公网IP的反向解析记录

hcloud DNS ShowPtrRecordSet

查询弹性公网IP的反向解析记录。

去调试

查询弹性公网IP的反向解析记录列表

hcloud DNS ListPtrRecords

查询弹性公网IP的反向解析记录列表。

去调试

将弹性公网IP的反向解析记录恢复为默认值

hcloud DNS RestorePtrRecord

将弹性公网IP的反向解析记录恢复为默认值。

去调试

修改弹性公网IP的反向解析记录

hcloud DNS UpdatePtrRecord

修改弹性公网IP的反向解析记录。

去调试

反向解析管理(v2.1)

API名称

命令

描述

操作

创建弹性公网IP的反向解析记录

hcloud DNS CreatePtr

创建弹性公网IP的反向解析记录。

去调试

查询弹性公网IP的反向解析记录列表

hcloud DNS ListPtrs

查询弹性公网IP的反向解析记录列表。

去调试

查询弹性公网IP的反向解析记录

hcloud DNS ShowPtr

查询弹性公网IP的反向解析记录。

去调试

修改弹性公网IP的反向解析记录

hcloud DNS UpdatePtr

修改弹性公网IP的反向解析记录。

去调试

将弹性公网IP的反向解析记录恢复为默认值

hcloud DNS DeletePtr

将弹性公网IP的反向解析记录恢复为默认值。

去调试

标签管理

API名称

命令

描述

操作

为指定实例添加标签

hcloud DNS CreateTag

为指定实例添加标签

去调试

删除资源标签

hcloud DNS DeleteTag

删除资源标签

去调试

为指定实例批量添加或删除标签

hcloud DNS BatchCreateTag

为指定实例批量添加或删除标签

去调试

查询指定实例的标签信息

hcloud DNS ShowResourceTag

查询指定实例的标签信息

去调试

查询指定实例类型的所有标签集合

hcloud DNS ListTags

查询指定实例类型的所有标签集合

去调试

使用标签查询资源实例

hcloud DNS ListTag

使用标签查询资源实例

去调试

自定义线路管理

API名称

命令

描述

操作

创建自定义线路

hcloud DNS CreateCustomLine

创建自定义线路。

去调试

查询自定义线路

hcloud DNS ListCustomLine

查询自定义线路。

去调试

删除自定义线路

hcloud DNS DeleteCustomLine

删除自定义线路。

去调试

修改自定义线路

hcloud DNS UpdateCustomLine

修改自定义线路。

去调试

创建线路分组

hcloud DNS CreateLineGroup

创建线路分组。该接口部分区域未上线,如需使用请提交工单申请开通。

去调试

查询线路分组列表

hcloud DNS ListLineGroups

查询线路分组列表。该接口部分区域未上线,如需使用请提交工单申请开通。

去调试

查询线路分组

hcloud DNS ShowLineGroup

查询线路分组。该接口部分区域未上线,如需使用请提交工单申请开通。

去调试

修改线路分组

hcloud DNS UpdateLineGroups

修改线路分组。该接口部分区域未上线,如需使用请提交工单申请开通。

去调试

删除线路分组

hcloud DNS DeleteLineGroup

删除线路分组。该接口部分区域未上线,如需使用请提交工单申请开通。

去调试

名称服务器管理

API名称

命令

描述

操作

查询名称服务器列表

hcloud DNS ListNameServers

查询名称服务器列表

去调试

配额管理

API名称

命令

描述

操作

查询租户配额

hcloud DNS ShowDomainQuota

查询租户在DNS服务下的资源配额,包括公网域名配额、内网域名配额、记录集配额、反向解析配额、自定义线路配额、线路分组配额、入站终端节点配额、出站终端节点配额、转发规则配额等。

去调试

解析器管理

API名称

命令

描述

操作

创建终端节点

hcloud DNS CreateEndpoint

创建终端节点。

去调试

查询终端节点列表

hcloud DNS ListEndpoints

查询终端节点列表。

去调试

查询终端节点

hcloud DNS ShowEndpoint

查询终端节点。

去调试

修改终端节点

hcloud DNS UpdateEndpoint

修改终端节点

去调试

删除终端节点

hcloud DNS DeleteEndpoint

删除终端节点。

去调试

终端节点绑定IP地址

hcloud DNS AssociateEndpointIpaddress

终端节点绑定IP地址。

去调试

查询IP地址列表

hcloud DNS ListEndpointIpaddresses

查询终端节点下的IP地址列表。

去调试

终端节点解绑IP地址

hcloud DNS DisassociateEndpointIpaddress

终端节点解绑IP地址。

去调试

查询终端节点VPC列表

hcloud DNS ListEndpointVpcs

查询终端节点VPC列表。

去调试

创建解析器转发规则

hcloud DNS CreateResolverRule

创建解析器转发规则。

去调试

查询解析器转发规则列表

hcloud DNS ListResolverRules

查询解析器转发规则列表。

去调试

解析器转发规则关联VPC

hcloud DNS AssociateResolverRuleRouter

解析器转发规则关联VPC。

去调试

解析器转发规则解关联VPC

hcloud DNS DisassociateResolverRuleRouter

解析器转发规则解关联VPC。

去调试

查询解析器转发规则

hcloud DNS ShowResolverRule

查询解析器转发规则。

去调试

修改解析器转发规则

hcloud DNS UpdateResolverRule

修改解析器转发规则。

去调试

删除解析器转发规则

hcloud DNS DeleteResolverRule

删除解析器转发规则。

去调试

访问日志管理

API名称

命令

描述

操作

创建解析器访问日志

hcloud DNS CreateResolverQueryLogConfig

创建解析器访问日志。

去调试

查询解析器访问日志列表

hcloud DNS ListResolverQueryLogConfigs

查询解析器访问日志列表。

去调试

解析器访问日志关联VPC

hcloud DNS AssociateResolverQueryLogConfig

解析器访问日志关联VPC。

去调试

解析器访问日志解关联VPC

hcloud DNS DisassociateResolverQueryLogConfig

解析器访问日志解关联VPC。

去调试

查询解析器访问日志

hcloud DNS ShowResolverQueryLogConfig

查询解析器访问日志。

去调试

删除解析器访问日志

hcloud DNS DeleteResolverQueryLogConfig

删除解析器访问日志。

去调试

批量操作

API名称

命令

描述

操作

批量删除域名

hcloud DNS BatchDeleteZones

批量删除域名。

去调试

批量删除记录集

hcloud DNS BatchDeleteRecordSets

批量删除记录集。

去调试

批量删除反向解析

hcloud DNS BatchDeletePtrRecords

批量删除反向解析。本接口为原子操作,所有记录应全部删除成功或全部失败。

去调试

批量设置域名状态

hcloud DNS BatchSetZonesStatus

批量设置域名状态。

去调试

批量设置记录集状态

hcloud DNS BatchSetRecordSetsStatus

批量设置记录集状态。

去调试

批量查询DNS解析量统计相关的资源

hcloud DNS ListInstances

批量查询DNS解析量统计相关的资源。

去调试

批量创建公网域名

hcloud DNS BatchCreatePublicZonesTask

提交批量创建公网域名任务,返回任务ID。

去调试

批量创建公网记录集

hcloud DNS BatchCreateCombinedPublicRecordsetsTask

提交批量创建公网记录集任务,返回任务ID。

去调试

批量创建公网记录集

hcloud DNS BatchCreatePublicRecordsetsTask

提交批量创建公网记录集任务,返回任务ID。

去调试

批量删除公网记录集

hcloud DNS BatchDeletePublicRecordsetsTask

提交批量删除公网记录集任务,返回任务ID。

去调试

批量修改公网记录集

hcloud DNS BatchUpdatePublicRecordsetsTask

提交批量修改公网记录集任务,返回任务ID。

去调试

批量转移公网域名

hcloud DNS BatchTransferPublicZonesTask

提交批量转移公网域名任务,返回任务ID。

去调试

查询批量操作任务列表

hcloud DNS ListBatchOperationTasks

查询批量操作任务列表。

去调试

查询批量操作任务

hcloud DNS ShowBatchOperationTask

查询批量操作任务,分页返回失败条目。

去调试

DNSSEC

API名称

命令

描述

操作

开启DNSSEC

hcloud DNS EnableDnssecConfig

开启公网域名的DNSSEC。

去调试

关闭DNSSEC

hcloud DNS DisableDnssecConfig

关闭公网域名的DNSSEC。

去调试

查询DNSSEC

hcloud DNS ShowDnssecConfig

查询公网域名的DNSSEC。

去调试

公网域名检测

API名称

命令

描述

操作

查询公网域名的域名诊断

hcloud DNS ShowDomainDetection

查询公网域名的域名诊断。

去调试

查询公网域名的邮箱域名

hcloud DNS ShowEmailRecordSet

查询公网域名的邮箱域名。

去调试

查询公网域名的网站域名

hcloud DNS ShowWebsiteRecordSet

查询公网域名的网站域名。

去调试

查询公网域名的DNS服务器地址

hcloud DNS ShowZoneNameServer

查询域名当前DNS服务器地址及华为云提供的DNS服务器地址。

去调试

相关文档