CLI命令参考
版本管理
公网域名管理
| 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 | 查询批量操作任务,分页返回失败条目。 |