# CLI命令参考 #### 物理连接 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询物理连接详情 | hcloud DC ShowDirectConnect | 查询物理连接详细信息. | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ShowDirectConnect) | | 更新物理连接信息 | hcloud DC UpdateDirectConnect | 更新物理连接信息，包括名字,描述等信息 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=UpdateDirectConnect) | | 删除物理连接 | hcloud DC DeleteDirectConnect | 删除物理连接，本接口只适用于按需计费物理专线，对于包周期购买的专线通过订单退订的方式删除物理连接 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=DeleteDirectConnect) | | 查询物理连接列表 | hcloud DC ListDirectConnects | 查询租户创建的所有的direct connect对象. | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ListDirectConnects) | | 查询租户的托管专线列表 | hcloud DC ListHostedDirectConnects | 查询合作伙伴创建的托管专线连接列表. | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ListHostedDirectConnects) | | 创建托管专线连接 | hcloud DC CreateHostedDirectConnect | 用于合作伙伴用户最终租户创建托管专线 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=CreateHostedDirectConnect) | | 查询租户的托管专线详情 | hcloud DC ShowHostedDirectConnect | 查询合法作伙伴的Hosted专线类型. | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ShowHostedDirectConnect) | | 更新托管专线连接 | hcloud DC UpdateHostedDirectConnect | 合作伙伴更新托管专线. | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=UpdateHostedDirectConnect) | | 删除托管专线连接 | hcloud DC DeleteHostedDirectConnect | 合作伙伴删除托管专线 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=DeleteHostedDirectConnect) | #### 虚拟网关 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询虚拟网关详情 | hcloud DC ShowVirtualGateway | 查询指定虚拟网关的详细信息 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ShowVirtualGateway) | | 更新虚拟网关信息 | hcloud DC UpdateVirtualGateway | 更新虚拟网关的信息 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=UpdateVirtualGateway) | | 删除虚拟网关 | hcloud DC DeleteVirtualGateway | 删除指定的虚拟网关 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=DeleteVirtualGateway) | | 查询虚拟网关列表 | hcloud DC ListVirtualGateways | 查询虚拟网关列表 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ListVirtualGateways) | | 创建虚拟网关 | hcloud DC CreateVirtualGateway | 创建虚拟网关 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=CreateVirtualGateway) | #### 虚拟接口 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询虚拟接口详情 | hcloud DC ShowVirtualInterface | 查询虚拟接口详细信息 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ShowVirtualInterface) | | 更新虚拟接口 | hcloud DC UpdateVirtualInterface | 更新虚拟接口的详细信息 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=UpdateVirtualInterface) | | 删除虚拟接口 | hcloud DC DeleteVirtualInterface | 删除虚拟接口 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=DeleteVirtualInterface) | | 查询虚拟接口列表 | hcloud DC ListVirtualInterfaces | 查询租户所有的虚拟接口列表 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ListVirtualInterfaces) | | 创建虚拟接口 | hcloud DC CreateVirtualInterface | 虚拟接口配置物理专线上与客户互联的IP和路由等相关信息 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=CreateVirtualInterface) | | 修改虚拟接口可靠性检测的扩展参数 | hcloud DC UpdateExtendAttribute | 虚拟接口有bfd与nqa两种可靠性检测方式，您可以通过调用此接口修改可靠性检测的参数，例如检测报文最小发送间隔、检测报文最大发送间隔、检测周期等信息。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=UpdateExtendAttribute) | | 更新虚拟接口对等体 | hcloud DC UpdateVifPeer | 更新虚拟接口对等体信息,包括远端子网，名字和描述等。 本接口只在支持Ipv6的区域开放，如需要使用请联系客服 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=UpdateVifPeer) | | 删除虚拟接口对应的对等体 | hcloud DC DeleteVifPeer | 删除虚拟接口对等体信息,虚拟接口至少要含一个对等体，最后一个对等体不能删除 本接口只在支持Ipv6的区域开放，如需要使用请联系客服 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=DeleteVifPeer) | | 创建虚拟接口对等体 | hcloud DC CreateVifPeer | 每个虚拟接口可支持两个对等体，IPv4和IPv6对等体，在创建虚拟接口时默认创建IPv4对等体， 本接口一般用于增加ipv6对等体。创建虚拟接口对接体之后，可以通过虚拟接口查询配置结果 本接口只在支持Ipv6的区域开放，如需要使用请联系客服 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=CreateVifPeer) | | 执行虚拟接口倒换测试 | hcloud DC SwitchoverTest | 客户双专线接入，需要支持双线自动倒换，方便进行功能测试。 虚拟接口进行倒换测试会导致接口关闭，业务流量中断。 对于虚拟接口，支持"关闭接口"和"开放接口"两种操作。 1、关闭接口：下发shutdown命令，关闭接口； 2、开放接口：下发undo_shutdown命令，使能接口。 倒换测试选择shutdown时，虚拟接口的状态为ADMIN_SHUTDOWN，此状态不允许虚拟接口的其他操作。 倒换测试选择undo_shutdown时，虚拟接口的状态为ACTIVE。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=SwitchoverTest) | | 查询虚拟接口倒换测试记录列表 | hcloud DC ListSwitchoverTestRecords | 查询倒换测试记录列表，只展示operate_status为COMPELTE的记录。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ListSwitchoverTestRecords) | #### 标签管理 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询项目标签 | hcloud DC ListProjectTags | - 查询租户在指定Project中实例类型的所有资源标签集合。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ListProjectTags) | | 查询资源标签 | hcloud DC ShowResourceTag | 查询资源标签 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ShowResourceTag) | | 添加资源标签 | hcloud DC CreateResourceTag | - 一个资源上最多有10个标签。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=CreateResourceTag) | | 批量添加删除资源标签 | hcloud DC BatchCreateResourceTags | - 为指定实例批量添加或删除标签 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=BatchCreateResourceTags) | | 删除资源标签 | hcloud DC DeleteResourceTag | 删除时,不对标签字符集做校验，调用接口前必须要做encodeURI，服务端需要对接口uri做decodeURI。删除的key不存在报404，Key不能为空或者空字符串。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=DeleteResourceTag) | | 通过标签查询资源实例 | hcloud DC ListTagResourceInstances | 通过标签查询资源实例 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ListTagResourceInstances) | #### 配额管理 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询配额 | hcloud DC ShowQuotas | 查询租户各类资源的使用情况，如Directconnect的使用量，虚拟接口的使用量等。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ShowQuotas) | #### 全域接入网关 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询专线全域接入网关列表 | hcloud DC ListGlobalDcGateways | 查询专线全域接入网关列表，建议使用分页查询 分页查询使用的参数为marker、limit。marker和limit一起使用时才会生效，单独使用无效 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ListGlobalDcGateways) | | 创建专线全域接入网关 | hcloud DC CreateGlobalDcGateway | 创建专线全域接入网关实例(global-dc-gateway)，用于接入全球的ER实例 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=CreateGlobalDcGateway) | | 查询专线全域接入网关详情 | hcloud DC ShowGlobalDcGateway | 查询专线全域接入网关实例详情信息 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ShowGlobalDcGateway) | | 更新专线全域接入网关 | hcloud DC UpdateGlobalDcGateway | 更新专线全域接入网关global-dc-gateway的名字，描述等信息 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=UpdateGlobalDcGateway) | | 删除专线全域接入网关 | hcloud DC DeleteGlobalDcGateway | 删除专线全域接入网关global-dc-gateway实例 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=DeleteGlobalDcGateway) | #### 专线关联连接 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询专线关联连接列表 | hcloud DC ListPeerLinks | 查询全域接入网关与ER等对象的关联连接列表，分页查询使用的参数为marker、limit。marker和limit一起使用时才会生效，单独使用无效 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ListPeerLinks) | | 创建专线关联连接 | hcloud DC CreatePeerLink | 创建专线全域接入网关的关联连接peer-link对象，用于连接企业路由器或者其他接入网关 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=CreatePeerLink) | | 查询专线关联连接详情 | hcloud DC ShowPeerLink | 查询指定接入网关的指定的关联连接(peer link)详情 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ShowPeerLink) | | 更新专线关联连接 | hcloud DC UpdatePeerLink | 更新接入网关与ER对接的关联连接peer-link | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=UpdatePeerLink) | | 删除专线关联连接 | hcloud DC DeletePeerLink | 删除全域接入网关与ER的关联连接peer-link | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=DeletePeerLink) | #### 专线接入点管理 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询专线接入点位置列表 | hcloud DC ListDirectConnectLocations | 查询本区域下所有专线的接入点的信息，分页查询使用的参数为marker、limit。marker和limit一起使用时才会生效，单独使用无效 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ListDirectConnectLocations) | | 查询指定专线接入点详情 | hcloud DC ShowDirectConnectLocation | 查询指定的专线接入点详情 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ShowDirectConnectLocation) | #### 互联网关 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询互联网关详细信息 | hcloud DC ShowConnectGateway | 查询互联网关详细信息 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ShowConnectGateway) | | 更新互联网关 | hcloud DC UpdateConnectGateway | 更新互联网关 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=UpdateConnectGateway) | | 删除互联网关 | hcloud DC DeleteConnectGateway | 删除互联网关 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=DeleteConnectGateway) | | 查询互联网关列表信息 | hcloud DC ListConnectGateways | 查询互联网关列表信息 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ListConnectGateways) | | 创建互联网关 | hcloud DC CreateConnectGateway | 创建互联网关 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=CreateConnectGateway) | #### GEIP操作管理 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询已经绑定的GEIP列表 | hcloud DC ListGlobalEips | 查询已经绑定的GEIP列表 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ListGlobalEips) | | 绑定GEIP操作 | hcloud DC BindGlobalEips | 绑定GEIP操作 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=BindGlobalEips) | | 解绑GEIP | hcloud DC UnbindGlobalEips | 解绑GEIP | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=UnbindGlobalEips) | #### 全域接入网关路由表 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询全域接入网关路由表 | hcloud DC ListGdgwRouteTables | 查询全域接入网关路由表 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ListGdgwRouteTables) | | 修改全域接入网关路由表 | hcloud DC UpdateGdgwRouteTable | 支持的修改操作：新增、删除、修改 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=UpdateGdgwRouteTable) | #### 虚拟接口对等体连通性探测 | API名称 | 命令 | 描述 | 操作 | |:---|:---|:---|:---| | 查询虚拟接口对等体连通性探测实例 | hcloud DC ShowVifPeerDetection | 当您的对虚拟接口对等体发起连通性探测后，您可以通过此接口查询单次探测的信息，包括ID、探测开始时间、探测结束时间、探测状态、丢包率等。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ShowVifPeerDetection) | | 删除虚拟接口对等体连通性探测实例 | hcloud DC DeleteVifPeerDetection | 当您想不再保留虚拟接口对等体连通性探测实例时，您可以通过调用此接口将其删除。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=DeleteVifPeerDetection) | | 查询虚拟接口对等体连通性探测实例列表 | hcloud DC ListVifPeerDetections | 当您的对虚拟接口对等体发起连通性探测后，您可以通过此接口查询多次探测的信息，包括ID、探测开始时间、探测结束时间、探测状态、丢包率等。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=ListVifPeerDetections) | | 创建虚拟接口对等体连通性探测实例 | hcloud DC CreateVifPeerDetection | 当您想对虚拟接口对等体的远端网关的连通性进行探测时，可以通过调用此接口创建一个虚拟接口对等体连通性探测实例来实现。 | [去调试](https://console.huaweicloud.com/apiexplorer/#/openapi/DC/cli?api=CreateVifPeerDetection) |