文档首页/ 虚拟私有云 VPC/ CLI参考/ CLI命令参考(V3)
更新时间:2026-09-07 GMT+08:00

CLI命令参考(V3)

VPC

API名称

命令

描述

操作

查询VPC列表

hcloud VPC ListVpcs/v3

查询vpc列表

去调试

查询VPC详情

hcloud VPC ShowVpc/v3

查询vpc详情

去调试

移除VPC扩展网段

hcloud VPC RemoveVpcExtendCidr/v3

移除VPC扩展网段

去调试

添加VPC扩展网段

hcloud VPC AddVpcExtendCidr/v3

添加VPC的扩展网段

去调试

IP地址组

API名称

命令

描述

操作

查询地址组

hcloud VPC ShowAddressGroup/v3

查询地址组详情。

去调试

更新地址组

hcloud VPC UpdateAddressGroup/v3

更新地址组。

去调试

删除地址组

hcloud VPC DeleteAddressGroup/v3

删除地址组,非强制删除,删除前请确保未被其他资源引用

去调试

查询地址组列表

hcloud VPC ListAddressGroup/v3

查询地址组列表,根据过滤条件进行过滤。

去调试

创建地址组

hcloud VPC CreateAddressGroup/v3

创建地址组

去调试

强制删除地址组

hcloud VPC DeleteIpAddressGroupForce/v3

强制删除地址组,删除的地址组与安全组规则关联时,会删除地址组与关联的安全组规则。

去调试

查询IP地址组的关联资源

hcloud VPC ListAddressGroupsDependency/v3

当您的IP地址组被网络ACL和安全组资源关联时,您可以通过调用该接口查询IP地址组关联的网络ACL或安全组的资源ID和名称。

去调试

安全组

API名称

命令

描述

操作

查询安全组列表

hcloud VPC ListSecurityGroups/v3

查询某租户下的安全组列表

去调试

创建安全组

hcloud VPC CreateSecurityGroup/v3

创建安全组

去调试

查询安全组

hcloud VPC ShowSecurityGroup/v3

查询单个安全组详情

去调试

更新安全组

hcloud VPC UpdateSecurityGroup/v3

更新安全组

去调试

删除安全组

hcloud VPC DeleteSecurityGroup/v3

删除安全组

去调试

安全组规则

API名称

命令

描述

操作

查询安全组规则列表

hcloud VPC ListSecurityGroupRules/v3

查询安全组规则列表

去调试

创建安全组规则

hcloud VPC CreateSecurityGroupRule/v3

创建安全组规则

去调试

查询安全组规则

hcloud VPC ShowSecurityGroupRule/v3

查询单个安全组规则

去调试

删除安全组规则

hcloud VPC DeleteSecurityGroupRule/v3

删除安全组规则

去调试

批量创建安全组规则

hcloud VPC BatchCreateSecurityGroupRules/v3

在特定安全组下批量创建安全组规则

去调试

辅助弹性网卡

API名称

命令

描述

操作

查询租户下辅助弹性网卡列表

hcloud VPC ListSubNetworkInterfaces/v3

查询辅助弹性网卡列表,单次查询最多返回2000条数据

去调试

创建辅助弹性网卡

hcloud VPC CreateSubNetworkInterface/v3

创建辅助弹性网卡

去调试

批量创建辅助弹性网卡

hcloud VPC BatchCreateSubNetworkInterface/v3

批量创建辅助弹性网卡

去调试

查询租户下辅助弹性网卡

hcloud VPC ShowSubNetworkInterface/v3

查询辅助弹性网卡详情

去调试

更新辅助弹性网卡

hcloud VPC UpdateSubNetworkInterface/v3

更新辅助弹性网卡

去调试

删除辅助弹性网卡

hcloud VPC DeleteSubNetworkInterface/v3

删除辅助弹性网卡

去调试

查询租户下辅助弹性网卡数目

hcloud VPC ShowSubNetworkInterfacesQuantity/v3

查询辅助弹性网卡数目

去调试

网络ACL

API名称

命令

描述

操作

查询网络ACL列表

hcloud VPC ListFirewall/v3

查询网络ACL列表

去调试

创建网络ACL

hcloud VPC CreateFirewall/v3

创建网络ACL

去调试

查询网络ACL详情

hcloud VPC ShowFirewall/v3

查询网络ACL详情

去调试

更新网络ACL

hcloud VPC UpdateFirewall/v3

更新网络ACL

去调试

删除网络ACL

hcloud VPC DeleteFirewall/v3

删除网络ACL

去调试

网络ACL更新规则

hcloud VPC UpdateFirewallRules/v3

网络ACL更新规则

去调试

网络ACL插入规则

hcloud VPC AddFirewallRules/v3

网络ACL插入规则

去调试

网络ACL移除规则

hcloud VPC RemoveFirewallRules/v3

网络ACL移除规则

去调试

网络ACL绑定子网

hcloud VPC AssociateSubnetFirewall/v3

网络ACL绑定子网

去调试

网络ACL解绑子网

hcloud VPC DisassociateSubnetFirewall/v3

网络ACL解绑子网

去调试

流量镜像会话

API名称

命令

描述

操作

查询流量镜像会话列表

hcloud VPC ListTrafficMirrorSessions/v3

查询流量镜像会话列表

去调试

创建流量镜像会话

hcloud VPC CreateTrafficMirrorSession/v3

创建流量镜像会话

去调试

查询流量镜像会话详情

hcloud VPC ShowTrafficMirrorSession/v3

查询流量镜像会话详情

去调试

更新流量镜像会话

hcloud VPC UpdateTrafficMirrorSession/v3

更新流量镜像会话

去调试

删除流量镜像会话

hcloud VPC DeleteTrafficMirrorSession/v3

删除流量镜像会话

去调试

流量镜像会话移除镜像源

hcloud VPC RemoveSourcesFromTrafficMirrorSession/v3

流量镜像会话移除镜像源

去调试

流量镜像会话添加镜像源

hcloud VPC AddSourcesToTrafficMirrorSession/v3

流量镜像会话添加镜像源

去调试

流量镜像筛选条件

API名称

命令

描述

操作

查询流量镜像筛选条件列表

hcloud VPC ListTrafficMirrorFilters/v3

查询流量镜像筛选条件列表

去调试

创建流量镜像筛选条件

hcloud VPC CreateTrafficMirrorFilter/v3

创建流量镜像筛选条件

去调试

查询流量镜像筛选条件详情

hcloud VPC ShowTrafficMirrorFilter/v3

查询流量镜像筛选条件详情

去调试

更新流量镜像筛选条件

hcloud VPC UpdateTrafficMirrorFilter/v3

更新流量镜像筛选条件

去调试

删除流量镜像筛选条件

hcloud VPC DeleteTrafficMirrorFilter/v3

删除流量镜像筛选条件

去调试

流量镜像筛选规则

API名称

命令

描述

操作

查询流量镜像筛选规则列表

hcloud VPC ListTrafficMirrorFilterRules/v3

查询流量镜像筛选规则列表

去调试

创建流量镜像筛选规则

hcloud VPC CreateTrafficMirrorFilterRule/v3

创建流量镜像筛选规则

去调试

查询流量镜像筛选规则详情

hcloud VPC ShowTrafficMirrorFilterRule/v3

查询流量镜像筛选规则详情

去调试

更新流量镜像筛选规则

hcloud VPC UpdateTrafficMirrorFilterRule/v3

更新流量镜像筛选规则

去调试

删除流量镜像筛选规则

hcloud VPC DeleteTrafficMirrorFilterRule/v3

删除流量镜像筛选规则

去调试

端口

API名称

命令

描述

操作

查询端口列表

hcloud VPC ListPorts/v3

当您的端口创建成功后,您可以通过调用该接口查询所有端口信息,包括端口ID、IP地址、所属云服务实例等。

去调试

查询端口详情

hcloud VPC ShowPort/v3

当您的端口创建成功后,您可以通过调用该接口查询单个端口的详细信息,包括端口ID、IP地址、所属云服务实例等。

去调试

端口插入安全组

hcloud VPC AddSecurityGroups/v3

端口插入安全组

去调试

端口移除安全组

hcloud VPC RemoveSecurityGroups/v3

端口移除安全组

去调试

网络ACL资源标签管理

API名称

命令

描述

操作

查询ACL资源实例数量

hcloud VPC CountFirewallsByTags/v3

使用标签过滤查询ACL实例数量。

去调试

查询ACL资源实例列表

hcloud VPC ListFirewallsByTags/v3

使用标签过滤查询ACL实例。

去调试

查询ACL资源标签

hcloud VPC ShowFirewallTags/v3

查询指定ACL实例的标签信息

去调试

添加ACL资源标签

hcloud VPC CreateFirewallTag/v3

给指定IP地址组资源实例增加标签信息

去调试

查询ACL项目标签

hcloud VPC ListFirewallTags/v3

查询租户在指定Project中实例类型的所有资源标签集合

去调试

批量添加ACL资源标签

hcloud VPC BatchCreateFirewallTags/v3

为指定的网络ACL资源实例批量添加标签。

去调试

删除ACL资源标签

hcloud VPC DeleteFirewallTag/v3

删除指定IP地址组资源实例的标签信息

去调试

批量删除ACL资源标签

hcloud VPC BatchDeleteFirewallTags/v3

为指定的网络ACL资源实例批量删除标签。

去调试

端口资源标签管理

API名称

命令

描述

操作

查询端口资源实例数量

hcloud VPC CountPortsByTags/v3

使用标签过滤查询端口实例数量。

去调试

查询端口资源实例列表

hcloud VPC ListPortsByTags/v3

使用标签过滤查询端口。

去调试

查询端口资源标签

hcloud VPC ShowPortTags/v3

查询指定端口的标签信息。

去调试

添加端口资源标签

hcloud VPC CreatePortTag/v3

给指定端口资源实例增加标签信息。

去调试

查询端口项目标签

hcloud VPC ListPortTags/v3

查询租户在指定Project中实例类型的所有资源标签集合。

去调试

批量添加端口资源标签

hcloud VPC BatchCreatePortTags/v3

为指定的端口批量添加标签。

去调试

删除端口资源标签

hcloud VPC DeletePortTag/v3

删除指定端口的标签信息。

去调试

批量删除端口资源标签

hcloud VPC BatchDeletePortTags/v3

为指定的端口资源实例批量删除标签。

去调试

虚拟子网

API名称

命令

描述

操作

查询虚拟子网列表

hcloud VPC ListVirsubnets/v3

当您的子网创建成功后,您可以通过调用该接口查询所有子网信息,包括子网的名称、ID等。

去调试

查询虚拟子网详情

hcloud VPC ShowVirsubnet/v3

当您的子网创建成功后,您可以通过调用该接口查询单个子网的详细信息,包括子网的名称、ID、状态等。

去调试

配额

API名称

命令

描述

操作

查询配额

hcloud VPC ShowQuota/v3

您可以通过此接口查询VPC服务相关资源的配额,包括安全组配额、安全组规则配额等。

去调试

子网预留网段

API名称

命令

描述

操作

查询子网预留网段列表

hcloud VPC ListVirsubnetCidrReservations/v3

当您的子网预留网段创建成功后,您可以通过调用该接口查询所有子网预留网段信息,包括子网预留网段名称、IP网段等。

去调试

创建子网预留网段

hcloud VPC CreateVirsubnetCidrReservation/v3

子网预留网段是子网网段范围的IP网段,此IP网段内的IP不会被子网内的实例占用。用户可以通过创建子网预留网段来预留某个IP网段,用于后续的特殊场景使用。

去调试

查询子网预留网段

hcloud VPC ShowVirsubnetCidrReservation/v3

当您的子网预留网段创建成功后,您可以通过调用该接口查询单个子网预留网段的详细信息,包括子网预留网段的名称、IP网段等。

去调试

更新子网预留网段

hcloud VPC UpdateVirsubnetCidrReservation/v3

当您的子网预留网段创建成功后,您可以通过调用该接口更新子网预留网段的基本信息,包括子网预留网段的名称、描述信息。

去调试

删除子网预留网段

hcloud VPC DeleteVirsubnetCidrReservation/v3

当您已创建的子网预留网段不再使用时,您可以通过调用该接口删除子网预留网段资源。

去调试