VPC CLI 参考

请将以下信息作为可用于 IBM Cloud® Virtual Private Cloud 虚拟私有云（VPC）的命令行界面（CLI）命令的参考。

本 CLI 参考指南分为以下几个部分：

先决条件

  1. 安装 IBM Cloud CLI。

  2. 安装或更新 VPC 基础架构服务插件。

    ibmcloud plugin install vpc-infrastructure

    要进行更新，请使用以下命令：

    ibmcloud plugin update

    要查看已安装的插件和版本，请使用以下命令:

    ibmcloud plugin list

网络命令

以下部分提供有关网络服务的 CLI 命令的信息。

浮动 IP

ibmcloud is 浮动 IP

查看浮动 IP 的详细信息。

ibmcloud is floating-ip FLOATING_IP [--output JSON] [-q, --quiet]

命令选项

  • FLOATING_IP：浮动 IP 的 ID。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是浮动 IP 发行版

释放浮动 IP。

ibmcloud is floating-ip-release (FLOATING_IP1 FLOATING_IP2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • FLOATING_IP1：浮动 IP 的 ID。
  • FLOATING_IP2：浮动 IP 的 ID。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 正在浮动-ip-reserve

预留浮动 IP。

ibmcloud is floating-ip-reserve FLOATING_IP_NAME (--zone ZONE_NAME | --nic TARGET_INTERFACE [--in TARGET_INSTANCE | --bm TARGET_BARE_METAL_SERVER] | --vni VNI | --reset-target) [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is floating-ip-reserve my-ip --zone us-south-1
  • ibmcloud is floating-ip-reserve my-ip --nic 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3
  • ibmcloud is floating-ip-reserve my-ip --nic eth0 --in my-instance
  • ibmcloud is floating-ip-reserve my-ip --nic eth0 --bm my-bm
  • ibmcloud is floating-ip-reserve my-ip --nic 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --output JSON
  • ibmcloud is floating-ip-reserve cli-vni-ip --vni vni2
  • ibmcloud is floating-ip-reserve cli-vni-ip-1 --vni 7308-b81c1e13-b3a2-455c-814a-213bc9de4a90

命令选项

  • FLOATING_IP_NAME：浮动 IP 的名称。
  • --zone：目标区域的名称。
  • --nic：要绑定的网络接口的 ID 或名称。
  • --in：要绑定的实例的 ID 或名称；仅当您使用网络接口名称而非 ID 时，才需要提供此 ID。
  • --bm：要绑定的裸机服务器的 ID 或名称；仅当您使用网络接口名称而非 ID 时，才需要此 ID。
  • --vni：虚拟网络接口的 ID 或名称。
  • --重置目标：从浮动 IP 重置目标。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is 浮动 IP-update

更新浮动 IP。

ibmcloud is floating-ip-update FLOATING_IP [--name NEW_NAME] [--nic TARGET_INTERFACE [--in TARGET_INSTANCE | --bm TARGET_BARE_METAL_SERVER] | --vni VNI | --reset-target] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is floating-ip-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name my-ip
  • ibmcloud is floating-ip-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --nic 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3
  • ibmcloud is floating-ip-update my-ip --nic eth0 --in my-instance
  • ibmcloud is floating-ip-update my-ip --nic eth0 --bm my-bm
  • ibmcloud is floating-ip-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --nic 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --output JSON
  • ibmcloud is floating-ip-update cli-vni-ip --name cli-vni-ip-2 --vni vni2
  • ibmcloud is floating-ip-update cli-vni-ip-1 --name cli-vni-ip-3 --vni 7308-b81c1e13-b3a2-455c-814a-213bc9de4a90
  • ibmcloud is floating-ip-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --reset-target

命令选项

  • FLOATING_IP：浮动 IP 的 ID。
  • --name：浮动 IP 的新名称。
  • --nic：要绑定的网络接口的 ID 或名称。
  • --in：要绑定的实例的 ID 或名称；仅当您使用网络接口名称而非 ID 时，才需要提供此 ID。
  • --bm：要绑定的裸机服务器的 ID 或名称；仅当您使用网络接口名称而非 ID 时，才需要此 ID。
  • --vni：虚拟网络接口的 ID 或名称。
  • --重置目标：从浮动 IP 重置目标。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is 浮动-ips

列出所有浮动 IP。

ibmcloud is floating-ips [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is floating-ips --output JSON
  • ibmcloud is floating-ips --resource-group-id fee82deba12e4c0fb69c3b09d1f12345 --output JSON

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

流日志

ibmcloud 是 flow-log-create

创建流日志。

ibmcloud is flow-log-create --bucket STORAGE_BUCKET_NAME --target TARGET_IDOrName [--target-type vpc | subnet | instance | nic | vni | nac] [--vpc VPC] [--in IN] [--name NAME] [--active TRUE | FALSE] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is flow-log-create --bucket bucket-name --target 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479
  • ibmcloud is flow-log-create --bucket bucket-name --target 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name my-flow-log
  • ibmcloud is flow-log-create --bucket bucket-name --target 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name my-flow-log --active false
  • ibmcloud is flow-log-create --bucket bucket-name --target 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name my-flow-log --output JSON
  • ibmcloud is flow-log-create --bucket bucket-name --target my-vpc --target-type vpc --name my-flow-log
  • ibmcloud is flow-log-create --bucket bucket-name --target my-vpc --target-type vpc --name my-flow-log --active false
  • ibmcloud is flow-log-create --bucket bucket-name --target my-vpc --target-type vpc --name my-flow-log --output JSON
  • ibmcloud is flow-log-create --bucket bucket-name --target my-subnet --target-type subnet
  • ibmcloud is flow-log-create --bucket bucket-name --target my-subnet --target-type subnet --vpc my-vpc
  • ibmcloud is flow-log-create --bucket bucket-name --target my-subnet --target-type subnet --name my-flow-log
  • ibmcloud is flow-log-create --bucket bucket-name --target my-subnet --target-type subnet --vpc my-vpc --name my-flow-log
  • ibmcloud is flow-log-create --bucket bucket-name --target my-instance --target-type instance
  • ibmcloud is flow-log-create --bucket bucket-name --target my-instance --target-type instance --name my-flow-log
  • ibmcloud is flow-log-create --bucket bucket-name --target my-network-interface --target-type nic
  • ibmcloud is flow-log-create --bucket bucket-name --target my-network-interface --target-type nic --name my-flow-log
  • ibmcloud is flow-log-create --bucket bucket-name --target my-network-interface --target-type nic --in my-instance
  • ibmcloud is flow-log-create --bucket bucket-name --target my-network-interface --target-type nic --in my-instance --name my-flow-log
  • ibmcloud is flow-log-create --bucket cli-bucket-1 --target 7308-3e36540f-9572-4fd5-9b53-c9a1122d3d28 --target-type vni
  • ibmcloud is flow-log-create --bucket cli-bucket-1 --target unworn-daintily-travesty-myself --target-type vni

命令选项

  • --bucket：COS 存储桶的名称。
  • --target：流日志的目标 ID 或名称。
  • --target-type：流量日志的目标类型。 仅当作为资源的名称传递目标时才需要此选项。 vpc，subnet，instance，nic，vni 和 nac 之一。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --in：实例的ID或名称。 只需在此实例中按名称指定唯一资源。
  • --name：流程日志的新名称。
  • --active：表示该收集器是否处于活动状态。 以下选项之一：TRUE、FALSE。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 采用流式日志删除机制

删除一个或多个流日志。

ibmcloud is flow-log-delete (FLOW_LOG1 FLOW_LOG2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • FLOW_LOG1：流日志的 ID 或名称。
  • FLOW_LOG2：流日志的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 flow-log-update

更新流日志。

ibmcloud is flow-log-update FLOW_LOG [--name NEW_NAME] [--active TRUE | FALSE] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is flow-log-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name new-name-flow-log
  • ibmcloud is flow-log-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name renamed-flow-log --active false
  • ibmcloud is flow-log-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name renamed-flow-log --output JSON
  • ibmcloud is flow-log-update my-flow-log --name new-name-flow-log
  • ibmcloud is flow-log-update my-flowlog --name new-name-flow-log --active false
  • ibmcloud is flow-log-update my-flowlog --name new-name-flow-log --output JSON

命令选项

  • FLOW_LOG：流日志的 ID 或名称。
  • --name：流程日志的新名称。
  • --active：表示该收集器是否处于活动状态。 更新为 false 将取消激活收集器，更新为 true 将激活收集器。 以下选项之一：TRUE、FALSE。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是流动日志

查看流程日志的详细信息。

ibmcloud is flow-log FLOW_LOG [--output JSON] [-q, --quiet]

命令选项

  • FLOW_LOG：流日志的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是流动日志

列出该区域内的所有流量日志。

ibmcloud is flow-logs [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--vpc VPC] [--target TARGET] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --vpc：VPC 的 ID、名称或 CRN。
  • --target：目标的 ID 或资源类型。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

负载均衡器

以下部分提供了有关用于处理负载均衡器，侦听器和池的 CLI 命令的信息。

ibmcloud 是负载均衡器

查看负载均衡器的详细信息。

ibmcloud is load-balancer LOAD_BALANCER [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-create

创建负载均衡器。

ibmcloud is load-balancer-create LOAD_BALANCER_NAME LOAD_BALANCER_ACCESS_TYPE (--subnet SUBNET1 --subnet SUBNET2 ... [--vpc VPC]) (--dns-instance-crn DNS_INSTANCE_CRN --dns-zone-id DNS_ZONE_ID) [--family application | network] [--route-mode false | true] [--sg SG] [--logging-datapath-active false | true] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--pools POOLS_JSON | @POOLS_JSON_FILE] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is load-balancer-create my-lb public --subnet 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --subnet 7ec86020-1c6e-4889-b3f0-a15f2e50f87e
  • ibmcloud is load-balancer-create my-lb public --subnet my-subnet --subnet my-subnet2
  • ibmcloud is load-balancer-create my-lb public --subnet my-subnet --vpc my-vpc
  • ibmcloud is load-balancer-create my-nlb public --subnet 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --family network
  • ibmcloud is load-balancer-create my-lb public --subnet 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --subnet 7ec86020-1c6e-4889-b3f0-a15f2e50f87e --resource-group-id fee82deba12e4c0fb69c3b09d1f12345
  • ibmcloud is load-balancer-create my-lb public --subnet 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --subnet 7ec86020-1c6e-4889-b3f0-a15f2e50f87e --resource-group-name Default
  • ibmcloud is load-balancer-create my-lb public --subnet 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --subnet 7ec86020-1c6e-4889-b3f0-a15f2e50f87e --output JSON
  • ibmcloud is load-balancer-create my-lb public --subnet 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --subnet 7ec86020-1c6e-4889-b3f0-a15f2e50f87e --sg 3428abaa-788b-439b-9404-ca386f2f3f79,f0e26f91-851a-4fc9-b32b-da24ad218b4e
  • ibmcloud is load-balancer-create my-lb public --subnet my-subnet --sg my-sg1,my-sg2 --vpc my-vpc
  • ibmcloud is load-balancer-create my-lb public --subnet 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --subnet 7ec86020-1c6e-4889-b3f0-a15f2e50f87e --logging-datapath-active true
  • ibmcloud is load-balancer-create my-lb public --subnet 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --subnet 7ec86020-1c6e-4889-b3f0-a15f2e50f87e --pools '[{"algorithm": "round_robin", "protocol": "tcp", "health_monitor": {"delay": 2, "max_retries": 2, "type": "tcp", "timeout": 1}}]' 使用池创建负载均衡器
  • ibmcloud is load-balancer-create my-lb private --subnet 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --family network --route-mode true 创建已启用路由方式的负载均衡器
  • ibmcloud is load-balancer-create my-lb private-path --subnet 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --family network 创建专用路径网络负载均衡器。
  • ibmcloud is load-balancer-create my-nlb private-path --subnet 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --subnet 7ec86020-1c6e-4889-b3f0-a15f2e50f87e --family network --pools '[{"algorithm":"round_robin","protocol":"tcp","health_monitor":{"delay":2,"max_retries":2,"type":"tcp","timeout":1},"members":[{"port":8080,"target":{"id":"72251a2e-d6c5-42b4-97b0-b5f8e8d1f478"}}]}]' 创建一个专用路径网络负载均衡器，并将应用程序负载均衡器标识作为池成员目标。
  • ibmcloud is load-balancer-create my-nlb private-path --subnet 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --subnet 7ec86020-1c6e-4889-b3f0-a15f2e50f87e --family network --pools '[{"algorithm":"round_robin","protocol":"tcp","health_monitor":{"delay":2,"max_retries":2,"type":"tcp","timeout":1},"members":[{"port":8080,"target":{"id":"72251a2e-d6c5-42b4-97b0-b5f8e8d1f474"}}]}]' 创建一个专用路径网络负载均衡器，并将保留的 IP 标识作为池成员目标。
  • ibmcloud is load-balancer-create my-lb public --subnet cli-subnet-1 --family network --route-mode true --dns-instance-crn crn:v1:staging:public:dns-svcs:global:a/efe5afc483594adaa8325e2b4d1290df:1bbaacf9-7bc7-4d64-a1d8-a8d1ca9e7662:: --dns-zone-id 5cca0d1c-9c85-4a18-bc07-a9f070949698 为负载均衡器创建专用 DNS 支持。
  • ibmcloud is load-balancer-create my-lb public --subnet 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --subnet 7ec86020-1c6e-4889-b3f0-a15f2e50f87e --pools '[{"algorithm": "round_robin", "protocol": "tcp", "health_monitor": {"delay": 2, "max_retries": 2, "request": {"method": "post", "body": "ACTIVE", "headers": [{"field": "Host", "value": "my-host-header-value"}, {"field": "Content-Type", "value": "text/plain"}]}, "response": {"body_regex": "ACTIVE"}, "type": "http", "timeout": 1}}]' 创建一个包含运行状况监控请求和响应正文正则表达式的负载均衡器池
  • ibmcloud is load-balancer-create my-lb public --subnet 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --subnet 7ec86020-1c6e-4889-b3f0-a15f2e50f87e --pools '[{"algorithm": "round_robin", "protocol": "tcp", "health_monitor": {"delay": 2, "max_retries": 2, "request": {"method": "get", "headers": [{"field": "Host", "value": "my-host-header-value"}]}, "response": {"codes": ["200", "201"]}, "type": "http", "timeout": 1}}]' 创建一个包含运行状况监控请求和响应代码的负载均衡器池

命令选项

  • LOAD_BALANCER_NAME：负载均衡器的名称。
  • LOAD_BALANCER_ACCESS_TYPE：负载均衡器的访问类型。 只有网络系列中的负载均衡器才支持"专用路径"访问类型。 其中之一：公共、私人、私人路径。
  • --subnet：要为该负载均衡器进行配置的子网的 ID 或名称。 可多次指定此选项以在多个子网中供应负载均衡器。 只能针对网络负载均衡器指定一个子网。
  • --vpc：VPC 的 ID 或名称。 仅当在此 VPC 中按名称指定唯一子网时，才需要此标识或名称。
  • --family：负载均衡器的家族类型。 其中一个: application，network。
  • --route-mode：启用或禁用负载均衡器的路由模式。 如果未指定，那么将禁用路由方式。 当前，只能为专用网络负载均衡器启用路由方式。 其中一个: false，true。
  • --sg：负载均衡器的安全组 ID 或名称，以逗号分隔。 如果未指定，则使用 VPC 的默认安全组。
  • --logging-datapath-active：启用或禁用此负载均衡器的数据路径日志记录。 如果未指定，那么将禁用数据路径日志记录。 数据路径日志记录仅适用于应用程序负载均衡器。 其中一个: false，true。
  • --dns-instance-crn：与该 DNS 区域关联的 DNS 实例的 CRN。
  • --dns-zone-id：DNS 区域的 ID。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
    • -pools：POOLS_JSON|@POOLS_JSON_FILE，JSON 格式的池或 JSON 文件 其中之一：pools_json、@pools_json_file。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-delete

删除一个或多个负载均衡器。

ibmcloud is load-balancer-delete (LOAD_BALANCER1 LOAD_BALANCER2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • LOAD_BALANCER1：负载均衡器的 ID 或名称。
  • LOAD_BALANCER2：负载均衡器的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-侦听器

查看负载均衡器监听器的详细信息。

ibmcloud is load-balancer-listener LOAD_BALANCER LISTENER_ID [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • LISTENER_ID：监听器的 ID。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-Listener-create

创建一个负载均衡监听器。

ibmcloud is load-balancer-listener-create LOAD_BALANCER (--protocol http | https | tcp | udp) [--vpc VPC] [--port PORT | --port-min PORT_MIN --port-max PORT_MAX] [--default-pool DEFAULT_POOL_ID] [--connection-limit LIMIT] [--certificate-instance-crn CERTIFICATE_INSTANCE_CRN] [--policies LISTENER_POLICIES_JSON | @LISTENER_POLICIES_JSON_FILE] [--accept-proxy-protocol false | true] [--http-redirect-listener-id HTTP_REDIRECT_LISTENER_ID --http-redirect-status-code 301 | 302 | 303 | 307 | 308 [--http-redirect-target-uri HTTP_REDIRECT_TARGET_URI]] [--idle-connection-timeout IDLE_CONNECTION_TIMEOUT] [--client-auth-ca-crn CLIENT_AUTH_CA_CRN] [--client-auth-crl CRL | @CRL_FILE] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is load-balancer-listener-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --port 443 --protocol http
  • ibmcloud is load-balancer-listener-create my-lb --port 443 --protocol http
  • ibmcloud is load-balancer-listener-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --port-min 80 --port-max 85 --protocol tcp 为公共网络负载均衡器创建具有端口范围的侦听器。
  • ibmcloud is load-balancer-listener-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --port 443 --protocol https --certificate-instance-crn crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f510
  • ibmcloud is load-balancer-listener-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --port 443 --protocol http --connection-limit 2000
  • ibmcloud is load-balancer-listener-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --port 443 --protocol http --default-pool 70294e14-4e61-11e8-bcf4-0242ac110004
  • ibmcloud is load-balancer-listener-create my-lb --port 443 --protocol http --default-pool my-pool
  • ibmcloud is load-balancer-listener-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --port 443 --protocol http --policies '[{"name": "my-policy", "priority": 5, "action": "reject" }]' 策略的优先级可以在 1 到 10 的范围内，其中较低的值代表较高的优先级。 action 的可能取值为“forward”、“redirect”、“reject”或“https_redirect”。
  • ibmcloud is load-balancer-listener-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --port 443 --protocol http --policies '[{"priority": 5, "action": "forward", "target": { "id": 70294e14-4e61-11e8-bcf4-0242ac110004 }}]' 当操作为 “转发” 时，必须指定池标识，以确定负载均衡器将流量转发到哪个池。
  • ibmcloud is load-balancer-listener-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --port 443 --protocol http --policies '[{"priority": 5, "action": "redirect", "target": { "http_status_code": 301, "url": "https://www.redirect.com"}}]' 当操作为_重定向_时，“url”和“http_status_code”为必填项。 http_status_code 的可能取值为“301”、“302”、“303”、“307”或“308”。 “url”是指重定向目标 URL。
  • ibmcloud is load-balancer-listener-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --port 443 --protocol http --policies '[{"priority": 5, "action": "reject", "rules": { "condition": "equals", "type": "header", "field": "My-app-header", "value": "value"}}]' _条件_可取的值包括“包含”、“等于”或“正则表达式匹配”。 _类型_的可能值是“头”、“主机名”或“路径”。_field_是HTTP头字段，仅适用于“头”规则类型。 “value” 参数是用于匹配规则条件的值。
  • ibmcloud is load-balancer-listener-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --port 443 --protocol http --output JSON
  • ibmcloud is load-balancer-listener-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --port 443 --protocol http --accept-proxy-protocol true
  • ibmcloud is load-balancer-listener-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --port-min 80 --port-max 85 --protocol tcp --accept-proxy-protocol true
  • ibmcloud is load-balancer-listener-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --protocol tcp 要在负载均衡器中启用路由方式时创建负载均衡器侦听器，请执行以下操作：
  • ibmcloud is load-balancer-listener-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --protocol udp --port 53 使用 UDP 协议创建负载均衡器侦听器。
  • ibmcloud is load-balancer-listener-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --protocol https --port 443 --idle-connection-timeout 30 创建具有空闲连接超时的应用程序负载均衡器侦听器。
  • ibmcloud is load-balancer-listener-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --protocol https --port 443 --certificate-instance-crn crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f510 --client-auth-ca-crn crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f511 --client-auth-crl @crl.pem 创建一个支持 mTLS 的应用程序负载均衡器监听器。

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --protocol：监听器协议。 该应用系列中的负载均衡器支持 tcp、http 和 https。 网络系列中的负载均衡器支持 tcp 和 udp。
  • --port：监听端口号。 范围：1-65535。
  • --port-min：此监听器所用端口范围的包含下限。 该值不得大于 port_max。 目前，仅启用了以路由模式运行的负载均衡器，且_网络_家族中的公共负载均衡器支持每个监听器拥有多个端口。 负载均衡器中使用相同_协议_的监听器必须具有互不重叠的端口范围。 范围：1-65535。
  • --port-max：此监听器所用端口范围的包含上界。 不得小于 port_min。 目前，只有启用了路由模式的负载均衡器以及_网络_家族中的公共负载均衡器支持每个监听器拥有多个端口。 负载均衡器中使用相同_协议_的监听器必须具有互不重叠的端口范围。 范围：1-65535。
  • --default-pool：默认池的 ID。
  • --connection-limit：监听器的最大连接数。 此选项不适用于属于该网络家族的负载均衡器。
  • --certificate-instance-crn：用于 SSL 终止的证书实例CRN。 当协议为 https 时，此项为必填项。 此选项不适用于属于该网络家族的负载均衡器。
  • --policies：LISTENER_POLICIES_JSON | @LISTENER_POLICIES_JSON_F ILE，以 JSON 或 JSON 文件形式指定的监听器策略。 此选项不适用于属于该网络家族的负载均衡器。
  • --accept-proxy-protocol：如果设置为 true，则为该监听器启用代理协议。 仅受应用程序负载均衡器支持。 其中一个: false，true。
  • --http-redirect-listener-id：作为 HTTP 重定向目标设置的监听器的ID。
  • --http-redirect-status-code：重定向响应中返回的 HTTP 状态码。 301，302，303，307 和 308 之一。
  • --http-redirect-target-uri：流量被重定向到的目标 URI。 此设置是可选的，如果设置，那么必须以“/”开头。
  • --idle-connection-timeout：监听器的空闲连接超时时间（单位：秒）。 只有应用程序系列中的负载均衡器支持此选项。 最小值: 50，最大值: 7200。(缺省值: 50)。
  • --client-auth-ca-crn：此监听器的客户端身份验证。 此选项不适用于属于该网络家族的负载均衡器。
  • --client-auth-crl: CRL | @CRL_FILE，用于验证客户端证书撤销情况的证书撤销列表。 监听器必须具备 HTTPS 协议。 证书撤销列表（CRL）的内容采用 PEM 格式进行编码，或者其文件路径中包含该CRL。 此选项不适用于属于该网络家族的负载均衡器。 以下之一：CRL、@CRL_FILE。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-Listener-delete

删除一个或多个负载均衡器侦听器。

ibmcloud is load-balancer-listener-delete LOAD_BALANCER (LISTENER_ID1 LISTENER_ID2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • LISTENER_ID1：监听器的ID。
  • LISTENER_ID2：监听器的ID。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-Listener-policies

列出所有负载均衡策略。

ibmcloud is load-balancer-listener-policies LOAD_BALANCER LISTENER_ID [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • LISTENER_ID：监听器的 ID。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-Listener-policy

查看负载均衡器监听器策略的详细信息。

ibmcloud is load-balancer-listener-policy LOAD_BALANCER LISTENER_ID POLICY [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • LISTENER_ID：监听器的 ID。
  • 保单：保单编号或保单名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-Listener-policy-create

创建一个负载均衡监听器策略。

ibmcloud is load-balancer-listener-policy-create LOAD_BALANCER LISTENER_ID --priority PRIORITY (--action forward_to_pool | forward_to_listener | redirect | reject | https_redirect) [--vpc VPC] [--name NEW_NAME] [(--target-listener-id TARGET_LISTENER_ID --target-listener-http-status-code 301 | 302 | 303 | 307 | 308 [--target-uri TARGET_URI]) | (--target-http-status-code 301 | 302 | 303 | 307 | 308 --target-url TARGET_URL) | --target TARGET] [--rules LISTENER_POLICY_RULES_JSON | @LISTENER_POLICY_RULES_JSON_FILE] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is load-balancer-listener-policy-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --name my-policy --action reject --priority 5 策略的优先级可以在 1 到 10 的范围内，其中较低的值代表较高的优先级。 “action” 的可能取值为“forward”、“redirect”或“reject”。
  • ibmcloud is load-balancer-listener-policy-create my-lb 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --name my-policy --action reject --priority 5 策略的优先级可以在 1 到 10 的范围内，其中较低的值代表较高的优先级。 “action” 的可能取值为“forward”、“redirect”或“reject”。
  • ibmcloud is load-balancer-listener-policy-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --action forward_to_listener --priority 2 --target my-pool 当操作为"forward_to_listener"时，需要监听器 ID 或名称以指定负载均衡器将流量转发到哪个监听器。
  • ibmcloud is load-balancer-listener-policy-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --action forward_to_listener --priority 2 --target 70294e14-4e61-11e8-bcf4-0242ac110004 当操作为"forward_to_listener"时，需要监听器 ID 或名称以指定负载均衡器将流量转发到哪个监听器。
  • ibmcloud is load-balancer-listener-policy-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --action forward_to_pool --priority 2 --target my-pool 当操作为"forward_to_pool"时，需要池标识或名称来指定负载均衡器将流量转发到哪个池。
  • ibmcloud is load-balancer-listener-policy-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --action forward_to_pool --priority 2 --target 70294e14-4e61-11e8-bcf4-0242ac110004 当操作为"forward_to_pool"时，需要池标识或名称来指定负载均衡器将流量转发到哪个池。
  • ibmcloud is load-balancer-listener-policy-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --action redirect --priority 1 --target-http-status-code 301 --target-url "https://www.redirect.com" 当操作为_重定向_时，“url”和“http_status_code”为必填项。 http_status_code 的可能取值为“301”、“302”、“303”、“307”或“308”。 “url”是指重定向目标 URL。
  • ibmcloud is load-balancer-listener-policy-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --action redirect --priority 1 --target-http-status-code 301 --target-url "https://redirect.com:443/new/{path}?{query}" 当操作为_重定向_时，“url”和“http_status_code”为必填项。 http_status_code 的可能取值为“301”、“302”、“303”、“307”或“308”。 “url”是指重定向目标 URL。
  • ibmcloud is load-balancer-listener-policy-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --action redirect --priority 1 --target-http-status-code 301 --target-url "https://test.{host}/search?q=watson" 当操作为_重定向_时，“url”和“http_status_code”为必填项。 http_status_code 的可能取值为“301”、“302”、“303”、“307”或“308”。 “url”是指重定向目标 URL。
  • ibmcloud is load-balancer-listener-policy-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --action reject --priority 4 --rules '[{ "condition": "equals", "type": "header", "field": "My-app-header", "value": "value"}]' _条件_可取的值包括“包含”、“等于”或“正则表达式匹配”。 _类型_的可能值是“头”、“主机名”或“路径”。_field_是HTTP头字段，仅适用于“头”规则类型。 “value” 参数是用于匹配规则条件的值。
  • ibmcloud is load-balancer-listener-policy-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --action reject --priority 3 --name my-policy --output JSON
  • ibmcloud is lb-lpc f5b20e9b-a77b-43e9-aa2d-a3a5ac9fe8fd 5cb08c12-004f-4587-87f4-ef46e799da50 --priority 3 --action https_redirect --target-listener-id d7e0543c-4e0f-4c0d-89aa-73f0f028ec61 --target-listener-http-status-code 303 当操作为“https_redirect”时，“target-listener-id”和“http_status_code”为必填项。 “http_status_code”的可能取值为“301”、“302”、“303”、“307”或“308”。
  • ibmcloud is lb-lpc f5b20e9b-a77b-43e9-aa2d-a3a5ac9fe8fd 5cb08c12-004f-4587-87f4-ef46e799da50 --priority 3 --action https_redirect --target-listener-id d7e0543c-4e0f-4c0d-89aa-73f0f028ec61 --target-listener-http-status-code 307 --target-uri /example 当操作为“https_redirect”时，“target-listener-id”和“http_status_code”为必填项。 “uri”是重定向目标 URI，这是一个可选字段。 “http_status_code”的可能取值为“301”、“302”、“303”、“307”或“308”。

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • LISTENER_ID：监听器的 ID。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --priority：策略的优先级。 数值越小，优先级越高，例如：5，范围：[1-10]。
  • --action：策略操作。 以下之一：forward_to_pool，forward_to_listener，redirect，rejection，https_redirect。
  • --name：策略的新名称。
  • --target：通过 forward_to_pool 指定的目标负载均衡器池的 ID 或名称，或者通过 forward_to_listener 操作指定的负载均衡器监听器的 ID。
  • --target-listener-id：要对其实施 https 重定向的监听器的 ID，需通过 https_redirect 操作指定。
  • --target-listener-http-status-code：重定向响应中返回的 HTTP 状态码，通过 https_redirect操作指定。 301，302，303，307 和 308 之一。
  • --target-uri：流量将被重定向到的目标 URI，通过 https_redirect 操作指定。 此设置是可选的，如果设置，那么必须以“/”开头。
  • --target-http-status-code：重定向响应中的 HTTP 状态码，需与重定向操作一起指定。 301，302，303，307 和 308 之一。
  • --target-url：重定向目标 URL，通过重定向操作指定。 该 URL 支持变量协议、主机、端口、路径和查询的 RFC 6570 1 级表达式。 这将扩展为原始请求中 URL 的值（如果请求中未包含这些值，则使用指定的默认值）。
  • --rules：LISTENER_POLICY_RULES_JSON | @LISTENER_POLICY_RULES_JSON_F ILE，以 JSON 或 JSON 文件形式指定的监听器策略规则。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-Listener-policy-delete

从负载均衡器侦听器中删除一个或多个策略。

ibmcloud is load-balancer-listener-policy-delete LOAD_BALANCER LISTENER_ID (POLICY1 POLICY2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • LISTENER_ID：监听器的 ID。
  • POLICY1：策略的ID或名称。
  • POLICY2：策略的ID或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-Listener-policy-rule

列出单个负载均衡策略规则。

ibmcloud is load-balancer-listener-policy-rule LOAD_BALANCER LISTENER_ID POLICY RULE_ID [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • LISTENER_ID：监听器的 ID。
  • 保单：保单编号或保单名称。
  • RULE_ID：规则的ID。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-Listener-policy-rule-create

创建一个负载均衡监听器策略规则。

ibmcloud is load-balancer-listener-policy-rule-create LOAD_BALANCER LISTENER_ID POLICY (--condition contains | equals | matches_regex | starts_with) (--type header | hostname | path | query | body | sni_hostname) --value VALUE [--vpc VPC] [--field FIELD] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is load-balancer-listener-policy-rule-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --condition equals --type header --field my-app-header --value match-value --output JSON
  • ibmcloud is load-balancer-listener-policy-rule-create my-lb 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 my-policy --condition equals --type header --field my-app-header --value match-value --output JSON

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • LISTENER_ID：监听器的 ID。
  • 保单：保单编号或保单名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --条件：规则的条件。 以下任一条件：包含、等于、正则表达式匹配、以...开头。
  • --type：规则的类型。 头、主机名、路径、查询、正文、sni_hostname 中的一个。
  • --value：用于匹配规则条件的值。
  • --field：HTTP 字段。 该字段适用于“头部”、“查询”和“正文”规则类型。 对于规则类型“header”，此字段为必填项。 对于“查询”或“正文”类型的规则，该字段为可选字段。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-Listener-policy-rule-delete

从负载均衡器侦听器中删除一个或多个策略。

ibmcloud is load-balancer-listener-policy-rule-delete LOAD_BALANCER LISTENER_ID POLICY (RULE_ID1 RULE_ID2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • LISTENER_ID：监听器的 ID。
  • 保单：保单编号或保单名称。
  • RULE_ID1：规则的ID。
  • RULE_ID2：规则的ID。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-Listener-policy-rule-update

更新负载均衡器监听器策略中的一条规则。

ibmcloud is load-balancer-listener-policy-rule-update LOAD_BALANCER LISTENER_ID POLICY RULE_ID [--vpc VPC] [--condition contains | equals | matches_regex | starts_with] [--type header | hostname | path | query | body | sni_hostname] [--value VALUE] [--field FIELD] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is load-balancer-listener-policy-rule-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 70294e14-4e61-11e8-bcf4-0242ac110004 --condition equals --type header --field my-app-header --value match-value --output JSON
  • ibmcloud is load-balancer-listener-policy-rule-update my-lb 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 my-policy 70294e14-4e61-11e8-bcf4-0242ac110004 --condition equals --type header --field my-app-header --value match-value --output JSON

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • LISTENER_ID：监听器的 ID。
  • 保单：保单编号或保单名称。
  • RULE_ID：规则的ID。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --条件：规则的条件。 以下任一条件：包含、等于、正则表达式匹配、以...开头。
  • --type：规则的类型。 头、主机名、路径、查询、正文、sni_hostname 中的一个。
  • --value：用于匹配规则条件的值。
  • --field：HTTP 字段。 该字段适用于“头部”、“查询”和“正文”规则类型。 对于规则类型“header”，此字段为必填项。 对于“查询”或“正文”类型的规则，该字段为可选字段。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-Listener-policy-rules

列出所有负载均衡策略规则。

ibmcloud is load-balancer-listener-policy-rules LOAD_BALANCER LISTENER_ID POLICY [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • LISTENER_ID：监听器的 ID。
  • 保单：保单编号或保单名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-侦听器-policy-update

更新负载均衡器监听器的策略。

ibmcloud is load-balancer-listener-policy-update LOAD_BALANCER LISTENER_ID POLICY [--vpc VPC] [--name NEW_NAME] [--priority PRIORITY] [--target TARGET] [--target-http-status-code 301 | 302 | 303 | 307 | 308] [--target-url TARGET_URL] [--target-listener-id TARGET_LISTENER_ID --target-listener-http-status-code 301 | 302 | 303 | 307 | 308 [--target-uri TARGET_URI]] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is load-balancer-listener-policy-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --name my-policy --priority 5
  • ibmcloud is load-balancer-listener-policy-update my-lb 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 my-lblp --name my-policy --priority 5
  • ibmcloud is load-balancer-listener-policy-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --action forward --target 70294e14-4e61-11e8-bcf4-0242ac110004 当操作为 “转发” 时，必须指定池的 ID 或名称，以确定负载均衡器将流量转发到哪个池。
  • ibmcloud is load-balancer-listener-policy-update my-lb 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 my-policy --action forward --target my-pool 当操作为 “转发” 时，必须指定池的 ID 或名称，以确定负载均衡器将流量转发到哪个池。
  • ibmcloud is load-balancer-listener-policy-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --target-http-status-code 301 --target-url "https://www.redirect.com" 当操作为_重定向_时，“url”和“http_status_code”为必填项。 http_status_code 的可能取值为“301”、“302”、“303”、“307”或“308”。 “url”是指重定向目标 URL。
  • ibmcloud is load-balancer-listener-policy-update r134-dd7cfd16-7a73-4921-bee2-ec9522879ac6 r134-23458256-1b39-4216-96bb-94111ed13a66 r134-59fb9ea6-c23c-4e62-887d-0dba384dc7ab --target-url {protocol}://test.{host}:80/{path} --target-http-status-code 301 当操作为_重定向_时，“url”和“http_status_code”为必填项。 http_status_code 的可能取值为“301”、“302”、“303”、“307”或“308”。 “url”是指重定向目标 URL。
  • ibmcloud is load-balancer-listener-policy-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --name my-policy --output JSON
  • ibmcloud is lb-lpu f5b20e9b-a77b-43e9-aa2d-a3a5ac9fe8fd 5cb08c12-004f-4587-87f4-ef46e799da50 c7d2c434-9202-48aa-837b-0661c4299c28 --name demo-policy --priority 2 --target-listener-id d7e0543c-4e0f-4c0d-89aa-73f0f028ec61 --target-listener-http-status-code 301
  • ibmcloud is lb-lpu my-lb 5cb08c12-004f-4587-87f4-ef46e799da50 my-lblp --name demo-policy --priority 2 --target-listener-id d7e0543c-4e0f-4c0d-89aa-73f0f028ec61 --target-listener-http-status-code 301
  • ibmcloud is lb-lpu f5b20e9b-a77b-43e9-aa2d-a3a5ac9fe8fd 5cb08c12-004f-4587-87f4-ef46e799da50 c7d2c434-9202-48aa-837b-0661c4299c28 --priority 2 --target-listener-id d7e0543c-4e0f-4c0d-89aa-73f0f028ec61 --target-listener-http-status-code 301 --target-uri /example2

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • LISTENER_ID：监听器的 ID。
  • 保单：保单编号或保单名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --name：此策略的用户自定义名称。 策略名称在负载均衡器侦听器中必须是唯一的。
  • --priority：策略的优先级。 数值越小，优先级越高，例如：5，范围：[1-10]。
  • --target：通过 forward_to_pool 指定的目标负载均衡器池的 ID 或名称，或者通过 forward_to_listener 操作指定的负载均衡器监听器的 ID。
  • --target-http-status-code：重定向响应中的 HTTP 状态码，需与重定向操作一起指定。 301，302，303，307 和 308 之一。
  • --target-url：重定向目标 URL，通过重定向操作指定。 该 URL 支持变量协议、主机、端口、路径和查询的 RFC 6570 1 级表达式。 这将扩展为原始请求中 URL 的值（如果请求中未包含这些值，则使用指定的默认值）。
  • --target-listener-id：要对其实施 https 重定向的监听器的 ID，需通过 https_redirect 操作指定。
  • --target-listener-http-status-code：重定向响应中返回的 HTTP 状态码，通过 https_redirect操作指定。 301，302，303，307 和 308 之一。
  • --target-uri：流量将被重定向到的目标 URI，通过 https_redirect 操作指定。 此设置是可选的，如果设置，那么必须以“/”开头。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-Listener-update

更新负载均衡器的监听器。

ibmcloud is load-balancer-listener-update LOAD_BALANCER LISTENER_ID [--vpc VPC] [--protocol http | https | tcp | udp] [--port PORT | --port-min PORT_MIN --port-max PORT_MAX] [--default-pool DEFAULT_POOL_ID | --reset-default-pool] [--connection-limit LIMIT] [--certificate-instance-crn CERTIFICATE_INSTANCE_CRN] [--accept-proxy-protocol false | true] [--disable-http-redirect | (--http-redirect-listener-id HTTP_REDIRECT_LISTENER_ID --http-redirect-status-code 301 | 302 | 303 | 307 | 308 [--http-redirect-target-uri HTTP_REDIRECT_TARGET_URI | --reset-http-redirect-target-uri])] [--idle-connection-timeout IDLE_CONNECTION_TIMEOUT] [--client-auth-ca-crn CLIENT_AUTH_CA_CRN | --reset-client-auth-ca-crn] [--client-auth-crl CRL | @CRL_FILE | --reset-client-auth-crl] [--reset-client-auth] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is load-balancer-listener-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --certificate-instance-crn crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f510
  • ibmcloud is load-balancer-listener-update my-lb 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --certificate-instance-crn crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f510
  • ibmcloud is load-balancer-listener-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --connection-limit 2000
  • ibmcloud is load-balancer-listener-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --default-pool 70294e14-4e61-11e8-bcf4-0242ac110004
  • ibmcloud is load-balancer-listener-update my-lb 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --default-pool my-pool
  • ibmcloud is load-balancer-listener-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --protocol https
  • ibmcloud is load-balancer-listener-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --port 222
  • ibmcloud is load-balancer-listener-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --output JSON
  • ibmcloud is load-balancer-listener-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --accept-proxy-protocol true
  • ibmcloud is load-balancer-listener-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --port-min 80 --port-max 85 此侦听器所使用的端口的范围。
  • ibmcloud is load-balancer-listener-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --http-redirect-listener-id d7e0543c-4e0f-4c0d-89aa-73f0f028ec61 --http-redirect-status-code 303
  • ibmcloud is load-balancer-listener-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --http-redirect-listener-id d7e0543c-4e0f-4c0d-89aa-73f0f028ec61 --http-redirect-status-code 307 --http-redirect-target-uri /example2
  • ibmcloud is load-balancer-listener-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --disable-http-redirect
  • ibmcloud is load-balancer-listener-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --protocol udp
  • ibmcloud is load-balancer-listener-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --idle-connection-timeout 30
  • ibmcloud is load-balancer-listener-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --client-auth-ca-crn crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f511 --client-auth-crl @crl.pem

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • LISTENER_ID：监听器的 ID。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --protocol：监听器协议。 该应用系列中的负载均衡器支持 tcp、http 和 https。 网络系列中的负载均衡器支持 tcp 和 udp。
  • --port：监听端口号。 范围：1-65535。
  • --port-min：此监听器所用端口范围的包含下限。 该值不得大于 port_max。 目前，仅启用了以路由模式运行的负载均衡器，且_网络_家族中的公共负载均衡器支持每个监听器拥有多个端口。 负载均衡器中使用相同_协议_的监听器必须具有互不重叠的端口范围。 范围：1-65535。
  • --port-max：此监听器所用端口范围的包含上界。 不得小于 port_min。 目前，只有启用了路由模式的负载均衡器以及_网络_家族中的公共负载均衡器支持每个监听器拥有多个端口。 负载均衡器中使用相同_协议_的监听器必须具有互不重叠的端口范围。 范围：1-65535。
  • --default-pool：默认池的 ID。
  • --reset-default-pool：重置默认池。
  • --connection-limit：监听器的最大连接数。 此选项不适用于属于该网络家族的负载均衡器。
  • --certificate-instance-crn：用于 SSL 终止的证书实例CRN。 当协议为 https 时，此项为必填项。 此选项不适用于属于该网络家族的负载均衡器。
  • --accept-proxy-protocol：如果设置为 true，则为该监听器启用代理协议。 仅受应用程序负载均衡器支持。 其中一个: false，true。
  • --disable-http-redirect：启用或禁用监听器上的 HTTP 重定向。
  • --http-redirect-listener-id：作为 HTTP 重定向目标设置的监听器的ID。
  • --http-redirect-status-code：重定向响应中返回的 HTTP 状态码。 301，302，303，307 和 308 之一。
  • --http-redirect-target-uri：流量被重定向到的目标 URI。 此设置是可选的，如果设置，那么必须以“/”开头。
  • --reset-http-redirect-target-uri：重置目标 URI。
  • --idle-connection-timeout：监听器的空闲连接超时时间（单位：秒）。 只有应用程序系列中的负载均衡器支持此选项。 最小值: 50，最大值: 7200。(缺省值: 50)。
  • --client-auth-ca-crn：此监听器的客户端身份验证。 此选项不适用于属于该网络家族的负载均衡器。
  • --reset-client-auth-ca-crn：从客户端身份验证中移除证书颁发机构。
  • --client-auth-crl: CRL | @CRL_FILE，用于验证客户端证书撤销情况的证书撤销列表。 监听器必须具备 HTTPS 协议。 证书撤销列表（CRL）的内容采用 PEM 格式进行编码，或者其文件路径中包含该CRL。 此选项不适用于属于该网络家族的负载均衡器。 以下之一：CRL、@CRL_FILE。
  • --reset-client-auth-crl：从客户端身份验证中移除证书撤销列表。
  • --reset-client-auth：从监听器中删除客户端身份验证配置。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-listeners

列出所有负载均衡器的监听器。

ibmcloud is load-balancer-listeners LOAD_BALANCER [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是负载均衡器池

查看负载均衡器池的详细信息。

ibmcloud is load-balancer-pool LOAD_BALANCER POOL [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • POOL：池的ID或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-pool-create

创建一个负载均衡器池。

ibmcloud is load-balancer-pool-create POOL_NAME LOAD_BALANCER ALGORITHM PROTOCOL HEALTH_DELAY HEALTH_RETRIES HEALTH_TIMEOUT HEALTH_TYPE (--members MEMBERS_JSON | @MEMBERS_JSON_FILE) [--health-monitor-request-method REQUEST_METHOD [--health-monitor-request-body REQUEST_BODY] [--health-monitor-request-headers REQUEST_HEADERS_JSON | @REQUEST_HEADERS_JSON_FILE]] [--vpc VPC] [--health-monitor-url URL] [--health-monitor-port PORT] [--session-persistence-type source_ip | http_cookie | app_cookie [--session-persistence-cookie-name SESSION_PERSISTENCE_COOKIE_NAME]] [--proxy-protocol disabled | v1 | v2] [--health-monitor-response-body-regex RESPONSE_BODY_REGEX] [--health-monitor-response-code RESPONSE_CODE1 --health-monitor-response-code RESPONSE_CODE2 ...] [--failsafe-policy-action fail | forward | drop | bypass] [--failsafe-policy-target FAILSAFE_POLICY_TARGET] [--server-auth-verify-cert true | false] [--server-auth-ca-crn SERVER_AUTH_CA_CRN] [--client-auth-cert-crn CLIENT_AUTH_CERT_CRN] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is load-balancer-pool-create my-pool 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 round_robin http 20 2 5 http
  • ibmcloud is load-balancer-pool-create my-pool my-lb round_robin http 20 2 5 http
  • ibmcloud is load-balancer-pool-create my-pool my-lb round_robin http 20 2 5 http --vpc my-vpc
  • ibmcloud is load-balancer-pool-create my-pool 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 round_robin http 20 2 5 http --health-monitor-url / --health-monitor-port 4001
  • ibmcloud is load-balancer-pool-create my-pool 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 round_robin http 20 2 5 http --session-persistence-type source_ip --output JSON
  • ibmcloud is load-balancer-pool-create my-pool 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 round_robin http 20 2 5 http --members '[{"port": 80, "target": { "address": "10.10.1.4"}, "weight": 20 }, {"port": 80, "target": { "address": "10.240.0.6"}, "weight": 30 }]' 创建一个包含成员的应用程序负载均衡池
  • ibmcloud is load-balancer-pool-create my-pool 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 round_robin tcp 20 2 5 http --members '[{"port": 80, "target": { "id": "0736_63b9233c-812e-4d65-9ee3-fa61172afa37"}, "weight": 20 }, {"port": 80, "target": { "id": "0716_4b30a833-6f10-46a9-a4b8-13871f3559b8"}, "weight": 30 }]' 创建一个包含成员的网络负载均衡器池
  • ibmcloud is load-balancer-pool-create my-pool2 my-nlb round_robin tcp 20 2 5 http --members '[{"port": 80, "target": { "name": "my-instance"}}, {"port": 80, "target": { "name": "my-instance2"}}]' 创建包含成员的网络负载均衡器池，并按名称提供成员目标。
  • ibmcloud is load-balancer-pool-create my-pool2 my-nlb round_robin tcp 20 2 5 http --members '[{"port":8080,"target":{"id":"72251a2e-d6c5-42b4-97b0-b5f8e8d1f478"}}]' 创建一个专用路径网络负载均衡器，并将应用程序负载均衡器标识作为池成员目标。
  • ibmcloud is load-balancer-pool-create my-pool2 my-nlb round_robin tcp 20 2 5 http --members '[{"port":8080,"target":{"name":"my-lb-name","target_type":"load_balancer"}}]' 创建一个专用路径网络负载均衡器，并将应用程序负载均衡器名称作为池成员目标。
  • ibmcloud is load-balancer-pool-create my-pool2 my-nlb round_robin tcp 20 2 5 http --members '[{"port":8080,"target":{"id":"72251a2e-d6c5-42b4-97b0-b5f8e8d1f474"}}]' 创建一个专用路径网络负载均衡器，并将保留的 IP 标识作为池成员目标。
  • ibmcloud is load-balancer-pool-create my-pool 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 round_robin http 20 2 5 http --proxy-protocol v1
  • ibmcloud is load-balancer-pool-create my-pool 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 round_robin http 20 2 5 http --session-persistence-type app_cookie --session-persistence-cookie-name my-cookie-name
  • ibmcloud is load-balancer-pool-create my-pool 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 round_robin udp 20 2 5 http 为使用 UDP 协议的网络负载均衡器监听器创建一个网络负载均衡器池。
  • ibmcloud is load-balancer-pool-create my-pool 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 round_robin http 20 2 5 http --failsafe-policy-action forward --failsafe-policy-target my-lb 使用故障安全策略为网络负载均衡器侦听器创建网络负载均衡器池。
  • ibmcloud is load-balancer-pool-create my-pool 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 round_robin http 20 2 5 http --failsafe-policy-action forward --failsafe-policy-target 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 使用故障安全策略为网络负载均衡器侦听器创建网络负载均衡器池。
  • ibmcloud is load-balancer-pool-create my-pool 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 round_robin http 20 2 5 http --health-monitor-request-method post --health-monitor-request-body ACTIVE --health-monitor-request-headers '[{"field":"Host","value":"my-host-header-value"},{"field":"Content-Type","value":"text/plain"}]' --health-monitor-response-body-regex ACTIVE 创建一个应用程序负载均衡器池，并配置基于请求和响应正文正则表达式的健康检查。
  • ibmcloud is load-balancer-pool-create my-pool 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 round_robin http 20 2 5 http --health-monitor-request-method get --health-monitor-request-headers '[{"field":"Host","value":"my-host-header-value"}]' --health-monitor-response-code 200 创建一个带有健康检查请求和响应代码的应用程序负载均衡器池。
  • ibmcloud is load-balancer-pool-create my-pool 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 round_robin http 20 2 5 http --server-auth-verify-cert true --server-auth-ca-crn crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f511 --client-cert-crn crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f512a

命令选项

  • POOL_NAME：资源池的名称。
  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • 算法：负载均衡算法。 round_robin，weighted_round_robin 和 least_connections 中的一个。
  • 协议：泳池协议。 该应用系列中的负载均衡器支持 tcp、http 和 https。 网络系列中的负载均衡器支持 tcp 和 udp。
  • HEALTH_DELAY：健康检查间隔（单位：秒）。 时间间隔必须大于超时值。 最小值：2，最大值：60。
  • HEALTH_RETRIES：健康检查的最大重试次数。 最小值：1，最大值：10。
  • HEALTH_TIMEOUT：健康检查超时时间（单位：秒）。 最小值：1，最大值：59。
  • HEALTH_TYPE：健康检查协议。 该应用系列中的负载均衡器支持 tcp、http 和 https。 网络系列中的负载均衡器支持 tcp 和 http。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --health-monitor-url：健康检查的 URL 路径。 仅当 HEALTH_TYPE 为 http 或 https 时才适用。
  • --health-monitor-port：健康检查端口号。 如果已指定，那么服务器成员资源中的指定端口会被覆盖。
  • --session-persistence-type：会话持久化类型。 source_ip，http_cookie 和 app_cookie 之一。
  • --session-persistence-cookie-name：会话持久化 Cookie 的名称。 此选项仅适用于 app_cookie 类型。
  • --proxy-protocol：此池的代理协议设置。 仅应用程序负载均衡器支持代理协议。 以下选项之一：残障人士，v1，v2.
  • --members：MEMBERS_JSON|@MEMBERS_JSON_FILE，以 JSON 或 JSON 文件形式提供的成员列表。
  • --health-monitor-request-method：用于健康检查的 HTTP 请求方法。 以下选项之一：get、post。 仅当 HEALTH_TYPE 为 http 或 https 时适用。
  • --health-monitor-request-body：用于健康检查的 HTTP 请求正文。 仅当发布的是 --health-monitor-request-method 时适用。
  • --health-monitor-request-headers：REQUEST_HEADERS_JSON|@REQUEST_HEADERS_JSON_FILE，以 JSON 或 JSON 文件格式提供的请求头。
  • --health-monitor-response-body-regex：HTTP 响应正文需匹配的PCRE风格正则表达式，以通过健康检查。
  • --health-monitor-response-code：健康检查成功时预期返回的 HTTP 响应代码。
  • --failsafe-policy-action：此资源池应采用的容错策略。 如果未指定，则使用配置文件中的默认故障安全策略操作。 失败 、前进、放弃、绕行。
  • --failsafe-policy-target：要转发到的故障安全目标池的 ID 或名称。 如果指定了故障安全策略操作，则该操作必须为“转发”。
  • --server-auth-verify-cert：如果设置为 true，则会验证后端服务器的证书。 以下选项之一：true、false。
  • --server-auth-ca-crn：用于服务器身份验证证书颁发机构（CA）的证书实例的 CRN。 当 server-auth-verify-cert 设置为 true 时，此项必填。
  • --client-auth-cert-crn：用于客户端身份验证的证书实例的 CRN，该证书可实现负载均衡器与后端服务器之间的双向 TLS （ mTLS ）。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-pool-delete

从负载均衡器中删除一个或多个池。

ibmcloud is load-balancer-pool-delete LOAD_BALANCER (POOL1 POOL2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • POOL1：池的ID或名称。
  • POOL2：资源池的ID或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-pool-member

查看负载均衡器池成员的详细信息。

ibmcloud is load-balancer-pool-member LOAD_BALANCER POOL MEMBER_ID [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • POOL：池的ID或名称。
  • MEMBER_ID：会员的ID。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-pool-member-create

创建一个负载均衡池成员。

ibmcloud is load-balancer-pool-member-create LOAD_BALANCER POOL PORT TARGET [--vpc VPC] [--weight WEIGHT] [--target-type instance | load_balancer | reserved_ip [--reserved-ip-subnet RESERVED_IP_SUBNET [--reserved-ip-vpc RESERVED_IP_VPC]]] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is load-balancer-pool-member-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 3000 192.168.100.5
  • ibmcloud is load-balancer-pool-member-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 3000 9e692608-3b3a-4cfb-9f46-efb6b711876d
  • ibmcloud is load-balancer-pool-member-create my-nlb my-pool 3000 my-instance
  • ibmcloud is load-balancer-pool-member-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 3000 192.168.100.5 --weight 100 --output JSON
  • ibmcloud is load-balancer-pool-member-create my-nlb my-pool 3000 my-instance --target-type instance
  • ibmcloud is load-balancer-pool-member-create my-nlb my-pool 3000 my-lb --target-type load_balancer
  • ibmcloud is load-balancer-pool-member-create my-nlb my-pool 3000 my-reserved-ip --target-type reserved_ip --reserved-ip-subnet my-subnet-name --reserved-ip-vpc my-vpc
  • ibmcloud is load-balancer-pool-member-create my-nlb my-pool 3000 my-reserved-ip --target-type reserved_ip --reserved-ip-subnet 72251a2e-d6c5-42b4-97b0-b5f8e8d1f4
  • ibmcloud is load-balancer-pool-member-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 3000 my-service.example.com --weight 100

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • POOL：池的ID或名称。
  • 端口：成员接收负载均衡器流量的端口。 仅适用于在具有单个端口的侦听器上接收到的负载均衡器流量。 如果在具有端口范围的侦听器上接收到流量，那么成员将在该侦听器所接收到的同一端口上接收到流量。 除非在 health_monitor 属性中指定了端口属性，否则该端口也可用于健康检查。
  • 目标：对于属于应用程序家族的负载均衡器，其池成员的 IP 地址或完全合格域名（FQDN）；对于属于网络家族的负载均衡器，其 ALB 的 ID 或名称，或其实例。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --weight：服务器成员的权重。 仅当该负载均衡池的算法为 weighted_round_robin 时，此选项才适用。
  • --target-type：此资源池成员的目标类型。 实例、负载平衡器、预留 IP 中的一个。
  • --reserved-ip-subnet：当目标类型仅为保留 IP 时，此选项才适用。
  • --reserved-ip-vpc：此选项仅在目标类型为“预留 IP”且通过名称指定了预留 IP 子网时适用。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-pool-member-update

更新负载均衡器池中的一个成员。

ibmcloud is load-balancer-pool-member-update LOAD_BALANCER POOL MEMBER_ID [--vpc VPC] [--target-address TARGET_ADDRESS | --target-fqdn TARGET_FQDN | --target TARGET] [--port PORT] [--weight WEIGHT] [--target-type instance | load_balancer | reserved_ip [--reserved-ip-subnet RESERVED_IP_SUBNET [--reserved-ip-vpc RESERVED_IP_VPC]]] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is load-balancer-pool-member-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --target 192.168.100.5 --port 3001
  • ibmcloud is load-balancer-pool-member-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --target 9e692608-3b3a-4cfb-9f46-efb6b711876d --port 3001
  • ibmcloud is load-balancer-pool-member-update my-nlb my-pool 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --target my-instance --port 3001
  • ibmcloud is load-balancer-pool-member-update my-nlb my-pool 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --vpc my-vpc --target my-instance --port 3001
  • ibmcloud is load-balancer-pool-member-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --target-address 192.168.100.5 --port 3001
  • ibmcloud is load-balancer-pool-member-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --target-address 192.168.100.5 --port 3001 --weight 100 --output JSON
  • ibmcloud is load-balancer-pool-member-update my-nlb my-pool 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --target my-instance --target-type instance
  • ibmcloud is load-balancer-pool-member-update my-nlb my-pool 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --target my-lb --target-type load_balancer
  • ibmcloud is load-balancer-pool-member-update my-nlb my-pool 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --port 3001 --target my-instance --target-type instance
  • ibmcloud is load-balancer-pool-member-update my-nlb my-pool 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --port 3001 --target my-reserved-ip --target-type reserved_ip --reserved-ip-subnet my-subnet-name --reserved-ip-vpc my-vpc
  • ibmcloud is load-balancer-pool-member-update my-nlb my-pool 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --port 3001 --target my-reserved-ip --target-type reserved_ip --reserved-ip-subnet 72251a2e-d6c5-42b4-97b0-b5f8e8d1f4
  • ibmcloud is load-balancer-pool-member-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --target-fqdn my-service.example.com --port 3001

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • POOL：池的ID或名称。
  • MEMBER_ID：会员的ID。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --target-address：池成员的 IP 地址。
  • --target-fqdn：要作为目标的完全合格域名（FQDN）。 负载均衡器必须将 fqdn_pool_members_supported 设置为 true。
  • --target：对于属于应用程序家族的负载均衡器，指定其池成员的 IP 地址或完全合格域名（FQDN）；对于属于网络家族的负载均衡器，指定其 ALB 的 ID 或名称，或其实例。
  • --port：成员接收负载均衡器流量的端口。 仅适用于在具有单个端口的侦听器上接收到的负载均衡器流量。 如果在具有端口范围的侦听器上接收到流量，那么成员将在该侦听器所接收到的同一端口上接收到流量。 除非在 health_monitor 属性中指定了端口属性，否则该端口也可用于健康检查。
  • --weight：服务器成员的权重。 仅当该负载均衡池的算法为 weighted_round_robin 时，此选项才适用。
  • --target-type：此资源池成员的目标类型。 实例、负载平衡器、预留 IP 中的一个。
  • --reserved-ip-subnet：当目标类型仅为保留 IP 时，此选项才适用。
  • --reserved-ip-vpc：此选项仅在目标类型为“预留 IP”且通过名称指定了预留 IP 子网时适用。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-pool-member-delete

从负载均衡器池中删除一个或多个成员。

ibmcloud is load-balancer-pool-member-delete LOAD_BALANCER POOL (MEMBER_ID1 MEMBER_ID2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • POOL：池的ID或名称。
  • MEMBER_ID1：会员的ID。
  • MEMBER_ID2：会员的ID。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-pool-members

列出负载均衡池中的所有成员。

ibmcloud is load-balancer-pool-members LOAD_BALANCER POOL [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • POOL：池的ID或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-pool-update

更新负载均衡器的池。

ibmcloud is load-balancer-pool-update LOAD_BALANCER POOL [--vpc VPC] [--algorithm round_robin | weighted_round_robin | least_connections] [--health-delay DELAY] [--health-max-retries RETRIES] [--health-timeout TIMEOUT] [--health-type https | http | tcp] [--health-monitor-url URL] [--health-monitor-port PORT | --reset-health-monitor-port] [--protocol https | http | tcp | udp] [[--session-persistence-type source_ip | http_cookie | app_cookie | none] | [--session-persistence-cookie-name SESSION_PERSISTENCE_COOKIE_NAME]] [--proxy-protocol disabled | v1 | v2] [--name NEW_NAME] [--failsafe-policy-action fail | forward | drop | bypass] [--failsafe-policy-target FAILSAFE_POLICY_TARGET] [--health-monitor-request-method REQUEST_METHOD] [--health-monitor-request-body REQUEST_BODY | --reset-health-monitor-request-body] [--health-monitor-request-headers REQUEST_HEADERS_JSON|@REQUEST_HEADERS_JSON_FILE] [--health-monitor-response-body-regex RESPONSE_BODY_REGEX | --reset-health-monitor-response-body-regex] [--health-monitor-response-code RESPONSE_CODE1 --health-monitor-response-code RESPONSE_CODE2 ...] [[--server-auth-verify-cert true | false] [--server-auth-ca-crn SERVER_AUTH_CA_CRN] | --reset-server-auth] [--client-auth-cert-crn CLIENT_AUTH_CERT_CRN | --reset-client-auth] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is load-balancer-pool-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --algorithm round_robin
  • ibmcloud is load-balancer-pool-update my-lb my-pool --algorithm round_robin
  • ibmcloud is load-balancer-pool-update my-lb my-pool --vpc my-vpc --algorithm round_robin
  • ibmcloud is load-balancer-pool-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --health-delay 20 --health-max-retries 2 --health-timeout 5 --health-type http
  • ibmcloud is load-balancer-pool-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --health-monitor-url / --health-monitor-port 4001
  • ibmcloud is load-balancer-pool-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --session-persistence-type source_ip
  • ibmcloud is load-balancer-pool-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --protocol http
  • ibmcloud is load-balancer-pool-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --name lb-rule-name --output JSON
  • ibmcloud is load-balancer-pool-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --proxy-protocol v2
  • ibmcloud is load-balancer-pool-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --session-persistence-type app_cookie --session-persistence-cookie-name my-cookie-name
  • ibmcloud is load-balancer-pool-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --failsafe-policy-action forward --failsafe-policy-target my-lb
  • ibmcloud is load-balancer-pool-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --health-monitor-request-method post --health-monitor-request-body ACTIVE --health-monitor-request-headers '[{"field":"Host","value":"my-host-header-value"},{"field":"Content-Type","value":"text/plain"}]' --health-monitor-response-body-regex ACTIVE
  • ibmcloud is load-balancer-pool-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --health-monitor-request-method get --health-monitor-request-headers '[{"field":"Host","value":"my-host-header-value"}]' --health-monitor-response-code 200
  • ibmcloud is load-balancer-pool-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --health-monitor-request-method post --reset-health-monitor-request-body --reset-health-monitor-response-body-regex
  • ibmcloud is load-balancer-pool-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --server-auth-verify-cert true --server-auth-ca-crn crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f511
  • ibmcloud is load-balancer-pool-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --client-cert-crn crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f512a

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • POOL：池的ID或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --algorithm：负载均衡算法。 round_robin，weighted_round_robin 和 least_connections 中的一个。
  • --health-delay：健康检查间隔（单位：秒）。 时间间隔必须大于超时值。 最小值：2，最大值：60。
  • --health-max-retries：健康检查的最大重试次数。 最小值：1，最大值：10。
  • --health-timeout：健康检查超时时间（单位：秒）。 最小值：1，最大值：59。
  • --health-type：健康检查协议。 该应用系列中的负载均衡器支持 tcp、http 和 https。 网络系列中的负载均衡器支持 tcp 和 http。
  • --health-monitor-url：健康检查的 URL 路径。 仅当 HEALTH_TYPE 为 http 或 https 时才适用。
  • --health-monitor-port：健康检查端口号。 如果已指定，那么服务器成员资源中的指定端口会被覆盖。
  • --reset-health-monitor-port：重置健康监测端口。
  • --protocol：池协议。 该应用系列中的负载均衡器支持 tcp、http 和 https。 网络系列中的负载均衡器支持 tcp 和 udp。
  • --session-persistence-type：会话持久化类型。 下列其中一项: source_ip，http_cookie，app_cookie 和 none。
  • --session-persistence-cookie-name：会话持久化 Cookie 的名称。 此选项仅适用于 app_cookie 类型。
  • --proxy-protocol：此池的代理协议设置。 仅应用程序负载均衡器支持代理协议。 以下选项之一：残障人士，v1，v2.
  • --name: 池的新名称。
  • --failsafe-policy-action：此资源池应采用的容错策略。 如果未指定，则使用配置文件中的默认故障安全策略操作。 失败 、前进、放弃、绕行。
  • --failsafe-policy-target：要转发到的故障安全目标池的 ID 或名称。 如果指定了故障安全策略操作，则该操作必须为“转发”。
  • --health-monitor-request-method：用于健康检查的 HTTP 请求方法。 以下选项之一：get、post。 仅当 HEALTH_TYPE 为 http 或 https 时适用。
  • --health-monitor-request-body：用于健康检查的 HTTP 请求正文。 仅当发布的是 --health-monitor-request-method 时适用。
  • --reset-health-monitor-request-body：重置健康监测请求正文。
  • --health-monitor-request-headers：REQUEST_HEADERS_JSON|@REQUEST_HEADERS_JSON_FILE，以 JSON 或 JSON 文件格式提供的请求头。
  • --health-monitor-response-body-regex：HTTP 响应正文需匹配的PCRE风格正则表达式，以通过健康检查。
  • --reset-health-monitor-response-body-regex：重置健康监测响应正文。
  • --health-monitor-response-code：健康检查成功时预期返回的 HTTP 响应代码。
  • --server-auth-verify-cert：如果设置为 true，则会验证后端服务器的证书。 以下选项之一：true、false。
  • --server-auth-ca-crn：用于服务器身份验证证书颁发机构（CA）的证书实例的 CRN。 当 server-auth-verify-cert 设置为 true 时，此项必填。
  • --reset-server-auth：从服务器池中删除服务器身份验证配置。
  • --client-auth-cert-crn：用于客户端身份验证的证书实例的 CRN，该证书可实现负载均衡器与后端服务器之间的双向 TLS （ mTLS ）。
  • --reset-client-auth：从连接池中删除客户端身份验证配置。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是负载均衡器池

列出负载均衡器的所有池。

ibmcloud is load-balancer-pools LOAD_BALANCER [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-statistics

列出负载均衡器的所有统计信息。

ibmcloud is load-balancer-statistics LOAD_BALANCER [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 load-balancer-update

更新负载均衡器。

ibmcloud is load-balancer-update LOAD_BALANCER --subnets SUBNETS [--vpc VPC] [--name NEW_NAME] [--logging-datapath-active false | true] [--dns-instance-crn DNS_INSTANCE_CRN --dns-zone-id DNS_ZONE_ID | --reset-dns] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is load-balancer-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name my-renamed-lb
  • ibmcloud is load-balancer-update my-lb --name my-renamed-lb
  • ibmcloud is load-balancer-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name my-renamed-lb --output JSON
  • ibmcloud is load-balancer-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --logging-datapath-active false
  • ibmcloud is load-balancer-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --subnets ec8bb350-d802-4f1b-b362-b848abd5bb65,ec8bb350-d802-4f1b-b362-b848abd5bb66
  • ibmcloud is load-balancer-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --dns-instance-crn crn:v1:staging:public:dns-svcs:global:a/efe5afc483594adaa8325e2b4d1290df:228e2e37-b0ce-474d-9824-41fdef4d9121:: --dns-zone-id 260763f2-81e8-4447-b8a1-e9a92d82062c
  • ibmcloud is load-balancer-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --reset-dns

命令选项

  • LOAD_BALANCER：负载均衡器的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --name：负载均衡器的新名称。
  • --logging-datapath-active：启用或禁用此负载均衡器的数据路径日志记录。 数据路径日志记录仅适用于应用程序负载均衡器。 其中一个: false，true。
  • --subnets：用于为该负载均衡器配置子网的 ID 或名称，以逗号分隔。 负载均衡器可用性取决于指定子网所在区域的可用性。 目前，只有应用程序系列中的负载均衡器支持此选项。
  • --dns-instance-crn：与该 DNS 区域关联的 DNS 实例的 CRN。
  • --dns-zone-id：DNS 区域的 ID。
  • --reset-dns：指定此标志可删除所有现有的 DNS 记录。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is load-balancers

列出所有负载均衡器。

ibmcloud is load-balancers [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

网络 ACL

ibmcloud is network-acls

列出所有网络 ACL。

ibmcloud is network-acls [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 network-acl

查看网络访问控制列表（ACL）的详细信息。

ibmcloud is network-acl ACL [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • ACL：网络访问控制列表（ACL）的ID或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 network-acl-create

创建网络 ACL。

ibmcloud is network-acl-create ACL_NAME VPC [--rules (RULES_JSON|@RULES_JSON_FILE) | (--source-acl SOURCE_ACL [--source-acl-vpc SOURCE_ACL_VPC])] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is network-acl-create my-acl 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479
  • ibmcloud is network-acl-create my-acl my-vpc
  • ibmcloud is network-acl-create my-acl 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --source-acl 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3
  • ibmcloud is network-acl-create my-new-acl my-vpc --source-acl my-acl
  • ibmcloud is network-acl-create my-new-acl my-vpc --source-acl my-acl --source-acl-vpc my-vpc2
  • ibmcloud is network-acl-create my-acl 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --rules '[{ "action": "allow", "destination": "192.168.0.0/24", "direction": "inbound", "source": "10.0.0.0/24", "protocol": "tcp" }]'
  • ibmcloud is network-acl-create my-acl 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --output JSON

命令选项

  • ACL_NAME：网络访问控制列表（ACL）的名称。
  • VPC：VPC 的 ID 或名称。
  • --rules：RULES_JSON|@RULES_JSON_FILE，以 JSON 或 JSON 文件形式指定的访问控制列表 (ACL) 规则。
  • --source-acl：要从中复制规则的网络访问控制列表（ACL）的 ID 或名称。
  • --source-acl-vpc：源网络访问控制列表（ACL）所属 VPC 的 ID 或名称。 在此 VPC 内按名称指定唯一源网络 ACL 时才需要此项。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 network-acl-update

更新网络 ACL。

ibmcloud is network-acl-update ACL --name NEW_NAME [--vpc VPC] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is network-acl-update 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --name my-renamed-acl
  • ibmcloud is network-acl-update my-acl --name my-renamed-acl
  • ibmcloud is network-acl-update my-acl --vpc my-vpc --name my-renamed-acl
  • ibmcloud is network-acl-update 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --name my-renamed-acl --output JSON

命令选项

  • ACL：网络访问控制列表（ACL）的ID或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --name: 网络访问控制列表（ACL）的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 network-acl-delete

删除一个或多个网络 ACL。

ibmcloud is network-acl-delete (ACL1 ACL2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • ACL1：网络访问控制列表（ACL）的ID或名称。
  • ACL2：网络访问控制列表（ACL）的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 network-acl-rules

列出网络访问控制列表（ACL）中的所有规则。

ibmcloud is network-acl-rules ACL [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • ACL：网络访问控制列表（ACL）的ID或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 network-acl-rule

查看网络访问控制列表（ACL）规则的详细信息。

ibmcloud is network-acl-rule ACL RULE [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • ACL：网络访问控制列表（ACL）的ID或名称。
  • 规则：规则的ID或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 network-acl-rule-add

向网络访问控制列表（ACL）添加一条规则。

ibmcloud is network-acl-rule-add ACL ACTION DIRECTION PROTOCOL SOURCE DESTINATION [--vpc VPC] [--name NAME] [--icmp-type ICMP_TYPE] [--icmp-code ICMP_CODE] [--source-port-min PORT_MIN] [--source-port-max PORT_MAX] [--destination-port-min PORT_MIN] [--destination-port-max PORT_MAX] [--before-rule BEFORE_RULE | --reset-before-rule] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is network-acl-rule-add 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 allow inbound icmp_tcp_udp 10.2.2.2 10.2.2.3
  • ibmcloud is network-acl-rule-add my-acl allow inbound icmp_tcp_udp 10.2.2.2 10.2.2.3
  • ibmcloud is network-acl-rule-add my-acl allow inbound icmp_tcp_udp 10.2.2.2 10.2.2.3 --vpc my-vpc
  • ibmcloud is network-acl-rule-add 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 allow inbound number_99 10.2.2.2 10.2.2.3
  • ibmcloud is network-acl-rule-add 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 allow inbound any 10.2.2.2 10.2.2.3
  • ibmcloud is network-acl-rule-add 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 allow inbound icmp_tcp_udp 10.2.2.2 10.2.2.3 --name my-acl-rule
  • ibmcloud is network-acl-rule-add 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 allow inbound icmp 10.2.2.2 10.2.2.3 --icmp-type 8 --icmp-code 0
  • ibmcloud is network-acl-rule-add 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 allow inbound tcp 10.2.2.2 10.2.2.3 --source-port-min 555 --source-port-max 666 --destination-port-min 11 --destination-port-max 55
  • ibmcloud is network-acl-rule-add 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 allow inbound icmp_tcp_udp 10.2.2.2 10.2.2.3 --before-rule-id 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479
  • ibmcloud is network-acl-rule-add 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 allow inbound icmp_tcp_udp 10.2.2.2 10.2.2.3 --output JSON

命令选项

  • ACL：网络访问控制列表（ACL）的ID或名称。
  • 操作: allow 和 deny 之一。
  • 行车方向：需执行的行车方向。 其中一个: 入站，出站。
  • 协议：网络协议的名称。 以下之一：any、icmp_tcp_udp、icmp、tcp、udp、ah、gre、ip_in_ip、l2tp, rsvp, sctp, vrrp。 对于其他协议，请使用 number_ ，其中 的取值范围为 0-255（例如：number_99 ）。 众所周知的协议使用标准名称（例如，协议 6 称为 tcp）；其 number_ 这种形式是无效的。 IPv6-specific 协议不受支持：number_0、number_43、number_44、number_58、number_59、number_60、number_135。
  • 源：源 IP 地址或 CIDR 地址块。
  • 目标：目标 IP 地址或 CIDR 块。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --name：ACL 规则的名称。
  • --icmp-type：要允许的 ICMP 流量类型。 有效值范围为 0 到 254。 仅当协议设置为 icmp 时，才指定此选项。 如果未指定，将允许所有类型。
  • --icmp-code：要允许的 ICMP 流量代码。 有效值范围为 0 到 255。 仅当协议设置为 icmp 时，才指定此选项。 如果未指定，将允许所有代码。
  • --source-port-min：源端口号的下限。 有效值范围为 1 到 65535。 仅当协议设置为 tcp 或 udp 时，才指定此选项（默认值：1 ）。
  • --source-port-max：源端口号的最大值。 有效值范围为 1 到 65535。 仅当协议设置为 tcp 或 udp 时，才需指定此选项（默认值：65535 ）。
  • --destination-port-min：最小目标端口号。 有效值范围为 1 到 65535。 仅当协议设置为 tcp 或 udp 时，才指定此选项（默认值：1 ）。
  • --destination-port-max：最大目标端口号。 有效值范围为 1 到 65535。 仅当协议设置为 tcp 或 udp 时，才需指定此选项（默认值：65535 ）。
  • --before-rule：本规则插入前的规则的 ID 或名称。
  • --reset-before-rule：在规则执行前重置。 指定此选项以将此规则移到全部现有规则之后。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 network-acl-rule-update

更新网络访问控制列表（ACL）中的一条规则。

ibmcloud is network-acl-rule-update ACL RULE [--vpc VPC] [--name NEW_NAME] [--direction inbound | outbound] [--action allow | deny] [--before-rule BEFORE_RULE | --reset-before-rule] [--source SOURCE] [--dest DEST] [--icmp-type ICMP_TYPE] [--icmp-code ICMP_CODE] [--source-port-min PORT_MIN] [--source-port-max PORT_MAX] [--destination-port-min PORT_MIN] [--destination-port-max PORT_MAX] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is network-acl-rule-update 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 8daca77a-4980-4d33-8f3e-7038797be8f9 --action allow --direction inbound --source 10.2.2.2 --dest 10.2.2.3
  • ibmcloud is network-acl-rule-update my-acl my-acl-rule --action allow --direction inbound --source 10.2.2.2 --dest 10.2.2.3
  • ibmcloud is network-acl-rule-update my-acl my-acl-rule --vpc my-vpc --name my-acl-renamed-rule
  • ibmcloud is network-acl-rule-update 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 8daca77a-4980-4d33-8f3e-7038797be8f9 --action allow --direction inbound --source 10.2.2.2 --dest 10.2.2.3 --name my-acl
  • ibmcloud is network-acl-rule-update 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 8daca77a-4980-4d33-8f3e-7038797be8f9 --action allow --direction inbound --source 10.2.2.2 --dest 10.2.2.3 --icmp-type 8 --icmp-code 0
  • ibmcloud is network-acl-rule-update 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 8daca77a-4980-4d33-8f3e-7038797be8f9 --action allow --direction inbound --source 10.2.2.2 --dest 10.2.2.3 --source-port-min 555 --source-port-max 666 --destination-port-min 11 --destination-port-max 55
  • ibmcloud is network-acl-rule-update 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 8daca77a-4980-4d33-8f3e-7038797be8f9 --action allow --direction inbound --source 10.2.2.2 --dest 10.2.2.3 --before-rule-id 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479
  • ibmcloud is network-acl-rule-update 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 8daca77a-4980-4d33-8f3e-7038797be8f9 --action allow --direction inbound --source 10.2.2.2 --dest 10.2.2.3 --output JSON

命令选项

  • ACL：网络访问控制列表（ACL）的ID或名称。
  • 规则：规则的ID或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --name: 规则的新名称。
  • --direction：需执行的交通方向。 其中一个: 入站，出站。
  • -- action: allow 和 deny 之一。
  • --before-rule：本规则插入前的规则的 ID 或名称。
  • --reset-before-rule：在规则执行前重置。 指定此选项以将此规则移到全部现有规则之后。
  • --source：源 IP 地址或 CIDR 地址块。
  • --dest：目标 IP 地址或 CIDR 地址块。
  • --icmp-type：要允许的 ICMP 流量类型。 有效值范围为 0 到 254。 仅当协议设置为 icmp 时，才指定此选项。 如果未指定，将允许所有类型。
  • --icmp-code：要允许的 ICMP 流量代码。 有效值范围为 0 到 255。 仅当协议设置为 icmp 时，才指定此选项。 如果未指定，将允许所有代码。
  • --source-port-min：源端口号的下限。 有效值范围为 1 到 65535。 仅当协议设置为 tcp 或 udp 时，才指定此选项（默认值：1 ）。
  • --source-port-max：源端口号的最大值。 有效值范围为 1 到 65535。 仅当协议设置为 tcp 或 udp 时，才需指定此选项（默认值：65535 ）。
  • --destination-port-min：最小目标端口号。 有效值范围为 1 到 65535。 仅当协议设置为 tcp 或 udp 时，才指定此选项（默认值：1 ）。
  • --destination-port-max：最大目标端口号。 有效值范围为 1 到 65535。 仅当协议设置为 tcp 或 udp 时，才需指定此选项（默认值：65535 ）。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 network-acl-rule-delete

从网络 ACL 中删除一个或多个规则。

ibmcloud is network-acl-rule-delete ACL (RULE1 RULE2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • ACL：网络访问控制列表（ACL）的ID或名称。
  • 规则1：规则的ID或名称。
  • 规则2：规则的ID或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

公共网关

ibmcloud 是 public-gateway

查看公共网关的详细信息。

ibmcloud is public-gateway GATEWAY [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • 网关：公共网关的ID或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 公共网关创建

创建公共网关。

ibmcloud is public-gateway-create GATEWAY_NAME VPC ZONE_NAME [--ip ID | NAME | ADDRESS] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is public-gateway-create my-public-gateway 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1
  • ibmcloud is public-gateway-create my-public-gateway my-vpc us-south-1
  • ibmcloud is public-gateway-create my-public-gateway 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 --ip 39300233-9995-4806-89a5-3c1b6eb88689
  • ibmcloud is public-gateway-create my-public-gateway my-vpc us-south-1 --ip my-ip
  • ibmcloud is public-gateway-create my-public-gateway 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 --ip 203.0.113.1
  • ibmcloud is public-gateway-create my-public-gateway 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 --output JSON

命令选项

  • GATEWAY_NAME：公共网关的名称。
  • VPC：VPC 的 ID 或名称。
  • ZONE_NAME：区域名称。
  • --ip：绑定到公共网关的浮动 IP 的 ID、名称或现有 IP 地址。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 公共网关删除

删除一个或多个公共网关。

ibmcloud is public-gateway-delete (GATEWAY1 GATEWAY2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • 网关1：公共网关的ID或名称。
  • GATEWAY2：公共网关的ID或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 public-gateway-update

更新公共网关。

ibmcloud is public-gateway-update GATEWAY --name NEW_NAME [--vpc VPC] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is public-gateway-update 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --name my-renamed-gateway --output JSON
  • ibmcloud is public-gateway-update my-gateway --name my-renamed-gateway --output JSON

命令选项

  • 网关：公共网关的ID或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --name：公共网关的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is public-gateways

列出所有公共网关。

ibmcloud is public-gateways [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

路由表和路由

以下部分提供了有关可用于处理 VPC 路由表和路由的 CLI 命令的详细信息。

ibmcloud 是 vpc-default-路由表

查看 VPC 的默认路由表详细信息。

ibmcloud is vpc-default-routing-table VPC [--output JSON] [-q, --quiet]

命令选项

  • VPC：VPC 的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpc-路由表

列出某个 VPC 的所有路由表。

ibmcloud is vpc-routing-tables VPC [--is-default true | false] [--output JSON] [-q, --quiet]

命令选项

  • VPC：VPC 的 ID 或名称。
  • --is-default：将集合过滤为具有 is_default 属性且该属性值与指定值匹配的路由表。 以下选项之一：true、false。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpc-路由表

查看 VPC 路由表的详细信息。

ibmcloud is vpc-routing-table VPC ROUTING_TABLE [--output JSON] [-q, --quiet]

命令选项

  • VPC：VPC 的 ID 或名称。
  • ROUTING_TABLE：VPC 路由表的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is vpc-路由-table-create

创建一个 VPC 路由表。

ibmcloud is vpc-routing-table-create VPC [--name NAME] [--direct-link-ingress false | true] [--internet-ingress, --internet false | true] [--transit-gateway-ingress false | true] [--vpc-zone-ingress false | true] [--accept-routes-from-resource-type-filters, --ar-rtf vpn_server | vpn_gateway] [--advertise-routes-to direct_link | transit_gateway | direct_link,transit_gateway] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpc-routing-table-create 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --name my-vpc-routing-table --output JSON
  • ibmcloud is vpc-routing-table-create my-vpc --name my-vpc-routing-table --output JSON
  • ibmcloud is vpc-routing-table-create vpc-doloremque-6364-us-east --name test-vpc-cli-routing-tb2 --direct-link-ingress true --internet-ingress false --transit-gateway-ingress false --vpc-zone-ingress false
  • ibmcloud is vpc-routing-table-create 979b4bc6-f018-40a2-92f5-0b1cf777b55d --name test-vpc-cli-routing-tb1 --direct-link-ingress false --internet-ingress false --transit-gateway-ingress false --vpc-zone-ingress true
  • ibmcloud is vpc-routing-table-create my-vpc --name my-vpc-routing-table --accept-routes-from-resource-type-filters vpn_server,vpn_gateway 使用资源类型过滤器创建路由表。
  • ibmcloud is vpc-routing-table-create 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --name my-vpc-routing-table --direct-link-ingress true --transit-gateway-ingress true --advertise-routes-to direct_link,transit_gateway

命令选项

  • VPC：VPC 的 ID 或名称。
  • --name：VPC 路由表的名称。
  • --direct-link-ingress，--direct-link：如果设置为“true”，则该路由表将用于将源自 Direct Link 的流量路由到此 VPC。 为了使路由配置成功，该 VPC 不得已存在一个将此属性设置为“true”的路由表。 其中一个: false，true。
  • --internet-ingress，--internet：指示该路由表是否用于路由源自互联网的流量。 如果 VPC 中没有其他路由表的属性设置为 "true"，那么更新为 "true" 将选择此路由表。 更新为 "false" 将取消选择此路由表。 其中一个: false，true。
  • --transit-gateway-ingress，--transit-gateway：如果设置为“true”，则该路由表将用于将源自 Transit Gateway 的流量路由到此 VPC。 为了使路由配置成功，该 VPC 不得已存在一个将此属性设置为“true”的路由表。 其中一个: false，true。
  • --vpc-zone-ingress，--vpc-zone： 如果设置为“true”，则该路由表将用于路由源自该 VPC 中其他区域子网的流量。 为了使路由配置成功，该 VPC 不得已存在一个将此属性设置为“true”的路由表。 其中一个: false，true。
  • --accept-routes-from-resource-type-filters，--ar-rtf：以逗号分隔的资源类型过滤器，这些过滤器可以在该路由表中创建路由。 vpn_server 和 vpn_gateway 之一。
  • --advertise-routes-to：要向其发布路由的 ingress 源。 表中启用了广告的路由将向这些源发布广告。 一个或多个以逗号分隔的值：direct_link、transit_gateway。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpc-Routing-table-update

更新 VPC 路由表。

ibmcloud is vpc-routing-table-update VPC ROUTING_TABLE [--name NEW_NAME] [--direct-link-ingress false | true] [--internet-ingress, --internet false | true] [--transit-gateway-ingress false | true] [--vpc-zone-ingress false | true] [[--accept-routes-from-resource-type-filters, --ar-rtf vpn_server | vpn_gateway] | --clean-all-accept-routes-from-filters, --cl-arf] [[--advertise-routes-to direct_link | transit_gateway | direct_link,transit_gateway] | --clean-all-advertise-routes-to-sources, --cl-adrt] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpc-routing-table-update 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1d456 --name my-renamed-vpc-routing-table --output JSON
  • ibmcloud is vpc-routing-table-update my-vpc my-vpc-routing-table --name my-renamed-vpc-routing-table --output JSON
  • ibmcloud is vpc-routing-table-update vpc-doloremque-6364-us-east test-vpc-cli-routing-tb2 --direct-link-ingress true --internet-ingress false --transit-gateway-ingress true --vpc-zone-ingress false
  • ibmcloud is vpc-routing-table-update 979b4bc6-f018-40a2-92f5-0b1cf777b55d 27415d55-9d3b-4adb-a993-236ef59a45ec --direct-link-ingress false --internet-ingress false --transit-gateway-ingress false --vpc-zone-ingress false
  • ibmcloud is vpc-routing-table-update 6fd4f882-9640-4da2-a76f-e3732d317610 ce155406-8a64-4f05-946a-634c2977584d --advertise-routes-to direct_link
  • ibmcloud is vpc-routing-table-update 6fd4f882-9640-4da2-a76f-e3732d317610 ce155406-8a64-4f05-946a-634c2977584d --clean-all-advertise-routes-to-sources

命令选项

  • VPC：VPC 的 ID 或名称。
  • ROUTING_TABLE：VPC 路由表的 ID 或名称。
  • --name：路由表的新名称。
  • --direct-link-ingress，--direct-link：如果设置为“true”，则该路由表将用于将源自 Direct Link 的流量路由到此 VPC。 为了使路由配置成功，该 VPC 不得已存在一个将此属性设置为“true”的路由表。 其中一个: false，true。
  • --internet-ingress，--internet：指示该路由表是否用于路由源自互联网的流量。 如果 VPC 中没有其他路由表的属性设置为 "true"，那么更新为 "true" 将选择此路由表。 更新为 "false" 将取消选择此路由表。 其中一个: false，true。
  • --transit-gateway-ingress，--transit-gateway：如果设置为“true”，则该路由表将用于将源自 Transit Gateway 的流量路由到此 VPC。 为了使路由配置成功，该 VPC 不得已存在一个将此属性设置为“true”的路由表。 其中一个: false，true。
  • --vpc-zone-ingress，--vpc-zone： 如果设置为“true”，则该路由表将用于路由源自该 VPC 中其他区域子网的流量。 为了使路由配置成功，该 VPC 不得已存在一个将此属性设置为“true”的路由表。 其中一个: false，true。
  • --accept-routes-from-resource-type-filters，--ar-rtf：以逗号分隔的资源类型过滤器，这些过滤器可以在该路由表中创建路由。 移除现有资源过滤器时，将移除来自匹配资源过滤器的资源的所有了解到的路由。 vpn_server 和 vpn_gateway 之一。
  • --clean-all-accept-routes-from-filters, --cl-arf：从过滤器中移除所有接受路由，并从路由表中删除所有已学习的路由。
  • --advertise-routes-to：要向其发布路由的 ingress 源。 表中启用了广告的路由将向这些源发布广告。 一个或多个以逗号分隔的值：direct_link、transit_gateway。
  • --clean-all-advertise-routes-to-sources, --cl-adrt：删除所有用于进行路由广播的现有入站源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is vpc-路由-table-delete

删除一个或多个 VPC 路由表。

ibmcloud is vpc-routing-table-delete VPC (ROUTING_TABLE1 ROUTING_TABLE2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • VPC：VPC 的 ID 或名称。
  • ROUTING_TABLE1：VPC 路由表的 ID 或名称。
  • ROUTING_TABLE2：VPC 路由表的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpc-路由表路径

列出 VPC 路由表中的所有路由。

ibmcloud is vpc-routing-table-routes VPC ROUTING_TABLE [--output JSON] [-q, --quiet]

命令选项

  • VPC：VPC 的 ID 或名称。
  • ROUTING_TABLE：VPC 路由表的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpc-route-table-route

查看 VPC 路由的详细信息。

ibmcloud is vpc-routing-table-route VPC ROUTING_TABLE ROUTE [--output JSON] [-q, --quiet]

命令选项

  • VPC：VPC 的 ID 或名称。
  • ROUTING_TABLE：VPC 路由表的 ID 或名称。
  • 路由：VPC 路由的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is vpc-route-table-route-create

创建 VPC 路由。

ibmcloud is vpc-routing-table-route-create VPC ROUTING_TABLE --zone ZONE_NAME --destination DESTINATION_CIDR [--action delegate_vpc | delegate | deliver | drop] [--priority PRIORITY] [--next-hop NEXT_HOP [--vpngw VPNGW]] [--advertise false | true] [--name NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpc-routing-table-route-create 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1d456 --name my-vpc-route --action deliver --zone us-south-1 --destination 10.2.2.0/24 --next-hop 10.0.0.2 --output JSON
  • ibmcloud is vpc-routing-table-route-create my-vpc my-routing-table --name my-vpc-route --action deliver --zone us-south-1 --destination 10.2.2.0/24 --next-hop 10.0.0.2 --output JSON
  • ibmcloud is vpc-routing-table-route-create 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1d456 --name my-vpc-route --action delegate --zone us-south-1 --destination 10.2.2.0/24 --output JSON
  • ibmcloud is vpc-routing-table-route-create 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1d456 --name my-vpc-route --action drop --zone us-south-1 --destination 10.2.2.0/24 --output JSON
  • ibmcloud is vpc-routing-table-route-create vpc1001 routing-table-vpc1001-rtable011-id -name my-vpc-route --action deliver --zone us-east-3 --destination 10.2.2.0/24 --priority 1 --next-hop 10.0.0.2
  • ibmcloud is vpc-routing-table-route-create vpc1001 routing-table-vpc1001-1-name --zone us-east-3 --destination 10.2.2.0/24 --action deliver --priority 3 --next-hop vpn-connection-vel-4573-us-east --vpngw aaa-default-vpn-gateway-1 --name vpc-route-cli-demo-1001
  • ibmcloud is vpc-routing-table-route-create 6fd4f882-9640-4da2-a76f-e3732d317610 ce155406-8a64-4f05-946a-634c2977584d --zone us-east-1 --destination 10.2.2.0/24 --next-hop 10.0.0.2 --action deliver --advertise true --name cli-route-7

命令选项

  • VPC：VPC 的 ID 或名称。
  • ROUTING_TABLE：VPC 路由表的 ID 或名称。
  • --zone：区域名称。
  • --action：对匹配该路由的数据包执行的操作。 下列其中一项: Delegate_vpc，委派，交付和 删除。
  • --destination：该路由的目标 CIDR 地址。 在表中的每个区域内，至多有两条路由的目的地相同，且仅当这两条路由的操作均为 “交付” 时才成立。
  • --priority：该路由的优先级。 值越小优先级越高。 值的范围可以在 0-4 之间。(缺省值: 2)。
  • --next-hop：如果操作为“deliver”，则表示数据包将被转发到的下一跳的 IP 地址、VPN 连接 ID 或名称。 对于其他操作值，必须将其省略或指定为 0.0.0.0。
  • --vpngw：VPN网关的ID或名称。 仅当将下一个跃点以名称格式指定为 VPN 连接时，才需要此选项。
  • --advertise：指示该路由是否向由路由表属性 advertise_routes_to 指定的入站源进行路由广播。 其中一个: false，true。
  • --name：VPC 路由表的名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpc-route-table-route-update

更新 VPC 路由。

ibmcloud is vpc-routing-table-route-update VPC ROUTING_TABLE ROUTE [--name NEW_NAME] [--priority PRIORITY] [--advertise false | true] [--next-hop NEXT_HOP [--vpngw VPNGW]] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpc-routing-table-route-update 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1d456 72b27b5c-f4b0-48bb-b954-5becc7c1d4ef --name my-vpc-route --output JSON
  • ibmcloud is vpc-routing-table-route-update vpc1001 routing-table-vpc1001-rtable011-id my-vpc-route --priority 4 --next-hop 10.1.1.1 --name vpc-route-cli-1
  • ibmcloud is vpc-routing-table-route-update vpc1001 routing-table-vpc1001-1-name vpc-route-cli-demo-1001 --priority 3 --next-hop 541c6bbf-6109-44bd-b2c9-176c6e11bc59 --vpngw aaa-default-vpn-gateway-1 --name vpc-route-cli-demo-1003
  • ibmcloud is vpc-routing-table-route-update 6fd4f882-9640-4da2-a76f-e3732d317610 ce155406-8a64-4f05-946a-634c2977584d 2bbca25a-a7c6-4bce-8889-5f914b7a7142 --advertise false

命令选项

  • VPC：VPC 的 ID 或名称。
  • ROUTING_TABLE：VPC 路由表的 ID 或名称。
  • 路由：VPC 路由的 ID 或名称。
  • --name: 路由的新名称。
  • --priority：该路由的优先级。 值越小优先级越高。 值的范围可以在 0-4 之间。(缺省值: 2)。
  • --advertise：指示该路由是否向由路由表属性 advertise_routes_to 指定的入站源进行路由广播。 其中一个: false，true。
  • --next-hop：如果操作为“deliver”，则表示数据包将被转发到的下一跳的 IP 地址、VPN 连接 ID 或名称。 对于其他操作值，必须将其省略或指定为 0.0.0.0。
  • --vpngw：VPN网关的ID或名称。 仅当将下一个跃点以名称格式指定为 VPN 连接时，才需要此选项。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpc-route-table-route-delete

删除一个或多个 VPC 路由。

ibmcloud is vpc-routing-table-route-delete VPC ROUTING_TABLE (ROUTE1 ROUTE2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • VPC：VPC 的 ID 或名称。
  • ROUTING_TABLE：VPC 路由表的 ID 或名称。
  • ROUTE1：VPC 路由的 ID 或名称。
  • ROUTE2：VPC 路由的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 subnet-路由表

查看与该子网关联的路由表详细信息。

ibmcloud is subnet-routing-table SUBNET [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • 子网：子网的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

安全组

ibmcloud 是安全组

查看安全组的详细信息。

ibmcloud is security-group GROUP [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • 组：安全组的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 安全组创建

创建安全组。

ibmcloud is security-group-create GROUP_NAME VPC [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is security-group-create my-sg 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3
  • ibmcloud is security-group-create my-sg my-vpc
  • ibmcloud is security-group-create my-sg 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --resource-group-id fee82deba12e4c0fb69c3b09d1f12345
  • ibmcloud is security-group-create my-sg 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --resource-group-name Default
  • ibmcloud is security-group-create my-sg 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --output JSON

命令选项

  • GROUP_NAME：安全组的名称。
  • VPC：VPC 的 ID 或名称。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 安全组删除

删除一个或多个安全组。

ibmcloud is security-group-delete (GROUP1 GROUP2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • GROUP1：安全组的 ID 或名称。
  • GROUP2：安全组的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是安全组规则

查看安全组规则的详细信息。

ibmcloud is security-group-rule GROUP RULE_ID [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • 组：安全组的 ID 或名称。
  • RULE_ID：安全组规则的ID。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 安全组规则添加

向安全组添加规则。

ibmcloud is security-group-rule-add GROUP DIRECTION PROTOCOL [--vpc VPC] [--local LOCAL_ADDRESS | CIDR_BLOCK] [--remote REMOTE_ADDRESS | CIDR_BLOCK | SECURITY_GROUP] [--icmp-type ICMP_TYPE [--icmp-code ICMP_CODE]] [--port-min PORT_MIN] [--port-max PORT_MAX] [--name NEW_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is security-group-rule-add my-sg inbound icmp_tcp_udp
  • ibmcloud is security-group-rule-add my-sg inbound icmp_tcp_udp --vpc my-vpc
  • ibmcloud is security-group-rule-add my-sg inbound icmp_tcp_udp --remote my-sg
  • ibmcloud is security-group-rule-add 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 inbound icmp_tcp_udp --remote 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3
  • ibmcloud is security-group-rule-add --sg 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --direction inbound --protocol icmp_tcp_udp --local 192.168.3.0
  • ibmcloud is security-group-rule-add 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 inbound tcp --port-min 4 --port-max 22 --output JSON
  • ibmcloud is security-group-rule-add 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 inbound icmp --icmp-type 8 --icmp-code 0
  • ibmcloud is security-group-rule-add --sg 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --direction inbound --protocol icmp_tcp_udp --local 192.168.3.0
  • ibmcloud is security-group-rule-add --sg 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --direction inbound --protocol number_99 --local 192.168.3.0
  • ibmcloud is security-group-rule-add --sg 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --direction inbound --protocol any --local 192.168.3.0

命令选项

  • 组：安全组的 ID 或名称。
  • 行车方向：需执行的行车方向。 其中一个: 入站，出站。
  • 协议：网络协议的名称。 以下之一：any、icmp_tcp_udp、icmp、tcp、udp、ah、gre、ip_in_ip、l2tp, rsvp, sctp, vrrp。 对于其他协议，请使用 number_ ，其中 的取值范围为 0-255（例如：number_99 ）。 众所周知的协议使用标准名称（例如，协议 6 称为 tcp）；其 number_ 这种形式是无效的。 IPv6-specific 协议不受支持：number_0、number_43、number_44、number_58、number_59、number_60、number_135。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --local：该规则允许入站和出站流量使用的本地 IP 地址或本地 IP 地址范围。 CIDR 块 0.0.0.0/0 允许到所有本地 IP 地址的入站和出站流量。
  • --remote：该规则允许流量来自的网络接口集合。 可以将其指定为 REMOTE_ADDRESS、CIDR_BLOCK 或 SECURITY_GROUP。 如果未指定，则允许来自任何源的流量（对于出站规则，则允许发往任何源的流量）。
  • --icmp-type：要允许的 ICMP 流量类型。 有效值范围为 0 到 254。 仅当协议设置为 icmp 时，才指定此选项。 如果未指定，将允许所有类型。
  • --icmp-code：要允许的 ICMP 流量代码。 有效值范围为 0 到 255。 仅当协议设置为 icmp 时，才指定此选项。 如果未指定，将允许所有代码。
  • --port-min：最小端口号。 有效值范围为 1 到 65535。 仅当协议设置为 tcp 或 udp 时，才指定此选项。 如果未指定，则允许所有端口（默认：1 ）。
  • --port-max：最大端口号。 有效值范围为 1 到 65535。 仅当协议设置为 tcp 或 udp 时，才指定此选项。 如果未指定，则允许所有端口（默认：65535 ）。
  • --name：此安全组规则的名称。 该名称不得被安全组中的其他规则占用。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 安全组规则删除

从安全组中删除一个或多个规则。

ibmcloud is security-group-rule-delete GROUP (RULE_ID1 RULE_ID2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is security-group-rule-delete 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 r134-c9bc0d12-de72-400d-885c-dcb9ec895f17
  • ibmcloud is security-group-rule-delete my-sg r134-c9bc0d12-de72-400d-885c-dcb9ec895f17 --vpc my-vpc

命令选项

  • 组：安全组的 ID 或名称。
  • RULE_ID1：安全组规则的ID。
  • RULE_ID2：安全组规则的ID。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 安全组规则更新

更新安全组的规则。

ibmcloud is security-group-rule-update GROUP RULE_ID [--vpc VPC] [--direction inbound | outbound] [--local LOCAL_ADDRESS | CIDR_BLOCK] [--remote REMOTE_ADDRESS | CIDR_BLOCK | SECURITY_GROUP] [--icmp-type ICMP_TYPE | --reset-icmp-type] [--icmp-code ICMP_CODE | --reset-icmp-code] [--port-min PORT_MIN | --reset-port-min] [--port-max PORT_MAX | --reset-port-max] [--name NEW_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is security-group-rule-update 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 8daca77a-4980-4d33-8f3e-7038797be8f9 --direction inbound
  • ibmcloud is security-group-rule-update my-sg 8daca77a-4980-4d33-8f3e-7038797be8f9 --direction inbound --icmp-type 8 --icmp-code 0
  • ibmcloud is security-group-rule-update 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 8daca77a-4980-4d33-8f3e-7038797be8f9 --direction inbound --port-min 4 --port-max 22
  • ibmcloud is security-group-rule-update my-sg 8daca77a-4980-4d33-8f3e-7038797be8f9 --direction inbound --remote 12.2.2.3
  • ibmcloud is security-group-rule-update 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 8daca77a-4980-4d33-8f3e-7038797be8f9 --direction inbound --reset-icmp-code --reset-icmp-type
  • ibmcloud is security-group-rule-update 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 8daca77a-4980-4d33-8f3e-7038797be8f9 --direction inbound --output JSON
  • ibmcloud is security-group-rule-update 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 8daca77a-4980-4d33-8f3e-7038797be8f9 --direction inbound --local 192.168.3.4
  • ibmcloud is security-group-rule-update 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 8daca77a-4980-4d33-8f3e-7038797be8f9 --name my-sg1

命令选项

  • 组：安全组的 ID 或名称。
  • RULE_ID：安全组规则的ID。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --direction：需执行的交通方向。 其中一个: 入站，出站。
  • --local：该规则允许入站和出站流量使用的本地 IP 地址或本地 IP 地址范围。 CIDR 块 0.0.0.0/0 允许到所有本地 IP 地址的入站和出站流量。
  • --remote：该规则允许流量来自的网络接口集合。 可以将其指定为 REMOTE_ADDRESS、CIDR_BLOCK 或 SECURITY_GROUP。 如果未指定，则允许来自任何源的流量（对于出站规则，则允许发往任何源的流量）。
  • --icmp-type：要允许的 ICMP 流量类型。 有效值范围为 0 到 254。 仅当协议设置为 icmp 时，才指定此选项。 如果未指定，将允许所有类型。
  • --reset-icmp-type：重置现有的 ICMP 流量类型值。
  • --icmp-code：要允许的 ICMP 流量代码。 有效值范围为 0 到 255。 仅当协议设置为 icmp 时，才指定此选项。 如果未指定，将允许所有代码。
  • --reset-icmp-code：重置现有的 ICMP 流量代码值。
  • --port-min：最小端口号。 有效值范围为 1 到 65535。 仅当协议设置为 tcp 或 udp 时，才指定此选项。 如果未指定，则允许所有端口（默认：1 ）。
  • --reset-port-min：重置最小端口号。
  • --port-max：最大端口号。 有效值范围为 1 到 65535。 仅当协议设置为 tcp 或 udp 时，才指定此选项。 如果未指定，则允许所有端口（默认：65535 ）。
  • --reset-port-max：重置最大端口号。
  • --name：此安全组规则的名称。 该名称不得被安全组中的其他规则占用。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 安全组规则

列出安全组的所有规则。

ibmcloud is security-group-rules GROUP [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • 组：安全组的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 安全组更新

更新安全组。

ibmcloud is security-group-update GROUP [--vpc VPC] [--name NEW_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is security-group-update 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --name my-sg-renamed --output JSON
  • ibmcloud is security-group-update my-sg --name my-sg-renamed --output JSON
  • ibmcloud is security-group-update my-sg --vpc my-vpc --name my-sg-renamed --output JSON

命令选项

  • 组：安全组的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --name: 安全组的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is security-groups

列出所有安全组。

ibmcloud is security-groups [--vpc VPC] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令选项

  • --vpc：VPC 的 ID 或名称。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 security-group-target

查看安全组目标的详细信息。

ibmcloud is security-group-target GROUP TARGET [--vpc VPC] [(--trt load_balancer | endpoint_gateway | vpn_server | virtual_network_interface) | --in INSTANCE | --bm BARE_METAL_SERVER] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is security-group-target 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 8daca77a-4980-4d33-8f3e-7038797be8f9
  • ibmcloud is security-group-target my-sg my-nic --in my-in
  • ibmcloud is security-group-target my-sg my-nic --bm my-bm
  • ibmcloud is security-group-target my-sg my-lb --trt load_balancer
  • ibmcloud is security-group-target my-sg my-ege --trt endpoint_gateway
  • ibmcloud is sg-t sg-qui-us-east vpn-server-1 --trt vpn_server --vpc vpc_per_region_us-east
  • ibmcloud is security-group-target sg-vni cli-share-vni-1 --trt virtual_network_interface

命令选项

  • 组：安全组的 ID 或名称。
  • 目标：安全组的绑定目标资源的 ID 或名称。 以下类型是受支持的目标资源类型: network_interface，load_balancer，endpoint_gateway，_vpn_server_和 virtual_network_interface。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --trt：要绑定的目标资源类型，仅当使用目标名称而非 ID 时，此选项才为必填项。 load_balancer，endpoint_gateway，vpn_server 和 virtual_network_interface 之一。
  • --in：要绑定的实例的 ID 或名称。 仅当使用网络接口名称而不是标识时才是必需的。
  • --bm：要绑定的裸机服务器的 ID 或名称。 仅当使用网络接口名称而不是标识时才是必需的。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 安全组目标添加

将目标添加到安全组中。

ibmcloud is security-group-target-add GROUP TARGET [--vpc VPC] [(--trt load_balancer | endpoint_gateway | vpn_server | virtual_network_interface) | --in INSTANCE | --bm BARE_METAL_SERVER] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is security-group-target-add 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 8daca77a-4980-4d33-8f3e-7038797be8f9 --output JSON
  • ibmcloud is security-group-target-add my-sg my-lb --trt load_balancer --vpc my-vpc --output JSON
  • ibmcloud is security-group-target-add my-sg eth0 --in my-instnace --vpc my-vpc --output JSON
  • ibmcloud is security-group-target-add my-sg eth0 --in my-instnace
  • ibmcloud is security-group-target-add my-sg eth0 --bm my-bm --vpc my-vpc --output JSON
  • ibmcloud is security-group-target-add my-sg my-egw --trt endpoint_gateway --vpc my-vpc --output JSON
  • ibmcloud is sg-ta demo-sg vpnServer_per_region_us-east --trt vpn_server --vpc default-vpc-2
  • ibmcloud is security-group-target-add sg-vni cli-share-vni-1 --trt virtual_network_interface

命令选项

  • 组：安全组的 ID 或名称。
  • 目标：安全组的绑定目标资源的 ID 或名称。 以下类型是受支持的目标资源类型: network_interface，load_balancer，endpoint_gateway，_vpn_server_和 virtual_network_interface。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --trt：要绑定的目标资源类型，仅当使用目标名称而非 ID 时，此选项才为必填项。 load_balancer，endpoint_gateway，vpn_server 和 virtual_network_interface 之一。
  • --in：要绑定的实例的 ID 或名称。 仅当使用网络接口名称而不是标识时才是必需的。
  • --bm：要绑定的裸机服务器的 ID 或名称。 仅当使用网络接口名称而不是标识时才是必需的。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 安全组目标移除

从安全组中移除目标。

ibmcloud is security-group-target-remove GROUP (TARGET1 TARGET2 ...) [--vpc VPC] [(--trt load_balancer | endpoint_gateway | vpn_server | virtual_network_interface) | --in INSTANCE | --bm BARE_METAL_SERVER] [--output JSON] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is security-group-target-remove 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 8daca77a-4980-4d33-8f3e-7038797be8f9 -f
  • ibmcloud is security-group-target-remove my-sg my-lb --trt load_balancer --vpc my-vpc
  • ibmcloud is security-group-target-remove my-sg eth0 --in my-instnace --vpc my-vpc
  • ibmcloud is security-group-target-remove my-sg eth0 --in my-instnace
  • ibmcloud is security-group-target-remove my-sg eth0 --bm my-bm --vpc my-vpc
  • ibmcloud is security-group-target-remove my-sg my-egw --trt endpoint-gateway
  • ibmcloud is sg-td demo-sg vpnServer_per_region_us-east --trt vpn_server --vpc default-vpc-2
  • ibmcloud is security-group-target-remove sg-vni cli-share-vni-1 --trt virtual_network_interface

命令选项

  • 组：安全组的 ID 或名称。
  • TARGET1：安全组的已绑定目标资源的 ID 或名称。 如果使用此名称格式，那么仅提供同一资源类型下的资源。 而且对于网络接口（按名称），所有网络接口名称都必须在同一实例下。 以下类型是受支持的目标资源类型: network_interface，load_balancer，endpoint_gateway，_vpn_server_和 virtual_network_interface。
  • TARGET2：安全组的绑定目标资源的 ID 或名称。 如果使用此名称格式，那么仅提供同一资源类型下的资源。 而且对于网络接口（按名称），所有网络接口名称都必须在同一实例下。 以下类型是受支持的目标资源类型: network_interface，load_balancer，endpoint_gateway，_vpn_server_和 virtual_network_interface。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --trt：要绑定的目标资源类型，仅当使用目标名称而非 ID 时，此选项才为必填项。 load_balancer，endpoint_gateway，vpn_server 和 virtual_network_interface 之一。
  • --in：要绑定的实例的 ID 或名称。 仅当使用网络接口名称而不是标识时才是必需的。
  • --bm：要绑定的裸机服务器的 ID 或名称。 仅当使用网络接口名称而不是标识时才是必需的。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 security-group-targets

列出安全组的所有目标。

ibmcloud is security-group-targets GROUP [--vpc VPC] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is sg-ts 821ce0fe-e87b-4fa7-9083-7c0d86bef357
  • ibmcloud is sg-ts sg-qui-us-east

命令选项

  • 组：安全组的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

子网

ibmcloud 是子网

查看子网的详细信息。

ibmcloud is subnet SUBNET [--vpc VPC] [--show-attached] [--output JSON] [-q, --quiet]

命令选项

  • 子网：子网的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --show-attached：查看连接到该子网的资源（实例、负载均衡器、VPN 网关）的详细信息。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是子网创建

创建子网。

ibmcloud is subnet-create SUBNET_NAME VPC ((--zone ZONE_NAME --ipv4-address-count ADDR_COUNT) | --ipv4-cidr-block CIDR_BLOCK) [--acl ACL] [--pgw PGW] [--rt RT] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is subnet-create my-subnet 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --ipv4-cidr-block 10.10.10.0/24
  • ibmcloud is subnet-create my-subnet my-vpc --ipv4-cidr-block 10.10.10.0/24
  • ibmcloud is subnet-create my-subnet 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --ipv4-address-count 256 --zone us-south-2
  • ibmcloud is subnet-create my-subnet my-vpc --ipv4-address-count 256 --zone us-south-2
  • ibmcloud is subnet-create my-subnet 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --ipv4-address-count 256 --zone us-south-2 --acl 8daca77a-4980-4d33-8f3e-7038797be8f9
  • ibmcloud is subnet-create my-subnet 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --ipv4-address-count 256 --zone us-south-2 --pgw 8daca77a-4980-4d33-8f3e-7038797be8f9
  • ibmcloud is subnet-create my-subnet my-vpc --ipv4-address-count 256 --zone us-south-2 --acl my-acl --pgw --my-pgw --rt my-vpc-rt
  • ibmcloud is subnet-create my-subnet 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --ipv4-address-count 256 --zone us-south-2 --pgw 8daca77a-4980-4d33-8f3e-7038797be8f9 --output JSON
  • ibmcloud is subnet-create my-subnet 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --ipv4-address-count 256 --zone us-south-2 --rt 8daca77a-4980-4d33-8f3e-7038797be8f9

命令选项

  • SUBNET_NAME：子网名称。
  • VPC：VPC 的 ID 或名称。
  • --ipv4-cidr-block：子网的 IPv4 范围。 此选项与 --ipv4-address-count。
  • -- ipv4-address-count: 所需的 IPv4 地址总数必须是 2 的幂，最小值为 8。 此选项与 --ipv4-cidr-block。
  • --zone：区域名称。
  • --acl：网络访问控制列表（ACL）的 ID 或名称。
  • --pgw：公共网关的 ID 或名称。
  • --rt：路由表的 ID、名称或 CRN。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is subnet-删除

删除一个或多个子网。

ibmcloud is subnet-delete (SUBNET1 SUBNET2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • SUBNET1：子网的 ID 或名称。
  • SUBNET2：子网的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是子网更新

更新子网。

ibmcloud is subnet-update SUBNET [--vpc VPC] [--name NEW_NAME] [--acl ACL] [--pgw PGW] [--rt RT] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is subnet-update ec8bb350-d802-4f1b-b362-b848abd5bb65 --name my-renamed-subnet
  • ibmcloud is subnet-update my-subnet --name my-renamed-subnet
  • ibmcloud is subnet-update ec8bb350-d802-4f1b-b362-b848abd5bb65 --acl 8daca77a-4980-4d33-8f3e-7038797be8f9
  • ibmcloud is subnet-update my-subnet --acl my-acl
  • ibmcloud is subnet-update ec8bb350-d802-4f1b-b362-b848abd5bb65 --pgw 8daca77a-4980-4d33-8f3e-7038797be8f9
  • ibmcloud is subnet-update my-subnet --pgw my-pgw
  • ibmcloud is subnet-update ec8bb350-d802-4f1b-b362-b848abd5bb65 --name my-subnet --output JSON
  • ibmcloud is subnet-update my-subnet --rt my-vpc-rt

命令选项

  • 子网：子网的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --name：子网的新名称。
  • --acl：网络访问控制列表（ACL）的 ID 或名称。
  • --pgw：公共网关的 ID 或名称。
  • --rt：路由表的 ID、名称或 CRN。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is subnets

列出所有子网。

ibmcloud is subnets [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--zone ZONE] [--rt ROUTING_TABLE] [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --zone：将集合过滤为“zone name”属性与指定名称完全匹配的资源。
  • --rt：路由表的ID或名称。
  • --vpc：VPC 的 ID、名称或 CRN。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 subnet-public-gateway

查看与该子网关联的公共网关的详细信息。

ibmcloud is subnet-public-gateway SUBNET [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • 子网：子网的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 subnet-public-gateway-detach

断开公共网关与子网的连接。

ibmcloud is subnet-public-gateway-detach SUBNET [--vpc VPC] [-f, --force] [-q, --quiet]

命令选项

  • 子网：子网的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 subnet-reserved-ips

列出子网中所有已保留的 IP 地址。

ibmcloud is subnet-reserved-ips SUBNET [--vpc VPC] [--target TARGET] [--trt endpoint_gateway | virtual_network_interface] [--output JSON] [-q, --quiet]

命令选项

  • 子网：子网的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --target：目标资源的 ID、名称或 CRN。
  • --trt：支持的目标资源类型。 端点网关、虚拟网络接口之一。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 subnet-reserved-ip

查看预留 IP 的详细信息。

ibmcloud is subnet-reserved-ip SUBNET RESERVED_IP [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • 子网：子网的 ID 或名称。
  • RESERVED_IP：预留 IP 的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是子网保留 IP 创建

在子网中预留一个 IP 地址。

ibmcloud is subnet-reserved-ip-create SUBNET [--vpc VPC] [--name NAME] [--address ADDRESS] [--trt endpoint_gateway | virtual_network_interface] [--auto-delete true | false] [--target TARGET] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is subnet-reserved-ip-create 2201-3f2e33d4-2140-44b4-843c-d73e03d585f1 --name my-reserved-ip --address 10.240.64.10 --auto-delete true
  • ibmcloud is subnet-reserved-ip-create my-subnet --name my-reserved-ip --address 10.240.64.10 --auto-delete true
  • ibmcloud is subnet-reserved-ip-create 2201-3f2e33d4-2140-44b4-843c-d73e03d585f1 --name my-reserved-ip --address 10.240.64.10 --auto-delete true --target r134-5be98168-017a-459c-959f-7a6c1f7b813b
  • ibmcloud is subnet-reserved-ip-create my-subnet --name my-reserved-ip --address 10.240.64.10 --auto-delete true --target my-vpe
  • ibmcloud is subnet-reserved-ip-create 2201-3f2e33d4-2140-44b4-843c-d73e03d585f1 --name my-reserved-ip --address 10.240.64.10 --output JSON
  • ibmcloud is subnet-reserved-ip-create sn-20230803-02 --name vni-rip-1 --target vni2 --trt virtual_network_interface
  • ibmcloud is subnet-reserved-ip-create 7308-5c62937d-b7cb-4ce8-8456-c39de068755e --name vni-rip-2 --trt virtual_network_interface --target 7308-b81c1e13-b3a2-455c-814a-213bc9de4a90 --auto-delete true

命令选项

  • 子网：子网的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --name：此预留 IP 的用户自定义名称。 名称在预留 IP 所在的子网中必须是唯一的。 以 ibm- 开头的名称专用于服务商自有资源。
  • --address：要预留的 IP 地址，该地址在子网中不得已被预留。 如果未指定，则将自动选择子网上的可用地址。
  • --trt：支持的目标资源类型。 endpoint_gateway，virtual_network_interface 之一。(缺省值: endpoint_gateway)。
  • --auto-delete：指定当任一目标被删除，或预留 IP 被解除绑定时，该预留 IP 成员是否自动删除。 如果未绑定预留 IP，那么必须为 false。 下列其中一项: true 和 false。(缺省值: false)。
  • --target：目标资源的 ID 或名称。 支持的目标资源类型包括：endpoint_gateway、virtual_network_interface。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 subnet-reserved-ip-update

更新预留 IP。

ibmcloud is subnet-reserved-ip-update SUBNET RESERVED_IP [--vpc VPC] [--name NEW_NAME] [--auto-delete true | false] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is subnet-reserved-ip-update 2201-3f2e33d4-2140-44b4-843c-d73e03d585f1 2201-7fc11925-47ff-4080-a314-be64c662c302 --name my-reserved-ip2
  • ibmcloud is subnet-reserved-ip-update my-subnet my-reserved-ip --name my-reserved-ip2
  • ibmcloud is subnet-reserved-ip-update 2201-3f2e33d4-2140-44b4-843c-d73e03d585f1 2201-7fc11925-47ff-4080-a314-be64c662c302 --auto-delete false
  • ibmcloud is subnet-reserved-ip-update 2201-3f2e33d4-2140-44b4-843c-d73e03d585f1 2201-7fc11925-47ff-4080-a314-be64c662c302 --name my-reserved-ip2 --output JSON

命令选项

  • 子网：子网的 ID 或名称。
  • RESERVED_IP：预留 IP 的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --name：预留 IP 的新名称。
  • --auto-delete：指定当任一目标被删除，或预留 IP 被解除绑定时，该预留 IP 成员是否自动删除。 如果未绑定预留 IP，那么必须为 false。 以下选项之一：true、false。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 subnet-reserved-ip-delete

释放一个或多个预留 IP。

ibmcloud is subnet-reserved-ip-delete SUBNET (RESERVED_IP1 RESERVED_IP2 ...) [--vpc VPC] [-f, --force] [--output JSON] [-q, --quiet]

命令选项

  • 子网：子网的 ID 或名称。
  • RESERVED_IP1：预留 IP 的 ID 或名称。
  • RESERVED_IP2：预留 IP 的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --force，-f：强制执行操作，无需确认。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

Virtual private clouds

ibmcloud is vpc

查看 VPC 的详细信息。

ibmcloud is vpc VPC [--show-attached] [--output JSON] [-q, --quiet]

命令选项

  • VPC：VPC 的 ID 或名称。
  • --show-attached：查看与该 VPC 关联的资源（子网、VPC 路由和地址前缀）的详细信息。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpc-address-prefix

查看 VPC 地址前缀的详细信息。

ibmcloud is vpc-address-prefix VPC PREFIX [--output JSON] [-q, --quiet]

命令选项

  • VPC：VPC 的 ID 或名称。
  • 前缀：VPC 地址前缀的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpc-address-prefix-create

创建地址前缀。

ibmcloud is vpc-address-prefix-create PREFIX_NAME VPC ZONE_NAME CIDR [--default false | true] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpc-address-prefix-create my-prefix 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 us-south-2 10.0.0.0/24 --default true --output JSON
  • ibmcloud is vpc-address-prefix-create my-prefix my-vpc us-south-2 10.0.0.0/24 --default true --output JSON

命令选项

  • PREFIX_NAME：VPC 地址前缀的名称。
  • VPC：VPC 的 ID 或名称。
  • ZONE_NAME：区域名称。
  • CIDR：地址前缀的 IPv4 范围，以CIDR格式表示。 该地址前缀不得与 VPC 中任何现有的地址前缀重叠，且必须位于 RFC 1918 地址范围内。 地址前缀的 CIDR 前缀长度必须在 /9 （8,388,608 个地址）和 /29 （8 个地址）之间。
  • --default：此标志用于指示该前缀是否为该 VPC 中该区域的默认前缀。 其中一个: false，true。(缺省值: false)。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 正在删除 VPC 地址前缀

删除一个或多个地址前缀。

ibmcloud is vpc-address-prefix-delete VPC (PREFIX1 PREFIX2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • VPC：VPC 的 ID 或名称。
  • PREFIX1：VPC 地址前缀的 ID 或名称。
  • PREFIX2：VPC 地址前缀的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpc-address-prefix-update

更新地址前缀。

ibmcloud is vpc-address-prefix-update VPC PREFIX [--name NEW_NAME] [--default false | true] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpc-address-prefix-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 fee82deba12e4c0fb69c3b09d1f12345 --name my-renamed-prefix --default false --output JSON
  • ibmcloud is vpc-address-prefix-update my-vpc my-prefix --name my-renamed-prefix --default false --output JSON

命令选项

  • VPC：VPC 的 ID 或名称。
  • 前缀：VPC 地址前缀的 ID 或名称。
  • --name：地址前缀的新名称。
  • --default：此标志用于指示该前缀是否为该 VPC 中该区域的默认前缀。 其中一个: false，true。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpc-address-prefixes

列出所有地址前缀。

ibmcloud is vpc-address-prefixes VPC [--output JSON] [-q, --quiet]

命令选项

  • VPC：VPC 的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is vpc-创建

创建 VPC。

ibmcloud is vpc-create VPC_NAME [--classic-access] [--address-prefix-management auto | manual] [[--dns-enable-hub false | true] [--dns-resolver-type manual | system] [--dns-resolver-manual-servers MANUAL_SERVERS | @MANUAL_SERVERS]] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpc-create my-vpc --address-prefix-management auto
  • ibmcloud is vpc-create my-vpc --resource-group-id fee82deba12e4c0fb69c3b09d1f12345
  • ibmcloud is vpc-create my-vpc --resource-group-name Default --output JSON
  • ibmcloud is vpc-create my-vpc --dns-enable-hub true
  • ibmcloud is vpc-create my-vpc --dns-enable-hub true --dns-resolver-type manual --dns-resolver-manual-servers ~/manualServers.json
  • ibmcloud is vpc-create my-vpc --dns-enable-hub true --dns-resolver-type manual --dns-resolver-manual-servers '[{"address": "190.20.3.0"},{"address": "190.20.3.1"},{"address": "190.20.3.2"}]'

命令选项

  • VPC_NAME：VPC 的名称。
  • --classic-access：[已弃用]。建议改用 Transit Gateway 将您的VPC连接到经典基础设施网络。 此标志指示 VPC 是否必须连接至 Classic Infrastructure。 缺省值为 false。
  • --address-prefix-management：此标志用于指定是否为该 VPC 中的每个区域自动创建默认地址前缀。 如果采用手动创建，则该 VPC 在创建时不会包含任何默认地址前缀。 其中一个: auto，manual。(缺省值: auto)。
  • --dns-enable-hub：指示此 VPC 是否已启用为 DNS 名称解析中心。 其中一个: false，true。
  • --dns-resolver-type：要使用的 DNS 解析器的类型。 其中一个: manual，system。
  • --dns-resolver-manual-servers: MANUAL_SERVERS|@MANUAL_SERVERS，以 JSON 或 JSON 文件形式指定的手动服务器。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpc-default-security-group

查看 VPC 的缺省安全组的详细信息。

ibmcloud is vpc-default-security-group VPC [--output JSON] [-q, --quiet]

命令选项

  • VPC：VPC 的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is vpc-删除

删除一个或多个 VPC。

ibmcloud is vpc-delete (VPC1 VPC2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • VPC1：VPC 的 ID 或名称。
  • VPC2：VPC 的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is vpc-更新

更新 VPC。

ibmcloud is vpc-update VPC --name NEW_NAME [[--dns-enable-hub false | true] [--dns-resolver-type manual | system | delegated] [--dns-resolver-manual-servers MANUAL_SERVERS | @MANUAL_SERVERS] [--delegate-to-vpc DELEGATE_TO_VPC]] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpc-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name my-renamed-vpc
  • ibmcloud is vpc-update my-vpc --name my-renamed-vpc
  • ibmcloud is vpc-update my-vpc --dns-enable-hub true
  • ibmcloud is vpc-update my-vpc --dns-enable-hub true --dns-resolver-type manual --dns-resolver-manual-servers @~/manualServers.json
  • ibmcloud is vpc-update my-vpc --dns-enable-hub true --dns-resolver-type manual --dns-resolver-manual-servers '[{"address": "190.20.3.0"},{"address": "190.20.3.1"},{"address": "190.20.3.2"}]'
  • ibmcloud is vpc-update my-vpc --dns-resolver-type delegated --delegate-to-vpc 72251a2e-d6c5-42b4-97b0-b5f727d1f479
  • ibmcloud is vpc-update my-vpc --dns-resolver-type delegated --delegate-to-vpc my-delegated-vpc

命令选项

  • VPC：VPC 的 ID 或名称。
  • --name: VPC 的新名称。
  • --dns-enable-hub：指示此 VPC 是否已启用为 DNS 名称解析中心。 其中一个: false，true。
  • --dns-resolver-type：要使用的 DNS 解析器的类型。 其中一个: manual，system，委派。
  • --dns-resolver-manual-servers: MANUAL_SERVERS|@MANUAL_SERVERS，以 JSON 或 JSON 文件形式指定的手动服务器。
  • --delegate-to-vpc：要为其提供 DNS 服务器地址的 VPC 的 ID、名称或 CRN。 仅当解析器类型为“委托”时，才必须设置此选项。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is vpcs

列出所有 VPC。

ibmcloud is vpcs [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--classic-access true | false] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --classic-access：[已弃用]。建议改用 Transit Gateway 将您的VPC连接到经典基础设施网络。 此标志会列出已启用经典访问的 VPC。 如果未指定，此标志将返回已启用和未启用经典访问的所有 VPC。 以下选项之一：true、false。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 正在创建 VPC DNS 解析绑定

创建 DNS 解析绑定。

ibmcloud is vpc-dns-resolution-binding-create VPC --target-vpc TARGET_VPC [--name NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpc-dns-resolution-binding-create my-vpc --name my-dns-res-binding --target-vpc my-dns-binding-vpc --output JSON
  • ibmcloud is vpc-dns-resolution-binding-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name my-dns-res-binding --target-vpc my-dns-binding-vpc --output JSON

命令选项

  • VPC：VPC 的 ID 或名称。
  • --name：此 DNS 解析绑定的名称。
  • --target-vpc：用于将此 VPC 绑定到另一个 VPC 以进行 DNS 解析的 ID、名称或 CRN。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpc-dns-resolution-binding

查看 VPC DNS 解析绑定的详细信息。

ibmcloud is vpc-dns-resolution-binding VPC DNS_RESOLUTION_BINDING [--output JSON] [-q, --quiet]

命令选项

  • VPC：VPC 的 ID 或名称。
  • DNS_RESOLUTION_BINDING：VPC DNS 解析绑定的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 VPC DNS 解析绑定更新

更新 DNS 解析绑定。

ibmcloud is vpc-dns-resolution-binding-update VPC DNS_RESOLUTION_BINDING [--name NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpc-dns-resolution-binding-update r134-e5b9726b-c975-46bd-b713-c8aea55d51d8 r134-75ccea7b-c705-4b50-934d-2152f9eab4ec --name my-dns-resolution-updated --output JSON
  • ibmcloud is vpc-dns-resolution-binding-update my-vpc my-dns-resolution-binding --name my-dns-resolution-binding-updated --output JSON

命令选项

  • VPC：VPC 的 ID 或名称。
  • DNS_RESOLUTION_BINDING：VPC DNS 解析绑定的 ID 或名称。
  • --name：此 DNS 解析绑定的名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 正在删除 VPC DNS 解析绑定

删除一个或多个 DNS 解析绑定。

ibmcloud is vpc-dns-resolution-binding-delete VPC (DNS_RESOLUTION_BINDING1 DNS_RESOLUTION_BINDING2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • VPC：VPC 的 ID 或名称。
  • DNS_RESOLUTION_BINDING1：VPC DNS 解析绑定的 ID 或名称。
  • DNS_RESOLUTION_BINDING2：VPC DNS 解析绑定的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpc-dns-resolution-bindings

列出所有 DNS 解析绑定。

ibmcloud is vpc-dns-resolution-bindings VPC [--account-id ACCOUNT_ID] [--output JSON] [-q, --quiet]

命令选项

  • VPC：VPC 的 ID 或名称。
  • --account-id：此访问策略所属账户的 ID。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

Virtual private endpoint gateways

以下部分提供了有关可用于处理端点网关的 CLI 命令的详细信息。

ibmcloud 是 endpoint-gateway-targets

列出所有可在所有区域中设置为端点网关目标的资源。

ibmcloud is endpoint-gateway-targets [--output JSON] [-q, --quiet]

命令选项

  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 endpoint-gateway

查看端点网关的详细信息。

ibmcloud is endpoint-gateway ENDPOINT_GATEWAY [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • ENDPOINT_GATEWAY：端点网关的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 endpoint-gateways

列出该区域中的所有端点网关。

ibmcloud is endpoint-gateways [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--vpc VPC] [--dns-resolution-binding-mode DNS_RESOLUTION_BINDING_MODE] [--lifecycle-state LIFECYCLE_STATE] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --vpc：VPC 的 ID、名称或 CRN。
  • --dns-resolution-binding-mode：将集合过滤为那些 dns_resolution_binding_mode 属性值与以下以逗号分隔的指定值之一匹配的端点网关：disabled、per_resource_binding、primary。
  • --lifecycle-state: lifecycle_state 筛选集合中具有 lifecycle_state 属性的资源，该属性值需匹配以下以逗号分隔的指定值之一：deleting、failed、pending、stable、suspended、updating、waiting。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是端点-网关-创建

创建端点网关。

ibmcloud is endpoint-gateway-create --target TARGET [--target-type private_path_service_gateway | provider_cloud_service | provider_infrastructure_service] [--vpc VPC] [--name NAME] [--rip RIP --subnet SUBNET | (--new-reserved-ip NEW_RESERVED_IP1 --new-reserved-ip NEW_RESERVED_IP2 ...)] [--dns-resolution-binding-mode disabled | primary | per_resource_binding] [--sg SG] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is endpoint-gateway-create --vpc 417f1275-b11a-4077-8755-84e795bc3172 --target crn:v1:bluemix:public:kms:us-south:a/86e1130a970148348271c47ed80ac3f3:7372408d-b68a-47f5-b5e5-4b64390aebff:: --name myegw1 在不绑定预留 IP 的情况下，创建端点网关。
  • ibmcloud is endpoint-gateway-create --vpc my-vpc --target crn:v1:bluemix:public:kms:us-south:a/86e1130a970148348271c47ed80ac3f3:7372408d-b68a-47f5-b5e5-4b64390aebff:: --name myegw1 在不绑定预留 IP 的情况下，以 VPC 名称创建端点网关。
  • ibmcloud is endpoint-gateway-create --vpc 4215db60-4515-4a5f-9822-341d8bea5985 --target crn:v1:bluemix:public:kms:us-south:a/86e1130a970148348271c47ed80ac3f3:7372408d-b68a-47f5-b5e5-4b64390aebff:: --name myegw2 --new-reserved-ip '{"subnet": {"id": "a529e1b9-d4cf-48a0-a1bb-e9a1d32cb6e7"}}' 仅使用必需的子网标识数据创建绑定新的保留 IP 配置的端点网关。
  • ibmcloud is endpoint-gateway-create --vpc my-vpc --target crn:v1:bluemix:public:kms:us-south:a/86e1130a970148348271c47ed80ac3f3:7372408d-b68a-47f5-b5e5-4b64390aebff:: --name myegw2 --new-reserved-ip '{"subnet": {"name": "my-subnet"}}' 仅使用必需的子网名称数据创建绑定新的保留 IP 配置的端点网关。
  • ibmcloud is endpoint-gateway-create --vpc 4215db60-4515-4a5f-9822-341d8bea5985 --target crn:v1:bluemix:public:kms:us-south:a/86e1130a970148348271c47ed80ac3f3:7372408d-b68a-47f5-b5e5-4b64390aebff:: --name myegw2 --new-reserved-ip '{"subnet": {"id": "a529e1b9-d4cf-48a0-a1bb-e9a1d32cb6e7"},"name":"my-reserved-ip1","auto_delete":false}' 通过绑定新预留 IP 配置（包含子网标识、预留 IP 名称和预留 IP auto_delete 配置），创建端点网关。
  • ibmcloud is endpoint-gateway-create --vpc my-vpc --target crn:v1:bluemix:public:kms:us-south:a/86e1130a970148348271c47ed80ac3f3:7372408d-b68a-47f5-b5e5-4b64390aebff:: --name myegw2 --new-reserved-ip '{"subnet": {"name": "my-subnet"},"name":"my-reserved-ip1","auto_delete":false}' 通过绑定新预留 IP 配置（包含子网名称、预留 IP 名称和预留 IP auto_delete 配置），创建端点网关。
  • ibmcloud is endpoint-gateway-create --vpc 417f1275-b11a-4077-8755-84e795bc3172 --target ibm-ntp-server --name myegw3 以提供者基础架构服务“ibm-ntp-server”创建端点网关。
  • ibmcloud is endpoint-gateway-create --vpc 417f1275-b11a-4077-8755-84e795bc3172 --target ibm-ntp-server --name my-egw --rip 0757-aabb6555-7de5-4a53-aac1-03dd3a50e377,0767-799bd24a-7d85-4ffa-9920-6e51c4001d02 通过绑定现有预留 IP 标识，创建端点网关。
  • ibmcloud is endpoint-gateway-create --vpc my-vpc --target ibm-ntp-server --name my-egw --rip my-rip --subnet my-subnet 通过绑定现有预留 IP 名称，创建端点网关。
  • ibmcloud is endpoint-gateway-create --target crn:v1:staging:public:cloud-object-storage:global:::endpoint:s3.direct.us-west.cloud-object-storage.test.appdomain.cloud --name cli-egw-1 --vpc cli-vpc-3 --target-type provider_cloud_service --dns-resolution-binding-mode per_resource_binding 创建具有 DNS 解析绑定模式的端点网关
  • ibmcloud is endpoint-gateway-create --target-type private_path_service_gateway --target crn:v1:staging:public:is:us-south:aefe5afc483594adaa8325e2b4d1290df::private-path-service-gateway:r134-f5926633-81d0-429e-bcf8-91151ade00bf --vpc cli-vpc 为专用路径服务网关创建端点网关。
  • ibmcloud is endpoint-gateway-create --vpc 417f1275-b11a-4077-8755-84e795bc3172 --target crn:v1:bluemix:public:kms:us-south:a/86e1130a970148348271c47ed80ac3f3:7372408d-b68a-47f5-b5e5-4b64390aebff:: --name myegw1 --sg r006-dfd5e7a2-0f6d-47d3-b46a-567430f1d70c,r006-e60eba9b-7c88-49ae-b8e1-05bd76d39d66 通过安全组创建端点网关。
  • ibmcloud is endpoint-gateway-create --vpc my-vpc --target crn:v1:bluemix:public:kms:us-south:a/86e1130a970148348271c47ed80ac3f3:7372408d-b68a-47f5-b5e5-4b64390aebff:: --name myegw1 --sg my-sg,my-sg2 通过名称格式的安全组创建端点网关。
  • ibmcloud is endpoint-gateway-create --vpc 4215db60-4515-4a5f-9822-341d8bea5985 --target crn:v1:bluemix:public:kms:us-south:a/86e1130a970148348271c47ed80ac3f3:7372408d-b68a-47f5-b5e5-4b64390aebff:: --name newEG1 --new-reserved-ip '{"subnet": {"id": "ab6599a8-12ac-4546-b983-8040458fd339"}, "address": "34.218.28.200", "name": "myreservedip1", "auto_delete": false}' 通过绑定指定的新预留 IP 配置（包含所有预留 IP 配置选项），创建端点网关。
  • ibmcloud is endpoint-gateway-create --vpc my-vpc --target crn:v1:bluemix:public:kms:us-south:a/86e1130a970148348271c47ed80ac3f3:7372408d-b68a-47f5-b5e5-4b64390aebff:: --name newEG1 --new-reserved-ip '{"subnet": {"name": "my-subnet"}, "address": "34.218.28.200", "name": "myreservedip1", "auto_delete": false}' 使用绑定指定的新预留 IP 配置创建端点网关，该配置具有所有预留 IP 配置选项，并且子网采用名称格式。

命令选项

  • --target-type：此端点网关的目标类型。 其中之一：private_path_service_gateway（私有路径服务网关）、provider_cloud_service（云服务提供商）、provider_infrastructure_service（基础设施服务提供商）。
  • --vpc：VPC 的 ID 或名称。
  • --target：提供商基础设施服务的名称，或提供商云服务实例的 CRN。 您可以使用命令 **ibmcloud is endpoint-gateway-targets** 来列出符合条件、可设置为端点网关目标的云提供商及其基础设施服务。
  • --name：端点网关的新名称。
  • --rip：要绑定到端点网关的保留 IP 的 ID，以逗号分隔。 每个区域最多允许一个预留 IP。 它还可以是预留 IP 名称，但只允许一个预留 IP 名称，并且还必须提供此预留 IP 名称的子网选项。
  • --subnet：子网的 ID 或名称。 仅当提供的保留 IP 为名称格式时，才需要此名称。
  • --new-reserved-ip：RESERVED_IP_JSON|@RESERVED_IP_JSON_FILE，以 JSON 或 JSON 文件格式提供的新预留 IP 配置。
  • --dns-resolution-binding-mode: DNS解析绑定模式，取值为：禁用、主模式、按资源绑定。
  • --sg：端点网关的以逗号分隔的安全组 ID 或名称。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是端点网关更新

更新端点网关。

ibmcloud is endpoint-gateway-update ENDPOINT_GATEWAY [--vpc VPC] [--name NEW_NAME] [--dns-resolution-binding-mode disabled | primary | per_resource_binding] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is egu 4325b873-33db-48aa-a98e-601177fd745f --vpc b224ead6-b835-473c-ad6b-bc91840829c3 --allow-dns-resolution-binding true --name my-cli-egw 更新端点网关并允许使用 VPC 参与 DNS 解析绑定。

命令选项

  • ENDPOINT_GATEWAY：端点网关的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --name：端点网关的新名称。
  • --dns-resolution-binding-mode: DNS解析绑定模式，取值为：禁用、主模式、按资源绑定。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是端点网关保留IP绑定

将一个保留的 IP 地址绑定到端点网关。

ibmcloud is endpoint-gateway-reserved-ip-bind ENDPOINT_GATEWAY (--rip RIP [--subnet SUBNET]) [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • ENDPOINT_GATEWAY：端点网关的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --rip：要绑定的预留 IP 地址的 ID 或名称。
  • --subnet：子网的 ID 或名称。 仅当提供的保留 IP 为名称格式时，才需要此名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 端点网关保留IP解绑

解除端点网关上已预留 IP 的绑定。

ibmcloud is endpoint-gateway-reserved-ip-unbind ENDPOINT_GATEWAY ((--rip RIP [--subnet SUBNET]) | --address ADDRESS) [--vpc VPC] [-f, --force] [-q, --quiet]

命令选项

  • ENDPOINT_GATEWAY：端点网关的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --address：要解除绑定的保留 IP 地址。
  • --rip：要解除绑定的已保留 IP 地址的 ID 或名称。
  • --subnet：子网的 ID 或名称。 仅当提供的保留 IP 为名称格式时，才需要此名称。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 端点网关删除

删除一个或多个端点网关。

ibmcloud is endpoint-gateway-delete (ENDPOINT_GATEWAY1 ENDPOINT_GATEWAY2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • ENDPOINT_GATEWAY1：端点网关的 ID 或名称。
  • ENDPOINT_GATEWAY2：端点网关的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是端点网关资源绑定

查看资源绑定的详细信息。

ibmcloud is endpoint-gateway-resource-binding ENDPOINT_GATEWAY RESOURCE_BINDING [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • ENDPOINT_GATEWAY：端点网关的 ID 或名称。
  • RESOURCE_BINDING：资源绑定的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 端点网关资源绑定创建

为端点网关创建资源绑定。

ibmcloud is endpoint-gateway-resource-binding-create ENDPOINT_GATEWAY --target TARGET [--vpc VPC] [--name NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is endpoint-gateway-resource-binding-create 2201-3f2e33d4-2140-44b4-843c-d73e03d585f1 --name my-resource-binding --target crn:v1:staging:public:is:us-south:a/2d1bace7b46e4815a81e52c6ffeba5cf::vpc:r134-6c04d375-2a37-4bcc-93e6-68d7f9aa9f84
  • ibmcloud is endpoint-gateway-resource-binding-create my-endpoint-gateway --vpc my-vpc --target crn:v1:staging:public:is:us-south:a/2d1bace7b46e4815a81e52c6ffeba5cf::vpc:r134-6c04d375-2a37-4bcc-93e6-68d7f9aa9f84

命令选项

  • ENDPOINT_GATEWAY：端点网关的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --name：此资源绑定的名称。 该名称不得被该端点网关的其他资源绑定占用。 如果未指定，名称将是一个以连字符连接随机选择的单词所组成的列表。
  • --target：要绑定到端点网关的资源的 CRN。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 端点网关资源绑定删除

从端点网关中删除一个或多个资源绑定。

ibmcloud is endpoint-gateway-resource-binding-delete ENDPOINT_GATEWAY (RESOURCE_BINDING1 RESOURCE_BINDING2 ...) [--vpc VPC] [-f, --force] [--output JSON] [-q, --quiet]

命令选项

  • ENDPOINT_GATEWAY：端点网关的 ID 或名称。
  • RESOURCE_BINDING1：资源绑定的 ID 或名称。
  • RESOURCE_BINDING2：资源绑定的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --force，-f：强制执行操作，无需确认。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是端点网关资源绑定更新

更新端点网关资源绑定。

ibmcloud is endpoint-gateway-resource-binding-update ENDPOINT_GATEWAY RESOURCE_BINDING [--vpc VPC] [--name NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is endpoint-gateway-resource-binding-update 2201-3f2e33d4-2140-44b4-843c-d73e03d585f1 my-resource-binding --name my-resource-binding-new
  • ibmcloud is endpoint-gateway-resource-binding-update my-endpoint-gateway 2201-3f2e33d4-2140-44b4-843c-d73e03d585f1 --vpc my-vpc --name my-resource-binding-new

命令选项

  • ENDPOINT_GATEWAY：端点网关的 ID 或名称。
  • RESOURCE_BINDING：资源绑定的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --name：此资源绑定的名称。 该名称不得被该端点网关的其他资源绑定占用。 如果未指定，名称将是一个以连字符连接随机选择的单词所组成的列表。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是端点网关资源绑定

列出端点网关的资源绑定。

ibmcloud is endpoint-gateway-resource-bindings ENDPOINT_GATEWAY [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • ENDPOINT_GATEWAY：端点网关的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

虚拟网络接口

以下部分提供了有关可用于处理虚拟网络接口的 CLI 命令的详细信息。

ibmcloud 是 virtual-network-interface

查看虚拟网络接口的详细信息。

ibmcloud is virtual-network-interface VIRTUAL_NETWORK_INTERFACE [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is virtual-network-interface r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2
  • ibmcloud is virtual-network-interface new-share-vni

命令选项

  • VIRTUAL_NETWORK_INTERFACE：虚拟网络接口的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 virtual-network-interfaces

列出所有虚拟网络接口。

ibmcloud is virtual-network-interfaces [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is virtual-network-interfaces

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 virtual-network-interface-update

更新虚拟网络接口。

ibmcloud is virtual-network-interface-update VIRTUAL_NETWORK_INTERFACE --name NEW_NAME [--allow-ip-spoofing false | true] [--auto-delete false | true] [--enable-infrastructure-nat false | true] [--protocol-state-filtering-mode, --psfm auto | enabled | disabled] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is virtual-network-interface-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name new-vni
  • ibmcloud is virtual-network-interface-update new-vni --name new-share
  • ibmcloud is virtual-network-interface-update 7208-8918786e-5958-42fc-9e4b-410c5a58b164 --name cli-vni-1 --allow-ip-spoofing false --auto-delete false --enable-infrastructure-nat false
  • ibmcloud is virtual-network-interface-update cli-vni-1 --name cli-vni-2 --allow-ip-spoofing false --auto-delete true --enable-infrastructure-nat false
  • ibmcloud is virtual-network-interface-update cli-vni-1 --name cli-vni-2 --allow-ip-spoofing false --protocol-state-filtering-mode enabled --auto-delete true --enable-infrastructure-nat false

命令选项

  • VIRTUAL_NETWORK_INTERFACE：虚拟网络接口的 ID 或名称。
  • --name: 虚拟网络接口的新名称。
  • --allow-ip-spoofing：指示是否允许在此接口上进行源 IP 欺骗。 如果为 false，那么在此接口上阻止源 IP 电子欺骗。 如果为 true，那么在此接口上允许源 IP 电子欺骗。 其中一个: false，true。
  • --auto-delete：指示当目标被删除时，此虚拟网络接口是否会自动删除。 如果虚拟网络接口未绑定，那么必须为 false。 其中一个: false，true。
  • --enable-infrastructure-nat：如果为 true：VPC 基础设施将执行任何必要的 NAT 操作。 如果为 false：将包保持不变地传递到网络接口以及从网络接口传递包，这将允许工作负载执行任何所需的 NAT 操作。 其中一个: false，true。
  • --protocol-state-filtering-mode: auto,--psfm auto 此虚拟网络接口应采用的协议状态过滤模式。 如果设置为“自动”，则协议状态数据包过滤功能是否启用或禁用，取决于虚拟网络接口的 target 资源类型。 其中一个: auto，enabled，disabled。(缺省值: auto)。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 virtual-network-interface-create

创建虚拟网络接口。

ibmcloud is virtual-network-interface-create [--name NAME] [--allow-ip-spoofing false | true] [--auto-delete false | true] [--enable-infrastructure-nat false | true] [[--rip RIP | [--rip-address RIP_ADDRESS --rip-auto-delete RIP_AUTO_DELETE --rip-name RIP_NAME]]] [--protocol-state-filtering-mode, --psfm auto | enabled | disabled] [--subnet SUBNET] [--ips RESERVED_IPS_JSON | @RESERVED_IPS_JSON_FILE] [--sgs SGS] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--vpc VPC] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is virtual-network-interface-create --name cli-vni-1 --allow-ip-spoofing true --auto-delete true --enable-infrastructure-nat true --rip 7208-d4c0abbe-3fc2-4696-9fe1-4eb3dc9af976 --ips '[{"id":"7208-d83b7e58-3c3d-47d0-89c5-02d9a20c72fd"},{"address":"10.240.64.13", "auto_delete": false, "name": "srip2"}]' --sgs r134-aa7c7658-e503-4456-b342-8d6a89e05115,r134-4fb388f1-2b6e-4013-b279-7a8748f4d6ca --resource-group-id 11caaa983d9c4beb82690daab08717e9
  • ibmcloud is virtual-network-interface-create --name cli-vni-2 --allow-ip-spoofing true --auto-delete true --enable-infrastructure-nat true --rip cli-rip-1 --subnet my-subnet --vpc vpc-cli-1 --ips '[{"id":"7208-d83b7e58-3c3d-47d0-89c5-02d9a20c72fd"},{"address":"10.240.64.14", "auto_delete": false, "name": "srip3"}]' --sgs cli-sg,sanctity-contest-only-filing --resource-group-name Default
  • ibmcloud is virtual-network-interface-create --name cli-vni-4 --allow-ip-spoofing false --auto-delete false --enable-infrastructure-nat false --subnet 7208-bfe017e7-6e71-415a-8615-0ee787fbeef9 --rip-address 10.240.64.15 --rip-auto-delete false --rip-name primar-ip-1 --ips '[{"id":"7208-2772a45f-c062-4e22-bafb-32ea792da56b"},{"address":"10.240.64.17", "auto_delete": false, "name": "sec-ip-2"}]' --sgs r134-aa7c7658-e503-4456-b342-8d6a89e05115,r134-4fb388f1-2b6e-4013-b279-7a8748f4d6ca --resource-group-id 11caaa983d9c4beb82690daab08717e9
  • ibmcloud is virtual-network-interface-create --name cli-vni-3 --allow-ip-spoofing true --auto-delete false --enable-infrastructure-nat true --subnet my-subnet --vpc vpc-cli-1 --rip-address 10.240.64.18 --rip-auto-delete true --rip-name primar-ip-2 --ips '[{"id":"7208-d42716a5-6df2-416c-979d-f26330b9d0b1"},{"address":"10.240.64.19", "auto_delete": true, "name": "sec-ip-3"}]' --sgs cli-sg,sanctity-contest-only-filing --resource-group-name Default
  • ibmcloud is virtual-network-interface-create --name cli-vni-3 --allow-ip-spoofing true --auto-delete false --protocol-state-filtering-mode disabled --enable-infrastructure-nat true --subnet my-subnet --vpc vpc-cli-1 --rip-address 10.240.64.18 --rip-auto-delete true --rip-name primar-ip-2 --ips '[{"id":"7208-d42716a5-6df2-416c-979d-f26330b9d0b1"},{"address":"10.240.64.19", "auto_delete": true, "name": "sec-ip-3"}]' --sgs cli-sg,sanctity-contest-only-filing --resource-group-name Default

命令选项

  • --name：此虚拟网络接口的名称。
  • --allow-ip-spoofing：指示是否允许在此接口上进行源 IP 欺骗。 如果为 false，那么在此接口上阻止源 IP 电子欺骗。 如果为 true，那么在此接口上允许源 IP 电子欺骗。 其中一个: false，true。
  • --auto-delete：指示当目标被删除时，此虚拟网络接口是否会自动删除。 如果虚拟网络接口未绑定，那么必须为 false。 其中一个: false，true。
  • --enable-infrastructure-nat：如果为 true：VPC 基础设施将执行任何必要的 NAT 操作。 如果为 false：将包保持不变地传递到网络接口以及从网络接口传递包，这将允许工作负载执行任何所需的 NAT 操作。 其中一个: false，true。
  • --rip：要绑定到虚拟网络接口的保留 IP 的 ID 或名称。
  • --rip-address：要绑定到虚拟网络接口的预留 IP 地址。
  • --rip-auto-delete：指定当任一目标被删除，或者该保留 IP 地址被解除绑定时，该保留 IP 地址是否自动删除。
  • --rip-name：此预留 IP 地址用于绑定到虚拟网络接口的名称。
  • --protocol-state-filtering-mode: auto,--psfm auto 此虚拟网络接口应采用的协议状态过滤模式。 如果设置为“自动”，则协议状态数据包过滤功能是否启用或禁用，取决于虚拟网络接口的 target 资源类型。 其中一个: auto，enabled，disabled。(缺省值: auto)。
  • --subnet：关联的子网。
  • --ips：IPS RESERVED_IPS_JSON | @RESERVED_IPS_JSON_FILE，以 JSON 或 JSON 文件格式提供的备用 IP 地址，用于绑定到虚拟网络接口。 关于数据模式，请查阅 API 文档 中的 IPS 属性。 RESERVED_IPS_JSON，@RESERVED_IPS_JSON_FILE 之一。
  • --sgs：用于虚拟网络接口的安全组的 ID 或名称，以逗号分隔。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --vpc：此 VNI 关联的 VPC 的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 virtual-network-interface-delete

删除一个或多个虚拟网络接口。

ibmcloud is virtual-network-interface-delete (VIRTUAL_NETWORK_INTERFACE1 VIRTUAL_NETWORK_INTERFACE2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is virtual-network-interface-delete my-vni-share-99 cli-vni-demo-00
  • ibmcloud is virtual-network-interface-delete r006-866fc826-6f30-444f-b55e-0d697cf8b4bb

命令选项

  • VIRTUAL_NETWORK_INTERFACE1：虚拟网络接口的 ID 或名称。
  • VIRTUAL_NETWORK_INTERFACE2：虚拟网络接口的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 virtual-network-interface-浮动-ip

查看与虚拟网络接口关联的浮动 IP 的详细信息。

ibmcloud is virtual-network-interface-floating-ip VIRTUAL_NETWORK_INTERFACE FLOATING_IP [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is virtual-network-interface-floating-ip cli-vni-2 cli-ip-2
  • ibmcloud is virtual-network-interface-floating-ip 7208-a666bd40-c065-4feb-8815-1cbb81313e08 r134-90b991ee-7da1-404a-91d6-64aa91e43292

命令选项

  • VIRTUAL_NETWORK_INTERFACE：虚拟网络接口的 ID 或名称。
  • FLOATING_IP：浮动 IP 的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 virtual-network-interface-浮动-ips

列出所有与虚拟网络接口关联的浮动 IP 地址。

ibmcloud is virtual-network-interface-floating-ips VIRTUAL_NETWORK_INTERFACE [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is virtual-network-interface-floating-ips 7208-8918786e-5958-42fc-9e4b-410c5a58b164
  • ibmcloud is virtual-network-interface-floating-ips cli-vni-2

命令选项

  • VIRTUAL_NETWORK_INTERFACE：虚拟网络接口的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 virtual-network-interface-浮动-ip-add

将浮动 IP 与虚拟网络接口关联。

ibmcloud is virtual-network-interface-floating-ip-add VIRTUAL_NETWORK_INTERFACE FLOATING_IP [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is virtual-network-interface-floating-ip-add cli-vni-1 cli-ip
  • ibmcloud is virtual-network-interface-floating-ip-add 7208-a666bd40-c065-4feb-8815-1cbb81313e08 r134-90b991ee-7da1-404a-91d6-64aa91e43292

命令选项

  • VIRTUAL_NETWORK_INTERFACE：虚拟网络接口的 ID 或名称。
  • FLOATING_IP：浮动 IP 的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 virtual-network-interface-浮动-ip-remove

将浮动 IP 地址从虚拟网络接口中解除绑定。

ibmcloud is virtual-network-interface-floating-ip-remove VIRTUAL_NETWORK_INTERFACE FLOATING_IP [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is virtual-network-interface-floating-ip-remove cli-vni-2 cli-ip-2
  • ibmcloud is virtual-network-interface-floating-ip-remove 7208-a8c7311c-938e-452d-a89e-3e6f282583e0 r134-90b991ee-7da1-404a-91d6-64aa91e43292

命令选项

  • VIRTUAL_NETWORK_INTERFACE：虚拟网络接口的 ID 或名称。
  • FLOATING_IP：浮动 IP 的 ID 或名称。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 virtual-network-interface-reserved-ip

查看与虚拟网络接口关联的已保留 IP 的详细信息。

ibmcloud is virtual-network-interface-reserved-ip VIRTUAL_NETWORK_INTERFACE RESERVED_IP [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is virtual-network-interface-reserved-ip cli-vni-2 cli-rip-2
  • ibmcloud is virtual-network-interface-reserved-ip 7208-a666bd40-c065-4feb-8815-1cbb81313e08 r134-90b991ee-7da1-404a-91d6-64aa91e43292

命令选项

  • VIRTUAL_NETWORK_INTERFACE：虚拟网络接口的 ID 或名称。
  • RESERVED_IP：预留 IP 的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 virtual-network-interface-reserved-ips

列出与虚拟网络接口关联的所有已保留 IP 地址。

ibmcloud is virtual-network-interface-reserved-ips VIRTUAL_NETWORK_INTERFACE [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is virtual-network-interface-reserved-ips 7208-8918786e-5958-42fc-9e4b-410c5a58b164
  • ibmcloud is virtual-network-interface-reserved-ips cli-vni-2

命令选项

  • VIRTUAL_NETWORK_INTERFACE：虚拟网络接口的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 virtual-network-interface-reserved-ip-bind

将保留的 IP 绑定到虚拟网络接口。

ibmcloud is virtual-network-interface-reserved-ip-bind VIRTUAL_NETWORK_INTERFACE RESERVED_IP [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is virtual-network-interface-reserved-ip-bind cli-vni-1 cli-rip
  • ibmcloud is virtual-network-interface-reserved-ip-bind 7208-a666bd40-c065-4feb-8815-1cbb81313e08 r134-90b991ee-7da1-404a-91d6-64aa91e43292

命令选项

  • VIRTUAL_NETWORK_INTERFACE：虚拟网络接口的 ID 或名称。
  • RESERVED_IP：预留 IP 的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 virtual-network-interface-reserved-ip-unbind

从虚拟网络接口上解除已保留的 IP 地址的绑定。

ibmcloud is virtual-network-interface-reserved-ip-unbind VIRTUAL_NETWORK_INTERFACE RESERVED_IP [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is virtual-network-interface-reserved-ip-unbind cli-vni-2 cli-rip-2
  • ibmcloud is virtual-network-interface-reserved-ip-unbind 7208-a8c7311c-938e-452d-a89e-3e6f282583e0 r134-90b991ee-7da1-404a-91d6-64aa91e43292

命令选项

  • VIRTUAL_NETWORK_INTERFACE：虚拟网络接口的 ID 或名称。
  • RESERVED_IP：预留 IP 的 ID 或名称。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

专用路径服务网关

下一节将详细介绍可用于处理专用路径服务网关的 CLI 命令。

ibmcloud 是私有路径服务网关

列出所有专用路径服务网关。

ibmcloud is private-path-service-gateways [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is private-path-service-gateways 列出所有专用路径服务网关。

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是私有路径服务网关

查看专用路径服务网关的详细信息。

ibmcloud is private-path-service-gateway PRIVATE_PATH_SERVICE_GATEWAY [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is ppsg r134-2e671f14-19fc-4089-9ad3-973176711259 使用其标识查看专用路径服务网关的详细信息。
  • ibmcloud is private-path-service-gateway cli-ppsg-0 通过名称查看“私有路径”服务网关的详细信息。

命令选项

  • PRIVATE_PATH_SERVICE_GATEWAY：私有路径服务网关的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 创建私有路径服务网关

创建一个“私有路径”服务网关。

ibmcloud is private-path-service-gateway-create --load-balancer LOAD_BALANCER --service-endpoints SERVICE_ENDPOINTS [--default-access-policy deny | permit | review] [--name NAME] [--zonal-affinity false | true] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is private-path-service-gateway-create --load-balancer my-cli-nlb --service-endpoints cli.domain.com --default-access-policy permit --name cli-ppsg-1 --zonal-affinity true 通过指定负载均衡器名称，并将缺省访问策略配置为“允许”，创建一个专用路径服务网关。
  • ibmcloud is private-path-service-gateway-create --load-balancer r134-d-439744e1-81d7-43fb-95d5-2356774240bb --service-endpoints clidemo.domain.com --default-access-policy deny --name cli-ppsg-2 --zonal-affinity true 通过指定负载均衡器标识，并将缺省访问策略配置为“拒绝”，创建一个专用路径服务网关。

命令选项

  • --default-access-policy：对于未明确指定账户策略的账户，其绑定应采用的策略。 其中之一：拒绝、允许、审查。(默认：拒绝）。
  • --load-balancer：此私有路径网关所对应的负载均衡器的 ID 或名称。
  • --name：此“私有路径”服务网关的名称。
  • --service-endpoints：此“私有路径”服务网关的完全限定域名。 任何大写字母都将转换为小写形式。
  • --zonal-affinity：指示此私有路径服务网关是否具有区域亲和性。 其中一个: false，true。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 private-path-service-gateway-update

更新专用路径服务网关。

ibmcloud is private-path-service-gateway-update PRIVATE_PATH_SERVICE_GATEWAY [--default-access-policy deny | permit | review] [--load-balancer LOAD_BALANCER] [--zonal-affinity false | true] [--name NEW_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is private-path-service-gateway-update r134-2e671f14-19fc-4089-9ad3-973176711259 --name cli-ppsg-2 --default-access-policy deny --load-balancer r134-d-740be75d-be41-48bd-b6e4-89946ddcac4a --zonal-affinity false --published true 使用标识更新专用路径服务网关，修改其名称、访问策略、负载均衡器、区域亲缘关系，并予以发布。
  • ibmcloud is private-path-service-gateway-update cli-ppsg-2 --name cli-ppsg-0 --default-access-policy review --load-balancer my-cli-nlb-1 --zonal-affinity false --published true 使用名称更新专用路径服务网关，修改其名称、访问策略、负载均衡器、区域亲缘关系，并予以发布。
  • ibmcloud is private-path-service-gateway-update r134-2e671f14-19fc-4089-9ad3-973176711259 --name cli-ppsg-2 --default-access-policy deny --load-balancer r134-d-740be75d-be41-48bd-b6e4-89946ddcac4a --zonal-affinity false 使用标识更新专用路径服务网关，修改其名称、访问策略、负载均衡器及区域亲缘关系。
  • ibmcloud is private-path-service-gateway-update cli-ppsg-2 --name cli-ppsg-0 --default-access-policy review --load-balancer my-cli-nlb-1 --zonal-affinity false 使用名称更新专用路径服务网关，修改其名称、访问策略、负载均衡器及区域亲缘关系。

命令选项

  • PRIVATE_PATH_SERVICE_GATEWAY：私有路径服务网关的 ID 或名称。
  • --default-access-policy：对于未明确指定账户策略的账户，其绑定应采用的策略。 其中之一：拒绝、允许、审查。(默认：拒绝）。
  • --load-balancer：此私有路径网关所对应的负载均衡器的 ID 或名称。
  • --zonal-affinity：指示此私有路径服务网关是否具有区域亲和性。 其中一个: false，true。
  • --name：Private Path 服务网关的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 private-path-service-gateway-delete

删除一个或多个专用路径服务网关。

ibmcloud is private-path-service-gateway-delete (PRIVATE_PATH_SERVICE_GATEWAY1 PRIVATE_PATH_SERVICE_GATEWAY2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is ppsgd r134-01cd30f7-e6f2-432f-9520-76247b1fbbe1 r134-72940467-a4db-487f-b57e-b7141ac40e32 使用其标识删除多个专用路径服务网关。
  • ibmcloud is private-path-service-gateway-delete cli-ppsg-0 cli-ppsg-1 使用其名称删除多个专用路径服务网关。

命令选项

  • PRIVATE_PATH_SERVICE_GATEWAY1：私有路径服务网关的 ID 或名称。
  • PRIVATE_PATH_SERVICE_GATEWAY2：私有路径服务网关的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud是私有路径服务网关发布

发布专用路径服务网关。

ibmcloud is private-path-service-gateway-publish PRIVATE_PATH_SERVICE_GATEWAY [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is ppsgp r134-01cd30f7-e6f2-432f-9520-76247b1fbbe1 使用其标识发布一个专用路径服务网关，以便任何帐户均可请求访问。
  • ibmcloud is private-path-service-gateway-publish cli-ppsg-0 使用其名称发布一个专用路径服务网关，以便任何帐户均可请求访问。

命令选项

  • PRIVATE_PATH_SERVICE_GATEWAY：私有路径服务网关的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 private-path-service-gateway-unpublish

取消发布专用路径服务网关。

ibmcloud is private-path-service-gateway-unpublish PRIVATE_PATH_SERVICE_GATEWAY [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is ppsgunp r134-01cd30f7-e6f2-432f-9520-76247b1fbbe1 使用其标识取消发布专用路径服务网关，以限制访问请求。
  • ibmcloud is private-path-service-gateway-unpublish cli-ppsg-0 使用其名称取消发布专用路径服务网关，以限制访问请求。

命令选项

  • PRIVATE_PATH_SERVICE_GATEWAY：私有路径服务网关的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是私有路径服务网关账户策略

列出专用路径服务网关的所有帐户策略。

ibmcloud is private-path-service-gateway-account-policies (PRIVATE_PATH_SERVICE_GATEWAY1 PRIVATE_PATH_SERVICE_GATEWAY2 ...) [--account-id ACCOUNT_ID] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is ppsg-aps cli-ppsg-0 使用其名称列出专用路径服务网关的所有帐户策略。
  • ibmcloud is ppsg-aps r134-f5926633-81d0-429e-bcf8-91151ade00bf 使用其标识列出专用路径服务网关的所有帐户策略。

命令选项

  • PRIVATE_PATH_SERVICE_GATEWAY1：私有路径服务网关的 ID 或名称。
  • PRIVATE_PATH_SERVICE_GATEWAY2：私有路径服务网关的 ID 或名称。
  • --account-id：此访问策略所属账户的 ID。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是私有路径服务网关账户策略

查看专用路径服务网关的帐户策略的详细信息。

ibmcloud is private-path-service-gateway-account-policy PRIVATE_PATH_SERVICE_GATEWAY ACCOUNT_POLICY [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is ppsg-ap cli-ppsg-0 2d1bace7b46e4815a81e52c6ffeba5cf 使用其网关名称和策略标识，查看专用路径服务网关的帐户策略详细信息。
  • ibmcloud is private-path-service-gateway-account-policy r134-f5926633-81d0-429e-bcf8-91151ade00bf e13b4574db1743b1b7897bebca551db1 使用其网关标识和策略标识，查看专用路径服务网关的帐户策略详细信息。

命令选项

  • PRIVATE_PATH_SERVICE_GATEWAY：私有路径服务网关的 ID 或名称。
  • ACCOUNT_POLICY：Private Path 服务网关的账户策略 ID。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 创建私有路径服务网关账户策略

为专用路径服务网关创建帐户策略。

ibmcloud is private-path-service-gateway-account-policy-create PRIVATE_PATH_SERVICE_GATEWAY --account-id ACCOUNT_ID [--access-policy deny | permit | review] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is private-path-service-gateway-account-policy-create r134-f5926633-81d0-429e-bcf8-91151ade00bf --account-id e13b4574db1743b1b7897bebca551db1 --access-policy deny 使用配有拒绝访问策略的网关标识为专用路径服务网关创建帐户策略。
  • ibmcloud is private-path-service-gateway-account-policy-create cli-ppsg-0 --account-id 2d1bace7b46e4815a81e52c6ffeba5cf --access-policy review 使用配有审核访问策略的网关名称，为专用路径服务网关创建帐户策略。

命令选项

  • PRIVATE_PATH_SERVICE_GATEWAY：私有路径服务网关的 ID 或名称。
  • --access-policy：该账户的访问策略。 其中之一：拒绝、允许、审查。
  • --account-id：此访问策略所属账户的 ID。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 专属路径服务网关账户策略更新

更新专用路径服务网关的帐户策略。

ibmcloud is private-path-service-gateway-account-policy-update PRIVATE_PATH_SERVICE_GATEWAY ACCOUNT_POLICY [--access-policy deny | permit | review] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is ppsg-apu r134-f5926633-81d0-429e-bcf8-91151ade00bf 2d1bace7b46e4815a81e52c6ffeba5cf --access-policy permit 使用其网关标识和策略标识更新专用路径服务网关的帐户策略，将访问策略更改为允许。
  • ibmcloud is ppsg-apu cli-ppsg-0 e13b4574db1743b1b7897bebca551db1 --access-policy review 使用其网关标识和策略标识更新专用路径服务网关的帐户策略，将访问策略更改为审查。

命令选项

  • PRIVATE_PATH_SERVICE_GATEWAY：私有路径服务网关的 ID 或名称。
  • ACCOUNT_POLICY：Private Path 服务网关的账户策略 ID。
  • --access-policy：该账户的访问策略。 其中之一：拒绝、允许、审查。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 私人路径服务网关账户策略删除

删除专用路径服务网关的一个或多个帐户策略。

ibmcloud is private-path-service-gateway-account-policy-delete PRIVATE_PATH_SERVICE_GATEWAY (ACCOUNT_POLICY1 ACCOUNT_POLICY2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is ppsg-apd r134-2e671f14-19fc-4089-9ad3-973176711259 efe5afc483594adaa8325e2b4d1290df 使用网关标识和策略标识删除专用路径服务网关的帐户策略。
  • ibmcloud is private-path-service-gateway-account-policy-delete cli-ppsg-0 2d1bace7b46e4815a81e52c6ffeba5cf e13b4574db1743b1b7897bebca551db1 使用其网关名称和策略标识删除专用路径服务网关的多个帐户策略。

命令选项

  • PRIVATE_PATH_SERVICE_GATEWAY：私有路径服务网关的 ID 或名称。
  • ACCOUNT_POLICY1：Private Path 服务网关的账户策略 ID。
  • ACCOUNT_POLICY2：Private Path 服务网关的账户策略 ID。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是私有路径服务网关端点网关绑定

列出专用路径服务网关的所有端点网关绑定。

ibmcloud is private-path-service-gateway-endpoint-gateway-bindings (PRIVATE_PATH_SERVICE_GATEWAY1 PRIVATE_PATH_SERVICE_GATEWAY2 ...) [--account-id ACCOUNT_ID] [--status STATUS] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is ppsg-egbs r134-2e671f14-19fc-4089-9ad3-973176711259 使用其标识列出专用路径服务网关的所有端点网关绑定。
  • ibmcloud is ppsg-egbs cli-ppsg-0 使用其名称列出专用路径服务网关的所有端点网关绑定。

命令选项

  • PRIVATE_PATH_SERVICE_GATEWAY1：私有路径服务网关的 ID 或名称。
  • PRIVATE_PATH_SERVICE_GATEWAY2：私有路径服务网关的 ID 或名称。
  • --account-id：此访问策略所属账户的 ID。
  • --status：端点网关绑定的状态。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是私有路径服务网关端点网关绑定

查看专用路径服务网关的端点网关绑定的详细信息。

ibmcloud is private-path-service-gateway-endpoint-gateway-binding PRIVATE_PATH_SERVICE_GATEWAY ENDPOINT_GATEWAY_BINDING [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is private-path-service-gateway-endpoint-gateway-binding r134-2e671f14-19fc-4089-9ad3-973176711259 r134-17635273-0702-4a31-b406-a0014c291fbb 使用其网关标识和绑定标识，查看专用路径服务网关的端点网关绑定详细信息。
  • ibmcloud is private-path-service-gateway-endpoint-gateway-binding cli-ppsg-0 r134-3aabeae6-830c-40d6-b67e-4b08382989e9 使用其网关名称和绑定标识，查看专用路径服务网关的端点网关绑定详细信息。

命令选项

  • PRIVATE_PATH_SERVICE_GATEWAY：私有路径服务网关的 ID 或名称。
  • ENDPOINT_GATEWAY_BINDING：私有路径服务网关的端点网关绑定 ID。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 私人路径服务网关端点网关绑定拒绝

拒绝专用路径服务网关的端点网关绑定。

ibmcloud is private-path-service-gateway-endpoint-gateway-binding-deny PRIVATE_PATH_SERVICE_GATEWAY ENDPOINT_GATEWAY_BINDING (--set-account-policy true | false) [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is private-path-service-gateway-endpoint-gateway-binding-deny r134-2e671f14-19fc-4089-9ad3-973176711259 r134-17635273-0702-4a31-b406-a0014c291fbb --set-account-policy true 使用其网关标识和绑定标识拒绝专用路径服务网关的端点网关绑定，并将此标识设置为帐户策略。
  • ibmcloud is ppsg-egb-deny cli-ppsg r134-f7e2b651-0d02-46e1-8811-16ea2157b547 --set-account-policy true 使用其网关名称和绑定标识拒绝专用路径服务网关的端点网关绑定，并将此名称设置为帐户策略。

命令选项

  • PRIVATE_PATH_SERVICE_GATEWAY：私有路径服务网关的 ID 或名称。
  • ENDPOINT_GATEWAY_BINDING：私有路径服务网关的端点网关绑定 ID。
  • --set-account-policy：指示该策略是否将成为同一账户下所有待处理和未来端点网关绑定的访问策略。 以下选项之一：true、false。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是私有路径服务网关端点网关绑定许可

允许为专用路径服务网关绑定端点网关。

ibmcloud is private-path-service-gateway-endpoint-gateway-binding-permit PRIVATE_PATH_SERVICE_GATEWAY ENDPOINT_GATEWAY_BINDING (--set-account-policy true | false) [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is ppsg-egb-permit r134-e64dab2d-8fd2-43bd-8390-229ba66e53c4 r134-0dcc2105-14a1-4501-9b43-29632e910e4b --set-account-policy true 使用其网关标识和绑定标识允许专用路径服务网关的端点网关绑定，并将此标识设置为帐户策略。
  • ibmcloud is ppsg-egb-permit cli-ppsg r134-3a30c0b3-8c4b-4a64-bb93-3f3e17459363 --set-account-policy true 使用其网关名称和绑定标识允许专用路径服务网关的端点网关绑定，并将此名称设置为帐户策略。

命令选项

  • PRIVATE_PATH_SERVICE_GATEWAY：私有路径服务网关的 ID 或名称。
  • ENDPOINT_GATEWAY_BINDING：私有路径服务网关的端点网关绑定 ID。
  • --set-account-policy：指示该策略是否将成为同一账户下所有待处理和未来端点网关绑定的访问策略。 以下选项之一：true、false。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 私人路径服务网关端点网关绑定撤销

撤销对帐户的专用路径服务网关的访问权。

ibmcloud is private-path-service-gateway-endpoint-gateway-binding-revoke (PRIVATE_PATH_SERVICE_GATEWAY1 PRIVATE_PATH_SERVICE_GATEWAY2 ...) --account-id ACCOUNT_ID [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is ppsg-ar r134-e64dab2d-8fd2-43bd-8390-229ba66e53c4 --account-id efe5afc483594adaa8325e2b4d1290df 使用其网关标识撤销帐户的专用路径服务网关的访问权限。
  • ibmcloud is ppsg-ar cli-ppsg --account-id efe5afc483594adaa8325e2b4d1290df 使用其网关名称撤销帐户的专用路径服务网关的访问权限。

命令选项

  • PRIVATE_PATH_SERVICE_GATEWAY1：私有路径服务网关的 ID 或名称。
  • PRIVATE_PATH_SERVICE_GATEWAY2：私有路径服务网关的 ID 或名称。
  • --account-id：此访问策略所属账户的 ID。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

公共地址范围

ibmcloud 是公共地址范围

列出所有公共地址范围。

ibmcloud is public-address-ranges [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is public-address-ranges
  • ibmcloud is public-address-ranges --resource-group-id fee82deba12e4c0fb69c3b09d1f12345

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是公共地址范围

查看公共地址范围的详细信息。

ibmcloud is public-address-range PUBLIC_ADDRESS_RANGE [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is public-address-range r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2
  • ibmcloud is public-address-range my-public-address-range-name

命令选项

  • PUBLIC_ADDRESS_RANGE：公共地址范围的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 公共地址范围创建

创建公共地址范围。

ibmcloud is public-address-range-create --ipv4-address-count IPV4_ADDRESS_COUNT [--name NAME] [--vpc VPC --zone ZONE] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is public-address-range-create --name public-address-range-1 --ipv4-address-count 8 --vpc cli-test-vpc --zone us-south-1 --resource-group-id 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3
  • ibmcloud is public-address-range-create --name public-address-range-2 --ipv4-address-count 4 --resource-group-name Default

命令选项

  • --ipv4-address-count：所需的公共 IPv4 地址总数。 必须是 2 的幂。
  • --name：此公共地址范围的名称。 该名称不得由区域中的其他公共地址范围使用。 以 ibm- 开头的名称专用于服务商管理的资源，因此不允许使用。
  • --vpc：您要将此公共地址范围绑定到的 VPC。 在指定标志时，必须使用 --zone 标志。
  • --zone：您希望该公网地址范围所属的区域。 在指定标志时， 需要 --vpc 标志。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是公共地址范围更新

更新公共地址范围。

ibmcloud is public-address-range-update PUBLIC_ADDRESS_RANGE [--name NAME] [[--vpc VPC] [--zone ZONE] | --reset-target] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is public-address-range-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --name public-address-range-1 --vpc cli-test-vpc --zone us-south-1
  • ibmcloud is public-address-range-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --name public-address-range-1 --reset-target

命令选项

  • PUBLIC_ADDRESS_RANGE：公共地址范围的 ID 或名称。
  • --name：此公共地址范围的名称。 该名称不得由区域中的其他公共地址范围使用。 以 ibm- 开头的名称专用于服务商管理的资源，因此不允许使用。
  • --vpc：您希望将此公共地址范围绑定到的 VPC，该 VPC 将替换任何现有的 VPC。
  • --zone：您希望该公共地址范围所属的区域，将替换任何现有的区域。
  • --reset-target：将目标从公共地址范围中移除。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 公共地址范围删除

删除一个或多个公共地址范围。

ibmcloud is public-address-range-delete (PUBLIC_ADDRESS_RANGE1 PUBLIC_ADDRESS_RANGE2 ...) [-f, --force] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is public-address-range-delete r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2

命令选项

  • PUBLIC_ADDRESS_RANGE1：公共地址范围的 ID 或名称。
  • PUBLIC_ADDRESS_RANGE2：公共地址范围的 ID 或名称。
  • --force，-f：强制执行操作，无需确认。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

虚拟专用网络（VPN）网关

以下部分提供了有关可用于处理 VPN 网关的 CLI 命令的详细信息，包括 IKE 和 IPsec 策略。

ibmcloud is ike-策略

列出所有 IKE 策略。

ibmcloud is ike-policies [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 IKE 策略

查看 IKE 策略的详细信息。

ibmcloud is ike-policy IKE_POLICY [--output JSON] [-q, --quiet]

命令选项

  • IKE_POLICY：IKE 策略的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 IKE 策略连接

列出所有使用该 IKE 策略的连接。

ibmcloud is ike-policy-connections IKE_POLICY [--output JSON] [-q, --quiet]

命令选项

  • IKE_POLICY：IKE 策略的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 执行 IKE 策略创建操作

创建 IKE 策略。

ibmcloud is ike-policy-create IKE_POLICY_NAME AUTHENTICATION_ALGORITHMS DH_GROUPS ENCRYPTION_ALGORITHMS IKE_VERSION [--key-lifetime KEY_LIFETIME] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is ike-policy-create my-ike-policy sha256 14 aes128 2
  • ibmcloud is ike-policy-create my-ike-policy sha256 14 aes128 2 --key-lifetime 28000
  • ibmcloud is ike-policy-create my-ike-policy sha256 14 aes128 2 --resource-group-name Default
  • ibmcloud is ike-policy-create my-ike-policy sha256 14 aes128 2 --resource-group-id fee82deba12e4c0fb69c3b09d1f12345 --output JSON
  • ibmcloud is ike-policy-create my-ike-policy sha256,sha384 14,15,16 aes128,aes192 2

命令选项

  • IKE_POLICY_NAME：IKE 策略的名称。
  • AUTHENTICATION_ALGORITHMS：身份验证算法。 允许的值：sha256、sha384、sha512，或按顺序以逗号分隔的值。 算法的顺序决定了它们在协商中的优先级。 仅当 IKE_VERSION 为 2 时，才允许多个值。
  • DH_GROUPS：迪菲-赫尔曼群。 允许的值：14、15、16、17、18、19、20、21、22、23、24、31，或按顺序以逗号分隔的值。 Diffie-Hellman 组的顺序决定了它们在协商中的优先级。 仅当 IKE_VERSION 为 2 时，才允许多个值。
  • ENCRYPTION_ALGORITHMS：加密算法。 允许的值：aes128、aes192、aes256，或按顺序以逗号分隔的值。 算法的顺序决定了它们在协商中的优先级。 仅当 IKE_VERSION 为 2 时，才允许多个值。
  • IKE_VERSION：IKE 协议版本。 其中一个: 1，2。
  • --key-lifetime：密钥的有效期（以秒为单位）。 最大值: 86400，最小值: 1800。(缺省值: 28800)。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 采用 IKE 策略删除机制

删除一个或多个 IKE 策略。

ibmcloud is ike-policy-delete (IKE_POLICY1 IKE_POLICY2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • IKE_POLICY1：IKE 策略的 ID 或名称。
  • IKE_POLICY2：IKE 策略的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is Ike-policy-update

更新 IKE 策略。

ibmcloud is ike-policy-update IKE_POLICY [--name NEW_NAME] [--authentication-algorithms AUTHENTICATION_ALGORITHMS] [--dh-groups DH_GROUPS] [--encryption-algorithms ENCRYPTION_ALGORITHMS] [--ike-version 1 | 2] [--key-lifetime KEY_LIFETIME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is ike-policy-update fee82deba12e4c0fb69c3b09d1f12345 --name my-ike-policy
  • ibmcloud is ike-policy-update my-ike-policy --name my-renamed-ike-policy
  • ibmcloud is ike-policy-update fee82deba12e4c0fb69c3b09d1f12345 --authentication-algorithms sha256
  • ibmcloud is ike-policy-update fee82deba12e4c0fb69c3b09d1f12345 --authentication-algorithms sha256,sha384
  • ibmcloud is ike-policy-update fee82deba12e4c0fb69c3b09d1f12345 --dh-groups 14
  • ibmcloud is ike-policy-update fee82deba12e4c0fb69c3b09d1f12345 --dh-groups 14,15,16
  • ibmcloud is ike-policy-update fee82deba12e4c0fb69c3b09d1f12345 --encryption-algorithms aes128
  • ibmcloud is ike-policy-update fee82deba12e4c0fb69c3b09d1f12345 --encryption-algorithms aes128,aes192
  • ibmcloud is ike-policy-update fee82deba12e4c0fb69c3b09d1f12345 --ike-version 2
  • ibmcloud is ike-policy-update fee82deba12e4c0fb69c3b09d1f12345 --key-lifetime 28000 --output JSON

命令选项

  • IKE_POLICY：IKE 策略的 ID 或名称。
  • --name: IKE 策略的新名称。
  • --authentication-algorithms：身份验证算法。 允许的值：sha256、sha384、sha512，或按顺序以逗号分隔的值。 算法的顺序决定了它们在协商中的优先级。 仅当 IKE_VERSION 为 2 时，才允许多个值。
  • --dh-groups：迪菲-赫尔曼群。 允许的值：14、15、16、17、18、19、20、21、22、23、24、31，或按顺序以逗号分隔的值。 Diffie-Hellman 组的顺序决定了它们在协商中的优先级。 仅当 IKE_VERSION 为 2 时，才允许多个值。
  • --encryption-algorithms：加密算法。 允许的值：aes128、aes192、aes256，或按顺序以逗号分隔的值。 算法的顺序决定了它们在协商中的优先级。 仅当 IKE_VERSION 为 2 时，才允许多个值。
  • --ike-version：IKE 协议版本。 其中一个: 1，2。
  • --key-lifetime：密钥的有效期（以秒为单位）。 最大值：86400，最小值：1800。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is ipsec-策略

列出所有 IPsec 策略。

ibmcloud is ipsec-policies [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 ipsec-policy

查看 IPsec 策略的详细信息。

ibmcloud is ipsec-policy IPSEC_POLICY [--output JSON] [-q, --quiet]

命令选项

  • IPSEC_POLICY：IPsec 策略的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 ipsec-policy-connections

列出所有使用该 IPsec 策略的连接。

ibmcloud is ipsec-policy-connections IPSEC_POLICY [--output JSON] [-q, --quiet]

命令选项

  • IPSEC_POLICY：IPsec 策略的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 ipsec-policy-create

创建 IPsec 策略。

ibmcloud is ipsec-policy-create IPSEC_POLICY_NAME AUTHENTICATION_ALGORITHMS ENCRYPTION_ALGORITHMS PFSGS [--key-lifetime KEY_LIFETIME] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is ipsec-policy-create my-ipsec-policy sha256 aes128 group_14
  • ibmcloud is ipsec-policy-create my-ipsec-policy sha256 aes128 group_14 --key-lifetime 3600
  • ibmcloud is ipsec-policy-create my-ipsec-policy sha256 aes128 group_14 --resource-group-name Default
  • ibmcloud is ipsec-policy-create my-ipsec-policy sha256 aes128 group_14 --resource-group-id fee82deba12e4c0fb69c3b09d1f12345 --output JSON
  • ibmcloud is ipsec-policy-create my-ipsec-policy sha256,sha384 aes128,aes192 group_14,group_15

命令选项

  • IPSEC_POLICY_NAME：IPsec 策略的名称。
  • AUTHENTICATION_ALGORITHMS：身份验证算法。 当仅使用组合模式加密算法（aes128gcm16、aes192gcm16、aes256gcm16）时，必须将其设置为 'disabled'。 当使用其他加密算法（aes128、aes192、aes256）时，不得设置为 'disabled'。 允许的值：disabled、sha256、sha384、sha512，或按顺序以逗号分隔的值。
  • ENCRYPTION_ALGORITHMS：加密算法。 允许的值：aes128、aes128gcm16、aes192、aes192gcm16、aes256、aes256gcm16，或按顺序以逗号分隔的值。 算法的顺序决定了它们在协商中的优先级。
  • PFSGS：完美前向保密组。 允许的值：disabled、group_14、group_15、group_16、group_17、group_18、group_19、group_20、group_21、group_22、group_23、group_24、group_31，或按顺序以逗号分隔的值。
  • --key-lifetime：密钥的有效期（以秒为单位）。 最大值: 86400，最小值: 1800。(缺省值: 3600)。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 ipsec-policy-delete

删除一个或多个 IPsec 策略。

ibmcloud is ipsec-policy-delete (IPSEC_POLICY1 IPSEC_POLICY2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • IPSEC_POLICY1：IPsec 策略的 ID 或名称。
  • IPSEC_POLICY2：IPsec 策略的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 ipsec-policy-update

更新 IPsec 策略。

ibmcloud is ipsec-policy-update IPSEC_POLICY [--name NEW_NAME] [--authentication-algorithms AUTHENTICATION_ALGORITHMS] [--encryption-algorithms ENCRYPTION_ALGORITHMS] [--pfsgs PFSGS] [--key-lifetime KEY_LIFETIME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is ipsec-policy-update my-ipsec-policy --name my-renamed-ipsec-policy
  • ibmcloud is ipsec-policy-update fee82deba12e4c0fb69c3b09d1f12345 --name my-ipsec-policy
  • ibmcloud is ipsec-policy-update fee82deba12e4c0fb69c3b09d1f12345 --authentication-algorithms sha256
  • ibmcloud is ipsec-policy-update fee82deba12e4c0fb69c3b09d1f12345 --authentication-algorithms sha256,sha384
  • ibmcloud is ipsec-policy-update fee82deba12e4c0fb69c3b09d1f12345 --pfsgs group_14
  • ibmcloud is ipsec-policy-update fee82deba12e4c0fb69c3b09d1f12345 --pfsgs group_14,group_15
  • ibmcloud is ipsec-policy-update fee82deba12e4c0fb69c3b09d1f12345 --encryption-algorithms aes128
  • ibmcloud is ipsec-policy-update fee82deba12e4c0fb69c3b09d1f12345 --encryption-algorithms aes128,aes192
  • ibmcloud is ipsec-policy-update fee82deba12e4c0fb69c3b09d1f12345 --key-lifetime 3600 --output JSON

命令选项

  • IPSEC_POLICY：IPsec 策略的 ID 或名称。
  • --name: IPsec 策略的新名称。
  • --authentication-algorithms：身份验证算法。 当仅使用组合模式加密算法（ aes128gcm16、aes192gcm16、aes256gcm16 ）时，必须禁用此选项。 当使用任何其他加密算法（ aes128、aes192、aes256 ）时，不得禁用此功能。 允许的值：disabled、sha256、sha384、sha512，或按顺序以逗号分隔的值。
  • --encryption-algorithms：加密算法。 允许的值：aes128、aes128gcm16、aes192、aes192gcm16、aes256、aes256gcm16，或按顺序以逗号分隔的值。 算法的顺序决定了它们在协商中的优先级。
  • --pfsgs：完美前向保密组。 允许的值：disabled、group_14、group_15、group_16、group_17、group_18、group_19、group_20、group_21、group_22、group_23、group_24、group_31，或按顺序以逗号分隔的值。
  • --key-lifetime：密钥的有效期（以秒为单位）。 最大值：86400，最小值：1800。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-gateway

查看 VPN 网关的详细信息。

ibmcloud is vpn-gateway VPN_GATEWAY [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • VPN_GATEWAY：VPN 网关的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn 网关连接

查看 VPN 网关连接的详细信息。

ibmcloud is vpn-gateway-connection VPN_GATEWAY (CONNECTION1 CONNECTION2 ...) [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • VPN_GATEWAY：VPN 网关的 ID 或名称。
  • 连接1：VPN 连接的 ID 或名称。
  • 连接2：VPN 连接的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-gateway-connection-create

建立一个 VPN 网关连接。

ibmcloud is vpn-gateway-connection-create CONNECTION_NAME VPN_GATEWAY PEER PRESHARED_KEY [--vpc VPC] [--admin-state-up true | false] [--dead-peer-detection-action restart | clear | hold | none] [--dead-peer-detection-interval INTERVAL] [--dead-peer-detection-timeout TIMEOUT] [--ike-policy IKE_POLICY_ID] [--ipsec-policy IPSEC_POLICY_ID] [--peer-cidr CIDR1 --peer-cidr CIDR2 ... --local-cidr CIDR1 --local-cidr CIDR2 ...] [[--local-ike-identity-type fqdn | hostname | ipv4_address | key_id --local-ike-identity-value VALUE] | [--local-ike-identities LISTENER_POLICIES_JSON | @LISTENER_POLICIES_JSON_FILE]] [--peer-ike-identity-type fqdn | hostname | ipv4_address | key_id --peer-ike-identity-value VALUE] [--establish-mode bidirectional | peer_only] [--distribute-traffic true | false] [--peer-asn ASN] [--tunnels TUNNELS_JSON | @TUNNELS_JSON_FILE] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpn-gateway-connection-create my-connection fee82deba12e4c0fb69c3b09d1f12345 169.21.50.5 lkj14b1oi0alcniejkso --local-cidr 10.240.0.0/24 --peer-cidr 192.168.1.0/24
  • ibmcloud is vpn-gateway-connection-create my-connection my-vpn-gateway 169.21.50.5 lkj14b1oi0alcniejkso --local-cidr 10.240.0.0/24 --peer-cidr 192.168.1.0/24
  • ibmcloud is vpn-gateway-connection-create my-connection fee82deba12e4c0fb69c3b09d1f12345 169.21.50.5 lkj14b1oi0alcniejkso --local-cidr 10.240.0.0/24 --peer-cidr 192.168.1.0/24 --admin-state-up true
  • ibmcloud is vpn-gateway-connection-create my-connection fee82deba12e4c0fb69c3b09d1f12345 169.21.50.5 lkj14b1oi0alcniejkso --local-cidr 10.240.0.0/24 --peer-cidr 192.168.1.0/24 --dead-peer-detection-action clear --dead-peer-detection-interval 33 --dead-peer-detection-timeout 100
  • ibmcloud is vpn-gateway-connection-create my-connection fee82deba12e4c0fb69c3b09d1f12345 169.21.50.5 lkj14b1oi0alcniejkso --local-cidr 10.240.0.0/24 --peer-cidr 192.168.1.0/24 --ipsec-policy 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479
  • ibmcloud is vpn-gateway-connection-create my-connection my-vpn-gateway 169.21.50.5 lkj14b1oi0alcniejkso --local-cidr 10.240.0.0/24 --peer-cidr 192.168.1.0/24 --ipsec-policy my-ispec-policy
  • ibmcloud is vpn-gateway-connection-create my-connection fee82deba12e4c0fb69c3b09d1f12345 169.21.50.5 lkj14b1oi0alcniejkso --local-cidr 10.240.0.0/24 --peer-cidr 192.168.1.0/24 --ike-policy 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479
  • ibmcloud is vpn-gateway-connection-create my-connection my-vpn-gateway 169.21.50.5 lkj14b1oi0alcniejkso --local-cidr 10.240.0.0/24 --peer-cidr 192.168.1.0/24 --ike-policy my-ike-policy
  • ibmcloud is vpn-gateway-connection-create my-connection fee82deba12e4c0fb69c3b09d1f12345 169.21.50.5 lkj14b1oi0alcniejkso --local-cidr 10.240.0.0/24 --peer-cidr 192.168.1.0/24
  • ibmcloud is vpn-gateway-connection-create my-connection fee82deba12e4c0fb69c3b09d1f12345 169.21.50.5 lkj14b1oi0alcniejkso --local-cidr 10.240.0.0/24 --peer-cidr 192.168.1.0/24 --admin-state-up true
  • ibmcloud is vpn-gateway-connection-create my-connection fee82deba12e4c0fb69c3b09d1f12345 169.21.50.5 lkj14b1oi0alcniejkso --local-cidr 10.240.0.0/24 --peer-cidr 192.168.1.0/24 --dead-peer-detection-action clear --dead-peer-detection-interval 33 --dead-peer-detection-timeout 100
  • ibmcloud is vpn-gateway-connection-create my-connection fee82deba12e4c0fb69c3b09d1f12345 169.21.50.5 lkj14b1oi0alcniejkso --local-cidr 10.240.0.0/24 --peer-cidr 192.168.1.0/24 --ipsec-policy 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479
  • ibmcloud is vpn-gateway-connection-create my-connection fee82deba12e4c0fb69c3b09d1f12345 169.21.50.5 lkj14b1oi0alcniejkso --local-cidr 10.240.0.0/24 --peer-cidr 192.168.1.0/24 --ike-policy 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479
  • ibmcloud is vpn-gateway-connection-create my-connection fee82deba12e4c0fb69c3b09d1f12345 169.21.50.5 lkj14b1oi0alcniejkso --local-cidr 10.240.0.0/24 --local-cidr 10.240.1.0/24 --peer-cidr 192.168.1.0/24 --peer-cidr 192.168.2.0/24 --output JSON
  • ibmcloud is vpn-gateway-connection-create my-connection fee82deba12e4c0fb69c3b09d1f12345 169.21.50.5 lkj14b1oi0alcniejkso --distribute-traffic true --local-ike-identities '[{"type":"fqdn","value":"sadsadasd.com"},{"type":"fqdn","value":"sadsadasdasd.com"}]' --peer-ike-identity-type key_id --peer-ike-identity-value sampledd --output JSON
  • ibmcloud is vpn-gateway-connection-create my-connection fee82deba12e4c0fb69c3b09d1f12345 169.21.50.5 lkj14b1oi0alcniejkso --distribute-traffic true --local-ike-identities '[{"type":"fqdn","value":"sadsadasd.com"},{"type":"fqdn","value":"sadsadasdasd.com"}]' --peer-asn 65534 --tunnels '[{"neighbor_ip":{"address":"192.168.3.4"},"tunnel_interface_ip":{"address":"192.168.3.4"}},{"neighbor_ip":{"address":"192.168.3.5"},"tunnel_interface_ip":{"address":"192.168.3.5"}}]' --peer-ike-identity-type key_id --peer-ike-identity-value sampledd --output JSON
  • ibmcloud is vpn-gateway-connection-create my-connection fee82deba12e4c0fb69c3b09d1f12345 169.21.50.5 lkj14b1oi0alcniejkso --establish-mode peer_only --local-ike-identities '[{"type":"ipv4_address","value":"2.2.2.2"},{"type":"fqdn","value":"sadsadasd.com"}]' --peer-ike-identity-type key_id --peer-ike-identity-value sampledd 使用本地 ike_identities 创建 VPN 网关连接，将其用作 JSON 结构
  • ibmcloud is vpn-gateway-connection-create my-connection fee82deba12e4c0fb69c3b09d1f12345 169.21.50.5 lkj14b1oi0alcniejkso --establish-mode peer_only --local-ike-identity-type fqdn --local-ike-identity-value sadsadasd.com --peer-ike-identity-type key_id --peer-ike-identity-value sampledd 使用本地 ike_identities 创建 VPN 网关连接，将其用作标志结构

命令选项

  • CONNECTION_NAME：连接名称。
  • VPN_GATEWAY：VPN 网关的 ID 或名称。
  • 对等方：对等 VPN 网关的 IP 地址或完全限定域名 (FQDN)。
  • PRESHARED_KEY：预共享密钥。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --admin-state-up：如果设置为 false，则会关闭 VPN 网关连接。 下列其中一项: true 和 false。(缺省值: true)。
  • --dead-peer-detection-action：死对等检测操作。 其中一个: restart，clear，hold，none。(缺省值: restart)。
  • --dead-peer-Detection-interval: Dead Peer Detection 时间间隔 (以秒为单位) (缺省值: 2)。
  • --dead-peer-Detection-timeout: Dead Peer Detection 超时 (以秒为单位) (缺省值: 10)。
  • --ike-policy：IKE 策略的 ID 或名称。
  • --ipsec-policy：IPsec 策略的 ID 或名称。
  • --peer-cidr：该资源的对等 CIDR 范围。
  • --local-cidr：该资源的本地 CIDR。
  • --local-ike-identity-type：本地 IKE 身份类型。
  • --local-ike-identity-value：本地 IKE 标识的完全合格域名 (FQDN) 值。
  • --local-ike-identities：LOCAL_IKE_IDENTITIES_JSON | @LOCAL_IKE_IDENTITIES_JSON_FILE，以 JSON 或 JSON 文件格式存储的本地 IKE 身份信息。
  • --peer-ike-identity-type：对等方 IKE 身份类型。
  • --peer-ike-identity-value：对等方 IKE 标识的全限定域名 (FQDN) 值。
  • --establish-mode：VPN 网关连接的建立模式。 其中一个: 双向，仅限 peer_only。(缺省值: 双向)。
  • --distribute-traffic：指示流量是否在VPN网关连接的各上行隧道之间进行分流。 以下选项之一：true、false。
  • --peer-asn：此 VPN 网关连接的对等自治系统编号 (ASN)。
  • --tunnels：TUNNELS_JSON | @TUNNELS_JSON_FILE，以 JSON 或 JSON 文件形式提供的隧道。 以下之一：TUNNELS_JSON，@TUNNELS_JSON_FILE。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-gateway-connection-delete

删除一个或多个 VPN 网关连接。

ibmcloud is vpn-gateway-connection-delete VPN_GATEWAY (CONNECTION1 CONNECTION2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • VPN_GATEWAY：VPN 网关的 ID 或名称。
  • 连接1：VPN 连接的 ID 或名称。
  • 连接2：VPN 连接的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-gateway-connection-local-cidr-add

将本地 CIDR 添加到 VPN 网关连接中。

ibmcloud is vpn-gateway-connection-local-cidr-add VPN_GATEWAY CONNECTION CIDR [--vpc VPC] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpn-gateway-connection-local-cidr-add 0726-59be5c84-1dc2-4191-b591-d506514563bf 0726-0d642e87-b868-4a22-83f4-a35a19390b5c 1.168.0.0/22
  • ibmcloud is vpn-gateway-connection-local-cidr-add 0726-59be5c84-1dc2-4191-b591-d506514563bf 0726-0d642e87-b868-4a22-83f4-a35a19390b5c 1.168.0.0/22 --output JSON

命令选项

  • VPN_GATEWAY：VPN 网关的 ID 或名称。
  • 连接：VPN 连接的 ID 或名称。
  • CIDR：以 CIDR 块表示法表示的 IP 地址范围。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-gateway-connection-local-cidr-delete

从 VPN 网关连接中移除一个本地 CIDR 地址。

ibmcloud is vpn-gateway-connection-local-cidr-delete VPN_GATEWAY CONNECTION CIDR [--vpc VPC] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is vpn-gateway-connection-local-cidr-delete 0726-59be5c84-1dc2-4191-b591-d506514563bf 0726-0d642e87-b868-4a22-83f4-a35a19390b5c 1.168.0.0/22
  • ibmcloud is vpn-gateway-connection-local-cidr-delete 0726-59be5c84-1dc2-4191-b591-d506514563bf 0726-0d642e87-b868-4a22-83f4-a35a19390b5c 1.168.0.0/22 --output JSON

命令选项

  • VPN_GATEWAY：VPN 网关的 ID 或名称。
  • 连接：VPN 连接的 ID 或名称。
  • CIDR：以 CIDR 块表示法表示的 IP 地址范围。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-网关-连接-对等体-cidr-地址

将对等 CIDR 添加到 VPN 网关连接中。

ibmcloud is vpn-gateway-connection-peer-cidr-add VPN_GATEWAY CONNECTION CIDR [--vpc VPC] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpn-gateway-connection-peer-cidr-add 0726-59be5c84-1dc2-4191-b591-d506514563bf 0726-0d642e87-b868-4a22-83f4-a35a19390b5c 10.45.0.0/24
  • ibmcloud is vpn-gateway-connection-peer-cidr-add 0726-59be5c84-1dc2-4191-b591-d506514563bf 0726-0d642e87-b868-4a22-83f4-a35a19390b5c 10.45.0.0/24 --output JSON

命令选项

  • VPN_GATEWAY：VPN 网关的 ID 或名称。
  • 连接：VPN 连接的 ID 或名称。
  • CIDR：以 CIDR 块表示法表示的 IP 地址范围。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-gateway-connection-peer-cidr-delete

从 VPN 网关连接中删除一个对等 CIDR。

ibmcloud is vpn-gateway-connection-peer-cidr-delete VPN_GATEWAY CONNECTION CIDR [--vpc VPC] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is vpn-gateway-connection-peer-cidr-delete 0726-59be5c84-1dc2-4191-b591-d506514563bf 0726-0d642e87-b868-4a22-83f4-a35a19390b5c 10.45.0.0/24
  • ibmcloud is vpn-gateway-connection-peer-cidr-add 0726-59be5c84-1dc2-4191-b591-d506514563bf 0726-0d642e87-b868-4a22-83f4-a35a19390b5c 10.45.0.0/24 --output JSON

命令选项

  • VPN_GATEWAY：VPN 网关的 ID 或名称。
  • 连接：VPN 连接的 ID 或名称。
  • CIDR：以 CIDR 块表示法表示的 IP 地址范围。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-gateway-connection-update

更新 VPN 网关连接。

ibmcloud is vpn-gateway-connection-update VPN_GATEWAY CONNECTION [--vpc VPC] [--admin-state-up true | false] [--dead-peer-detection-action restart | clear | hold | none] [--dead-peer-detection-interval INTERVAL] [--dead-peer-detection-timeout TIMEOUT] [--ike-policy IKE_POLICY_ID | --reset-ike-policy] [--ipsec-policy IPSEC_POLICY_ID | --reset-ipsec-policy] [--peer-address ADDRESS] [--peer-fqdn FQDN] [--distribute-traffic true | false] [--routing-protocol bgp | none] [--peer-asn ASN] [--tunnels TUNNELS_JSON | @TUNNELS_JSON_FILE] [--psk PSK] [--establish-mode bidirectional | peer_only] [--name NEW_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpn-gateway-connection-update fee82deba12e4c0fb69c3b09d1f12345 gfe82deba12e4c0fb69c3b09d1f23456 --admin-state-up true --dead-peer-detection-action clear --dead-peer-detection-interval 33 --dead-peer-detection-timeout 100 --ike-policy 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --ipsec-policy 05251a2e-d6c5-42b4-97b0-b5f8e8d1f445 --peer-address 234.3.4.5 -psk rweirjgiort --name my-new-connection --output JSON
  • ibmcloud is vpn-gateway-connection-update my-vpn-gateway my-connection --admin-state-up true --dead-peer-detection-action clear --dead-peer-detection-interval 33 --dead-peer-detection-timeout 100 --ike-policy my-ike-policy --ipsec-policy my-ipsec-policy --peer-address 234.3.4.5 -psk rweirjgiort --name my-new-connection --output JSON
  • ibmcloud is vpn-gateway-connection-update my-vpn-gateway my-connection --admin-state-up true --dead-peer-detection-action clear --dead-peer-detection-interval 33 --dead-peer-detection-timeout 100 --ike-policy my-ike-policy --ipsec-policy my-ipsec-policy --peer-address 234.3.4.5 -psk rweirjgiort --name my-new-connection --establish-mode peer_only --output JSON
  • ibmcloud is vpn-gateway-connection-update my-vpn-gateway my-connection --admin-state-up true --ike-policy my-ike-policy --ipsec-policy my-ipsec-policy --peer-fqdn my-service.example.com -psk rweirjgiort --name my-new-connection --establish-mode peer_only --output JSON
  • ibmcloud is vpn-gateway-connection-update my-vpn-gateway my-connection --distribute-traffic true --output JSON
  • ibmcloud is vpn-gateway-connection-update my-vpn-gateway my-connection --routing-protocol bgp --peer-asn 65534 —-tunnels '[{"neighbor_ip":{"address":"192.168.3.4"},"tunnel_interface_ip":{"address":"192.168.3.4"}},{"neighbor_ip":{"address":"192.168.3.5"},"tunnel_interface_ip":{"address":"192.168.3.5"}}]' --output JSON

命令选项

  • VPN_GATEWAY：VPN 网关的 ID 或名称。
  • 连接：VPN 连接的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --admin-state-up：如果设置为 false，则会关闭 VPN 网关连接。 以下选项之一：true、false。
  • --dead-peer-detection-action：死对等检测操作。 其中一个: restart，clear，hold，none。
  • --dead-peer-detection-interval：死对等体检测间隔（单位：秒）。
  • --dead-peer-detection-timeout：死对等检测超时时间（单位：秒）。
  • --ike-policy：IKE 策略的 ID 或名称。
  • --reset-ike-policy：删除 IKE 策略。
  • --ipsec-policy：IPsec 策略的 ID 或名称。
  • --reset-ipsec-policy：删除 IPsec 策略。
  • --peer-address：对等 VPN 网关的 IP 地址。
  • --peer-fqdn：对等 VPN 网关的完全合格域名 (FQDN)。
  • --distribute-traffic：指示流量是否在VPN网关连接的各上行隧道之间进行分流。 以下选项之一：true、false。
  • --routing-protocol：此 VPN 网关连接启用的路由协议。如果指定了该参数，mode 必须为 route。 其中之一：BGP、无。
  • --peer-asn：此 VPN 网关连接的对等自治系统编号 (ASN)。
  • --tunnels：TUNNELS_JSON | @TUNNELS_JSON_FILE，以 JSON 或 JSON 文件形式提供的隧道。 以下之一：TUNNELS_JSON，@TUNNELS_JSON_FILE。
  • --psk：预共享密钥。
  • --establish-mode：VPN 网关连接的建立模式。 其中一个: 双向，仅限 peer_only。
  • --name: 连接的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-gateway-connections

列出所有 VPN 网关连接。

ibmcloud is vpn-gateway-connections VPN_GATEWAY [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • VPN_GATEWAY：VPN 网关的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-gateway-create

创建 VPN 网关。

ibmcloud is vpn-gateway-create VPN_GATEWAY_NAME SUBNET [--mode policy | route [--advertised-cidrs ADVERTISED_CIDRS1 --advertised-cidrs ADVERTISED_CIDRS2 ...] [--local-asn ASN]] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpn-gateway-create my-vpn-gateway fee82deba12e4c0fb69c3b09d1f12345 --mode route
  • ibmcloud is vpn-gateway-create my-vpn-gateway my-subnet --vpc my-vpc --mode route
  • ibmcloud is vpn-gateway-create my-vpn-gateway fee82deba12e4c0fb69c3b09d1f12345 --mode policy
  • ibmcloud is vpn-gateway-create my-vpn-gateway my-subnet --vpc my-vpc --mode policy
  • ibmcloud is vpn-gateway-create my-vpn-gateway fee82deba12e4c0fb69c3b09d1f12345 --mode route --resource-group-name Default
  • ibmcloud is vpn-gateway-create my-vpn-gateway fee82deba12e4c0fb69c3b09d1f12345 --mode route --resource-group-id fee82deba12e4c0fb69c3b09d1f12345 --output JSON
  • ibmcloud is vpn-gateway-create my-vpn-gateway fee82deba12e4c0fb69c3b09d1f12345 --mode route --advertised-cidrs 10.45.0.0/24
  • ibmcloud is vpn-gateway-create my-vpn-gateway fee82deba12e4c0fb69c3b09d1f12345 --mode route --local-asn 64520

命令选项

  • VPN_GATEWAY_NAME：VPN 网关的名称。
  • 子网：子网的 ID 或名称。
  • --mode：VPN 网关的模式；如果未指定，则 VPN 网关的默认模式为“策略”。 policy，route 之一。
  • --advertised-cidrs：以 CIDR 块表示法表示的 IP 地址范围。
  • --local-asn：此 VPN 网关及其连接所对应的本地自治系统编号（ASN）。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 正在删除 VPN 网关

删除一个或多个 VPN 网关。

ibmcloud is vpn-gateway-delete (VPN_GATEWAY1 VPN_GATEWAY2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • VPN_GATEWAY1：VPN 网关的 ID 或名称。
  • VPN_GATEWAY2：VPN 网关的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-gateway-update

更新 VPN 网关。

ibmcloud is vpn-gateway-update VPN_GATEWAY [--vpc VPC] [--name NEW_NAME] [--local-asn ASN] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpn-gateway-update fee82deba12e4c0fb69c3b09d1f12345 --name my-renamed-gateway --output JSON
  • ibmcloud is vpn-gateway-update my-vpn-gateway --name my-renamed-gateway --output JSON
  • ibmcloud is vpn-gateway-update my-vpn-gateway --name my-renamed-gateway --local-asn 64520 --output JSON

命令选项

  • VPN_GATEWAY：VPN 网关的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --name: VPN 网关的新名称。
  • --local-asn：此 VPN 网关及其连接所对应的本地自治系统编号（ASN）。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is vpn-gateways

列出所有 VPN 网关。

ibmcloud is vpn-gateways [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是通过VPN网关广告的CIDR

检查指定的已通告 CIDR 是否存在于 VPN 网关上。

ibmcloud is vpn-gateway-advertised-cidr VPN_GATEWAY --cidr CIDR [--vpc VPC] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpn-gateway-advertised-cidr 0726-59be5c84-1dc2-4191-b591-d506514563bf --cidr 10.45.0.0/24
  • ibmcloud is vpn-gateway-advertised-cidr 0726-59be5c84-1dc2-4191-b591-d506514563bf --cidr 10.45.0.0/24 --output JSON

命令选项

  • VPN_GATEWAY：VPN 网关的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --cidr：以 CIDR 块表示法表示的 IP 地址范围。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 VPN 网关广告的 CIDR 地址

将已通告 CIDR 添加到 VPN 网关。

ibmcloud is vpn-gateway-advertised-cidr-add VPN_GATEWAY --cidr CIDR [--vpc VPC] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpn-gateway-advertised-cidr-add 0726-59be5c84-1dc2-4191-b591-d506514563bf --cidr 10.45.0.0/24
  • ibmcloud is vpn-gateway-advertised-cidr-add 0726-59be5c84-1dc2-4191-b591-d506514563bf --cidr 10.45.0.0/24 --output JSON

命令选项

  • VPN_GATEWAY：VPN 网关的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --cidr：以 CIDR 块表示法表示的 IP 地址范围。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 VPN 网关广告的 CIDR 删除

从 VPN 网关中移除已通告的 CIDR。

ibmcloud is vpn-gateway-advertised-cidr-delete VPN_GATEWAY (CIDR1 CIDR2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is vpn-gateway-advertised-cidr-delete 0726-59be5c84-1dc2-4191-b591-d506514563bf 10.45.0.0/24
  • ibmcloud is vpn-gateway-advertised-cidr-delete 0726-59be5c84-1dc2-4191-b591-d506514563bf 10.45.0.0/24 --output JSON

命令选项

  • VPN_GATEWAY：VPN 网关的 ID 或名称。
  • CIDR1：以 CIDR 块表示法表示的 IP 地址范围。
  • CIDR2：以 CIDR 块表示法表示的 IP 地址范围。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 VPN 网关广告的 CIDR 范围

列出所有已通告的 VPN 网关 CIDR。

ibmcloud is vpn-gateway-advertised-cidrs VPN_GATEWAY [--vpc VPC] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpn-gateway-advertised-cidrs 0726-59be5c84-1dc2-4191-b591-d506514563bf
  • ibmcloud is vpn-gateway-advertised-cidrs 0726-59be5c84-1dc2-4191-b591-d506514563bf --output JSON

命令选项

  • VPN_GATEWAY：VPN 网关的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn 网关服务连接

检索 VPN 网关服务连接。

ibmcloud is vpn-gateway-service-connection VPN_GATEWAY --service-connection-id SERVICE_CONNECTION_ID [--vpc VPC] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpn-gateway-service-connection 0726-59be5c84-1dc2-4191-b591-d506514563bf --service-connection-id my-connection
  • ibmcloud is vpn-gateway-service-connection 0726-59be5c84-1dc2-4191-b591-d506514563bf --service-connection-id my-connection --output JSON

命令选项

  • VPN_GATEWAY：VPN 网关的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --service-connection-id：VPN 网关连接标识符。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-gateway-service-connections

列出所有 VPN 网关服务连接。

ibmcloud is vpn-gateway-service-connections VPN_GATEWAY [--vpc VPC] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpn-gateway-service-connections 0726-59be5c84-1dc2-4191-b591-d506514563bf
  • ibmcloud is vpn-gateway-service-connections 0726-59be5c84-1dc2-4191-b591-d506514563bf --output JSON

命令选项

  • VPN_GATEWAY：VPN 网关的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

虚拟专用网络（VPN）服务器

以下部分提供了有关可用于处理 VPN 服务器的 CLI 命令的详细信息。

ibmcloud 是 vpn-servers

列出所有 VPN 服务器。

ibmcloud is vpn-servers [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-server

查看 VPN 服务器的详细信息。

ibmcloud is vpn-server VPN_SERVER [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • VPN_SERVER：VPN 服务器的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-服务器-创建

创建 VPN 服务器。

ibmcloud is vpn-server-create --client-ip-pool CLIENT_IP_POOL --cert CERT (--client-auth-methods certificate | username | certificate,username | username,certificate) [--subnet SUBNET --vpc VPC] [--client-ca CLIENT_CA] [--client-crl CLIENT_CRL] [--client-dns CLIENT_DNS] [--client-idle-timeout CLIENT_IDLE_TIMEOUT] [--enable-split-tunnel false | true] [--port PORT] [--protocol udp | tcp] [--sg SG] [--name NAME] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpn-server-create --subnet 0726-a7191f77-7c87-4ad4-bb11-a37f9e9fc0f0,0736-4b871e22-e819-4f87-bb17-e457a88246a2 --cert crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f510 --client-ip-pool 192.168.0.0/20 --client-auth-methods certificate --client-ca crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f514
  • ibmcloud is vpn-server-create --subnet my-subnet,my-subnet2 --vpc my-vpc --cert crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f510 --client-ip-pool 192.168.0.0/20 --client-auth-methods certificate --client-ca crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f514
  • ibmcloud is vpn-server-create --name myvpnserver --subnet 0726-a7191f77-7c87-4ad4-bb11-a37f9e9fc0f0,0736-4b871e22-e819-4f87-bb17-e457a88246a2 --cert crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f510 --client-ip-pool 192.168.0.0/20 --client-auth-methods username
  • ibmcloud is vpn-server-create --name myvpnserver2 --subnet 0726-a7191f77-7c87-4ad4-bb11-a37f9e9fc0f0 --cert crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f510 --client-ip-pool 192.168.0.0/20 --client-auth-methods username --client-dns 9.9.9.9,8.8.8.8 --protocol tcp --port 8888 --enable-split-tunnel true --client-idle-timeout 1200
  • ibmcloud is vpn-server-create --name myvpnserver3 --subnet 0726-a7191f77-7c87-4ad4-bb11-a37f9e9fc0f0 --cert crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f510 --client-ip-pool 192.168.0.0/20 --client-auth-methods username --sg r134-e32f671c-463d-4f93-88e3-2dd0413476b4,r134-3af7a9db-d9bc-43d4-bced-93e0a33fee25
  • ibmcloud is vpn-server-create --name myvpnserver3 --subnet my-subnet --vpc my-vpc --cert crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f510 --client-ip-pool 192.168.0.0/20 --client-auth-methods username --sg my-sg1,my-sg2
  • ibmcloud is vpn-server-create --subnet 0726-a7191f77-7c87-4ad4-bb11-a37f9e9fc0f0,0736-4b871e22-e819-4f87-bb17-e457a88246a2 --cert crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f510 --client-ip-pool 192.168.0.0/20 --client-dns 172.34.1.100 --client-auth-methods certificate,username --client-ca crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f514 --client-crl @./openvpn/crl.pem --name vpnswithcrl --sg r134-5744b689-e5c4-461d-9f9b-ce5e7e8dbed6

命令选项

  • --subnet：用于配置此 VPN 服务器的子网 ID 或名称，以逗号分隔。 使用不同区域中的子网以实现高可用性，最多可以设置两个子网。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --client-ip-pool：VPN 客户端的 IPv4 地址池，以 CIDR 格式表示。 请求不得与 VPC 中的任何现有地址前缀或者以下任何保留的地址范围重叠：127.0.0.0/8（IPv4 回送地址）、161.26.0.0/16（IBM 服务）、166.8.0.0/14（云服务端点）、169.254.0.0/16（IPv4 链路本地地址）和 224.0.0.0/4（IPv4 多点广播地址）。 客户端 IP 地址池的 CIDR 的前缀长度必须介于 /9（8,388,608 个地址）和 /22（1024 个地址）之间。 建议使用包含启用最大并发连接数所需的两倍数量的 IP 地址的 CIDR 块。
  • --cert：来自密钥管理器、用于此 VPN 服务器的密钥 CRN。
  • --client-auth-methods：以逗号分隔的客户端身份验证方法列表。 下列其中一项: certificate，username，certificate，username，username，certificate。
  • --client-ca：来自密钥管理器的密钥 CRN，用于 VPN 客户端证书颁发机构 (CA)。
  • -- client-crl:CRL | @CRL-file。 证书撤销列表的内容，采用 PEM 格式编码。
  • --client-dns：以逗号分隔的 DNS 服务器地址列表，这些地址将提供给连接到此 VPN 服务器的 VPN 客户端。 最多可设置两个 DNS 服务器。
  • --client-idle-timeout：VPN 客户端处于空闲状态的秒数，超过该时间后，此 VPN 服务器将断开其连接。 指定 0 可防止服务器断开闲置客户端的连接（默认值：600 ）。
  • --enable-split-tunnel：指示此 VPN 服务器上是否启用了分流隧道功能。 其中一个: false，true。(缺省值: false)。
  • --port：此 VPN 服务器要使用的端口号。（默认：443 ）。
  • --protocol：此 VPN 服务器要使用的传输协议。 udp 和 tcp 之一。(缺省值: udp)。
  • --sg：VPN 服务器的以逗号分隔的安全组 ID 或名称。
  • --name: VPN 服务器的全新名称。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-server-update

更新 VPN 服务器。

ibmcloud is vpn-server-update VPN_SERVER [--vpc VPC] [--subnet SUBNET] [--client-ip-pool CLIENT_IP_POOL] [--cert CERT] [--client-auth-methods certificate | username | certificate,username | username,certificate] [--client-ca CLIENT_CA] [--client-crl CLIENT_CRL] [[--client-dns CLIENT_DNS | --reset-client-dns]] [--client-idle-timeout CLIENT_IDLE_TIMEOUT] [--enable-split-tunnel false | true] [--port PORT] [--protocol udp | tcp] [--name NEW_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpn-server-update r134-aa88726e-8b34-4f97-992d-027df9c4bb36 --name my-server
  • ibmcloud is vpn-server-update my-server --name my-renamed-server
  • ibmcloud is vpn-server-update r134-aa88726e-8b34-4f97-992d-027df9c4bb36 --cert crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f510 --client-auth-methods certificate --client-ca crn:v1:bluemix:public:secrets-manager:us-south:a/aa5a471f75bc456fac416bf02c4ba6de:aace9348-39da-4498-b132-e5ab918237f4:secret:e3bd96ce-1e4c-f642-d1f2-0d0ab025f514
  • ibmcloud is vpn-server-update r134-aa88726e-8b34-4f97-992d-027df9c4bb36 --client-ip-pool 192.168.0.0/20 --client-dns 9.9.9.9 --client-idle-timeout 120 --port 9090 --protocol tcp --enable-split-tunnel true --output JSON
  • ibmcloud is vpn-server-update r134-aa88726e-8b34-4f97-992d-027df9c4bb36 --client-dns "" 清除提供给与此 VPN 服务器连接的 VPN 客户端的 DNS 服务器地址。
  • ibmcloud is vpn-server-update r134-aa88726e-8b34-4f97-992d-027df9c4bb36 --reset-client-dns 清除提供给与此 VPN 服务器连接的 VPN 客户端的 DNS 服务器地址。
  • ibmcloud is vpn-server-update r134-aa88726e-8b34-4f97-992d-027df9c4bb36 --subnet 0716-6ec3e875-abfa-40f4-a7c5-7473f4b2a2e1,0726-61b2f53f-1e95-42a7-94ab-55de8f8cbdd5 使用来自不同区域的多个子网来更新 VPN 服务器以实现高可用性。
  • ibmcloud is vpn-server-update r134-aa88726e-8b34-4f97-992d-027df9c4bb36 --subnet 0716-6ec3e875-abfa-40f4-a7c5-7473f4b2a2e1 使用子网更新 VPN 服务器以更改 VPN 服务器的子网，或者将 VPN 服务器从高可用 VPN 服务器降级到独立 VPN 服务器。

命令选项

  • VPN_SERVER：VPN 服务器的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --subnet：用于配置此 VPN 服务器的子网 ID 或名称，以逗号分隔。 使用不同区域中的子网以实现高可用性，最多可以设置两个子网。
  • --client-ip-pool：VPN 客户端的 IPv4 地址池，以 CIDR 格式表示。 请求不得与 VPC 中的任何现有地址前缀或者以下任何保留的地址范围重叠：127.0.0.0/8（IPv4 回送地址）、161.26.0.0/16（IBM 服务）、166.8.0.0/14（云服务端点）、169.254.0.0/16（IPv4 链路本地地址）和 224.0.0.0/4（IPv4 多点广播地址）。 客户端 IP 地址池的 CIDR 的前缀长度必须介于 /9（8,388,608 个地址）和 /22（1024 个地址）之间。 建议使用包含启用最大并发连接数所需的两倍数量的 IP 地址的 CIDR 块。
  • --cert：来自密钥管理器、用于此 VPN 服务器的密钥 CRN。
  • --client-auth-methods：以逗号分隔的客户端身份验证方法列表。 下列其中一项: certificate，username，certificate，username，username，certificate。
  • --client-ca：来自密钥管理器的密钥 CRN，用于 VPN 客户端证书颁发机构 (CA)。
  • -- client-crl:CRL | @CRL-file。 证书撤销列表的内容，采用 PEM 格式编码。
  • --client-dns：以逗号分隔的 DNS 服务器地址列表，这些地址将提供给连接到此 VPN 服务器的 VPN 客户端。 最多可设置两个 DNS 服务器。
  • --reset-client-dns：清理提供给连接到此 VPN 服务器的 VPN 客户端的 DNS 服务器地址。
  • --client-idle-timeout：VPN 客户端处于空闲状态的秒数，超过该时间后，此 VPN 服务器将断开其连接。 将该值设为 0，可防止服务器断开闲置客户端的连接。
  • --enable-split-tunnel：指示此 VPN 服务器上是否启用了分流隧道功能。 其中一个: false，true。(缺省值: false)。
  • --port：此 VPN 服务器要使用的端口号。
  • --protocol：此 VPN 服务器要使用的传输协议。 udp 和 tcp 之一。
  • --name: VPN 服务器的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-server-delete

删除一个或多个 VPN 服务器。

ibmcloud is vpn-server-delete (VPN_SERVER1 VPN_SERVER2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • VPN_SERVER1：VPN 服务器的 ID 或名称。
  • VPN_SERVER2：VPN 服务器的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-server-client-configuration

检索 OpenVPN 客户端配置。

ibmcloud is vpn-server-client-configuration VPN_SERVER [--vpc VPC] [--file FILE] [-q, --quiet]

命令示例

  • ibmcloud is vpn-server-client-configuration r134-d0671da5-1646-449b-8390-6bd7d6abea01
  • ibmcloud is vpn-server-client-configuration my-server
  • ibmcloud is vpn-server-client-configuration r134-d0671da5-1646-449b-8390-6bd7d6abea01 --file ./my_vpn.conf

命令选项

  • VPN_SERVER：VPN 服务器的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --file：将客户端配置保存到指定的文件路径中。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-server-clients

列出某个 VPN 服务器的所有 VPN 客户端。

ibmcloud is vpn-server-clients VPN_SERVER [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • VPN_SERVER：VPN 服务器的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-server-client

查看 VPN 客户端的详细信息。

ibmcloud is vpn-server-client VPN_SERVER CLIENT_ID [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • VPN_SERVER：VPN 服务器的 ID 或名称。
  • CLIENT_ID：VPN 客户端的 ID。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-服务器-客户端-删除

删除 VPN 服务器的一个或多个 VPN 客户端。

ibmcloud is vpn-server-client-delete VPN_SERVER (CLIENT_ID1 CLIENT_ID2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • VPN_SERVER：VPN 服务器的 ID 或名称。
  • CLIENT_ID1：VPN 客户端的 ID。
  • CLIENT_ID2：VPN 客户端的 ID。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 VPN 服务器与客户端断开连接

断开 VPN 客户端连接。

ibmcloud is vpn-server-client-disconnect VPN_SERVER (CLIENT_ID1 CLIENT_ID2 ...) [--vpc VPC] [-f, --force] [-q, --quiet]

命令选项

  • VPN_SERVER：VPN 服务器的 ID 或名称。
  • CLIENT_ID1：VPN 客户端的 ID。
  • CLIENT_ID2：VPN 客户端的 ID。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-server-路由

列出某个 VPN 服务器的所有 VPN 路由。

ibmcloud is vpn-server-routes VPN_SERVER [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • VPN_SERVER：VPN 服务器的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-server-route

查看 VPN 路由的详细信息。

ibmcloud is vpn-server-route VPN_SERVER ROUTE_ID [--vpc VPC] [--output JSON] [-q, --quiet]

命令选项

  • VPN_SERVER：VPN 服务器的 ID 或名称。
  • ROUTE_ID：VPN 路由的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-server-route-create

创建 VPN 路由。

ibmcloud is vpn-server-route-create VPN_SERVER --destination DESTINATION_CIDR [--vpc VPC] [--action translate | deliver | drop] [--name NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpn-server-route-create r134-77e21079-7291-44c2-866a-8f1848bc10f0 --name my-route --action deliver --destination 10.0.0.0/24
  • ibmcloud is vpn-server-route-create my-server --name my-route --action deliver --destination 10.0.0.0/24
  • ibmcloud is vpn-server-route-create r134-77e21079-7291-44c2-866a-8f1848bc10f0 --name my-route --action drop --destination 10.0.0.0/24

命令选项

  • VPN_SERVER：VPN 服务器的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --action：对匹配该路由的数据包执行的操作。 translate，拯救者和 drop 之一。(缺省值: 拯救人)。
  • --destination：VPN 服务器中用于此 VPN 路由的目标地址。 在 VPN 服务器中必须是唯一的。 如果入局包与任何目标都不匹配，那么将删除该包。
  • --name：VPN 路由的名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 VPN 服务器路由更新

更新 VPN 路由。

ibmcloud is vpn-server-route-update VPN_SERVER ROUTE_ID [--vpc VPC] [--name NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is vpn-server-route-update r134-77e21079-7291-44c2-866a-8f1848bc10f0 1233a60b-fc95-4dbc-96ab-a976b723bfb0 --name my-route
  • ibmcloud is vpn-server-route-update my-server my-route --name my-renamed-route

命令选项

  • VPN_SERVER：VPN 服务器的 ID 或名称。
  • ROUTE_ID：VPN 路由的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --name: VPN 路由的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 vpn-server-route-delete

删除一个或多个 VPN 路由。

ibmcloud is vpn-server-route-delete VPN_SERVER (ROUTE_ID1 ROUTE_ID2 ...) [--vpc VPC] [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • VPN_SERVER：VPN 服务器的 ID 或名称。
  • ROUTE_ID1：VPN 路由的 ID 或名称。
  • ROUTE_ID2：VPN 路由的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

计算命令

以下部分介绍了与计算功能相关的 CLI 命令。

映像

ibmcloud 是操作系统

列出所有操作系统。

ibmcloud is operating-systems [--output JSON] [-q, --quiet]

命令选项

  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是操作系统

查看操作系统的详细信息。

ibmcloud is operating-system OPERATING_SYSTEM_NAME [--output JSON] [-q, --quiet]

命令选项

  • OPERATING_SYSTEM_NAME：操作系统的名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是映像

查看映像的详细信息。

ibmcloud is image IMAGE [--output JSON] [-q, --quiet]

命令选项

  • IMAGE：图像的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is images

列出区域中的所有映像。

ibmcloud is images [--visibility all | public | private] [--status STATUS] [--user-data-format USER_DATA_FORMAT] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [--remote-account-id provider | user] [-q, --quiet]

命令示例

  • ibmcloud is images --status deprecated,obsolete
  • ibmcloud is images --user-data-format esxi_kickstart,ipxe
  • ibmcloud is images --remote-account-id provider
  • ibmcloud is images --remote-account-id 2d1bace7b46e4815a81e52c6ffeba5cf

命令选项

  • --visibility：列出具有指定可见性的图片。 有效的可见性有两种：public 或 private。
  • --status：根据以逗号分隔的状态值列表，筛选出符合条件的图片。 可用值：可用、删除中、已弃用、已失败、已过时、部分可用、暂挂、不可用、全部。
  • --user-data-format：根据以逗号分隔的用户数据格式值列表，筛选出符合条件的图片。 可用值：cloud_init，esxi_kickstart 和 ipxe。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --remote-account-id: remote.account.id 将集合筛选为 remote.account.id 属性与指定账户匹配的图片。 用户也可以提供 ACCOUNT_ID 或提供者、用户中的一个。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 image-create

创建映像。

ibmcloud is image-create IMAGE_NAME ([--file IMAGE_FILE_LOCATION --os-name OPERATING_SYSTEM_NAME [--encrypted-data-key ENCRYPTED_DATA_KEY --encryption-key ENCRYPTION_KEY]] | [--source-volume SOURCE_VOLUME --encryption-key-volume ENCRYPTION_KEY_VOLUME]) [--allowed-use-api-version, --au-api-version ALLOWED_USE_API_VERSION, AU_API_VERSION] [--allowed-use-bare-metal-server, --au-bms ALLOWED_USE_BARE_METAL_SERVER, AU_BMS] [--allowed-use-instance, --au-ins ALLOWED_USE_INSTANCE, AU_INS] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--deprecate-at DEPRECATE_AT] [--obsolete-at OBSOLETE_AT] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is image-create my-ubuntu-16-amd64 --file cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2 --os-name ubuntu-16-amd64
  • ibmcloud is image-create my-ubuntu-16-amd64 --file cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2 --os-name ubuntu-16-amd64 --resource-group-id fee82deba12e4c0fb69c3b09d1f12345
  • ibmcloud is image-create my-ubuntu-16-amd64 --file cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2 --os-name ubuntu-16-amd64 --resource-group-name Default
  • ibmcloud is image-create my-ubuntu-16-amd64 --file cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2 --os-name ubuntu-16-amd64 --output JSON
  • ibmcloud is image-create my-ubuntu-16-amd64 --file cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2 --os-name ubuntu-16-amd64 --encrypted-data-key eyJjaXBoZXJ0ZXh0IjoiSFVBS1VxTFFzUVhVRytTdElxTENDS3BjQjZ5Qm9HWlMxOVU9IiwiaXYiOiIxVXdNeTFTNG9odHVOWmJPIiwidmVyc2lvbiI6IjQuMC4wIiwiaGFuZGxlIjoiMWU5MzNkY2QtYjczMi00MDY3LWEyNTUtZDg5MzMxMTdmZGZmIn0= --encryption-key crn:v1:bluemix:public:kms:us-south:a/823bd195e9fd4f0db40ac2e1bffef3e0:2479bd12-1e8e-4506-88d9-bdb9512ac317:key:404f662d-1e18-40b1-aabf-d6c25bca22ea
  • ibmcloud is image-create my-image-from-volume --source-volume r006-c95c2317-6336-45b4-b67d-087312895a4e
  • ibmcloud is image-create my-image-from-volume --source-volume r006-c95c2317-6336-45b4-b67d-087312895a4e --encryption-key-volume crn:v1:bluemix:public:kms:us-south:a/823bd195e9fd4f0db40ac2e1bffef3e0:2479bd12-1e8e-4506-88d9-bdb9512ac317:key:404f662d-1e18-40b1-aabf-d6c25bca22ea
  • ibmcloud is image-create my-image-from-volume --source-volume r006-c95c2317-6336-45b4-b67d-087312895a4e --deprecate-at "2023-03-01T00:45:00Z" --obsolete-at "2023-03-02T00:50:00Z"
  • ibmcloud is image-create my-ubuntu-16-amd64 --file cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2 --os-name ubuntu-16-amd64 --allowed-use-api-version "2024-10-29" --allowed-use-bare-metal-server "enable_secure_boot==true" --allowed-use-instance true
  • ibmcloud is image-create my-image-from-volume --source-volume r006-c95c2317-6336-45b4-b67d-087312895a4e --allowed-use-api-version "2024-10-29" --allowed-use-bare-metal-server "enable_secure_boot==true" --allowed-use-instance true

命令选项

  • IMAGE_NAME：图像名称。
  • --file：图像文件在云对象存储（COS）中的位置，例如：cos://us-south/custom-image-vpc-bucket/customImage-0.qcow2.
  • --os-name：此镜像所对应的操作系统名称。
  • --encrypted-data-key：一个 base64-encoded，即用于加密该镜像数据的密钥的加密表示形式。
  • --encryption-key：用于对数据密钥进行封装的根密钥的 CRN（该数据密钥最终表示为 encrypted_data_key ）。 此外，根密钥用于加密基于此映像创建的卷（除非在创建卷时提供了其他加密密钥 ）。
  • --source-volume：卷的 ID 或名称。 用于创建映像的卷。 指定的卷必须源自映像。 该卷的“active”和“busy”属性值必须为 false，且与该卷关联的实例必须处于已停止状态。
  • --encryption-key-volume：指向用于封装镜像中系统生成的数据加密密钥的根密钥的引用。 如果未提供此属性，那么将使用源卷中的根密钥。
  • --allowed-use-api-version、--au-api-version：用于评估表达式的 API 版本。
  • --allowed-use-bare-metal-server: true,--au-bms true - 使用此镜像进行配置的裸机服务器必须满足的属性条件。 如果未指定，则表达式将被设置为 true。
  • --allowed-use-instance: true,--au-ins true - 使用此镜像进行配置的虚拟服务器实例的属性必须满足的表达式。 如果未指定，则表达式将被设置为 true。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --deprecate-at：为该镜像设置的弃用日期和时间。 日期和时间不得在过去，并且必须早于“obsolete_at”。 日期和时间必须采用 ISO 8601 格式：2024-03-05T15:31:50.701Z 或 2024-03-05T15:31:50.701+8:00。
  • --obsolete-at：要为该镜像设置的过期日期和时间。 日期和时间不得在过去，并且必须晚于“deprecate_at”。 日期和时间必须采用 ISO 8601 格式：2024-03-05T15:31:50.701Z 或 2024-03-05T15:31:50.701+8:00。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 image-update

更新映像。

ibmcloud is image-update IMAGE --name NEW_NAME [--allowed-use-api-version, --au-api-version ALLOWED_USE_API_VERSION, AU_API_VERSION] [--allowed-use-bare-metal-server, --au-bms ALLOWED_USE_BARE_METAL_SERVER, AU_BMS] [--allowed-use-instance, --au-ins ALLOWED_USE_INSTANCE, AU_INS] [--deprecate-at DEPRECATE_AT | --reset-deprecate-at] [--obsolete-at OBSOLETE_AT | --reset-obsolete-at] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is image-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name my-image
  • ibmcloud is image-update my-image-from-volume-cli --name my-image-from-volume-cli-do-not-delete --obsolete-at "2023-03-02T04:20:00+05:30"
  • ibmcloud is image-update my-image-from-volume-cli-do-not-delete --deprecate-at "2023-03-03T04:20:00+05:30"
  • ibmcloud is image-update my-image-from-volume-cli-do-not-delete --reset-deprecate-at
  • ibmcloud is image-update my-image-from-volume-cli-do-not-delete --reset-obsolete-at
  • ibmcloud is image-update my-image-from-volume-cli-do-not-delete --allowed-use-api-version "2024-10-31" --allowed-use-bare-metal-server enable_secure_boot==true --allowed-use-instance true

命令选项

  • IMAGE：图像的ID或名称。
  • --name：镜像的新名称。
  • --allowed-use-api-version、--au-api-version：用于评估表达式的 API 版本。
  • --allowed-use-bare-metal-server, --au-bms：使用此镜像进行配置的裸机服务器必须满足的条件。
  • --allowed-use-instance、--au-ins：使用此镜像部署的虚拟服务器实例必须满足的条件。
  • --deprecate-at：为该镜像设置的弃用日期和时间。 日期和时间不得在过去，并且必须早于“obsolete_at”。 日期和时间必须采用 ISO 8601 格式：2024-03-05T15:31:50.701Z 或 2024-03-05T15:31:50.701+8:00。
  • --reset-deprecate-at：指定此标志可删除现有的弃用日期和时间。 如果映像状态为“不推荐”，那么将变为“可用”。
  • --obsolete-at：要为该镜像设置的过期日期和时间。 日期和时间不得在过去，并且必须晚于“deprecate_at”。 日期和时间必须采用 ISO 8601 格式：2024-03-05T15:31:50.701Z 或 2024-03-05T15:31:50.701+8:00。
  • --reset-obsolete-at：指定此标志可删除现有的过期日期和时间。 如果映像状态为“过时”，那么当“deprecate_at” 为过去的时间时，将变为“不推荐”。 否则，将变为“可用”。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is image-删除

删除一个或多个映像。

ibmcloud is image-delete (IMAGE1 IMAGE2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • IMAGE1：图片的ID或名称。
  • IMAGE2：图像的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 image-export-job

查看图像导出任务的详细信息。

ibmcloud is image-export-job IMAGE JOB [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is image-export-job 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 6451a2e-d6c5-42b4-97b0-b5f8e8d1f479
  • ibmcloud is image-export-job my-image my-export-job

命令选项

  • IMAGE：图像的ID或名称。
  • JOB：图像导出任务的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 image-export-jobs

列出某张图片的所有导出任务。

ibmcloud is image-export-jobs IMAGE [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is image-export-jobs 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479
  • ibmcloud is image-export-jobs my-image

命令选项

  • IMAGE：图像的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 image-export-job-create

创建一个图像导出任务。

ibmcloud is image-export-job-create IMAGE --bucket BUCKET [--name NEW_NAME] [--format qcow2 | vhd] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is image-export-job-create 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name my-export-job --format qcow2 --bucket my-bucket
  • ibmcloud is image-export-job-create my-image --name my-export-job --format qcow2 --bucket my-bucket

命令选项

  • IMAGE：图像的ID或名称。
  • --name：镜像导出任务的新名称。
  • --format：导出图像时使用的格式。 如果映像已加密，那么仅支持 qcow2。 qcow2，vhd 之一。(缺省值: qcow2)。
  • --bucket：用于导出镜像的 Cloud Object Storage 存储桶。 该存储区必须存在，并且 IAM 服务授权必须向 VPC 基础结构服务写入器的 VPC 映像服务授予对该存储区的访问权。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 image-export-job-update

更新图像导出任务。

ibmcloud is image-export-job-update IMAGE JOB --name NAME [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is image-export-job-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 6451a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name my-image-export-job
  • ibmcloud is image-export-job-update my-image my-export-job --name my-image-export-job

命令选项

  • IMAGE：图像的ID或名称。
  • JOB：图像导出任务的 ID 或名称。
  • --name: 镜像导出任务的名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 image-export-job-delete

删除一个或多个图像导出任务。

ibmcloud is image-export-job-delete IMAGE (JOB1 JOB2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is image-export-job-delete 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 6451a2e-d6c5-42b4-97b0-b5f8e8d1f479
  • ibmcloud is image-export-job-delete my-image my-export-job

命令选项

  • IMAGE：图像的ID或名称。
  • JOB1：图像导出任务的ID或名称。
  • JOB2：图像导出任务的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is image-不推荐使用

弃用映像。

ibmcloud is image-deprecate IMAGE [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is image-deprecate my-image-from-volume-cli-do-not-delete

命令选项

  • IMAGE：图像的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is image-过时

使映像过时。

ibmcloud is image-obsolete IMAGE [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is image-obsolete my-image-from-volume-cli-do-not-delete

命令选项

  • IMAGE：图像的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 image-instance-profiles

列出与映像兼容的实例概要文件。

ibmcloud is image-instance-profiles IMAGE [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is image-instance-profiles my-image-from-volume-cli-do-not-delete
  • ibmcloud is image-instance-profiles my-image-from-volume-cli-do-not-delete --output JSON
  • ibmcloud is image-instance-profiles r134-064dcec0-5e15-42cf-8b28-a9d27f9cd751
  • ibmcloud is image-instance-profiles r134-064dcec0-5e15-42cf-8b28-a9d27f9cd751 --output JSON

命令选项

  • IMAGE：图像的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 裸机服务器配置文件

列出与映像兼容的裸机服务器概要文件。

ibmcloud is image-bare-metal-server-profiles IMAGE [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is image-bare-metal-server-profiles my-image
  • ibmcloud is image-bare-metal-server-profiles my-image --output JSON
  • ibmcloud is image-bare-metal-server-profiles r134-064dcec0-5e15-42cf-8b28-a9d27f9cd751
  • ibmcloud is image-bare-metal-server-profiles r134-064dcec0-5e15-42cf-8b28-a9d27f9cd751 --output JSON

命令选项

  • IMAGE：图像的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 catalog-image-offering

列出所有目录图片资源。

ibmcloud is catalog-image-offerings [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is catalog-image-offerings

命令选项

  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 catalog-image-offering

获取目录映像产品。

ibmcloud is catalog-image-offering CATALOG OFFERING [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is catalog-image-offering 2497ae83-40cb-46ba-ac7f-5303514a2669 54372a73-7a0a-4799-ac9c-8736620c67f1

命令选项

  • 目录：目录的ID。
  • 供品：供品的标识符。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

实例

ibmcloud 是实例

查看虚拟服务器实例的详细信息。

ibmcloud is instance INSTANCE [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is instance-init-values

查看虚拟实例的初始化详细信息。

ibmcloud is instance-initialization-values INSTANCE [--private-key (KEY | @KEY_FILE) [--private-key-passphrase PRIVATE_KEY_PASSPHRASE]] [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • -- private-key: key|@key-file。 用于解密密码的 PEM 格式的专用密钥。
  • --private-key-passphrase：加密私钥的密码短语。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is instances

列出所有虚拟服务器实例。

ibmcloud is instances [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--reservation RESERVATION] [--vpc VPC] [--ig IG] [--availability-class spot | standard] [--dh DH] [--pg PG] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --reservation：预订的ID或名称。
  • --vpc：VPC 的 ID、名称或 CRN。
  • --ig：实例组的 ID、名称或 CRN。
  • --availability-class：虚拟服务器实例的可用性类。 其中之一：斑点、标准。
  • --dh：专用主机的 ID、名称或 CRN。
  • --pg：实习组的ID、名称或CRN。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是实例控制台

打开虚拟服务器实例的交互式控制台。 缺省情况下，此命令将打开交互式串行控制台。

ibmcloud is instance-console INSTANCE [--vnc] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • --vnc：获取 VNC 控制台的 WebSocket URI，并在该实例的浏览器中打开 IBM Cloud 网页 VNC 控制台。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 实例创建

创建虚拟服务器实例。

ibmcloud is instance-create INSTANCE_NAME VPC ZONE_NAME PROFILE_NAME SUBNET (([--pnac-name PRIMARY_NAC_NAME] [--pnac-vni PNAC_VNI | (--pnac-vni-ais false | true --pnac-vni-ein true | false --pnac-vni-auto-delete true | false --pnac-vni-ips VNI_RESERVED_IPS_JSON | @VNI_RESERVED_IPS_JSON_FILE --pnac-vni-name PNAC_VNI_NAME [--pnac-vni-rip PNAC_VNI_RIP | (--pnac-vni-rip-address PNAC_VNI_RIP_ADDRESS --pnac-vni-rip-auto-delete true | false --pnac-vni-rip-name PNAC_VNI_RIP_NAME)] --pnac-vni-sgs PNAC_VNI_SGS [--pnac-vni-psfm auto | enabled | disabled])] [--network-attachments NETWORK_ATTACHMENTS_JSON | @NETWORK_ATTACHMENTS_JSON_FILE]) | [([--rip RIP | (--address ADDRESS --auto-delete true | false --ip-name IP_NAME)] [--allow-ip-spoofing false | true]) | --primary-network-interface PRIMARY_NETWORK_INTERFACE_JSON | @PRIMARY_NETWORK_INTERFACE_JSON_FILE] [--network-interface NETWORK_INTERFACE_JSON | @NETWORK_INTERFACE_JSON_FILE]) [--image IMAGE | (--catalog-offering CATALOG_OFFERING | --catalog-offering-version CATALOG_OFFERING_VERSION) [--catalog-offering-plan CATALOG_OFFERING_PLAN]] [--total-volume-bandwidth TOTAL_VOLUME_BANDWIDTH] [--boot-volume BOOT_VOLUME_JSON | @BOOT_VOLUME_JSON_FILE] [--volume-attach VOLUME_ATTACH_JSON | @VOLUME_ATTACH_JSON_FILE] [--keys KEYS] [--dedicated-host DEDICATED_HOST | --dedicated-host-group DEDICATED_HOST_GROUP | --placement-group PLACEMENT_GROUP] [--reservation-affinity-policy, --res-policy disabled | manual | automatic] [--reservation-affinity-pool, --res-pool RESERVATION_AFFINITY_POOL] [--user-data DATA] [--sgs SGS] [--default-trusted-profile DEFAULT_TRUSTED_PROFILE [--default-trusted-profile-auto-link true,false]] [--metadata-service, --ms true | false [--metadata-service-protocol, --msp http | https | --metadata-service-response-hop-limit, --msrhl METADATA_SERVICE_RESPONSE_HOP_LIMIT,MSRHL]] [--host-failure-policy restart | stop] [--confidential-compute-mode disabled | sgx | tdx] [--enable-secure-boot true | false] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [[--cluster-network-attachments CLUSTER_NETWORK_ATTACHMENTS_JSON | @CLUSTER_NETWORK_ATTACHMENTS_JSON_FILE]] [--volume-bandwidth-qos-mode pooled | weighted] [--vcpu-percentage VCPU_PERCENTAGE] [--availability-class spot | standard] [--preemption-policy delete | stop] [--threads-per-core 1 | 2] [--output JSON] [-i, --interactive] [-q, --quiet]

命令示例

  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --volume-attach '[{"volume": {"name":"my-volume-name", "capacity":10, "profile": {"name": "general-purpose"},"user_tags": ["my-tag-1"]}}]' 创建具有卷连接的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --volume-attach '[{"volume": {"name":"my-volume-name", "bandwidth":1000, "capacity":10, "profile": {"name": "general-purpose"},"user_tags": ["my-tag-1"]}}]' 创建具有卷连接和带宽的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --volume-attach '[{"volume": {"id":"67531475-bd8a-478e-bcfe-2e53365cd0aa"}}]' 创建具有卷连接中现有卷的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --keys 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8,72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 创建具有多个 SSH 密钥的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"name": "my-boot-vol", "capacity": 150, "profile": {"name": "general-purpose"}}}' 从具有引导卷容量的映像创建实例。 容量值可在映像的最小预配大小与 250 之间取值。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"name": "my-boot-vol", "profile": {"name": "general-purpose"},"user_tags": ["my-tag-1"]}}' 创建具有引导卷和含用户标记的引导卷的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"profile": {"name": "general-purpose"},"encryption_key": {"crn": "crn:v1:bluemix:public:kms:us-south:adffc98a0f1f0f95f6613b3b752286b87:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"}}}' 创建具有加密引导卷的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"bandwidth":1000, "profile": {"name": "general-purpose"},"encryption_key": {"crn": "crn:v1:bluemix:public:kms:us-south:adffc98a0f1f0f95f6613b3b752286b87:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"}}}' 创建具有加密引导卷和带宽的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --network-interface '[{"name": "secondary-nic", "allow_ip_spoofing": true, "subnet": {"id":"72b27b5c-f4b0-48bb-b954-5becc7c1dcb3"}, "security_groups": [{"id": "72b27b5c-f4b0-48bb-b954-5becc7c1dcb8"}, {"id": "72b27b5c-f4b0-48bb-b954-5becc7c1dcb3"}]}]' 创建连接到辅助网络接口的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --primary-network-interface '{"name": "primary-nic", "allow_ip_spoofing": true, "subnet": {"id":"72b27b5c-f4b0-48bb-b954-5becc7c1dcb3"}, "primary_ip": {"address": "10.240.129.10", "auto-delete": true, "name": "my-reserved-ip"}, "security_groups": [{"id": "72b27b5c-f4b0-48bb-b954-5becc7c1dcb8"}, {"id": "72b27b5c-f4b0-48bb-b954-5becc7c1dcb3"}]}' 使用 JSON 格式的主网络接口配置创建实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --sgs 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8,72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --address 10.240.129.10 --auto-delete true --ip-name my-reserved-ip --allow-ip-spoofing true 使用包含安全组、保留 IP 设置和源 IP 防电子欺骗设置的主网络接口配置创建实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --sgs 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8,72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --reserved-ip 0711-5c7f016e-5bd2-42e3-8dff-81519e4e2469 --allow-ip-spoofing true 使用包含安全组、现有保留 IP 和源 IP 防电子欺骗设置的主网络接口配置创建实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --dedicated-host c019b1f7-c4d6-430c-aaa4-e0cc25d47277 创建要放置在所需专用主机中的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --dedicated-host-group a4738ceb-5e59-4601-849a-61d7895740ee 创建要放置在所需专用主机组中的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --placement-group 1d2afa0f-b9f2-4d85-ae35-a08885269644 创建要放置在所需放置组中的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --total-volume-bandwidth 4000 创建具有特定卷总带宽的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --metadata-service true 创建已启用或禁用元数据服务的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --metadata-service true --metadata-service-protocol http --metadata-service-response-hop-limit 60 使用元数据服务配置创建实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --reservation-affinity-policy manual --reservation-affinity-pool r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 创建具有预留亲缘关系的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --reservation-affinity-policy manual --reservation-affinity-pool crn:v1:bluemix:public:is:us-south:a/123456::vpc:4727d842-f94f-4a2d-824a-9bc9b02c523b 创建具有预留亲缘关系的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --default-trusted-profile Profile-c9fe8182-870a-49df-8308-c8bb7394c4c3 --default-trusted-profile-auto-link true 使用缺省可信概要文件创建实例
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --host-failure-policy restart 使用主机故障时的可用性策略创建实例。
  • ibmcloud is instance-create my-instance-name my-vpc us-south-1 bx2-2x8 my-subnet --image ibm-ubuntu-20-04-2-minimal-amd64-1 --volume-attach '[{"volume": {"name":"my-vol-1"}}]' 借助资源名称，创建具有卷连接中现有卷的实例。
  • ibmcloud is instance-create my-instance-name my-vpc us-south-1 mx2-2x16 my-subnet --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --dedicated-host my-dedicated-host 借助资源名称，创建要放置在所需专用主机中的实例。
  • ibmcloud is instance-create my-instance-name my-vpc us-south-1 mx2-2x16 my-subnet --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --dedicated-host-group my-dedicated-host-group 借助资源名称，创建要放置在所需专用主机组中的实例。
  • ibmcloud is instance-create my-instance-name my-vpc us-south-1 mx2-2x16 my-subnet --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --placement-group my-placement-host-group 借助资源名称，创建要放置在所需放置组中的实例。
  • ibmcloud is instance-create my-instance-name my-vpc us-south-1 bx2-2x8 --image ibm-ubuntu-20-04-2-minimal-amd64-1 --primary-network-interface '{"name": "primary-nic", "allow_ip_spoofing": true, "subnet": {"name":"my-subnet"}, "primary_ip": {"name": "my-reserved-ip"}, "security_groups": [{"name": "my-security-group-1"}, {"name": "my-security-group-2"}]}' 借助资源名称，使用主网络接口配置创建实例。
  • ibmcloud is instance-create my-instance-name my-vpc us-south-1 bx2-2x8 my-subnet --image ibm-ubuntu-20-04-2-minimal-amd64-1 --network-interface '[{"name": "secondary-nic", "allow_ip_spoofing": true, "subnet": {"id":"my-subnet"}, "security_groups": [{"id": "my-security-group-1"}, {"id": "my-security-group-2"}]}]' 借助资源名称，创建连接到辅助网络接口的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"id": "67531475-bd8a-478e-bcfe-2e53365cd0aa"}}' 从现有引导卷创建实例。
  • ibmcloud is instance-create my-instance-name my-vpc us-south-1 bx2-2x8 my-subnet --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"name": "my-existing-boot-vol"}}' 使用资源名称从现有引导卷创建实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --catalog-offering crn:v1:bluemix:public:globalcatalog-collection:global:a/efe5afc483594adaa8325e2b4d1290df:2497ae83-40cb-46ba-ac7f-5303514a2669:offering:54372a73-7a0a-4799-ac9c-8736620c67f1 从目录产品创建实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --catalog-offering-version crn:v1:bluemix:public:globalcatalog-collection:global:a/efe5afc483594adaa8325e2b4d1290df:2497ae83-40cb-46ba-ac7f-5303514a2669:offering:54372a73-7a0a-4799-ac9c-8736620c67f1 从目录产品版本创建实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --catalog-offering-version crn:v1:bluemix:public:globalcatalog-collection:global:a/efe5afc483594adaa8325e2b4d1290df:2497ae83-40cb-46ba-ac7f-5303514a2669:offering:54372a73-7a0a-4799-ac9c-8736620c67f1 --catalog-offering-plan crn:v1:bluemix:public:globalcatalog-collection:global:a/123456:51c9e0db-2911-45a6-adb0-ac5332d27cf2:plan:sw.51c9e0db-2911-45a6-adb0-ac5332d27cf2.772c0dbe-aa62-482e-adbe-a3fc20101e0e 从目录产品版本和计划创建实例。
  • ibmcloud is instance-create --interactive 以交互方式创建实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --pnac-name cli-pnac-1 --pnac-vni 7322-1293a27a-7178-4e62-ba5b-272623c989aa --network-attachments [{"name": "instance-snac-1","virtual_network_interface": {"id":"02h7-56705448-c9d9-43dc-aa11-20d42333cd87"}}] --image --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 创建具有网络连接和现有虚拟网络接口的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --pnac-name cli-pnac-1 --pnac-vni-ais true --pnac-vni-ein true --pnac-vni-auto-delete true --pnac-vni-ips [{"id": "7322-f61b85bd-d963-4069-bb72-b58ed9ebc9f5"}] --pnac-vni-name cli-panc-vni-1 --pnac-vni-rip bee-olympics-perplexed-briskness --network-attachments [{"name": "instance-snac-1","virtual_network_interface": {"id":"02h7-56705448-c9d9-43dc-aa11-20d42333cd87"}}] 使用现有保留 IP 创建具有网络连接和新的虚拟网络接口的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --pnac-name cli-pnac-1 --pnac-vni-ais true --pnac-vni-ein true --pnac-vni-auto-delete true --pnac-vni-ips [{"id": "7322-f61b85bd-d963-4069-bb72-b58ed9ebc9f5"},{"address": "10.240.128.13", "auto_delete" : true, "name": "vni-pnac-sip-1"}] --pnac-vni-name cli-panc-vni-1 --pnac-vni-rip-address 10.240.128.13 --pnac-vni-rip-auto-delete true --pnac-vni-rip-name pnac-vni-rip-1 --pnac-vni-sgs r134-8e0e4ad9-4ca3-4d5f-b9d8-7a967693d231 使用现有保留 IP 创建具有网络连接和新的虚拟网络接口的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --cluster-network-attachments '[{"name": "instance-cnac-1","cluster_network_interface": {"id":"02h7-56705448-c9d9-43dc-aa11-20d42333cd87"}}]' 使用具有现有预留 IP 的现有集群网络接口的集群网络连接，创建实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --cluster-network-attachments '[{"name":"cli-cnac-1", "cluster_network_interface": {"auto_delete": true, "name": "cni-1", "primary_ip": { "auto-delete": true, "name": "my-reserved-ip"}, "subnet": "72b27b5c-f4b0-48bb-b954-5becc7c1dcb8"}}]' 使用集群网络连接创建实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --volume-bandwidth-qos-mode pooled 创建采用特定卷带宽 QoS 方式的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --vcpu-percentage 50 创建一个具有共享核心的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --availability-class spot --preemption-policy stop 创建竞价实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 hx4da-8x32 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --threads-per-core 1 创建一个每核一个线程的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 hx4da-8x32 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --threads-per-core 2 创建一个每核一个线程的实例。
  • ibmcloud is instance-create my-instance-name my-vpc us-south-1 bx2-2x8 my-subnet --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"name": "boot-vol-name", "capacity": 150, "profile": {"name": "general-purpose"}, "source_snapshot": {"id": "150847e3-ef0d-4927-9341-6d0a7bae424f"}}}' 从具有引导卷容量的快照创建实例。 容量值可在快照的最小容量与250之间取值。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"name": "boot-vol-name", "profile": {"name": "general-purpose"}, "source_snapshot": {"id": "150847e3-ef0d-4927-9341-6d0a7bae424f"}}}' 从卷快照创建具有引导卷连接的实例。
  • ibmcloud is instance-create my-instance-name my-vpc us-south-1 bx2-2x8 my-subnet --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --volume-attach '[{"volume": {"name":"my-volume-name", "profile": {"name": "general-purpose"}, "source_snapshot": {"name": "my-snapshot-name"}}}]' 借助资源名称，从卷快照创建具有卷连接的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --volume-attach '[{"volume": {"name":"my-volume-name", "capacity":10, "profile": {"name": "general-purpose"}, "source_snapshot": {"id": "150847e3-ef0d-4927-9341-6d0a7bae424f"}}}]' 从卷快照创建具有卷连接的实例。
  • ibmcloud is instance-create my-instance-name my-vpc us-south-1 bx2-2x8 my-subnet --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"name": "boot-vol-name", "profile": {"name": "general-purpose"}, "source_snapshot": {"name": "my-snapshot-name"}}}' 借助资源名称，从卷快照创建具有引导卷连接的实例。
  • ibmcloud is instance-create my-instance-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 my-subnet --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"name": "boot-vol-name", "profile": {"name": "general-purpose"}, "source_snapshot": {"name": "test-cli"}, "allowed_use":{"instance":"true","bare_metal_server":"true","api_version":"2025-06-30"}}}' --volume-attach '[{"volume": {"name":"my-volume-name", "capacity":100, "profile": {"name": "general-purpose"}, "source_snapshot": {"id": "r006-523cf6c7-0591-43b9-b4ff-6663791e2814"}, "allowed_use":{"instance":"true","bare_metal_server":"true","api_version":"2025-06-30"}}}]' 创建一个允许在启动卷和卷挂载中使用的实例。

命令选项

  • INSTANCE_NAME：实例名称。
  • VPC：VPC 的 ID 或名称。 使用命令 'ibmcloud is vpcs' 来获取 VPC。
  • ZONE_NAME：区域名称。 使用命令 'ibmcloud is zones' 来获取可用专区。
  • PROFILE_NAME：配置文件的名称。 使用命令 'ibmcloud is instance-profiles' 来获取实例概要文件。
  • 子网：子网的 ID 或名称。 使用命令 'ibmcloud is subnets' 来获取子网标识或名称。
  • --image：图片的ID或名称。
  • --catalog-offering：IBM Cloud 产品目录条目的 CRN。 如果指定了此选项，那么将使用该产品的最新版本。 有关创建目录商品的更多信息，请参阅 “将软件接入您的账户”。
  • --catalog-offering-version：IBM Cloud 目录产品版本的 CRN。 有关为目录产品创建版本的更多信息，请参阅《 将软件接入您的账户 》。
  • --catalog-offering-plan：IBM Cloud 目录产品计费方案的 CRN。 如果未指定，则不使用计费套餐（免费）。 必须为需要计费套餐的目录产品版本指定。
  • --total-volume-bandwidth：专门分配给实例存储卷的带宽量（单位为兆比特每秒）。 此值的增加将导致网络总带宽相应降低。
  • --boot-volume: BOOT_VOLUME_JSON|@BOOT_VOLUME_JSON_FILE，以 JSON 或 JSON 文件形式指定的启动卷挂载。 有关数据模式，请参阅 API 文档 中的 boot_volume_attachment 属性。
  • --volume-attach: VOLUME_ATTACH_JSON|@VOLUME_ATTACH_JSON_FILE，以 JSON 或 JSON 文件形式指定的卷挂载信息，包含卷列表。 有关数据模式，请参阅 API 文档 中的 volume_attachments 属性。
  • --keys：以逗号分隔的 SSH 密钥的 ID 或名称。 SSH 密钥可以是 RSA 或 Ed25519 密钥。 仅当操作系统支持此密钥类型时，才能使用 Ed25519。 Ed25519 不能与 Windows 或 VMware 映像配合使用。
  • --dedicated-host：实例所在的目标主机的 ID 或名称。
  • --dedicated-host-group：实例所属的主机组目标的 ID 或名称。
  • --placement-group：放置组的 ID 或名称。 虚拟服务器实例的放置组限制。
  • --reservation-affinity-policy, --res-policy：此虚拟服务器实例应采用的预留亲和性策略。 如果池不为空，策略缺省为“手动”。 如果设置了放置目标，则策略缺省为“禁用”。 在所有其他情况下，策略缺省为“自动”。 其中之一：禁用、手动、自动。
  • --reservation-affinity-pool，--res-pool： 该虚拟服务器实例可使用的预留资源的 ID、名称或 CRN。
  • --user-data: data|@data-file. 要传输到虚拟服务器实例的用户数据。
  • --rip：现有保留 IP 的 ID 或名称。
  • --address：要预留的 IP 地址，该地址在子网中不得已被预留。
  • --auto-delete：如果设置为 true，则当目标被删除时，该预留 IP 地址将自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --ip-name：此预留 IP 的用户自定义名称。 名称在预留 IP 所在的子网中必须是唯一的。 以 ibm- 开头的名称专用于服务商自有资源。
  • --allow-ip-spoofing：禁用该接口上的源地址和目标地址检查。 如果为false，则不允许在此接口上进行源IP欺骗。 其中一个: false，true。
  • --primary-network-interface: PRIMARY_NETWORK_INTERFACE_JSON|@PRIMARY_NETWORK_INTERFACE_JSON_FILE，以 JSON 或 JSON 文件形式指定的主网络接口。 有关数据模式，请参阅 API 文档 中的 primary_network_interface 属性。
  • --network-interface: NETWORK_INTERFACE_JSON|@NETWORK_INTERFACE_JSON_FILE，以 JSON 或 JSON 文件格式指定的网络接口绑定。 有关数据模式，请参阅 API 文档 中的 network_interfaces 属性。
  • --pnac-name：主网络连接的名称。
  • --pnac-vni：与主网络连接关联的虚拟网络接口的 ID 或名称。
  • --pnac-vni-ais：允许 IP 欺骗（AIS）。 指示与主网络连接关联的此虚拟网络接口上是否允许源 IP 电子欺骗。 其中一个: false，true。(缺省值: false)。
  • --pnac-vni-ein：启用基础设施 NAT（EIN）。 如果属实，VPC 基础设施将对 VNI 执行任何必要的 NAT 操作。 要将 VNI 连接到实例，该值必须为 true。 Floating_ips 不得具有多个浮动 IP。 如果为false，则数据包在发往或来自VNI时不会被修改，从而允许VNI执行任何必要的NAT操作。 Allow_ip_spoofing 必须为 false。 只能连接到 resource_type 为 bare_metal _server_network_attachment 的目标。 下列其中一项: true 和 false。(缺省值: true)。
  • --pnac-vni-auto-delete：指示与主网络连接关联的此虚拟网络接口是否会在目标被删除时自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --pnac-vni-ips: VNI_RESERVED_IPS_JSON | @VNI_RESERVED_IPS_JSON_FILE，用于绑定到虚拟网络接口的备用预留 IP 地址，格式为 JSON 或 JSON 文件。 有关数据模式，请参阅 API 文档 中的 IPS 属性。 其中一个: VNI_RESERVED_IPS_JSON，@VNI_RESERVED_IPS_JSON_FILE。
  • --pnac-vni-name：与主网络连接关联的此虚拟网络接口的名称。
  • --pnac-vni-rip：要绑定到与主网络连接关联的虚拟网络接口的保留 IP 的 ID 或名称。
  • --pnac-vni-rip-address：用于绑定到与主网络连接关联的虚拟网络接口的预留 IP 地址。
  • --pnac-vni-rip-auto-delete：指示当任一目标被删除，或者该保留 IP 地址被解除绑定时，该保留 IP 地址是否会自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --pnac-vni-rip-name：此保留 IP 地址的名称，用于将其绑定到与主网络连接关联的虚拟网络接口。
  • --pnac-vni-sgs：用于虚拟网络接口的安全组的 ID 或名称（以逗号分隔），这些安全组与主网络连接相关联。
  • --pnac-vni-psfm：此虚拟网络接口应采用的协议状态过滤模式。 如果设置为“自动”，则协议状态数据包过滤功能是否启用或禁用，取决于虚拟网络接口的 target 资源类型。 其中一个: auto，enabled，disabled。(缺省值: auto)。
  • -- network-Attachment: NETWORK_ATTACHMENTS_JSON |@NETWORK_ATTACHMENTS_JSON_FILE。 网络附件配置在 JSON 或 JSON 文件中。 有关数据模式，请参阅 API 文档 中的 network_attachments 属性。 NETWORK_ATTACHMENTS_JSON，@NETWORK_ATTACHMENTS_JSON_FILE 之一。
  • --sgs：主网络接口或主网络连接的以逗号分隔的安全组 ID 或名称。
  • --default-trusted-profile：受信任配置文件的 ID 或名称。
  • --default-trusted-profile-auto-link：如果设置为 true，系统将在实例创建过程中生成指向指定目标受信任配置文件的链接。 无论链接由系统创建还是使用 IAM 身份服务手动创建，它都会在删除实例时自动进行删除。 下列其中一项: true，false。(缺省值: true)。
  • --metadata-service, --ms：启用或禁用实例元数据服务。 以下选项之一：true、false。
  • --metadata-service-protocol，--msp：元数据服务端点的通信协议。 仅当启用了元数据服务时，协议才适用。 http 和 https 之一。(缺省值: http)。
  • --metadata-service-response-hop-limit，--msrhl： 元数据服务返回的 IP 响应数据包的跳数限制（IP 生存时间）。
  • --host-failure-policy：当计算主机发生故障时应执行的操作。 其中一个: restart，stop。(缺省值: restart)。
  • --confidential-compute-mode：此虚拟服务器实例要使用的机密计算模式。 如果未指定，那么将使用概要文件中的缺省保密计算方式。 残疾、SGX、TDX 其中之一。
  • --enable-secure-boot：指示此虚拟服务器实例是否启用了安全启动。 如果未指定，那么将使用概要文件中的缺省安全引导方式。 以下选项之一：true、false。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --cluster-network-attachments：cluster_network_attachments_json|@cluster_network_attachments_json_file。 集群网络连接配置位于 JSON 或 JSON 文件中。 有关数据模式，请参阅 API 文档 中的 cluster_network_attachments 属性。 有关群集网络的更多信息，请参阅“群集网络”。 以下之一：CLUSTER_NETWORK_ATTACHMENTS _JSON ，@CLUSTER_NETWORK_ATTACHMENTS_JSON_FILE。
  • --volume-bandwidth-qos-mode：此虚拟服务器实例应采用的卷带宽 QoS 模式。 必须在实例概要文件的 volume_bandwidth_qos_modes 中列出指定的值。 其中之一：集合、加权。
  • --vcpu-percentage：分配给该实例的 vCPU 时钟周期的百分比。 范围为 1-100。
  • --availability-class：虚拟服务器实例的可用性类。 其中之一：斑点、标准。
  • --preemption-policy：当虚拟服务器实例被抢占时应执行的操作。 其中之一是：删除，停止。
  • --threads-per-core：此虚拟服务器实例的每核线程数。 如果未指定，则使用配置文件的默认值。 其中一个: 1，2。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --interactive, -i：
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-create-from-template

根据实例模板创建一个虚拟服务器实例。

ibmcloud is instance-create-from-template --template TEMPLATE (([--pnac-name PRIMARY_NAC_NAME] [--pnac-vni PNAC_VNI | ((--pnac-vni-subnet PNAC_VNI_SUBNET [--vpc VPC]) --pnac-vni-ais false | true --pnac-vni-ein true | false --pnac-vni-auto-delete true | false --pnac-vni-ips VNI_RESERVED_IPS_JSON | @VNI_RESERVED_IPS_JSON_FILE --pnac-vni-name PNAC_VNI_NAME [--pnac-vni-rip PNAC_VNI_RIP | (--pnac-vni-rip-address PNAC_VNI_RIP_ADDRESS --pnac-vni-rip-auto-delete true | false --pnac-vni-rip-name PNAC_VNI_RIP_NAME)] --pnac-vni-sgs PNAC_VNI_SGS [--pnac-vni-psfm auto | enabled | disabled])] [--network-attachments NETWORK_ATTACHMENTS_JSON | @NETWORK_ATTACHMENTS_JSON_FILE]) | (--subnet SUBNET [--rip RIP | (--address ADDRESS --auto-delete true | false --ip-name IP_NAME)] [--allow-ip-spoofing false | true]) | --primary-network-interface PRIMARY_NETWORK_INTERFACE_JSON | @PRIMARY_NETWORK_INTERFACE_JSON_FILE [--network-interface NETWORK_INTERFACE_JSON | @NETWORK_INTERFACE_JSON_FILE]) [--name Name] [--profile PROFILE] [--zone ZONE] [--vpc VPC] [--image IMAGE | (--catalog-offering CATALOG_OFFERING | --catalog-offering-version CATALOG_OFFERING_VERSION) [--catalog-offering-plan CATALOG_OFFERING_PLAN]] [--total-volume-bandwidth TOTAL_VOLUME_BANDWIDTH] [--boot-volume BOOT_VOLUME_JSON | @BOOT_VOLUME_JSON_FILE] [--volume-attach VOLUME_ATTACH_JSON | @VOLUME_ATTACH_JSON_FILE] [--keys KEYS] [--dedicated-host DEDICATED_HOST | --dedicated-host-group DEDICATED_HOST_GROUP | --placement-group PLACEMENT_GROUP] [--reservation-affinity-policy, --res-policy disabled | manual | automatic] [--reservation-affinity-pool, --res-pool RESERVATION_AFFINITY_POOL] [--user-data DATA] [--sgs SGS] [--default-trusted-profile DEFAULT_TRUSTED_PROFILE [--default-trusted-profile-auto-link true,false]] [--metadata-service, --ms true | false [--metadata-service-protocol, --msp http | https | --metadata-service-response-hop-limit, --msrhl METADATA_SERVICE_RESPONSE_HOP_LIMIT,MSRHL]] [--host-failure-policy restart | stop] [--confidential-compute-mode disabled | sgx | tdx] [--enable-secure-boot true | false] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [[--cluster-network-attachments CLUSTER_NETWORK_ATTACHMENTS_JSON | @CLUSTER_NETWORK_ATTACHMENTS_JSON_FILE]] [--volume-bandwidth-qos-mode pooled | weighted] [--vcpu-percentage VCPU_PERCENTAGE] [--availability-class spot | standard] [--preemption-policy delete | stop] [--threads-per-core 1 | 2] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-create-from-template --template 0737-b7c965c7-2c26-4457-85c4-52e7156f570d
  • ibmcloud is instance-create-from-template --template 0737-b7c965c7-2c26-4457-85c4-52e7156f570d --resource-group-id 7494aacb866142fba11a88d75cb37bd8 --output JSON
  • ibmcloud is instance-create-from-template --template 0737-b7c965c7-2c26-4457-85c4-52e7156f570d --reservation-affinity-policy manual --reservation-affinity-pool r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2s
  • ibmcloud is instance-create-from-template --template 0737-b7c965c7-2c26-4457-85c4-52e7156f570d --reservation-affinity-policy manual --reservation-affinity-pool crn:v1:bluemix:public:is:us-south:a/123456::vpc:4727d842-f94f-4a2d-824a-9bc9b02c523b
  • ibmcloud is instance-create-from-template --template 0737-b7c965c7-2c26-4457-85c4-52e7156f570d --name my-instance --boot-volume '{"delete_volume_on_instance_delete": false, "name": "boot-vol-attachment-name", "volume": {"name": "myvol2", "profile": {"name": "general-purpose"}}}' 从使用引导卷配置的实例模板创建实例。
  • ibmcloud is instance-create-from-template --template 0737-b7c965c7-2c26-4457-85c4-52e7156f570d --name my-instance --vpc r006-beca4c2f-625f-45de-bd95-c8eb12f6842a --zone us-south-1 --subnet 0717-fe2e13d0-9ba8-43bd-ab6b-a1fad51557ac --address 10.240.129.10 --auto-delete true --ip-name my-reserved-ip --sgs r006-19c2ce0d-d35d-47bc-8147-120edddd3de5 --allow-ip-spoofing true 从使用主网络接口配置的实例模板创建实例。
  • ibmcloud is instance-create-from-template --template 0737-b7c965c7-2c26-4457-85c4-52e7156f570d --name my-instance --vpc r006-beca4c2f-625f-45de-bd95-c8eb12f6842a --zone us-south-1 --primary-network-interface '{"name": "primary-nic", "allow_ip_spoofing": true, "subnet": {"id":"0717-fe2e13d0-9ba8-43bd-ab6b-a1fad51557ac"}, "primary_ip": {"address": "10.240.129.10", "auto-delete": true, "name": "my-reserved-ip"}, "security_groups": [{"id": "r006-19c2ce0d-d35d-47bc-8147-120edddd3de5"}]}' 从使用 JSON 格式的主网络接口配置的实例模板创建实例。
  • ibmcloud is instance-create-from-template --template 0737-b7c965c7-2c26-4457-85c4-52e7156f570d --name my-instance --network-interface '[{"name": "secondary-nic", "allow_ip_spoofing": true, "subnet": {"id":"0737-f6b5a638-1fda-476b-9e2f-7a550fbb62b8"}, "primary_ip": {"address": "10.240.129.10", "auto-delete": true, "name": "my-reserved-ip"}, "security_groups": [{"id": "r006-caba3deb-136b-42c8-831a-1dbcc0f1912e"}]}, {"name": "third-nic", "allow_ip_spoofing": true, "subnet": {"id":"0737-6b939577-4839-47b0-b42f-a4b29a94c7d9"}, "primary_ip": {"address": "10.240.129.100", "auto-delete": true, "name": "my-reserved-ip"}, "security_groups": [{"id": "r006-caba3deb-136b-42c8-831a-1dbcc0f1912e"}]}]' 从使用第二个网络接口配置的实例模板创建实例。
  • ibmcloud is instance-create-from-template --template 0737-b7c965c7-2c26-4457-85c4-52e7156f570d --name new-instance-name --volume-attach '[{"delete_volume_on_instance_delete": false, "name": "my-volume-attachment1", "volume": {"name": "myvol2", "capacity": 200, "profile": {"name": "general-purpose"}}}, {"delete_volume_on_instance_delete": true, "name": "my-volume-attachment2", "volume": {"name": "myvol3", "capacity": 300, "iops": 1000, "profile": {"name": "custom"}}}]' 从使用数据卷配置的实例模板创建实例。
  • ibmcloud is instance-create-from-template --template 0737-b7c965c7-2c26-4457-85c4-52e7156f570d --name new-instance-name --image r006-ed3f775f-ad7e-4e37-ae62-7199b4988b00 --profile cx2-2x4 --key r006-02a07b78-6e5f-40a2-86a2-99e01916128c,r006-29e19fb1-e2b9-49d0-ab6e-9702e99f5021 --user-data @/tmp/userdata.sh 从使用映像/概要文件/密钥/用户数据配置的实例模板创建实例。
  • ibmcloud is instance-create-from-template --template 0737-b7c965c7-2c26-4457-85c4-52e7156f570d --dedicated-host 0737-4ab6b37d-4695-4efb-9439-0528b5550dfe --profile mx2-2x16 从使用所需专用主机的实例模板创建实例。
  • ibmcloud is instance-create-from-template --template 0737-b7c965c7-2c26-4457-85c4-52e7156f570d --dedicated-host-group 0737-7290ea56-7543-4590-8558-ca8cd51b12c4 --profile mx2-2x16 从使用所需专用主机组的实例模板创建实例。
  • ibmcloud is instance-create-from-template --template 0737-b7c965c7-2c26-4457-85c4-52e7156f570d --name new-instance-name --metadata-service true 从已启用或禁用元数据服务的实例模板创建实例。
  • ibmcloud is instance-create-from-template --template my-template --name new-instance-name --vpc my-vpc --zone us-south-1 --subnet my-subnet --reserved-ip my-reserved-ip --sgs my-security-group --allow-ip-spoofing true 借助资源名称，从使用主网络接口配置的实例模板创建实例。
  • ibmcloud is instance-create-from-template --template my-template --name my-instance --vpc my-vpc --zone us-south-1 --primary-network-interface '{"name": "primary-nic", "allow_ip_spoofing": true, "subnet": {"id":"my-subnet"}, "primary_ip": {"name": "my-reserved-ip"}, "security_groups": [{"name": "my-security-group"}]}' 借助资源名称，从使用 JSON 格式的主网络接口配置的实例模板创建实例。
  • ibmcloud is instance-create-from-template --template my-template --name my-instance --network-interface '[{"name": "secondary-nic", "allow_ip_spoofing": true, "subnet": {"id":"my-subnet-1"}, "primary_ip": {"name": "my-reserved-ip"}, "security_groups": [{"id": "my-security-group-1"}]}, {"name": "third-nic", "allow_ip_spoofing": true, "subnet": {"id":"my-subnet-1"}, "primary_ip": {"name": "my-reserved-ip-2"}, "security_groups": [{"id": "my-security-group-2"}]}]' 借助资源名称，从使用第二个网络接口配置的实例模板创建实例。
  • ibmcloud is instance-create-from-template --template my-template --name new-instance-name --subnet my-subnet --image ibm-ubuntu-20-04-2-minimal-amd64-1 --volume-attach '[{"volume": {"name":"my-vol-1"}}]' 借助资源名称，从使用卷连接中现有卷的实例模板创建实例。
  • ibmcloud is instance-create-from-template --template my-template --name new-instance-name --primary-network-interface '{"name": "primary-nic", "allow_ip_spoofing": true, "subnet": {"name":"my-subnet"}, "primary_ip": {"name": "my-reserved-ip"}, "security_groups": [{"name": "my-security-group-1"}, {"name": "my-security-group-2"}]}' 借助资源名称，从使用主网络接口配置的实例模板创建实例。
  • ibmcloud is instance-create-from-template --template 0737-b7c965c7-2c26-4457-85c4-52e7156f570d --cluster-network-attachments [{"name": "instance-cnac-1","cluster_network_interface": {"id":"02h7-56705448-c9d9-43dc-aa11-20d42333cd87"}}] 使用具有现有集群网络接口和现有保留 IP 的集群网络连接，通过实例模板创建实例。
  • ibmcloud is instance-create-from-template --template 0737-b7c965c7-2c26-4457-85c4-52e7156f570d --cluster-network-attachments [{"name":"cli-cnac-1", "cluster_network_interface": {"auto_delete": true, "name": "cni-1", "primary_ip": { "auto-delete": true, "name": "my-reserved-ip"}, "subnet": "72b27b5c-f4b0-48bb-b954-5becc7c1dcb8"}}] 使用集群网络连接，通过实例模板创建实例。
  • ibmcloud is instance-create-from-template --template 0737-b7c965c7-2c26-4457-85c4-52e7156f570d --volume-bandwidth-qos-mode pooled 创建采用特定卷带宽 QoS 方式的实例模板。
  • ibmcloud is instance-create-from-template --template 0737-b7c965c7-2c26-4457-85c4-52e7156f570d --vcpu-percentage 50 从具有共享核心的实例模板创建实例。

命令选项

  • --template：实例模板的 ID 或名称。
  • --name：实例名称。
  • --profile：实例配置文件的名称。
  • --zone：区域名称。
  • --vpc：VPC 的 ID 或名称。 只需通过名称指定该 VPC 内的唯一资源，或者在模板中覆盖 VPC 的值即可。
  • --image：图片的ID或名称。
  • --catalog-offering：IBM Cloud 产品目录条目的 CRN。 如果指定了此选项，那么将使用该产品的最新版本。 有关创建目录商品的更多信息，请参阅 “将软件接入您的账户”。
  • --catalog-offering-version：IBM Cloud 目录产品版本的 CRN。 有关为目录产品创建版本的更多信息，请参阅《 将软件接入您的账户 》。
  • --catalog-offering-plan：IBM Cloud 目录产品计费方案的 CRN。 如果未指定，则不使用计费套餐（免费）。 必须为需要计费套餐的目录产品版本指定。
  • --total-volume-bandwidth：专门分配给实例存储卷的带宽量（单位为兆比特每秒）。 此值的增加将导致网络总带宽相应降低。
  • --boot-volume: BOOT_VOLUME_JSON|@BOOT_VOLUME_JSON_FILE，以 JSON 或 JSON 文件形式指定的启动卷挂载。 有关数据模式，请参阅 API 文档 中的 boot_volume_attachment 属性。
  • --volume-attach: VOLUME_ATTACH_JSON|@VOLUME_ATTACH_JSON_FILE，以 JSON 或 JSON 文件形式指定的卷挂载信息，包含卷列表。 有关数据模式，请参阅 API 文档 中的 volume_attachments 属性。
  • --keys：以逗号分隔的 SSH 密钥的 ID 或名称。 SSH 密钥可以是 RSA 或 Ed25519 密钥。 仅当操作系统支持此密钥类型时，才能使用 Ed25519。 Ed25519 不能与 Windows 或 VMware 映像配合使用。
  • --dedicated-host：实例所在的目标主机的 ID 或名称。
  • --dedicated-host-group：实例所属的主机组目标的 ID 或名称。
  • --placement-group：放置组的 ID 或名称。 虚拟服务器实例的放置组限制。
  • --reservation-affinity-policy, --res-policy：此虚拟服务器实例应采用的预留亲和性策略。 如果池不为空，策略缺省为“手动”。 如果设置了放置目标，则策略缺省为“禁用”。 在所有其他情况下，策略缺省为“自动”。 其中之一：禁用、手动、自动。
  • --reservation-affinity-pool，--res-pool： 该虚拟服务器实例可使用的预留资源的 ID、名称或 CRN。
  • --user-data: data|@data-file. 要传输到虚拟服务器实例的用户数据。
  • --subnet：子网的 ID 或名称。 使用命令 ibmcloud is subnets 来获取子网 ID 或名称。
  • --rip：现有保留 IP 的 ID 或名称。
  • --address：要预留的 IP 地址，该地址在子网中不得已被预留。
  • --auto-delete：如果设置为 true，则当目标被删除时，该预留 IP 地址将自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --ip-name：此预留 IP 的用户自定义名称。 名称在预留 IP 所在的子网中必须是唯一的。 以 ibm- 开头的名称专用于服务商自有资源。
  • --allow-ip-spoofing：禁用该接口上的源地址和目标地址检查。 如果为false，则不允许在此接口上进行源IP欺骗。 其中一个: false，true。
  • --primary-network-interface: PRIMARY_NETWORK_INTERFACE_JSON|@PRIMARY_NETWORK_INTERFACE_JSON_FILE，以 JSON 或 JSON 文件形式指定的主网络接口。 有关数据模式，请参阅 API 文档 中的 primary_network_interface 属性。
  • --network-interface: NETWORK_INTERFACE_JSON|@NETWORK_INTERFACE_JSON_FILE，以 JSON 或 JSON 文件格式指定的网络接口绑定。 有关数据模式，请参阅 API 文档 中的 network_interfaces 属性。
  • --pnac-name：主网络连接的名称。
  • --pnac-vni：与主网络连接关联的虚拟网络接口的 ID 或名称。
  • --pnac-vni-subnet：关联的子网。
  • --pnac-vni-ais：允许 IP 欺骗（AIS）。 指示与主网络连接关联的此虚拟网络接口上是否允许源 IP 电子欺骗。 其中一个: false，true。(缺省值: false)。
  • --pnac-vni-ein：启用基础设施 NAT（EIN）。 如果属实，VPC 基础设施将对 VNI 执行任何必要的 NAT 操作。 要将 VNI 连接到实例，该值必须为 true。 Floating_ips 不得具有多个浮动 IP。 如果为false，则数据包在发往或来自VNI时不会被修改，从而允许VNI执行任何必要的NAT操作。 Allow_ip_spoofing 必须为 false。 只能连接到 resource_type 为 bare_metal _server_network_attachment 的目标。 下列其中一项: true 和 false。(缺省值: true)。
  • --pnac-vni-auto-delete：指示与主网络连接关联的此虚拟网络接口是否会在目标被删除时自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --pnac-vni-ips: VNI_RESERVED_IPS_JSON | @VNI_RESERVED_IPS_JSON_FILE，用于绑定到虚拟网络接口的备用预留 IP 地址，格式为 JSON 或 JSON 文件。 有关数据模式，请参阅 API 文档 中的 IPS 属性。 其中一个: VNI_RESERVED_IPS_JSON，@VNI_RESERVED_IPS_JSON_FILE。
  • --pnac-vni-name：与主网络连接关联的此虚拟网络接口的名称。
  • --pnac-vni-rip：要绑定到与主网络连接关联的虚拟网络接口的保留 IP 的 ID 或名称。
  • --pnac-vni-rip-address：用于绑定到与主网络连接关联的虚拟网络接口的预留 IP 地址。
  • --pnac-vni-rip-auto-delete：指示当任一目标被删除，或者该保留 IP 地址被解除绑定时，该保留 IP 地址是否会自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --pnac-vni-rip-name：此保留 IP 地址的名称，用于将其绑定到与主网络连接关联的虚拟网络接口。
  • --pnac-vni-sgs：用于虚拟网络接口的安全组的 ID 或名称（以逗号分隔），这些安全组与主网络连接相关联。
  • --pnac-vni-psfm：此虚拟网络接口应采用的协议状态过滤模式。 如果设置为“自动”，则协议状态数据包过滤功能是否启用或禁用，取决于虚拟网络接口的 target 资源类型。 其中一个: auto，enabled，disabled。(缺省值: auto)。
  • -- network-Attachment: NETWORK_ATTACHMENTS_JSON |@NETWORK_ATTACHMENTS_JSON_FILE。 网络附件配置在 JSON 或 JSON 文件中。 有关数据模式，请参阅 API 文档 中的 network_attachments 属性。 NETWORK_ATTACHMENTS_JSON，@NETWORK_ATTACHMENTS_JSON_FILE 之一。
  • --sgs：主网络接口或主网络连接的以逗号分隔的安全组 ID 或名称。
  • --default-trusted-profile：受信任配置文件的 ID 或名称。
  • --default-trusted-profile-auto-link：如果设置为 true，系统将在实例创建过程中生成指向指定目标受信任配置文件的链接。 无论链接由系统创建还是使用 IAM 身份服务手动创建，它都会在删除实例时自动进行删除。 下列其中一项: true，false。(缺省值: true)。
  • --metadata-service, --ms：启用或禁用实例元数据服务。 以下选项之一：true、false。
  • --metadata-service-protocol，--msp：元数据服务端点的通信协议。 仅当启用了元数据服务时，协议才适用。 http 和 https 之一。(缺省值: http)。
  • --metadata-service-response-hop-limit，--msrhl： 元数据服务返回的 IP 响应数据包的跳数限制（IP 生存时间）。
  • --host-failure-policy：当计算主机发生故障时应执行的操作。 其中一个: restart，stop。
  • --confidential-compute-mode：此虚拟服务器实例要使用的机密计算模式。 如果未指定，那么将使用概要文件中的缺省保密计算方式。 残疾、SGX、TDX 其中之一。
  • --enable-secure-boot：指示此虚拟服务器实例是否启用了安全启动。 如果未指定，那么将使用概要文件中的缺省安全引导方式。 以下选项之一：true、false。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --cluster-network-attachments：cluster_network_attachments_json|@cluster_network_attachments_json_file。 集群网络连接配置位于 JSON 或 JSON 文件中。 有关数据模式，请参阅 API 文档 中的 cluster_network_attachments 属性。 有关群集网络的更多信息，请参阅“群集网络”。 以下之一：CLUSTER_NETWORK_ATTACHMENTS _JSON ，@CLUSTER_NETWORK_ATTACHMENTS_JSON_FILE。
  • --volume-bandwidth-qos-mode：此虚拟服务器实例应采用的卷带宽 QoS 模式。 必须在实例概要文件的 volume_bandwidth_qos_modes 中列出指定的值。 其中之一：集合、加权。
  • --vcpu-percentage：分配给该实例的 vCPU 时钟周期的百分比。 范围为 1-100。
  • --availability-class：虚拟服务器实例的可用性类。 其中之一：斑点、标准。
  • --preemption-policy：当虚拟服务器实例被抢占时应执行的操作。 其中之一是：删除，停止。
  • --threads-per-core：此虚拟服务器实例的每核线程数。 如果未指定，则使用配置文件的默认值。 其中一个: 1，2。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is instance-delete

删除一个或多个虚拟服务器实例。

ibmcloud is instance-delete (INSTANCE1 INSTANCE2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • INSTANCE1：实例的ID或名称。
  • INSTANCE2：实例的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是实例磁盘

查看虚拟服务器实例磁盘的详细信息。

ibmcloud is instance-disk INSTANCE INSTANCE_DISK [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • INSTANCE_DISK：实例磁盘的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是实例磁盘更新

更新虚拟服务器实例的磁盘。

ibmcloud is instance-disk-update INSTANCE INSTANCE_DISK --name NEW_NAME [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • INSTANCE_DISK：实例磁盘的 ID 或名称。
  • --name：实例磁盘的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是实例磁盘

列出虚拟服务器实例的所有磁盘。

ibmcloud is instance-disks INSTANCE [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-network-interface

查看虚拟服务器实例的网络接口的详细信息。

ibmcloud is instance-network-interface INSTANCE NIC [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • NIC：网络接口的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 实例网络接口创建

为虚拟服务器实例创建一个网络接口。

ibmcloud is instance-network-interface-create NIC_NAME INSTANCE SUBNET [--vpc VPC] [--rip RIP | (--address ADDRESS --auto-delete true | false --ip-name IP_NAME)] [(--sg SG1 --sg SG2 ...)] [--allow-ip-spoofing false | true] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-network-interface-create my-vnic 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3
  • ibmcloud is instance-network-interface-create my-vnic 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --rip 0711-5c7f016e-5bd2-42e3-8dff-81519e4e2469
  • ibmcloud is instance-network-interface-create my-vnic 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --address 10.2.3.4 --ip-name my-reserved-ip --auto-delete false
  • ibmcloud is instance-network-interface-create my-vnic 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --address 10.2.3.4 --ip-name my-reserved-ip --auto-delete false --sg 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --sg 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8
  • ibmcloud is instance-network-interface-create my-vnic my-instance my-subnet --sg my-sg-1 --sg my-sg-2 使用资源名称为具有安全组的虚拟服务器实例创建网络接口。

命令选项

  • NIC_NAME：网络接口的名称。
  • 实例：实例的 ID 或名称。
  • 子网：子网的 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --rip：现有保留 IP 的 ID 或名称。
  • --address：要预留的 IP 地址，该地址在子网中不得已被预留。
  • --auto-delete：如果设置为 true，则当目标被删除时，该预留 IP 地址将自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --ip-name：此预留 IP 的用户自定义名称。 名称在预留 IP 所在的子网中必须是唯一的。 以 ibm- 开头的名称专用于服务商自有资源。
  • --sg：安全组的 ID 或名称。
  • --allow-ip-spoofing：禁用该接口上的源地址和目标地址检查。 如果为false，则不允许在此接口上进行源IP欺骗。 其中一个: false，true。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 实例网络接口删除

从虚拟服务器实例中移除一个或多个网络接口。

ibmcloud is instance-network-interface-delete INSTANCE (NIC1 NIC2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • NIC1：网络接口的ID或名称。
  • NIC2：网络接口的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is instance-network-interface-浮动-ip

查看与网络接口关联的浮动 IP 的详细信息。

ibmcloud is instance-network-interface-floating-ip INSTANCE NIC FLOATING_IP [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • NIC：网络接口的ID或名称。
  • FLOATING_IP：浮动 IP 的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is instance-network-interface-浮动-ip-add

将浮动 IP 与网络接口相关联。

ibmcloud is instance-network-interface-floating-ip-add INSTANCE NIC FLOATING_IP [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-network-interface-floating-ip-add 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 1a6b7274-678d-4dfb-8981-c71dd9d4daa5 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3
  • ibmcloud is instance-network-interface-floating-ip-add 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 1a6b7274-678d-4dfb-8981-c71dd9d4daa5 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --output JSON
  • ibmcloud is instance-network-interface-floating-ip-add my-instance my-nic my-floating-ip 通过使用资源名称将浮动 IP 与网络接口相关联。

命令选项

  • 实例：实例的 ID 或名称。
  • NIC：网络接口的ID或名称。
  • FLOATING_IP：浮动 IP 的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is instance-network-interface-浮动-ip-remove

解除浮动 IP 与网络接口的关联。

ibmcloud is instance-network-interface-floating-ip-remove INSTANCE NIC FLOATING_IP [-f, --force] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • NIC：网络接口的ID或名称。
  • FLOATING_IP：浮动 IP 的 ID 或名称。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is instance-network-interface-浮动-ips

列出与某个网络接口关联的所有浮动 IP 地址。

ibmcloud is instance-network-interface-floating-ips INSTANCE NIC [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • NIC：网络接口的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是实例网络接口保留的 IP 地址

列出与网络接口关联的所有预留 IP。

ibmcloud is instance-network-interface-reserved-ips INSTANCE NIC [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • NIC：网络接口的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是实例-网络接口-保留IP

查看与网络接口关联的预留 IP 的详细信息。

ibmcloud is instance-network-interface-reserved-ip INSTANCE NIC RESERVED_IP [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • NIC：网络接口的ID或名称。
  • RESERVED_IP：预留 IP 的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 实例网络接口更新

更新虚拟服务器实例的网络接口。

ibmcloud is instance-network-interface-update INSTANCE NIC --name NEW_NAME [--allow-ip-spoofing false | true] [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • NIC：网络接口的ID或名称。
  • --name: 网卡的新名称。
  • --allow-ip-spoofing：禁用该接口上的源地址和目标地址检查。 如果为false，则不允许在此接口上进行源IP欺骗。 其中一个: false，true。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-network-interfaces

列出虚拟服务器实例的所有网络接口。

ibmcloud is instance-network-interfaces INSTANCE [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是实例概要文件

查看虚拟服务器实例概要文件的详细信息。

ibmcloud is instance-profile PROFILE_NAME [--output JSON] [-q, --quiet]

命令选项

  • PROFILE_NAME：配置文件的名称。 使用命令 'ibmcloud is instance-profiles' 来获取实例概要文件。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is instance-profiles

列出区域中的所有虚拟服务器实例概要文件。

ibmcloud is instance-profiles [--output JSON] [-q, --quiet]

命令选项

  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is instance-reboot

重启实例的操作系统。

ibmcloud is instance-reboot INSTANCE [--no-wait] [-f, --force] [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • --no-wait：立即执行该操作，并取消所有已排入队列的操作。
  • --force，-f：强制执行操作，无需确认。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 正在重新初始化实例

重新初始化一个虚拟服务器实例。

ibmcloud is instance-reinitialize INSTANCE (--image IMAGE [--boot-volume BOOT_VOLUME_JSON | @BOOT_VOLUME_JSON_FILE] | --boot-volume BOOT_VOLUME_JSON | @BOOT_VOLUME_JSON_FILE) [--keys KEYS] [--default-trusted-profile DEFAULT_TRUSTED_PROFILE [--default-trusted-profile-auto-link true,false]] [--user-data DATA] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is instance-reinitialize 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --image r006-ed3f775f-ad7e-4e37-ae62-7199b4988b00 --keys r006-02a07b78-6e5f-40a2-86a2-99e01916128c 使用 SSH 密钥从镜像重新初始化一个实例。
  • ibmcloud is instance-reinitialize 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --image r006-ed3f775f-ad7e-4e37-ae62-7199b4988b00 --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"name": "my-boot-vol", "capacity": 150, "profile": {"name": "general-purpose"}}}' 使用具有自定义启动卷配置的镜像重新初始化一个实例。
  • ibmcloud is instance-reinitialize 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"id": "r006-1a6b7274-678d-4dfb-8981-c71dd9d4daa5"}}' 从现有的启动卷重新初始化一个实例。
  • ibmcloud is instance-reinitialize my-instance --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"name": "boot-vol-name", "profile": {"name": "general-purpose"}, "source_snapshot": {"name": "my-snapshot"}}}' --keys my-key-1,my-key-2 使用资源名称，通过 SSH 密钥从快照重新初始化一个实例。

命令选项

  • 实例：实例的 ID 或名称。
  • --image：图片的ID或名称。
  • --boot-volume: BOOT_VOLUME_JSON|@BOOT_VOLUME_JSON_FILE，以 JSON 或 JSON 文件形式指定的启动卷挂载。 有关数据模式，请参阅 API 文档 中的 boot_volume_attachment 属性。
  • --keys：以逗号分隔的 SSH 密钥的 ID 或名称。 SSH 密钥可以是 RSA 或 Ed25519 密钥。 Ed25519 只有当操作系统支持此类密钥时，才可使用。 Ed25519 不能与 Windows 或 VMware 映像配合使用。
  • --default-trusted-profile：受信任配置文件的 ID 或名称。
  • --default-trusted-profile-auto-link：如果设置为 true，系统将在实例创建过程中生成指向指定目标受信任配置文件的链接。 无论链接由系统创建还是使用 IAM 身份服务手动创建，它都会在删除实例时自动进行删除。 下列其中一项: true，false。(缺省值: true)。
  • --user-data: data|@data-file. 要传输到虚拟服务器实例的用户数据。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是实例启动

启动虚拟服务器实例。

ibmcloud is instance-start INSTANCE [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 实例已停止

停止虚拟服务器实例。

  • 当您停止实例并重新启动时，如果该实例在创建时未配置静态 IP 地址，或者在使用 CLI 或 API 创建实例时未设置 primary_ipv4_address 属性，则会分配一个新的私有 IP 地址。 有关设置静态 IP 地址的更多信息，请参阅 API 参考中的 primary_network_interface。 - 
ibmcloud is instance-stop INSTANCE [--no-wait] [-f, --force] [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • --no-wait：立即执行该操作，并取消所有已排入队列的操作。
  • --force，-f：强制执行操作，无需确认。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is instance-update

更新虚拟服务器实例。

ibmcloud is instance-update INSTANCE [--name NEW_NAME] [--profile PROFILE] [--total-volume-bandwidth TOTAL_VOLUME_BANDWIDTH] [--dedicated-host DEDICATED_HOST | --dedicated-host-group DEDICATED_HOST_GROUP] [--reservation-affinity-policy, --res-policy disabled | manual | automatic] [--reservation-affinity-pool, --res-pool RESERVATION_AFFINITY_POOL] [--metadata-service, --ms true | false] [--metadata-service-protocol, --msp http | https] [--metadata-service-response-hop-limit, --msrhl METADATA_SERVICE_RESPONSE_HOP_LIMIT,MSRHL] [--host-failure-policy restart | stop] [--confidential-compute-mode disabled | sgx | tdx] [--enable-secure-boot true | false] [--volume-bandwidth-qos-mode pooled | weighted] [--vcpu-percentage VCPU_PERCENTAGE] [--availability-class spot | standard] [--preemption-policy delete | stop] [--threads-per-core 1 | 2] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name new-instance-name
  • ibmcloud is instance-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name new-instance-name --output JSON
  • ibmcloud is instance-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --metadata-service true
  • ibmcloud is instance-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --dedicated-host d7e9969b-1453-4b51-89a6-6b5531c3d959
  • ibmcloud is instance-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --dedicated-host-group c05ecb00-701d-4ad1-8c84-2256f0a53f70
  • ibmcloud is instance-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --total-volume-bandwidth 4000
  • ibmcloud is instance-update my-instance --name new-instance-name
  • ibmcloud is instance-update my-instance --dedicated-host my-dedicated-host
  • ibmcloud is instance-update my-instance --dedicated-host-group my-dedicated-host-group
  • ibmcloud is instance-update my-instance --reservation-affinity-policy manual --reservation-affinity-pool crn:v1:bluemix:public:is:us-south:a/123456::vpc:4727d842-f94f-4a2d-824a-9bc9b02c523b
  • ibmcloud is instance-update my-instance --reservation-affinity-policy manual --reservation-affinity-pool r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2
  • ibmcloud is instance-update my-instance --availability-class spot --preemption-policy stop
  • ibmcloud is instance-update my-instance --threads-per-core 1
  • ibmcloud is instance-update my-instance --threads-per-core 2

命令选项

  • 实例：实例的 ID 或名称。
  • --name：虚拟服务器实例的新名称。
  • --profile：此虚拟服务器实例要使用的配置文件。 要更改配置文件，实例状态必须为“stopping”或“stopped”。 此外，请求的概要文件必须为：1。 与任何放置目标约束兼容。 例如，如果实例部署在专用主机上，则请求的配置文件 family 必须与专用主机 family 保持一致。
  • --total-volume-bandwidth：专门分配给实例存储卷的带宽量（单位为兆比特每秒）。 此值的增加将导致网络总带宽相应降低。
  • --dedicated-host：实例所在的目标主机的 ID 或名称。
  • --dedicated-host-group：实例所属的主机组目标的 ID 或名称。
  • --reservation-affinity-policy, --res-policy：此虚拟服务器实例应采用的预留亲和性策略。 如果池不为空，策略缺省为“手动”。 如果设置了放置目标，则策略缺省为“禁用”。 在所有其他情况下，策略缺省为“自动”。 其中之一：禁用、手动、自动。
  • --reservation-affinity-pool，--res-pool： 该虚拟服务器实例可使用的预留资源的 ID、名称或 CRN。
  • --metadata-service, --ms：启用或禁用实例元数据服务。 以下选项之一：true、false。
  • --metadata-service-protocol，--msp：元数据服务端点的通信协议。 仅当启用了元数据服务时，协议才适用。 http 和 https 之一。(缺省值: http)。
  • --metadata-service-response-hop-limit，--msrhl： 元数据服务返回的 IP 响应数据包的跳数限制（IP 生存时间）。
  • --host-failure-policy：当计算主机发生故障时应执行的操作。 其中一个: restart，stop。
  • --confidential-compute-mode：此虚拟服务器实例要使用的机密计算模式。 如果未指定，那么将使用概要文件中的缺省保密计算方式。 残疾、SGX、TDX 其中之一。
  • --enable-secure-boot：指示此虚拟服务器实例是否启用了安全启动。 如果未指定，那么将使用概要文件中的缺省安全引导方式。 以下选项之一：true、false。
  • --volume-bandwidth-qos-mode：此虚拟服务器实例应采用的卷带宽 QoS 模式。 必须在实例概要文件的 volume_bandwidth_qos_modes 中列出指定的值。 其中之一：集合、加权。
  • --vcpu-percentage：分配给该实例的 vCPU 时钟周期的百分比。 范围为 1-100。
  • --availability-class：虚拟服务器实例的可用性类。 其中之一：斑点、标准。
  • --preemption-policy：当虚拟服务器实例被抢占时应执行的操作。 其中之一是：删除，停止。
  • --threads-per-core：此虚拟服务器实例的每核线程数。 如果未指定，则使用配置文件的默认值。 其中一个: 1，2。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-volume-attachment

查看卷连接的详细信息。

ibmcloud is instance-volume-attachment INSTANCE VOLUME_ATTACHMENT [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • VOLUME_ATTACHMENT：卷挂载的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-volume-Attachment

列出实例的所有卷连接。

ibmcloud is instance-volume-attachments INSTANCE [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-volume-attachment-add

创建卷连接，以将卷连接到实例。

ibmcloud is instance-volume-attachment-add NAME INSTANCE (VOLUME | --profile PROFILE --new-volume-name NEW_VOLUME_NAME --iops IOPS --encryption-key ENCRYPTION_KEY --capacity CAPACITY --bandwidth BANDWIDTH --tags TAGS --source-snapshot SOURCE_SNAPSHOT [--allowed-use-api-version, --au-api-version ALLOWED_USE_API_VERSION, AU_API_VERSION] [--allowed-use-bare-metal-server, --au-bms ALLOWED_USE_BARE_METAL_SERVER, AU_BMS] [--allowed-use-instance, --au-ins ALLOWED_USE_INSTANCE, AU_INS]) [--auto-delete false | true] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-volume-attachment-add data-vol-name 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 1a6b7274-678d-4dfb-8981-c71dd9d4daa5
  • ibmcloud is instance-volume-attachment-add data-vol-name 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 1a6b7274-678d-4dfb-8981-c71dd9d4daa5 --auto-delete true
  • ibmcloud is instance-volume-attachment-add data-vol-name 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 1a6b7274-678d-4dfb-8981-c71dd9d4daa5 --auto-delete true --output JSON
  • ibmcloud is instance-volume-attachment-add data-vol-name 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --profile general-purpose --source-snapshot eaf9d6ca-35bf-4ac7-bc45-d0f2507f2830 --auto-delete true --output JSON
  • ibmcloud is instance-volume-attachment-add data-vol-name 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --profile general-purpose ---capacity 10 --auto-delete true --tags my-tag-1,my-tag-2
  • ibmcloud is instance-volume-attachment-add data-vol-name my-instance my-volume --auto-delete true 使用资源名称将现有卷添加到虚拟服务器实例。
  • ibmcloud is instance-volume-attachment-add data-vol-name 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --profile general-purpose --source-snapshot eaf9d6ca-35bf-4ac7-bc45-d0f2507f2830 --allowed-use-api-version "2024-10-31" --allowed-use-bare-metal-server enable_secure_boot==true --allowed-use-instance true --auto-delete true --output JSON

命令选项

  • NAME：卷挂载的名称。
  • 实例：实例的 ID 或名称。
  • 卷：卷的ID或名称。
  • --new-volume-name：新卷的名称。
  • --profile：配置文件的名称。
  • --iops：卷的每秒输入和输出操作次数，仅适用于自定义配置文件卷。 有关可用的 IOPS 范围，请参阅 [定制 IOPS 概要文件]将软件加载到帐户。
  • --encryption-key：密钥管理服务（KMS）根密钥的 CRN。
  • --capacity：卷的容量（单位为千兆字节）。 对于定制和通用概要文件卷，范围为 10-16000; 对于 5iops-tier 概要文件卷，范围为 10-9600; 对于 10iops-tier 概要文件卷，范围为 10-4800。
  • --bandwidth：该卷的最大带宽（单位为兆比特每秒）。 要指定此属性，卷存储代必须为 2。
  • --tags：该卷的以逗号分隔的标签。
  • --source-snapshot：要克隆卷的快照的 ID、名称或 CRN。
  • --allowed-use-api-version、--au-api-version：用于评估表达式的 API 版本。
  • --allowed-use-bare-metal-server: true,--au-bms true - 使用本卷中的镜像数据进行配置的裸机服务器，其属性必须满足的条件。 如果未指定，则表达式将被设置为 true。
  • --allowed-use-instance: true,--au-ins true - 使用此卷进行配置的虚拟服务器实例的属性必须满足的表达式。 如果未指定，则表达式将被设置为 true。
  • --auto-delete：当实例被删除时，关联的卷也将被删除。 其中一个: false，true。(缺省值: false)。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-volume-attachment-detach

删除一个或多个卷连接（从实例断开卷的连接）。

ibmcloud is instance-volume-attachment-detach INSTANCE (VOLUME_ATTACHMENT1 VOLUME_ATTACHMENT2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • VOLUME_ATTACHMENT1：卷挂载的 ID 或名称。
  • VOLUME_ATTACHMENT2：卷挂载的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-volume-attachment-update

更新卷连接。

ibmcloud is instance-volume-attachment-update INSTANCE VOLUME_ATTACHMENT [--name NEW_NAME] [--auto-delete true | false] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-volume-attachment-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 1a6b7274-678d-4dfb-8981-c71dd9d4daa5 --name name2
  • ibmcloud is instance-volume-attachment-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 1a6b7274-678d-4dfb-8981-c71dd9d4daa5 --auto-delete true
  • ibmcloud is instance-volume-attachment-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 1a6b7274-678d-4dfb-8981-c71dd9d4daa5 --name name2 --auto-delete true --output JSON
  • ibmcloud is instance-volume-attachment-update my-instance my-vol-att --name name2 使用资源名称更新卷附件。

命令选项

  • 实例：实例的 ID 或名称。
  • VOLUME_ATTACHMENT：卷挂载的 ID 或名称。
  • --name: 卷的新名称。
  • --auto-delete：当实例被删除时，关联的卷也将被删除。 以下选项之一：true、false。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-network-Attachment

列出实例的所有网络连接。

ibmcloud is instance-network-attachments INSTANCE [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-network-attachment

查看实例的网络连接详细信息。

ibmcloud is instance-network-attachment INSTANCE NAC [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • NAC：网络连接的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 实例网络连接创建

为实例创建网络连接。

ibmcloud is instance-network-attachment-create INSTANCE [--vni VNI | ((--vni-subnet VNI_SUBNET [--vpc VPC]) --vni-ais false | true --vni-ein true | false --vni-auto-delete true | false --vni-ips VNI_RESERVED_IPS_JSON | @VNI_RESERVED_IPS_JSON_FILE --vni-name VNI_NAME [--vni-rip VNI_RIP | (--vni-rip-address VNI_RIP_ADDRESS --vni-rip-auto-delete true | false --vni-rip-name VNI_RIP_NAME)] [--vni-psfm auto | enabled | disabled] --vni-sgs VNI_SGS)] [--name NAC_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-network-attachment-create 02h7_ef1b0428-f138-4d5e-a8e2-e9f35e397cf8 --vni-ais false --vni-ein true --vni-auto-delete true --vni-ips '[{"id": "02h7-b982a5f1-804b-4dd9-b448-777ae3641242"}]' --vni-name ins-vni-1 --vni-rip 02h7-f9203bfc-ea46-4431-9b66-a9ae223e9076 --vni-sgs r026-b315a040-8ea9-49c4-8974-b7ab373c660c
  • ibmcloud is instance-network-attachment-create 02h7_ef1b0428-f138-4d5e-a8e2-e9f35e397cf8 --vni-rip 02h7-f9203bfc-ea46-4431-9b66-a9ae223e9076
  • ibmcloud is instance-network-attachment-create 02h7_ef1b0428-f138-4d5e-a8e2-e9f35e397cf8 --vni-rip-address "10.245.0.34" --vni-subnet cli-subnet --vpc vpc-1
  • ibmcloud is instance-network-attachment-create 02h7_ef1b0428-f138-4d5e-a8e2-e9f35e397cf8 --vni-subnet 02h7-275c2a52-1890-4473-83a0-54de53da8a25
  • ibmcloud is instance-network-attachment-create 02h7_02b4927a-7837-4568-9653-6ae51a861c9d --vni 02h7-123156e0-3aee-489f-bcdc-78cdc2549c0d

命令选项

  • 实例：实例的 ID 或名称。
  • --name：此裸机服务器网络连接的名称。
  • --vni：用于此裸机服务器网络连接的虚拟网络接口的 ID 或名称。
  • --vni-subnet：关联的子网。
  • --vpc：VPC 的 ID 或名称。 仅当在此 VPC 中按名称指定唯一子网时，才需要此标识或名称。
  • --vni-ais：允许 IP 欺骗（AIS）。 指示此虚拟网络接口上是否允许源 IP 电子欺骗。 其中一个: false，true。(缺省值: false)。
  • --vni-ein：启用基础设施 NAT（EIN）。 如果为真，VPC 基础设施将执行任何必要的 NAT 操作。 如果为false，则数据包将未经修改地从虚拟网络接口传入或传出，这使得与浮动IP关联的虚拟机能够执行任何必要的NAT操作。 下列其中一项: true 和 false。(缺省值: true)。
  • --vni-auto-delete：指示当目标被删除时，此虚拟网络接口是否会自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --vni-ips: ips VNI_RESERVED_IPS_JSON | @VNI_RESERVED_IPS_JSON_FILE，以 JSON 或 JSON 文件格式提供的备用 IP 地址，用于绑定到虚拟网络接口。 关于数据模式，请查阅 API 文档 中的 ips 属性。 其中一个: VNI_RESERVED_IPS_JSON，@VNI_RESERVED_IPS_JSON_FILE。
  • --vni-name：此虚拟网络接口的名称。
  • --vni-rip：要绑定到虚拟网络接口的保留 IP 的 ID 或名称。 如果未指定子网，那么为必填。 必须取消绑定保留的 IP。
  • --vni-rip-address：用于绑定到虚拟网络接口的预留 IP 地址。 需要指定子网。
  • --vni-rip-auto-delete：指定当任一目标被删除，或者该预留 IP 地址被解除绑定时，该预留 IP 地址是否自动删除。 以下选项之一：true、false。
  • --vni-rip-name：此预留 IP 地址用于绑定到虚拟网络接口的名称。 该名称不得由子网中的另一个保留 IP 使用。 以 ibm- 开头的名称专用于服务提供商拥有的资源，因此不允许使用。
  • --vni-psfm：此虚拟网络接口应采用的协议状态过滤模式。 如果设置为“自动”，则协议状态数据包过滤功能是否启用或禁用，取决于虚拟网络接口的 target 资源类型。 其中一个: auto，enabled，disabled。(缺省值: auto)。
  • --vni-sgs：用于此虚拟网络接口的安全组的 ID 或名称，以逗号分隔。 如果未指定，那么将使用子网的 VPC 的缺省安全组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是实例网络连接更新

更新实例的网络连接。

ibmcloud is instance-network-attachment-update INSTANCE NAC --name NEW_NAME [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is ins-nacu cli-instance-1 empty-ribcage-jiffy-stitch --name cli-instance-nac
  • ibmcloud is ins-nacu 02h7_ef1b0428-f138-4d5e-a8e2-e9f35e397cf8 02h7-a5c765f9-ebcd-41a0-89df-c6512d7f0147 --name ins-net-attch-1

命令选项

  • 实例：实例的 ID 或名称。
  • NAC：网络连接的ID或名称。
  • --name: 网络连接的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 实例网络连接删除

从实例中除去一个或多个网络连接。

ibmcloud is instance-network-attachment-delete INSTANCE (NAC1 NAC2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • NAC1：网络连接的ID或名称。
  • NAC2：网络连接的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是实例-群集-网络-附件

列出实例的所有集群网络连接。

ibmcloud is instance-cluster-network-attachments INSTANCE [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是实例-群集-网络-附件

查看实例的集群网络连接详细信息。

ibmcloud is instance-cluster-network-attachment INSTANCE CNAC [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • CNAC：集群网络连接的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是实例-集群-网络-附件-更新

更新实例的集群网络连接。

ibmcloud is instance-cluster-network-attachment-update INSTANCE CNAC --name NEW_NAME [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is ins-cnacu cli-instance-1 empty-ribcage-jiffy-stitch --name cli-instance-cnac
  • ibmcloud is ins-cnacu 02h7_ef1b0428-f138-4d5e-a8e2-e9f35e397cf8 02h7-a5c765f9-ebcd-41a0-89df-c6512d7f0147 --name in-cl-net-attch-1

命令选项

  • 实例：实例的 ID 或名称。
  • CNAC：集群网络连接的ID或名称。
  • --name：集群网络连接的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 实例集群网络附件创建

为实例创建集群网络连接。

ibmcloud is instance-cluster-network-attachment-create INSTANCE [(--cni CNI [--cluster-network CLUSTER_NETWORK]) | ((--cni-subnet CNI_SUBNET [--cluster-network CLUSTER_NETWORK]) --cni-auto-delete true | false --cni-name CNI_NAME [(--cni-primary-ip CNI_PRIMARY_IP [--cluster-network CLUSTER_NETWORK]) | (--cni-primary-ip-address CNI_PRIMARY_IP_ADDRESS --cni-primary-ip-auto-delete true | false --cni-primary-ip-name CNI_PRIMARY_IP_NAME)])] [--name CNAC_NAME] [--cnac CNAC] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-cluster-network-attachment-create my-instance --cni 02h7-f9203bfc-ea46-4431-9b66-a9ae223e9076 --name my-ins-cnat
  • ibmcloud is instance-cluster-network-attachment-create 02h7_ef1b0428-f138-4d5e-a8e2-e9f35e397cf8 --cni my-cluster-network-interface --cluster-network my-cluster-network
  • ibmcloud is instance-cluster-network-attachment-create 02h7_ef1b0428-f138-4d5e-a8e2-e9f35e397cf8 --cni-auto-delete true --cni-subnet my-cluster-network-subnet --cluster-network my-cluster-network --cni-primary-ip 02h7-f9203bfc-ea46-4431-9b66-a9ae223e9076
  • ibmcloud is ins-cnacc my-instance --cni-auto-delete true --cni-subnet 02h7_ef1b0428-f138-4d5e-a8e2-e9f35e397cf8 --cni-primary-ip-address 10.245.0.34 --cni-primary-ip-auto-delete true --cni-primary-ip-name my-cni-ip
  • ibmcloud is instance-cluster-network-attachment-create 02h7_ef1b0428-f138-4d5e-a8e2-e9f35e397cf8 --cni my-cluster-network-interface --cluster-network 02h7-f9203bfc-ea46-4431-9b66-a9ae223e9076 --cnac my-cnac-before-this-cnac --name my-cnac --output json

命令选项

  • 实例：实例的 ID 或名称。
  • --name：此实例集群网络连接的名称。
  • --cnac：要将此实例集群网络连接插入其前面的那个实例集群网络连接的 ID 或名称。
  • --cni：用于此实例集群网络连接的集群网络接口的 ID 或名称。
  • --cluster-network：集群网络的 ID 或名称。
  • --cni-auto-delete：指示当目标被删除时，该集群网络接口是否会自动删除。 以下选项之一：true、false。
  • --cni-name：此集群网络接口的名称。
  • --cni-subnet：关联的集群网络子网的 ID 或名称。
  • --cni-primary-ip：用于绑定到集群网络接口的集群网络子网中预留 IP 的 ID 或名称。
  • --cni-primary-ip-address：用于绑定到集群网络接口的预留 IP 地址。 需要指定子网。
  • --cni-primary-ip-auto-delete：指定当任一目标被删除，或者该预留 IP 被解除绑定时，该预留 IP 是否自动删除。 以下选项之一：true、false。
  • --cni-primary-ip-name：此预留 IP 用于绑定到集群网络接口的名称。 该名称不得由集群子网中的另一个预留 IP 使用。 以 ibm- 开头的名称专用于服务提供商拥有的资源，因此不允许使用。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 实例集群网络附件删除

从实例中移除一个或多个集群网络连接。

ibmcloud is instance-cluster-network-attachment-delete INSTANCE (CNAC1 CNAC2 ...) [-f, --force] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • CNAC1：集群网络连接的ID或名称。
  • CNAC2：集群网络连接的 ID 或名称。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是指实例-软件-附件

列出实例的所有软件附件。

ibmcloud is instance-software-attachments INSTANCE [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是一个实例-软件-关联

查看实例中某个软件附件的详细信息。

ibmcloud is instance-software-attachment INSTANCE SWAC [--output JSON] [-q, --quiet]

命令选项

  • 实例：实例的 ID 或名称。
  • SWAC：软件附件的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 实例-软件-关联-更新

更新实例的软件附件。

ibmcloud is instance-software-attachment-update INSTANCE SWAC --name NEW_NAME [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-software-attachment-update cli-instance-1 empty-ribcage-jiffy-stitch --name cli-instance-swac
  • ibmcloud is ins-swacu 02h7_ef1b0428-f138-4d5e-a8e2-e9f35e397cf8 02h7-a5c765f9-ebcd-41a0-89df-c6512d7f0147 --name ins-sw-attch-1

命令选项

  • 实例：实例的 ID 或名称。
  • SWAC：软件附件的ID或名称。
  • --name：软件附件的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

密钥

ibmcloud 是密钥

查看密钥的详细信息。

ibmcloud is key KEY [--output JSON] [-q, --quiet]

命令选项

  • KEY：密钥的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 key-create

导入 RSA 公共密钥。

ibmcloud is key-create KEY_NAME (KEY | @KEY_FILE) [--key-type rsa | ed25519] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is key-create my-key "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABAQDL9osaBrUD8uCBzIJo5YBvX8wtGrE+kcC7YZtID/nNYrjeCB26eFASHia5tmqmuCo434UygGSd5qj3t/3v/a7NZoMr/0+qspQF+dUVIl+xIsKTWYQ+gtYbJlvW+FIlNTOA4vbOXLg+nGGUCoaV79azmny4mYJbbo15i+Q3CI+w9bwOAwzqeGKaeOjpo5hdDcFW0QLDxKmQHKMLX8slsx3kB9I5wPe8C/ZBBDBBkZKK2y3RJBjaKxi0beFueo6ngUKOLooReefiBGpdoOJIi6Gf7vRduoBTmbyVvSv08wcrANtYSzGwDpqrEshEafv8bKo42MYHsPT2OwAbsFyqWQj5 test@example"
  • ibmcloud is key-create my-key @/tmp/my_id_rsa.pub
  • ibmcloud is key-create my-key @/tmp/my_id_rsa.pub --output JSON
  • ibmcloud is key-create my-key "ssh-ed25519 AAAAC3NzaC1lZDI1NTE6AAAAID/R2T8h6CPvZr/InxpBrxh8bmG2RTyB8vzUTvOtQhaJ test@example.com" --key-type ed25519
  • ibmcloud is key-create my-key @/tmp/my_id_ed25519.pub --key-type ed25519
  • ibmcloud is key-create my-key @/tmp/my_id_ed25519.pub --key-type ed25519 --output JSON

命令选项

  • KEY_NAME：密钥的 ID 或名称。
  • KEY: key|@密钥文件. 要导入系统中的公共 SSH 密钥。
  • --key-type：此密钥所使用的加密系统。 缺省值为 rsa。 rsa，ed25519 之一。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 key-delete

删除一个或多个密钥。

ibmcloud is key-delete (KEY1 KEY2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is key-delete e9e7655e-0000-0000-0000-0000001a957a --output JSON
  • ibmcloud is key-delete e9e7655e-0000-0000-0000-0000001a957a -f

命令选项

  • KEY1：密钥的ID或名称。
  • KEY2：密钥的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 key-update

更新密钥的名称。

ibmcloud is key-update KEY --name NEW_NAME [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is key-update e9e7655e-0000-0000-0000-0000001a957a --name my-new-name
  • ibmcloud is key-update e9e7655e-0000-0000-0000-0000001a957a --name my-new-name --output JSON

命令选项

  • KEY：密钥的ID或名称。
  • --name：密钥的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is keys

列出所有密钥。

ibmcloud is keys [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is keys --resource-group-name Default --output JSON
  • ibmcloud is keys --resource-group-id 11baaa8984beb82690daab08767et --output JSON

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

专用主机

ibmcloud 是专用主机档案

列出该区域内的所有主机配置文件。

ibmcloud is dedicated-host-profiles [--output JSON] [-q, --quiet]

命令选项

  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是专用主机配置文件

查看主机资料的详细信息。

ibmcloud is dedicated-host-profile PROFILE_NAME [--output JSON] [-q, --quiet]

命令选项

  • PROFILE_NAME：配置文件的名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是专用主机群

列出所有主机组。

ibmcloud is dedicated-host-groups [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--zone ZONE] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --zone：将集合过滤为“zone name”属性与指定名称完全匹配的资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是专用主机组

查看主机组的详细信息。

ibmcloud is dedicated-host-group HOST_GROUP [--output JSON] [-q, --quiet]

命令选项

  • HOST_GROUP：主机组的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 专用主机组创建

创建主机组。

ibmcloud is dedicated-host-group-create --zone ZONE_NAME --family FAMILY --class CLASS [--name NAME] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is dedicated-host-group-create --family memory --class mx2 --zone us-south-1 --name my-host-group
  • ibmcloud is dedicated-host-group-create --family memory --class mx2 --zone us-south-1 --name my-host-group --output JSON

命令选项

  • --zone：区域名称。
  • --name: 主机组的新名称。
  • --family：该组中主机的专用主机配置文件家族。
  • --class：该组中主机的专用主机配置类。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是专用主机组更新

更新主机组。

ibmcloud is dedicated-host-group-update HOST_GROUP --name NEW_NAME [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is dedicated-host-group-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name new-name-host-group
  • ibmcloud is dedicated-host-group-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name new-name-host-group --output JSON

命令选项

  • HOST_GROUP：主机组的 ID 或名称。
  • --name: 主机组的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是专用主机组-删除

删除一个或多个主机组。

ibmcloud is dedicated-host-group-delete (HOST_GROUP1 HOST_GROUP2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • HOST_GROUP1：主机组的 ID 或名称。
  • HOST_GROUP2：主机组的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是专用主机

列出所有主机。

ibmcloud is dedicated-hosts [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--zone ZONE] [--dhg DHG] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --zone：将集合过滤为“zone name”属性与指定名称完全匹配的资源。
  • --dhg：主机组的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是专用主机

查看主机的详细信息。

ibmcloud is dedicated-host HOST [--output JSON] [-q, --quiet]

命令选项

  • 主机：主机的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是专用主机创建

创建主机。

ibmcloud is dedicated-host-create --profile PROFILE --dhg DHG [--enabled true | false] [--name NAME] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is dedicated-host-create --profile dh2-56x344 --dhg 74213016-f179-4055-b161-46fd42a9d98a --name my-host
  • ibmcloud is dedicated-host-create --profile dh2-56x344 --dhg 74213016-f179-4055-b161-46fd42a9d98a --name my-host --enabled false
  • ibmcloud is dedicated-host-create --profile dh2-56x344 --dhg 74213016-f179-4055-b161-46fd42a9d98a --name my-host --output JSON

命令选项

  • --profile：主机配置文件的名称。
  • --dhg：主机组的 ID 或名称。
  • --enabled：启用或禁用在主机中放置实例的功能。 下列其中一项: true 和 false。(缺省值: true)。
  • --name：主机的全新名称。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是专用主机更新

更新主机。

ibmcloud is dedicated-host-update HOST [--name NEW_NAME] [--enabled true | false] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is dedicated-host-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name new-name-host-group
  • ibmcloud is dedicated-host-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name new-name-host-group --enabled false --output JSON

命令选项

  • 主机：主机的ID或名称。
  • --name: 主机的全新名称。
  • --enabled：启用或禁用在主机中放置实例的功能。 以下选项之一：true、false。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是专用主机-删除

删除一个或多个主机。

ibmcloud is dedicated-host-delete (HOST1 HOST2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • 主机1：主机的ID或名称。
  • 主机2：主机的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是专用主机磁盘

列出专用主机的所有磁盘。

ibmcloud is dedicated-host-disks HOST [--output JSON] [-q, --quiet]

命令选项

  • 主机：主机的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是专用主机磁盘

查看专用主机磁盘的详细信息。

ibmcloud is dedicated-host-disk HOST DISK [--output JSON] [-q, --quiet]

命令选项

  • 主机：主机的ID或名称。
  • DISK：专用主机磁盘的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是专用主机-磁盘更新

更新专用主机磁盘。

ibmcloud is dedicated-host-disk-update HOST DISK --name NEW_NAME [--output JSON] [-q, --quiet]

命令选项

  • 主机：主机的ID或名称。
  • DISK：专用主机磁盘的ID或名称。
  • --name: 磁盘的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

Bare metal servers

ibmcloud 是裸机服务器

查看裸机服务器的详细信息。

ibmcloud is bare-metal-server SERVER [--output JSON] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器控制台

打开裸机服务器的交互式控制台。 缺省情况下，此命令会打开交互式串行控制台。

ibmcloud is bare-metal-server-console SERVER [--vnc] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • --vnc：获取 VNC 控制台的 WebSocket URI，不会打开 VNC 控制台。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器创建

创建一台裸机服务器。

ibmcloud is bare-metal-server-create --zone ZONE_NAME --profile PROFILE --image IMAGE --keys KEYS (((--pnic-subnet PRIMARY_NIC_SUBNET [--vpc VPC]) [--pnic-name PRIMARY_NIC_NAME] [--pnic-rip PNIC_RIP | (--pnic-rip-address PNIC_RIP_ADDRESS --pnic-rip-auto-delete true | false --pnic-rip-name PNIC_RIP_NAME)] [--pnic-sgs PNIC_SGS] [--pnic-allowed-vlans PNIC_ALLOWED_VLANS] [--pnic-ein true | false] [--pnic-ais false | true] [--network-interfaces NETWORK_INTERFACES_JSON | @NETWORK_INTERFACES_JSON_FILE]) | ([--pnac-name PRIMARY_NAC_NAME] [--pnac-allowed-vlans PNAC_ALLOWED_VLANS] [--pnac-vni PNAC_VNI | ((--pnac-vni-subnet PNAC_VNI_SUBNET [--vpc VPC]) --pnac-vni-ais false | true --pnac-vni-ein true | false --pnac-vni-auto-delete true | false --pnac-vni-ips VNI_RESERVED_IPS_JSON | @VNI_RESERVED_IPS_JSON_FILE --pnac-vni-name PNAC_VNI_NAME [--pnac-vni-rip PNAC_VNI_RIP | (--pnac-vni-rip-address PNAC_VNI_RIP_ADDRESS --pnac-vni-rip-auto-delete true | false --pnac-vni-rip-name PNAC_VNI_RIP_NAME)] --pnac-vni-sgs PNAC_VNI_SGS [--pnac-vni-psfm auto | enabled | disabled])] [--network-attachments NETWORK_ATTACHMENTS_JSON | @NETWORK_ATTACHMENTS_JSON_FILE])) [--name NAME] [--user-data DATA] [--enable-secure-boot false | true] [--tpm-mode tpm_2 | disabled] [--bandwidth BANDWIDTH] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--reservation-affinity-policy, --res-policy disabled | manual | automatic] [--reservation-affinity-pool, --res-pool RESERVATION_AFFINITY_POOL] [--default-trusted-profile DEFAULT_TRUSTED_PROFILE [--default-trusted-profile-auto-link true,false]] [--metadata-service true | false [--metadata-service-protocol http | https]] [-i, --interactive] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is bare-metal-server-create --name my-server-name --zone us-east-1 --profile bmx2d-24x384 --image cfdaf1a0-5350-4350-fcbc-97173b510844 --keys 7ab1ee27-564c-4730-a1ad-9b9466589250,9727e31a-74d4-45cd-8f39-1ef7484b5f3e --pnic-subnet bdea9c01-ada2-46ba-a314-4b3240477a5f
  • ibmcloud is bare-metal-server-create --name my-server-name --zone us-east-1 --profile bmx2d-24x384 --image ibm-esxi-7-byol-amd64-1 --keys my-sshkey-1,my-sshkey-2 --pnic-subnet my-subnet 创建具有映像、密钥和子网的名称支持的裸机服务器
  • ibmcloud is bare-metal-server-create --name my-server-name2 --zone us-east-1 --profile bmx2d-24x384 --image cfdaf1a0-5350-4350-fcbc-97173b510844 --keys 7ab1ee27-564c-4730-a1ad-9b9466589250,9727e31a-74d4-45cd-8f39-1ef7484b5f3e --pnic-subnet bdea9c01-ada2-46ba-a314-4b3240477a5f --pnic-name eth0 --pnic-rip-address 46.9.49.11 --pnic-sgs c791f26f-4cf1-4bbf-be0e-72d7cb87133e,fefc8362-93c2-4f3d-90d4-82c56cce787e --pnic-allowed-vlans 1,2,3,4 --pnic-ein true --pnic-ais true 使用指定的主网络接口配置创建裸机服务器。
  • ibmcloud is bare-metal-server-create --name my-server-name3 --zone us-east-1 --profile bmx2d-24x384 --image cfdaf1a0-5350-4350-fcbc-97173b510844 --keys 7ab1ee27-564c-4730-a1ad-9b9466589250,9727e31a-74d4-45cd-8f39-1ef7484b5f3e --pnic-subnet bdea9c01-ada2-46ba-a314-4b3240477a5f --enable-secure-boot true --tpm-mode tpm_2 创建一台启用了可信平台模块（TPM）且处于 tpm_2 模式的裸机服务器。
  • ibmcloud is bare-metal-server-create --name my-server-name --zone us-east-1 --profile bmx2d-24x384 --image cfdaf1a0-5350-4350-fcbc-97173b510844 --keys 7ab1ee27-564c-4730-a1ad-9b9466589250,9727e31a-74d4-45cd-8f39-1ef7484b5f3e --pnic-subnet bdea9c01-ada2-46ba-a314-4b3240477a5f --resource-group-name Finance --output JSON 在“ Finance ”资源组中创建一台裸机服务器。
  • ibmcloud is bare-metal-server-create --name my-server-name --zone us-east-1 --profile bmx2d-24x384 --image cfdaf1a0-5350-4350-fcbc-97173b510844 --keys 7ab1ee27-564c-4730-a1ad-9b9466589250,9727e31a-74d4-45cd-8f39-1ef7484b5f3e --pnic-subnet bdea9c01-ada2-46ba-a314-4b3240477a5f --pnic-allowed-vlans 100,200,300,400,700,710,1000,900-929,800-829 创建带有 PCI 网络接口的裸机服务器。 允许的 VLAN 是以逗号分隔的值列表，这些值可以作为单独的值传递，也可以作为任何数字范围传递。
  • ibmcloud is bare-metal-server-create --name my-server-name --zone us-east-1 --profile mz2d-metal-2x32 --image sles15sp3-s390x-byol --keys 7ab1ee27-564c-4730-a1ad-9b9466589250,9727e31a-74d4-45cd-8f39-1ef7484b5f3e --pnac-name cli-pnac-1 --pnac-allowed-vlans 10 --pnac-vni 7322-1293a27a-7178-4e62-ba5b-272623c989aa --network-attachments '[{"interface_type": "pci", "name":"cli-snac-1", "virtual_network_interface": {"allow_ip_spoofing": true, "auto_delete": true, "enable_infrastructure_nat": true, "ips": [{"id": "7322-7594a7b8-dd7f-420c-ad09-a37646950edc"}, {"address": "10.240.128.15", "auto_delete": true, "name": "snac-sip-2"}]}}]' 创建具有网络连接和现有虚拟网络接口的裸机服务器。
  • ibmcloud is bare-metal-server-create --name my-server-name --zone us-east-1 --profile mz2d-metal-2x32 --image sles15sp3-s390x-byol --keys 7ab1ee27-564c-4730-a1ad-9b9466589250,9727e31a-74d4-45cd-8f39-1ef7484b5f3e --pnac-name cli-pnac-1 --pnac-allowed-vlans 10 --pnac-vni 7322-1293a27a-7178-4e62-ba5b-272623c989aa --network-attachments '[{"interface_type": "pci", "name":"cli-snac-1", "virtual_network_interface": {"allow_ip_spoofing": true, "auto_delete": true, "enable_infrastructure_nat": true, "ips": [{"id": "7322-7594a7b8-dd7f-420c-ad09-a37646950edc"}, {"address": "10.240.128.15", "auto_delete": true, "name": "snac-sip-2"}]}}]' 创建具有网络连接和现有虚拟网络接口的裸机服务器。
  • ibmcloud is bare-metal-server-create --name my-server-name --zone us-east-1 --profile bmx2d-24x384 --image cfdaf1a0-5350-4350-fcbc-97173b510844 --keys 7ab1ee27-564c-4730-a1ad-9b9466589250,9727e31a-74d4-45cd-8f39-1ef7484b5f3e --pnic-subnet bdea9c01-ada2-46ba-a314-4b3240477a5f --reservation-affinity-policy manual --reservation-affinity-pool r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 创建具有预留项的裸机服务器。
  • ibmcloud is bare-metal-server-create --name my-server-name --zone us-east-1 --profile bmx2d-24x384 --image cfdaf1a0-5350-4350-fcbc-97173b510844 --keys 7ab1ee27-564c-4730-a1ad-9b9466589250,9727e31a-74d4-45cd-8f39-1ef7484b5f3e --pnic-subnet bdea9c01-ada2-46ba-a314-4b3240477a5f --reservation-affinity-policy manual --reservation-affinity-pool my-reservation 创建具有预留项的裸机服务器。
  • ibmcloud is bare-metal-server-create --name my-server-name --zone us-east-1 --profile bmx2d-24x384 --image cfdaf1a0-5350-4350-fcbc-97173b510844 --keys 7ab1ee27-564c-4730-a1ad-9b9466589250,9727e31a-74d4-45cd-8f39-1ef7484b5f3e --pnic-subnet bdea9c01-ada2-46ba-a314-4b3240477a5f --pnic-rip 2302-74dd56cc-71c4-4461-95f0-4e5e3b57727d 使用预先创建的保留 IP 标识，创建裸机服务器。
  • ibmcloud is bare-metal-server-create --name my-server-name --zone us-east-1 --profile bmx2d-24x384 --image cfdaf1a0-5350-4350-fcbc-97173b510844 --keys 7ab1ee27-564c-4730-a1ad-9b9466589250,9727e31a-74d4-45cd-8f39-1ef7484b5f3e --pnic-subnet bdea9c01-ada2-46ba-a314-4b3240477a5f --pnic-rip 2302-74dd56cc-71c4-4461-95f0-4e5e3b57727d --bandwidth 10000 使用预先创建的预留 IP 标识和带宽，创建裸机服务器。
  • ibmcloud is bare-metal-server-create --name my-server-name --zone us-east-1 --profile bmx2d-24x384 --image cfdaf1a0-5350-4350-fcbc-97173b510844 --keys 7ab1ee27-564c-4730-a1ad-9b9466589250,9727e31a-74d4-45cd-8f39-1ef7484b5f3e --pnic-subnet bdea9c01-ada2-46ba-a314-4b3240477a5f --pnic-rip cli-rip-1 使用按名称预先创建的保留 IP，创建裸机服务器。
  • ibmcloud is bare-metal-server-create --name my-server-name --zone us-east-1 --profile bmx2d-24x384 --image cfdaf1a0-5350-4350-fcbc-97173b510844 --keys 7ab1ee27-564c-4730-a1ad-9b9466589250,9727e31a-74d4-45cd-8f39-1ef7484b5f3e --pnic-subnet bdea9c01-ada2-46ba-a314-4b3240477a5f --pnic-rip-address 10.240.128.38 --pnic-rip-auto-delete true --pnic-rip-name cli-rip1 使用新的保留 IP 创建具有主网络接口的裸机服务器。
  • ibmcloud is bare-metal-server-create --name my-server-name --zone us-east-1 --profile bmx2d-24x384 --image cfdaf1a0-5350-4350-fcbc-97173b510844 --keys 7ab1ee27-564c-4730-a1ad-9b9466589250,9727e31a-74d4-45cd-8f39-1ef7484b5f3e --pnic-subnet bdea9c01-ada2-46ba-a314-4b3240477a5f --pnic-rip 2302-74dd56cc-71c4-4461-95f0-4e5e3b57727d --network-interfaces '[{"name": "cli-snic", "allow_ip_spoofing": true, "enable_infrastructure_nat": true, "interface_type": "pci", "allowed_vlans": [1, 2, 3, 4], "subnet": {"id":"2302-531ad9fc-c86a-4504-b5cf-a46981fddb5f"}, "primary_ip":{"id": "2302-2b09dd0a-9cfb-4639-a2ac-cc6c154ab461"}}]' 使用预先创建的保留 IP 标识，创建具有辅助网络接口的裸机服务器。 已指定两个辅助接口的配置使用 JSON 格式。 请参阅 "--network-interfaces" 选项的帮助文本。
  • ibmcloud is bare-metal-server-create --name my-server-name --zone us-east-1 --profile bmx2d-24x384 --image cfdaf1a0-5350-4350-fcbc-97173b510844 --keys 7ab1ee27-564c-4730-a1ad-9b9466589250,9727e31a-74d4-45cd-8f39-1ef7484b5f3e --pnic-subnet bdea9c01-ada2-46ba-a314-4b3240477a5f --pnic-rip cli-rip-1 --network-interfaces '[{"name": "cli-snic", "allow_ip_spoofing": true, "enable_infrastructure_nat": true, "interface_type": "pci", "allowed_vlans": [1, 2, 3, 4], "subnet": {"id":"2302-531ad9fc-c86a-4504-b5cf-a46981fddb5f"},"primary_ip":{"name": "cli-rip-byname"}}]' 使用按名称预先创建的保留 IP，创建具有辅助网络接口的裸机服务器。 已指定两个辅助接口的配置使用 JSON 格式。 请参阅 "--network-interfaces" 选项的帮助文本。
  • ibmcloud is bare-metal-server-create --name my-server-name --zone us-east-1 --profile bmx2d-24x384 --image cfdaf1a0-5350-4350-fcbc-97173b510844 --keys 7ab1ee27-564c-4730-a1ad-9b9466589250,9727e31a-74d4-45cd-8f39-1ef7484b5f3e --pnic-subnet bdea9c01-ada2-46ba-a314-4b3240477a5f --pnic-rip-address 10.240.128.38 --pnic-rip-auto-delete true --pnic-rip-name cli-rip1 --network-interfaces '[{"name": "cli-snic", "allow_ip_spoofing": true, "enable_infrastructure_nat": true, "interface_type": "pci", "allowed_vlans": [1, 2, 3, 4], "subnet": {"id":"2302-d368b797-2955-464b-aa42-588edd4c389f"}, "primary_ip":{"address": "10.240.128.41"}, "security_groups": [{"id": "72b27b5c-f4b0-48bb-b954-5becc7c1dcb8"}, {"id": "72b27b5c-f4b0-48bb-b954-5becc7c1dcb3"}]}]' 使用新的保留 IP 创建具有辅助网络接口的裸机服务器。 已指定两个辅助接口的配置使用 JSON 格式。 请参阅 "--network-interfaces" 选项的帮助文本。

命令选项

  • --name: 服务器名称。
  • --zone：区域名称。
  • --profile：裸机服务器配置文件的名称。
  • --image：图片的ID或名称。
  • --keys：以逗号分隔的 SSH 密钥的 ID 或名称。 SSH 密钥可以是 RSA 或 Ed25519 密钥。 仅当操作系统支持此密钥类型时，才能使用 Ed25519。 Ed25519 不能与 Windows 或 VMware 映像配合使用。
  • --user-data: data|@data-file. 将要迁移到裸机服务器的用户数据。
  • --pnic-name：主网络接口的名称。
  • --pnic-subnet：主网络接口的子网 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 仅当在此 VPC 中按名称指定唯一子网时，才需要此标识或名称。
  • --pnic-rip：已绑定到主网络接口的现有保留 IP 的 ID 或名称。
  • --pnic-rip-address：要预留的主网络接口的 IP 地址，该地址在子网中不得已被预留。
  • --pnic-rip-auto-delete：如果设置为 true，则在删除目标时，主网络接口的该保留 IP 地址将自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --pnic-rip-name：主网络接口上该保留 IP 的用户自定义名称。 名称在预留 IP 所在的子网中必须是唯一的。 以 ibm- 开头的名称专用于服务商自有资源。
  • --pnic-sgs：主网络接口的以逗号分隔的安全组 ID。
  • --pnic-allowed-vlans: 逗号分隔的 VLAN 标识。 指示哪些 VLAN 标识（仅限 VLAN 接口）可使用主物理接口。 它可以作为单独的值传递，也可以作为任何范围的数字传递。
  • --pnic-ein：启用基础设施NAT（EIN）。 如果为真，VPC 基础设施将执行任何必要的 NAT 操作。 如果为假，则数据包将未经修改地从网络接口传入或传出，从而允许与浮动 IP 关联的虚拟机执行任何必要的 NAT 操作。 下列其中一项: true 和 false。(缺省值: true)。
  • --pnic-ais：允许 IP 欺骗（AIS）。 如果为真，则允许使用该网络接口的数据包进行源 IP 欺骗。 如果为false，则禁止在此接口上伪造源IP地址。 其中一个: false，true。(缺省值: false)。
  • -- network-interfaces:NETWORK_INTERFACES_JSON |@NETWORK_INTERFACES_JSON_FILE。 JSON 或 JSON 文件中的网络接口配置。 关于数据模式，请查阅 API 文档 中的 network_interfaces 属性。 NETWORK_INTERFACES_JSON，@NETWORK_INTERFACES_JSON_FILE 之一。
  • --pnac-name：主网络连接的名称。
  • --pnac-allowed-vlans: 逗号分隔的 VLAN 标识。 指示哪些 VLAN 标识（仅适用于 VLAN 接口）可以使用主网络连接。 它可以作为单独的值传递，也可以作为任何范围的数字传递。
  • --pnac-vni：与主网络连接关联的虚拟网络接口的 ID 或名称。
  • --pnac-vni-subnet：关联的子网。
  • --pnac-vni-ais：允许 IP 欺骗（AIS）。 指示与主网络连接关联的此虚拟网络接口上是否允许源 IP 电子欺骗。 其中一个: false，true。(缺省值: false)。
  • --pnac-vni-ein：启用基础设施 NAT（EIN）。 如果属实，VPC 基础设施将对 VNI 执行任何必要的 NAT 操作。 要将 VNI 连接到实例，该值必须为 true。 Floating_ips 不得具有多个浮动 IP。 如果为false，则数据包在发往或来自VNI时不会被修改，从而允许VNI执行任何必要的NAT操作。 Allow_ip_spoofing 必须为 false。 只能连接到 resource_type 为 bare_metal _server_network_attachment 的目标。 下列其中一项: true 和 false。(缺省值: true)。
  • --pnac-vni-auto-delete：指示与主网络连接关联的此虚拟网络接口是否会在目标被删除时自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --pnac-vni-ips: VNI_RESERVED_IPS_JSON | @VNI_RESERVED_IPS_JSON_FILE，用于绑定到虚拟网络接口的备用预留 IP 地址，格式为 JSON 或 JSON 文件。 有关数据模式，请参阅 API 文档 中的 IPS 属性。 其中一个: VNI_RESERVED_IPS_JSON，@VNI_RESERVED_IPS_JSON_FILE。
  • --pnac-vni-name：与主网络连接关联的此虚拟网络接口的名称。
  • --pnac-vni-rip：要绑定到与主网络连接关联的虚拟网络接口的保留 IP 的 ID 或名称。
  • --pnac-vni-rip-address：用于绑定到与主网络连接关联的虚拟网络接口的预留 IP 地址。
  • --pnac-vni-rip-auto-delete：指示当任一目标被删除，或者该保留 IP 地址被解除绑定时，该保留 IP 地址是否会自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --pnac-vni-rip-name：此保留 IP 地址的名称，用于将其绑定到与主网络连接关联的虚拟网络接口。
  • --pnac-vni-sgs：用于虚拟网络接口的安全组的 ID 或名称（以逗号分隔），这些安全组与主网络连接相关联。
  • --pnac-vni-psfm：此虚拟网络接口应采用的协议状态过滤模式。 如果设置为“自动”，则协议状态数据包过滤功能是否启用或禁用，取决于虚拟网络接口的 target 资源类型。 其中一个: auto，enabled，disabled。(缺省值: auto)。
  • -- network-Attachment: NETWORK_ATTACHMENTS_JSON |@NETWORK_ATTACHMENTS_JSON_FILE。 网络附件配置在 JSON 或 JSON 文件中。 有关数据模式，请参阅 API 文档 中的 network_attachments 属性。 NETWORK_ATTACHMENTS_JSON，@NETWORK_ATTACHMENTS_JSON_FILE 之一。
  • --enable-secure-boot：指示是否启用了安全启动。 如果启用，那么映像必须支持安全引导，否则服务器将无法引导。 其中一个: false，true。(缺省值: false)。
  • --tpm-mode：可信平台模块（TPM）的工作模式。 其中一个: tpm_2，已禁用。
  • --带宽：裸机服务器各网络接口共享的总带宽（单位：兆比特每秒）。 如果未指定，则使用概要文件中的缺省值。 您可以使用命令 ibmcloud is 裸机-server-profile 来获取有效的带宽值。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --reservation-affinity-policy, --res-policy：此裸机服务器应采用的预留亲和性策略。 如果池不为空，策略缺省为"手动"。 否则，策略将缺省为"自动"。 其中之一：禁用、手动、自动。
  • --reservation-affinity-pool，--res-pool： 该裸机服务器可使用的预留资源的 ID、名称或 CRN。
  • --default-trusted-profile：受信任配置文件的 ID、名称或 CRN。
  • --default-trusted-profile-auto-link：如果设置为 true，系统将在创建服务器时生成指向指定目标受信任配置文件的链接。 无论链接是由系统创建还是通过 IAM 身份服务手动创建，它都会在服务器被删除时自动删除。 下列其中一项: true，false。(缺省值: true)。
  • --metadata-service：启用或禁用裸机服务器的元数据服务。 以下选项之一：true、false。
  • --metadata-service-protocol：元数据服务端点的通信协议。 仅当启用了元数据服务时，协议才适用。 http 和 https 之一。(缺省值: http)。
  • --interactive, -i：
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is 裸机服务器删除

删除一个或多个裸机服务器。

ibmcloud is bare-metal-server-delete (SERVER1 SERVER2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • SERVER1：服务器的ID或名称。
  • SERVER2：服务器的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器磁盘

查看裸机服务器磁盘的详细信息。

ibmcloud is bare-metal-server-disk SERVER SERVER_DISK [--output JSON] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • SERVER_DISK：服务器磁盘的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器磁盘更新

更新裸机服务器的磁盘。

ibmcloud is bare-metal-server-disk-update SERVER SERVER_DISK --name NEW_NAME [--output JSON] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • SERVER_DISK：服务器磁盘的 ID 或名称。
  • --name: 本地磁盘的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器磁盘

列出裸机服务器的所有磁盘。

ibmcloud is bare-metal-server-disks SERVER [--output JSON] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器初始化值

检索用于初始化裸机服务器的配置变量。

ibmcloud is bare-metal-server-initialization-values SERVER [--private-key (KEY | @KEY_FILE) [--private-key-passphrase PRIVATE_KEY_PASSPHRASE]] [--output JSON] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • -- private-key: key|@key-file。 用于解密密码的 PEM 格式的专用密钥。
  • --private-key-passphrase：加密私钥的密码短语。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器网络接口

查看裸机服务器的网络接口详细信息。

ibmcloud is bare-metal-server-network-interface SERVER NIC [--output JSON] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • NIC：网络接口的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is 裸机-server-network-interface-create

为裸机服务器创建一个网络接口。

ibmcloud is bare-metal-server-network-interface-create SERVER --subnet SUBNET (--interface-type pci | vlan) [--name NAME] [[--rip RIP | (--address ADDRESS --auto-delete true | false --ip-name IP_NAME)]] [--security-groups SECURITY_GROUPS] [--vpc VPC] [--allowed-vlans ALLOWED_VLANS | --vlan VLAN --allow-interface-to-float false | true] [--allow-ip-spoofing false | true] [--enable-infrastructure-nat true | false] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is bare-metal-server-network-interface-create 7d317c32-71f8-4060-9bdc-6c971b0317d4 --subnet dcaec790-f0b0-48e6-b4cb-03dd82b745c0 创建 PCI 网络接口。
  • ibmcloud is bare-metal-server-network-interface-create my-server --subnet my-subnet 创建具有名称支持的 PCI 网络接口。
  • ibmcloud is bare-metal-server-network-interface-create my-server --subnet my-subnet --vpc my-vpc 在 VPC 下创建具有名称支持的 PCI 网络接口。
  • ibmcloud is bare-metal-server-network-interface-create 7d317c32-71f8-4060-9bdc-6c971b0317d4 --subnet dcaec790-f0b0-48e6-b4cb-03dd82b745c0 --interface-type pci --name eth1 --address 10.0.0.12 --security-groups 43846d71-0f04-473f-9de5-5a2d33200a4b,27c8ca96-17f3-4943-898d-ad1a1f5aec26 --allowed-vlans 1,2,3,4 -allow-ip-spoofing true --enable-infrastructure-nat true 使用指定的配置创建 PCI 网络接口。
  • ibmcloud is bare-metal-server-network-interface-create 7d317c32-71f8-4060-9bdc-6c971b0317d4 --subnet dcaec790-f0b0-48e6-b4cb-03dd82b745c0 --interface-type pci --name eth1 --address 10.0.0.12 --security-groups 43846d71-0f04-473f-9de5-5a2d33200a4b,27c8ca96-17f3-4943-898d-ad1a1f5aec26 --vpc my-vpc --allowed-vlans 1,2,3,4 -allow-ip-spoofing true --enable-infrastructure-nat true 在 VPC 下创建具有指定配置的 PCI 网络接口。
  • ibmcloud is bare-metal-server-network-interface-create my-server --subnet my-subnet --interface-type pci --name eth1 --address 10.0.0.12 --security-groups my-sg-1,my-sg-2 --allowed-vlans 1,2,3,4 -allow-ip-spoofing true --enable-infrastructure-nat true 使用指定的配置创建具有名称支持的 PCI 网络接口。
  • ibmcloud is bare-metal-server-network-interface-create 7d317c32-71f8-4060-9bdc-6c971b0317d4 --subnet dcaec790-f0b0-48e6-b4cb-03dd82b745c0 --interface-type vlan --name eth2 --address 10.0.0.12 --security-groups 43846d71-0f04-473f-9de5-5a2d33200a4b,27c8ca96-17f3-4943-898d-ad1a1f5aec26 --vlan 1 -allow-interface-to-float true -allow-ip-spoofing true --enable-infrastructure-nat true 使用指定的配置创建 VLAN 网络接口。
  • ibmcloud is bare-metal-server-network-interface-create 7d317c32-71f8-4060-9bdc-6c971b0317d4 --subnet dcaec790-f0b0-48e6-b4cb-03dd82b745c0 --output JSON 创建 PCI 网络接口并指定 JSON 作为输出格式。
  • ibmcloud is bm-nicc bm-cli-1 --subnet cli-subnet-1 --name bm-cli-nic-secondary --allowed-vlans 210,510,500,3001-1001 创建 PCI 网络接口。 允许的 VLAN 是以逗号分隔的值列表，这些值可以作为单独的值传递，也可以作为任何数字范围传递。
  • ibmcloud is bm-nicc cli-bm --subnet alex-subnet --name cli-snic-3 --rip 2302-aef75588-7b87-46b7-bca4-0d6893d2593e 使用预先创建的预留 IP，创建裸机 NIC。
  • ibmcloud is bm-nicc cli-bm --subnet alex-subnet --name cli-snic-3 --rip cli-rip-byname3 使用按名称预先创建的预留 IP，创建裸机 NIC。
  • ibmcloud is bm-nicc cli-bm --subnet 2302-531ad9fc-c86a-4504-b5cf-a46981fddb5f --name cli-snic --address 10.240.128.51 --auto-delete true --ip-name cli-snicip 使用新的预留 IP 创建裸机 NIC。

命令选项

  • 服务器：服务器的 ID 或名称。
  • --subnet：网络接口的子网 ID 或名称。
  • --name: 网络接口的名称。
  • --interface-type：网络接口的类型。 其中一个: pci，vlan。(缺省值: pci)。
  • --rip：现有保留 IP 的 ID 或名称。
  • --address：要预留的 IP 地址，该地址在子网中不得已被预留。
  • --auto-delete：如果设置为 true，则当目标被删除时，该预留 IP 地址将自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --ip-name：此预留 IP 的用户自定义名称。 名称在预留 IP 所在的子网中必须是唯一的。 以 ibm- 开头的名称专用于服务商自有资源。
  • --security-groups：网络接口的、以逗号分隔的安全组 ID 或名称。
  • --vpc：VPC 的 ID 或名称。 只需要在此 VPC 中按名称指定唯一子网和唯一安全组。
  • --allowed-vlans：以逗号分隔的 VLAN ID。 指示哪些 VLAN 标识（仅限 VLAN 接口）可使用此 PCI 接口。 它可以作为单独的值传递，也可以作为任何范围的数字传递。
  • --vlan：指定 802.1Q 的VLAN ID标签，该标签必须用于此VLAN接口上的所有流量。
  • --allow-interface-to-float：指示该接口是否可以迁移到同一资源组内的任何其他服务器上。 当网络在该资源组中的另一台 bare metal server 上检测到 GARP 或 RARP 时，此接口会自动浮动。 仅适用于 VLAN 接口。 其中一个: false，true。(缺省值: false)。
  • --allow-ip-spoofing：允许 IP 欺骗（AIS）。 如果为真，则允许使用该网络接口的数据包进行源 IP 欺骗。 如果为false，则禁止在此接口上伪造源IP地址。 其中一个: false，true。(缺省值: false)。
  • --enable-infrastructure-nat：启用基础设施 NAT（EIN）。 如果为真，VPC 基础设施将执行任何必要的 NAT 操作。 如果为假，则数据包将未经修改地从网络接口传入或传出，从而允许与浮动 IP 关联的虚拟机执行任何必要的 NAT 操作。 下列其中一项: true 和 false。(缺省值: true)。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is 裸机-server-network-interface-delete

从裸机服务器中移除一个或多个网络接口。

ibmcloud is bare-metal-server-network-interface-delete SERVER (NIC1 NIC2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • NIC1：网络接口的ID或名称。
  • NIC2：网络接口的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器网络接口浮动 IP

查看与网络接口关联的浮动 IP 的详细信息。

ibmcloud is bare-metal-server-network-interface-floating-ip SERVER NIC FLOATING_IP [--output JSON] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • NIC：网络接口的ID或名称。
  • FLOATING_IP：浮动 IP 的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is 裸机-server-network-interface-浮动-ip-add

将浮动 IP 与网络接口相关联。

ibmcloud is bare-metal-server-network-interface-floating-ip-add SERVER NIC FLOATING_IP [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is bare-metal-server-network-interface-floating-ip-add 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 1a6b7274-678d-4dfb-8981-c71dd9d4daa5 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3
  • ibmcloud is bare-metal-server-network-interface-floating-ip-add 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 1a6b7274-678d-4dfb-8981-c71dd9d4daa5 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --output JSON 将浮动 IP 与裸机服务器上的网络接口关联，并指定 JSON 作为输出格式。

命令选项

  • 服务器：服务器的 ID 或名称。
  • NIC：网络接口的ID或名称。
  • FLOATING_IP：浮动 IP 的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is 裸机-server-network-interface-浮动-ip-remove

解除浮动 IP 与网络接口的关联。

ibmcloud is bare-metal-server-network-interface-floating-ip-remove SERVER NIC FLOATING_IP [-f, --force] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • NIC：网络接口的ID或名称。
  • FLOATING_IP：浮动 IP 的 ID 或名称。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器网络接口浮动 ips

列出与某个网络接口关联的所有浮动 IP 地址。

ibmcloud is bare-metal-server-network-interface-floating-ips SERVER NIC [--output JSON] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • NIC：网络接口的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is 裸机-server-network-interface-update

更新裸机服务器的网络接口。

ibmcloud is bare-metal-server-network-interface-update SERVER NIC --name NEW_NAME [--allow-ip-spoofing false | true] [--enable-infrastructure-nat true | false] [--allowed-vlans ALLOWED_VLANS] [--output JSON] [-q, --quiet]

命令示例

  • ic is bm-nicu 7d317c32-71f8-4060-9bdc-6c971b0317d4 784e2e4c-0540-4e1a-aba7-a51f9b35ba52 --name eth0 --allow-ip-spoofing true --enable-infrastructure-nat true -allowed-vlans 1,3,5
  • ic is bm-nicu 7d317c32-71f8-4060-9bdc-6c971b0317d4 784e2e4c-0540-4e1a-aba7-a51f9b35ba52 --name ethvlan1 --allow-ip-spoofing true --enable-infrastructure-nat true --output JSON
  • ic is bm-nicu my-bm-server my-bm-nic --name eth0 --allow-ip-spoofing true --enable-infrastructure-nat true -allowed-vlans 1,3,5
  • ic is bm-nicu my-bm-server eth0 --name ethvlan1 --allow-ip-spoofing true --enable-infrastructure-nat true --output JSON
  • ibmcloud is bm-nicu bm-cli-1 bm-cli-nic-secondary --allowed-vlans 210,500-600,3001-1001

命令选项

  • 服务器：服务器的 ID 或名称。
  • NIC：网络接口的ID或名称。
  • --name: 网络接口的新名称。
  • --allow-ip-spoofing：允许 IP 欺骗（AIS）。 如果为真，则允许使用该网络接口的数据包进行源 IP 欺骗。 如果为false，则禁止在此接口上伪造源IP地址。 其中一个: false，true。(缺省值: false)。
  • --enable-infrastructure-nat：启用基础设施 NAT（EIN）。 如果为真，VPC 基础设施将执行任何必要的 NAT 操作。 如果为假，则数据包将未经修改地从网络接口传入或传出，从而允许与浮动 IP 关联的虚拟机执行任何必要的 NAT 操作。 下列其中一项: true 和 false。(缺省值: true)。
  • --allowed-vlans：以逗号分隔的 VLAN ID。 指示哪些 VLAN 标识（仅限 VLAN 接口）可使用此 PCI 接口。 它可以作为单独的值传递，也可以作为任何范围的数字传递。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器网络接口

列出裸机服务器的所有网络接口。

ibmcloud is bare-metal-server-network-interfaces SERVER [--output JSON] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器概要文件

查看裸机服务器配置文件的详细信息。

ibmcloud is bare-metal-server-profile PROFILE_NAME [--output JSON] [-q, --quiet]

命令选项

  • PROFILE_NAME：配置文件的名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器概要文件

列出该区域内的所有裸机服务器配置文件。

ibmcloud is bare-metal-server-profiles [--output JSON] [-q, --quiet]

命令选项

  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器重新启动

重启一台裸机服务器。

ibmcloud is bare-metal-server-restart SERVER [-f, --force] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器启动

启动一台裸机服务器。

ibmcloud is bare-metal-server-start SERVER [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器停止

停止一台裸机服务器。

ibmcloud is bare-metal-server-stop SERVER [--type soft | hard] [-f, --force] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • -- type: 指示停止操作的类型。软: 向正在运行的操作系统发出信号以停顿并完全关闭。hard: 立即停止服务器。 soft，hard 之一。(缺省值: soft)。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器更新

更新一台裸机服务器。

ibmcloud is bare-metal-server-update SERVER [--name NEW_NAME] [--enable-secure-boot false | true] [--tpm-mode tpm_2 | disabled] [--bandwidth BANDWIDTH] [--reservation-affinity-policy, --res-policy disabled | manual | automatic] [--metadata-service true | false [--metadata-service-protocol http | https]] [--reservation-affinity-pool, --res-pool RESERVATION_AFFINITY_POOL] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is bare-metal-server-update 7d317c32-71f8-4060-9bdc-6c971b0317d4 --name my-server --enable-secure-boot true --tpm-mode tpm_2
  • ibmcloud is bare-metal-server-update 7d317c32-71f8-4060-9bdc-6c971b0317d4 --name my-server --output JSON
  • ibmcloud is bare-metal-server-update 7d317c32-71f8-4060-9bdc-6c971b0317d4 --bandwidth 25000 --output JSON
  • ibmcloud is bare-metal-server-update 7d317c32-71f8-4060-9bdc-6c971b0317d4 --reservation-affinity-policy manual --reservation-affinity-pool r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2
  • ibmcloud is bare-metal-server-update 7d317c32-71f8-4060-9bdc-6c971b0317d4 --reservation-affinity-policy disabled
  • ibmcloud is bare-metal-server-update my-baremetal-1 --name my-bm-server --output JSON

命令选项

  • 服务器：服务器的 ID 或名称。
  • --name: 裸机服务器的全新名称。
  • --enable-secure-boot：指示是否启用了安全启动。 如果启用，那么映像必须支持安全引导，否则服务器将无法引导。 在更改此配置之前，裸机服务器的状态必须为已停止。 其中一个: false，true。
  • --tpm-mode：可信平台模块（TPM）的工作模式。 其中一个: tpm_2，已禁用。
  • --带宽：裸机服务器各网络接口共享的总带宽（单位：兆比特每秒）。 如果未指定，则使用概要文件中的缺省值。 您可以使用命令 ibmcloud is 裸机-server-profile 来获取有效的带宽值。
  • --reservation-affinity-policy, --res-policy：此裸机服务器应采用的预留亲和性策略。 如果池不为空，策略缺省为"手动"。 否则，策略将缺省为"自动"。 其中之一：禁用、手动、自动。
  • --metadata-service：启用或禁用裸机服务器的元数据服务。 以下选项之一：true、false。
  • --metadata-service-protocol：元数据服务端点的通信协议。 仅当启用了元数据服务时，协议才适用。 http 和 https 之一。(缺省值: http)。
  • --reservation-affinity-pool，--res-pool： 该裸机服务器可使用的预留资源的 ID、名称或 CRN。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器

列出所有裸机服务器。

ibmcloud is bare-metal-servers [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--vpc VPC] [--reservation RESERVATION] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --vpc：VPC 的 ID、名称或 CRN。
  • --reservation：预订的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器固件更新

将裸机服务器更新为最新固件。

ibmcloud is bare-metal-server-firmware-update SERVER [--auto-start true | false] [-f, --force] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • --auto-start：指定在固件更新成功后是否自动启动裸机服务器。 下列其中一项: true 和 false。(缺省值: true)。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is 裸机-server-network-interface-reserved-ips

列出绑定到裸机服务器的网络接口的所有预留 IP。

ibmcloud is bare-metal-server-network-interface-reserved-ips SERVER NIC [--output JSON] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • NIC：网络接口的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is 裸机-server-network-interface-reserved-ip

如果指定的预留 IP 地址绑定到裸机服务器的网络接口，那么检索该地址。

ibmcloud is bare-metal-server-network-interface-reserved-ip SERVER NIC RESERVED_IP [--output JSON] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • NIC：网络接口的ID或名称。
  • RESERVED_IP：预留 IP 的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器网络附件

列出裸机服务器的所有网络连接。

ibmcloud is bare-metal-server-network-attachments SERVER [--output JSON] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器网络连接

查看裸机服务器的网络连接详细信息。

ibmcloud is bare-metal-server-network-attachment SERVER NAC [--output JSON] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • NAC：网络连接的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is 裸机-server-network-attachment-create

为裸机服务器创建网络连接。

ibmcloud is bare-metal-server-network-attachment-create SERVER (--interface-type pci | vlan) [--vni VNI | ((--vni-subnet VNI_SUBNET [--vpc VPC]) --vni-ais false | true --vni-ein true | false --vni-auto-delete true | false --vni-ips VNI_RESERVED_IPS_JSON | @VNI_RESERVED_IPS_JSON_FILE --vni-name VNI_NAME [--vni-rip VNI_RIP | (--vni-rip-address VNI_RIP_ADDRESS --vni-rip-auto-delete VNI_RIP_AUTO_DELETE --vni-rip-name VNI_RIP_NAME)] [--vni-psfm auto | enabled | disabled] --vni-sgs VNI_SGS)] [--name NAC_NAME] [--allowed-vlans ALLOWED_VLANS] [--allow-to-float ALLOW_TO_FLOAT] [--vlan VLAN] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is bare-metal-server-network-attachment-create my-bare-metal-server-nw-att --interface-type pci --vni bm-cli-vni-2 --name bm-nac-3 --allowed-vlans 10-50
  • ibmcloud is bare-metal-server-network-attachment-create 2302-f097c96c-c092-4929-b093-b9d4a481c20d --interface-type pci --vni-subnet 2302-a31b7225-c513-481b-be6b-9df9396f69ae --vni-ais false --vni-ein false --vni-auto-delete true --vni-ips '[{"id": "2302-8e9060c3-90d8-4c73-b07c-215f60c87a2e"},{"address": "10.240.133.22"}]' --vni-name bm-vni-2 --vni-rip-address 10.240.133.22 --vni-rip-auto-delete true --vni-rip-name bm-rip-11 --vni-sgs r134-61c9d87e-0a7d-4a5f-9c8a-a7475ebf182e,r134-244e457e-59ef-43de-9317-dba6de040ced --name bm-nac-10 --allowed-vlans 10-50
  • ibmcloud is bare-metal-server-network-attachment-create my-bare-metal-server-nw-att --interface-type vlan --vni-subnet subnet-us-3 --vpc travis-long-run-vpc --vni-ais true --vni-ein true --vni-auto-delete true --vni-ips '[{"id": "2302-4bc26be6-2d4a-4090-a645-f50c22091902"}]' --vni-name bm-vni-1 --vni-rip rip-cli-12 --vni-sgs abundantly-gangly-aspire-discuss,travis-long-run-sg1 --name bm-nac-30 --allow-to-float true --vlan 10
  • ibmcloud is bare-metal-server-network-attachment-create cli-bm-1 --interface-type vlan --vni-subnet subnet-us-3 --vpc cli-vpc --vni-ais true --vni-ein true --vni-psfm disabled --vni-auto-delete true --vni-ips '[{"id": "2302-4bc26be6-2d4a-4090-a645-f50c22091902"}]' --vni-name bm-vni-1 --vni-rip rip-cli-12 --vni-sgs abundantly-gangly-aspire-discuss,travis-long-run-sg1 --name bm-nac-30 --allow-to-float true --vlan 10

命令选项

  • 服务器：服务器的 ID 或名称。
  • --name：此裸机服务器网络连接的名称。
  • --interface-type：网络连接接口类型。 其中一个: pci，vlan。(缺省值: pci)。
  • --allowed-vlans：以逗号分隔的 VLAN ID。 指示哪些 VLAN 标识（仅适用于 VLAN 类型）可以使用此物理（PCI 类型）连接。 它可以作为单独的值传递，也可以作为任何范围的数字传递。
  • --allow-to-float：指示裸机服务器的网络连接是否可以自动迁移到同一资源组内的任何其他服务器上。
  • --vlan：指定 802.1Q 的VLAN ID标签，该标签必须用于此连接上的所有流量。
  • --vni：用于此裸机服务器网络连接的虚拟网络接口的 ID 或名称。
  • --vni-subnet：关联的子网。
  • --vpc：VPC 的 ID 或名称。 仅当在此 VPC 中按名称指定唯一子网时，才需要此标识或名称。
  • --vni-ais：允许 IP 欺骗（AIS）。 指示此虚拟网络接口上是否允许源 IP 电子欺骗。 其中一个: false，true。(缺省值: false)。
  • --vni-ein：启用基础设施 NAT（EIN）。 如果为真，VPC 基础设施将执行任何必要的 NAT 操作。 如果为false，则数据包将未经修改地从虚拟网络接口传入或传出，这使得与浮动IP关联的虚拟机能够执行任何必要的NAT操作。 下列其中一项: true 和 false。(缺省值: true)。
  • --vni-auto-delete：指示当目标被删除时，此虚拟网络接口是否会自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --vni-ips: ips VNI_RESERVED_IPS_JSON | @VNI_RESERVED_IPS_JSON_FILE，以 JSON 或 JSON 文件格式提供的备用 IP 地址，用于绑定到虚拟网络接口。 关于数据模式，请查阅 API 文档 中的 ips 属性。 其中一个: VNI_RESERVED_IPS_JSON，@VNI_RESERVED_IPS_JSON_FILE。
  • --vni-name：此虚拟网络接口的名称。
  • --vni-rip：要绑定到虚拟网络接口的保留 IP 的 ID 或名称。 如果未指定子网，那么为必填。 必须取消绑定保留的 IP。
  • --vni-rip-address：用于绑定到虚拟网络接口的预留 IP 地址。 需要指定子网。
  • --vni-rip-auto-delete：指定当任一目标被删除，或者该预留 IP 地址被解除绑定时，该预留 IP 地址是否自动删除。
  • --vni-rip-name：此预留 IP 地址用于绑定到虚拟网络接口的名称。 该名称不得由子网中的另一个保留 IP 使用。 以 ibm- 开头的名称专用于服务提供商拥有的资源，因此不允许使用。
  • --vni-psfm：此虚拟网络接口应采用的协议状态过滤模式。 如果设置为“自动”，则协议状态数据包过滤功能是否启用或禁用，取决于虚拟网络接口的 target 资源类型。 其中一个: auto，enabled，disabled。(缺省值: auto)。
  • --vni-sgs：用于此虚拟网络接口的安全组的 ID 或名称，以逗号分隔。 如果未指定，那么将使用子网的 VPC 的缺省安全组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器网络连接更新

更新裸机服务器的网络连接。

ibmcloud is bare-metal-server-network-attachment-update SERVER NAC --name NEW_NAME [--allowed-vlans ALLOWED_VLANS] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is bm-nacu my-bare-metal-server-nw-att cli-pnac-1-primary --name nac-2
  • ibmcloud is bm-nacu 2302-f097c96c-c092-4929-b093-b9d4a481c20d 2302-9688e589-ec0d-4611-9984-4bf88082414b --name nac-1 --allowed-vlans 10,20-50

命令选项

  • 服务器：服务器的 ID 或名称。
  • NAC：网络连接的ID或名称。
  • --name: 网络连接的新名称。
  • --allowed-vlans：以逗号分隔的 VLAN ID。 指示哪些 VLAN 标识（仅适用于 VLAN 类型）可以使用此物理（PCI 类型）连接。 它可以作为单独的值传递，也可以作为任何范围的数字传递。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is 裸机-server-network-attachment-delete

从裸机服务器中除去一个或多个网络连接。

ibmcloud is bare-metal-server-network-attachment-delete SERVER (NAC1 NAC2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • 服务器：服务器的 ID 或名称。
  • NAC1：网络连接的ID或名称。
  • NAC2：网络连接的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是裸机服务器初始化替换

使用指定的映像和 SSH 密钥重新初始化裸机服务器。

ibmcloud is bare-metal-server-initialization-replace SERVER --image IMAGE --keys KEYS [--default-trusted-profile DEFAULT_TRUSTED_PROFILE [--default-trusted-profile-auto-link true,false]] [--user-data DATA] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is bare-metal-server-initialization-replace server-name --image r006-ed3f775f-ad7e-4e37-ae62-7199b4988b00 --keys r006-02a07b78-6e5f-40a2-86a2-99e01916128c,r006-29e19fb1-e2b9-49d0-ab6e-9702e99f5021 --user-data @/tmp/userdata.sh 使用指定的映像和 SSH 密钥重新初始化裸机服务器。 服务器必须处于停止状态才能重新初始化。

命令选项

  • 服务器：服务器的 ID 或名称。
  • --image：图片的ID或名称。
  • --keys：以逗号分隔的 SSH 密钥的 ID 或名称。 SSH 密钥可以是 RSA 或 Ed25519 密钥。 仅当操作系统支持此密钥类型时，才能使用 Ed25519。 Ed25519 不能与 Windows 或 VMware 映像配合使用。
  • --default-trusted-profile：受信任配置文件的 ID、名称或 CRN。
  • --default-trusted-profile-auto-link：如果设置为 true，系统将在创建服务器时生成指向指定目标受信任配置文件的链接。 无论链接是由系统创建还是通过 IAM 身份服务手动创建，它都会在服务器被删除时自动删除。 下列其中一项: true，false。(缺省值: true)。
  • --user-data: data|@data-file. 将要迁移到裸机服务器的用户数据。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

集群网络

下一节将详细介绍可用于处理群集网络的 CLI 命令。

ibmcloud 是集群-网络-文件

列出某个区域中的所有集群网络配置文件。

ibmcloud is cluster-network-profiles [--output JSON] [-q, --quiet]

命令选项

  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是集群网络配置文件

查看集群网络配置文件的详细信息。

ibmcloud is cluster-network-profile PROFILE_NAME [--output JSON] [-q, --quiet]

命令选项

  • PROFILE_NAME：集群网络配置文件的名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud是集群网络

列出所有集群网络。

ibmcloud is cluster-networks [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是集群网络

查看集群网络的详细信息。

ibmcloud is cluster-network CLUSTER_NETWORK [--output JSON] [-q, --quiet]

命令选项

  • CLUSTER_NETWORK：集群网络的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是集群-网络-创建

创建集群网络。

ibmcloud is cluster-network-create --vpc VPC --zone ZONE --profile PROFILE [--name NAME] [--subnet-prefixes-cidr SUBNET_PREFIXES_CIDR] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is cluster-network-create --vpc my-vpc --zone us-south-1 --profile profile-name
  • ibmcloud is cluster-network-create --vpc my-vpc --zone us-south-1 --profile profile-name --name my-cl-net
  • ibmcloud is cluster-network-create --vpc my-vpc --zone us-south-1 --profile profile-name --name my-cl-net --subnet-prefixes-cidr 10.0.0.24/24
  • ibmcloud is cluster-network-create --vpc my-vpc --zone us-south-1 --profile profile-name
  • ibmcloud is cluster-network-create --vpc my-vpc --zone us-south-1 --profile profile-name --name my-cl-net
  • ibmcloud is cluster-network-create --vpc my-vpc --zone us-south-1 --profile profile-name --name my-cl-net --subnet-prefixes-cidr 10.0.0.24/24 --output JSON

命令选项

  • --vpc：VPC 的 ID 或名称。
  • --zone：该集群网络所在的区域。 区域必须在指定的集群网络概要文件中被列为受支持。
  • --profile：此集群网络要使用的配置文件名称。
  • --name: 集群网络的名称。
  • --subnet-prefixes-cidr：集群网络子网前缀的 IPv4 范围，以CIDR格式表示。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud是集群-网络-更新

更新群集网络。

ibmcloud is cluster-network-update CLUSTER_NETWORK [--name NEW_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is cluster-network-update my-cl-network --name my-updated-cl-net
  • ibmcloud is cluster-network-update r006-345545d8-798c-4dbc-112g-5c34a1e75e45 --name my-updated-cl-net

命令选项

  • CLUSTER_NETWORK：集群网络的 ID 或名称。
  • --name: 集群网络的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是集群-网络-删除

删除一个或多个集群网络。

ibmcloud is cluster-network-delete (CLUSTER_NETWORK1 CLUSTER_NETWORK2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • CLUSTER_NETWORK1：集群网络的 ID 或名称。
  • CLUSTER_NETWORK2：集群网络的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是集群-网络-接口

列出所有集群网络接口。

ibmcloud is cluster-network-interfaces CLUSTER_NETWORK [--output JSON] [-q, --quiet]

命令选项

  • CLUSTER_NETWORK：集群网络的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是集群网络接口

查看集群网络接口的详细信息。

ibmcloud is cluster-network-interface CLUSTER_NETWORK CLUSTER_NETWORK_INTERFACE [--output JSON] [-q, --quiet]

命令选项

  • CLUSTER_NETWORK：集群网络的 ID 或名称。
  • CLUSTER_NETWORK_INTERFACE：集群网络接口的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是集群-网络-接口-创建

创建一个集群网络接口。

ibmcloud is cluster-network-interface-create CLUSTER_NETWORK --subnet SUBNET (--rip RIP | (--rip-address RIP_ADDRESS --rip-auto-delete true | false --rip-name RIP_NAME)) [--name NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is cluster-network-interface-create my-cl-net --rip r134-2fbe71a8-126e-4a05-80ad-dad45df491a5 --subnet r124-72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 使用 RIP 标识创建集群网络接口。
  • ibmcloud is cluster-network-interface-create my-cl-net --rip r134-2fbe71a8-126e-4a05-80ad-dad45df491a5 --subnet my-subnet 使用 RIP 标识创建集群网络接口。
  • ibmcloud is cluster-network-interface-create my-cl-net --rip r134-2fbe71a8-126e-4a05-80ad-dad45df491a5 --subnet my-subnet --name my-cl-net-intf 使用 RIP 标识创建集群网络接口。
  • ibmcloud is cluster-network-interface-create --rip-address 10.2.0.1 --rip-auto-delete true --rip-name my-subnet-rip --subnet r124-72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --name my-cl-net-intf 使用 RIP 原型创建集群网络接口。
  • ibmcloud is cluster-network-interface-create --rip-address 10.2.0.1 --rip-auto-delete true --rip-name my-subnet-rip --subnet my-subnet --name my-cl-net-intf 使用 RIP 原型创建集群网络接口。

命令选项

  • CLUSTER_NETWORK：集群网络的 ID 或名称。
  • --subnet：集群网络子网的 ID 或名称。
  • --rip：用于将主 IP 地址绑定到集群网络接口的保留 IP 的 ID 或名称。
  • --rip-address：要绑定到集群网络接口的预留 IP 地址，该地址在子网中不得已被预留。
  • --rip-auto-delete：指示当任一目标被删除，或集群网络子网预留 IP 被解除绑定时，该集群网络子网预留 IP 成员是否自动删除。 以下选项之一：true、false。
  • --rip-name：此集群网络子网中预留 IP 的名称。
  • --name: 集群网络接口的名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud是集群-网络-接口-更新

更新集群网络接口。

ibmcloud is cluster-network-interface-update CLUSTER_NETWORK CLUSTER_NETWORK_INTERFACE [--name NEW_NAME] [--auto-delete true | false] [--output JSON] [-q, --quiet]

命令示例

更新集群网络接口。

命令选项

  • CLUSTER_NETWORK：集群网络的 ID 或名称。
  • CLUSTER_NETWORK_INTERFACE：集群网络接口的 ID 或名称。
  • --name: 集群网络的新名称。
  • --auto-delete：指定当任一目标被删除，或集群网络子网预留 IP 被解除绑定时，该集群网络子网预留 IP 成员是否自动删除。 以下选项之一：true、false。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是集群-网络-接口-删除

删除一个或多个集群网络接口。

ibmcloud is cluster-network-interface-delete CLUSTER_NETWORK (CLUSTER_NETWORK_INTERFACE1 CLUSTER_NETWORK_INTERFACE2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • CLUSTER_NETWORK：集群网络的 ID 或名称。
  • CLUSTER_NETWORK_INTERFACE1：集群网络接口的 ID 或名称。
  • CLUSTER_NETWORK_INTERFACE2：集群网络接口的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是集群-网络-子网

列出所有集群网络子网。

ibmcloud is cluster-network-subnets CLUSTER_NETWORK [--output JSON] [-q, --quiet]

命令选项

  • CLUSTER_NETWORK：集群网络的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是集群-网络-子网

查看集群网络子网的详细信息。

ibmcloud is cluster-network-subnet CLUSTER_NETWORK CLUSTER_NETWORK_SUBNET [--output JSON] [-q, --quiet]

命令选项

  • CLUSTER_NETWORK：集群网络的 ID 或名称。
  • CLUSTER_NETWORK_SUBNET：集群网络子网的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 创建集群-网络-子网

创建一个集群网络子网。

ibmcloud is cluster-network-subnet-create CLUSTER_NETWORK (--total-ipv4-address-count TOTAL_IPV4_ADDRESS_COUNT | --ipv4-cidr-block IPV4_CIDR_BLOCK) [--name NAME] [--ip-version ipv4] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is cluster-network-subnet-create --total-ipv4-address-count 256 --name my-cl-net-sub --ip-version ipv4 使用 IPv4 地址总数创建集群网络子网。
  • ibmcloud is cluster-network-subnet-create --ipv4-cidr-block 10.0.0.0/24 --name my-cl-net-sub --ip-version ipv4 使用 ipv4 cidr 块创建集群网络子网。

命令选项

  • CLUSTER_NETWORK：集群网络的 ID 或名称。
  • --total-ipv4-address-count：所需的 IPv4 地址总数。 必须是 2 的幂。
  • --ipv4-cidr-block：集群网络子网的 IPv4 范围，以CIDR格式表示。
  • --name：此集群网络子网的名称。
  • --ip-version：此集群网络子网应支持的 IP 版本。 其中之一：ipv4。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是集群-网络-子网-更新

更新集群网络子网。

ibmcloud is cluster-network-subnet-update CLUSTER_NETWORK CLUSTER_NETWORK_SUBNET [--name NEW_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is cluster-network-subnet-update my-cl-net-sub --name my-updated-cl-net-sub
  • ibmcloud is cluster-network-subnet-update r006-345545d8-798c-4dbc-112g-5c34a1e75e45 --name my-updated-cl-net-sub

命令选项

  • CLUSTER_NETWORK：集群网络的 ID 或名称。
  • CLUSTER_NETWORK_SUBNET：集群网络子网的 ID 或名称。
  • --name: 集群网络子网的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是集群-网络-子网-删除

删除一个或多个集群网络子网。

ibmcloud is cluster-network-subnet-delete CLUSTER_NETWORK (CLUSTER_NETWORK_SUBNET1 CLUSTER_NETWORK_SUBNET2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • CLUSTER_NETWORK：集群网络的 ID 或名称。
  • CLUSTER_NETWORK_SUBNET1：集群网络子网的 ID 或名称。
  • CLUSTER_NETWORK_SUBNET2：集群网络子网的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 集群-网络-子网-保留IP地址

列出所有集群网络子网中预留的IP地址。

ibmcloud is cluster-network-subnet-reserved-ips CLUSTER_NETWORK CLUSTER_NETWORK_SUBNET [--output JSON] [-q, --quiet]

命令选项

  • CLUSTER_NETWORK：集群网络的 ID 或名称。
  • CLUSTER_NETWORK_SUBNET：集群网络子网的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是集群-网络-子网-保留IP

查看集群网络子网中预留 IP 的详细信息。

ibmcloud is cluster-network-subnet-reserved-ip CLUSTER_NETWORK CLUSTER_NETWORK_SUBNET CLUSTER_NETWORK_SUBNET_RESERVED_IP [--output JSON] [-q, --quiet]

命令选项

  • CLUSTER_NETWORK：集群网络的 ID 或名称。
  • CLUSTER_NETWORK_SUBNET：集群网络子网的 ID 或名称。
  • CLUSTER_NETWORK_SUBNET_RESERVED_IP：集群网络子网预留 IP 的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 创建集群网络子网保留IP

创建集群网络子网保留 IP。

ibmcloud is cluster-network-subnet-reserved-ip-create CLUSTER_NETWORK CLUSTER_NETWORK_SUBNET [--name NAME] [--address ADDRESS] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is cluster-network-subnet-reserved-ip-create my-cnet my-cnet-sub 创建集群网络子网保留 IP。
  • ibmcloud is cluster-network-subnet-reserved-ip-create r134-2fbe71a8-126e-4a05-80ad-dad45df491a5 r124-72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --name NAME my-cl-net-sub-rip 创建集群网络子网保留 IP。
  • ibmcloud is cluster-network-subnet-reserved-ip-create my-cl-net my-cl-net-sub --name NAME my-cl-net-sub-rip --address 192.168.3.4 创建集群网络子网保留 IP。
  • ibmcloud is cluster-network-subnet-reserved-ip-create r134-2fbe71a8-126e-4a05-80ad-dad45df491a5 r124-72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --name NAME my-cl-net-sub-rip --address 192.168.3.4 创建集群网络子网保留 IP。

命令选项

  • CLUSTER_NETWORK：集群网络的 ID 或名称。
  • CLUSTER_NETWORK_SUBNET：集群网络子网的 ID 或名称。
  • --name：此集群网络子网预留 IP 的名称。
  • --address：要预留的 IP 地址，该地址在子网中不得已被预留。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 群集-网络-子网-保留IP-更新

更新群集网络。

ibmcloud is cluster-network-subnet-reserved-ip-update CLUSTER_NETWORK CLUSTER_NETWORK_SUBNET CLUSTER_NETWORK_SUBNET_RESERVED_IP [--auto-delete AUTO_DELETE] [--name NEW_NAME] [--output JSON] [-q, --quiet]

命令示例

更新集群网络子网保留 IP。

命令选项

  • CLUSTER_NETWORK：集群网络的 ID 或名称。
  • CLUSTER_NETWORK_SUBNET：集群网络子网的 ID 或名称。
  • CLUSTER_NETWORK_SUBNET_RESERVED_IP：集群网络子网预留 IP 的 ID 或名称。
  • --auto-delete：指定当任一目标被删除，或集群网络子网预留 IP 被解除绑定时，该集群网络子网预留 IP 成员是否自动删除。 如果集群网络子网保留 IP 未绑定，则必须为 false。
  • --name：集群网络子网预留 IP 的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 群集-网络-子网-保留IP-删除

删除一个或多个集群网络子网保留 IP。

ibmcloud is cluster-network-subnet-reserved-ip-delete CLUSTER_NETWORK CLUSTER_NETWORK_SUBNET (CLUSTER_NETWORK_SUBNET_RESERVED_IP1 CLUSTER_NETWORK_SUBNET_RESERVED_IP2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • CLUSTER_NETWORK：集群网络的 ID 或名称。
  • CLUSTER_NETWORK_SUBNET：集群网络子网的 ID 或名称。
  • CLUSTER_NETWORK_SUBNET_RESERVED_IP1：集群网络子网保留 IP 的 ID 或名称。
  • CLUSTER_NETWORK_SUBNET_RESERVED_IP2：集群网络子网保留 IP 的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

放置组

ibmcloud 是布置组

查看安置组的详细信息。

ibmcloud is placement-group PLACEMENT_GROUP [--output JSON] [-q, --quiet]

命令选项

  • PLACEMENT_GROUP：定位组的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是安置组-创建

创建放置组。

ibmcloud is placement-group-create (--strategy host_spread | power_spread) [--name NAME] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is placement-group-create --strategy host_spread
  • ibmcloud is placement-group-create --strategy host_spread --output JSON

命令选项

  • --strategy：此投放组的策略。 其中一个: host_扩频，power_扩频。
  • --name: 放置组的名称。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 placement-group-delete

删除一个或多个放置组。

ibmcloud is placement-group-delete (PLACEMENT_GROUP1 PLACEMENT_GROUP2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • PLACEMENT_GROUP1：安置组的 ID 或名称。
  • PLACEMENT_GROUP2：安置组的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 placement-group-update

更新放置组。

ibmcloud is placement-group-update PLACEMENT_GROUP --name NEW_NAME [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is placement-group-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name new-name
  • ibmcloud is placement-group-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name new-name --output JSON

命令选项

  • PLACEMENT_GROUP：定位组的 ID 或名称。
  • --name: 放置组的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是安置组

列出所有布置组。

ibmcloud is placement-groups [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

保留量

ibmcloud 是预留

查看预留的详细信息。

ibmcloud is reservation RESERVATION [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is reservation r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2
  • ibmcloud is reservation my-reservation-name

命令选项

  • 预订：预订编号或预订名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是预留

列出所有预留。

ibmcloud is reservations [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--zone ZONE] [--profile-resource-type instance_profile | bare_metal_server_profile] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is reservations
  • ibmcloud is reservations --zone us-east-1
  • ibmcloud is reservations --resource-group-id fee82deba12e4c0fb69c3b09d1f12345
  • ibmcloud is reservations --profile-resource-type bare_metal_server_profile
  • ibmcloud is reservations --profile-resource-type instance_profile

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --zone：将集合过滤为“zone name”属性与指定名称完全匹配的资源。
  • --profile-resource-type：配置文件的资源类型。 其中之一：instance_profile、bare_metal_server_profile。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is reservation-创建

创建预留。

ibmcloud is reservation-create --capacity CAPACITY (--term one_year | three_year) --profile PROFILE_NAME (--profile-resource-type instance_profile | bare_metal_server_profile) --zone ZONE_NAME [--name NEW_NAME] [--affinity-policy restricted | automatic] [--expiration-policy release | renew] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is reservation-create --name reservation-1 --capacity 10 --term one_year --profile cx2-2x4 --profile-resource-type instance_profile --zone us-east-1
  • ibmcloud is reservation-create --name reservation-2 --capacity 5 --term three_year --profile cx2-2x4 --profile-resource-type instance_profile --zone us-south-1 --resource-group-name Default --expiration-policy renew
  • ibmcloud is reservation-create --name reservation-3 --capacity 8 --term three_year --profile cx2-2x4 --profile-resource-type instance_profile --zone us-south-2 --expiration-policy release --affinity-policy restricted --resource-group-id 11baaa8984beb82690daab08767et --output JSON
  • ibmcloud is reservation-create --name my-reservation --capacity 2 --term three_year --profile cx2-2x4 --profile-resource-type instance_profile --zone us-south-2 --expiration-policy release --affinity-policy automatic --resource-group-id 11baaa8984beb82690daab08767et --output JSON

命令选项

  • --name: 预订名称。
  • --capacity：此预留的容量配置。
  • --term：预订期限。 其中一个: one_year，three_year。
  • --profile：此预订要使用的配置文件名称。
  • --profile-resource-type：配置文件的资源类型。 其中之一：instance_profile、bare_metal_server_profile。
  • --zone：区域名称。
  • --affinity-policy：此预留应采用的亲和性策略。 其中之一：受限、自动。(默认：自动）。
  • --expiration-policy：当已承诺的使用期限到期时应适用的策略。 其中一个: release，续订。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是预留-更新

更新预留。

ibmcloud is reservation-update RESERVATION [--name NEW_NAME] [--capacity CAPACITY] [--term one_year | three_year] [--expiration-policy release | renew] [--profile PROFILE_NAME] [--profile-resource-type instance_profile | bare_metal_server_profile] [--affinity-policy restricted | automatic] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is reservation-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --name reservation-1-new --capacity 7 --term one_year --profile profile-1-new --profile-resource-type instance_profile
  • ibmcloud is reservation-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --expiration-policy renew

命令选项

  • 预订：预订编号或预订名称。
  • --name: 预订名称。
  • --capacity：此预留的容量配置。
  • --term：预订期限。 其中一个: one_year，three_year。
  • --expiration-policy：当已承诺的使用期限到期时应适用的策略。 其中一个: release，续订。
  • --profile：此预订要使用的配置文件名称。
  • --profile-resource-type：配置文件的资源类型。 其中之一：instance_profile、bare_metal_server_profile。
  • --affinity-policy：此预留应采用的亲和性策略。 其中之一：受限、自动。(默认：自动）。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是预留-删除

删除一个或多个预留。

ibmcloud is reservation-delete (RESERVATION1 RESERVATION2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is reservation-delete r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2

命令选项

  • 预订1：预订的ID或名称。
  • 预订2：预订的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是预留-激活

激活预留。

ibmcloud is reservation-activate RESERVATION [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is reservation-activate r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2

命令选项

  • 预订：预订编号或预订名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

自动缩放命令

以下部分提供了有关用于自动缩放功能的 CLI 命令的信息。

实例模板

ibmcloud 是实例模板

列出该区域内的所有模板。

ibmcloud is instance-templates [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-template

查看实例模板的详细信息。

ibmcloud is instance-template TEMPLATE [--output JSON] [-q, --quiet]

命令选项

  • 模板：模板的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 实例模板创建

创建实例模板。

ibmcloud is instance-template-create INSTANCE_TEMPLATE_NAME VPC ZONE_NAME PROFILE_NAME SUBNET (--image IMAGE | (--catalog-offering CATALOG_OFFERING | --catalog-offering-version CATALOG_OFFERING_VERSION) [--catalog-offering-plan CATALOG_OFFERING_PLAN]) (([--pnac-name PRIMARY_NAC_NAME] [--pnac-vni PNAC_VNI | (--pnac-vni-ais false | true --pnac-vni-ein true | false --pnac-vni-auto-delete true | false --pnac-vni-ips VNI_RESERVED_IPS_JSON | @VNI_RESERVED_IPS_JSON_FILE --pnac-vni-name PNAC_VNI_NAME [--pnac-vni-rip PNAC_VNI_RIP | (--pnac-vni-rip-address PNAC_VNI_RIP_ADDRESS --pnac-vni-rip-auto-delete true | false --pnac-vni-rip-name PNAC_VNI_RIP_NAME)] --pnac-vni-sgs PNAC_VNI_SGS [--pnac-vni-psfm auto | enabled | disabled])] [--network-attachments NETWORK_ATTACHMENTS_JSON | @NETWORK_ATTACHMENTS_JSON_FILE]) | [([--rip RIP | (--address ADDRESS --auto-delete true | false --ip-name IP_NAME)] [--allow-ip-spoofing false | true]) | --primary-network-interface PRIMARY_NETWORK_INTERFACE_JSON | @PRIMARY_NETWORK_INTERFACE_JSON_FILE] [--network-interface NETWORK_INTERFACE_JSON | @NETWORK_INTERFACE_JSON_FILE]) [--total-volume-bandwidth TOTAL_VOLUME_BANDWIDTH] [--boot-volume BOOT_VOLUME_JSON | @BOOT_VOLUME_JSON_FILE] [--volume-attach VOLUME_ATTACH_JSON | @VOLUME_ATTACH_JSON_FILE] [--keys KEYS] [--dedicated-host DEDICATED_HOST | --dedicated-host-group DEDICATED_HOST_GROUP | --placement-group PLACEMENT_GROUP] [--reservation-affinity-policy, --res-policy disabled | manual | automatic] [--reservation-affinity-pool, --res-pool RESERVATION_AFFINITY_POOL] [--user-data DATA] [--sgs SGS] [--metadata-service, --ms true | false [--metadata-service-protocol, --msp http | https | --metadata-service-response-hop-limit, --msrhl METADATA_SERVICE_RESPONSE_HOP_LIMIT,MSRHL]] [--host-failure-policy restart | stop] [--confidential-compute-mode disabled | sgx | tdx] [--enable-secure-boot true | false] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [[--cluster-network-attachments CLUSTER_NETWORK_ATTACHMENTS_JSON | @CLUSTER_NETWORK_ATTACHMENTS_JSON_FILE]] [--volume-bandwidth-qos-mode pooled | weighted] [--vcpu-percentage VCPU_PERCENTAGE] [--availability-class spot | standard] [--preemption-policy delete | stop] [--threads-per-core 1 | 2] [--output JSON] [-i, --interactive] [-q, --quiet]

命令示例

  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --volume-attach '[{"volume": {"name":"my-volume-name", "capacity":10, "profile": {"name": "general-purpose"},"user_tags": ["my-tag-1"]}}]' 创建具有卷连接的实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --volume-attach '[{"volume": {"name":"my-volume-name", "bandwidth":1000, "capacity":10, "profile": {"name": "general-purpose"},"user_tags": ["my-tag-1"]}}]' 创建具有卷连接和带宽的实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --volume-attach '[{"volume": {"id":"67531475-bd8a-478e-bcfe-2e53365cd0aa"}}]' 使用卷连接中的现有卷创建实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --keys 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8,72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 创建具有多个 SSH 密钥的实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"name": "my-boot-vol", "capacity": 150, "profile": {"name": "general-purpose"}}}' 创建具有引导卷容量的映像的实例模板。 容量值可在映像的最小预配大小与 250 之间取值。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"name": "my-boot-vol", "profile": {"name": "general-purpose"},"user_tags": ["my-tag-1"]}}' 创建具有引导卷和具有用户标记的引导卷的实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"profile": {"name": "general-purpose"},"encryption_key": {"crn": "crn:v1:bluemix:public:kms:us-south:adffc98a0f1f0f95f6613b3b752286b87:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"}}}' 创建具有加密引导卷的实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"bandwidth":1000, "profile": {"name": "general-purpose"},"encryption_key": {"crn": "crn:v1:bluemix:public:kms:us-south:adffc98a0f1f0f95f6613b3b752286b87:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179"}}}' 创建具有加密引导卷和带宽的实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --network-interface '[{"name": "secondary-nic", "allow_ip_spoofing": true, "subnet": {"id":"72b27b5c-f4b0-48bb-b954-5becc7c1dcb3"}, "security_groups": [{"id": "72b27b5c-f4b0-48bb-b954-5becc7c1dcb8"}, {"id": "72b27b5c-f4b0-48bb-b954-5becc7c1dcb3"}]}]' 创建连接到辅助网络接口的实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --primary-network-interface '{"name": "primary-nic", "allow_ip_spoofing": true, "subnet": {"id":"72b27b5c-f4b0-48bb-b954-5becc7c1dcb3"}, "primary_ip": {"address": "10.240.129.10", "auto-delete": true, "name": "my-reserved-ip"}, "security_groups": [{"id": "72b27b5c-f4b0-48bb-b954-5becc7c1dcb8"}, {"id": "72b27b5c-f4b0-48bb-b954-5becc7c1dcb3"}]}' 使用 JSON 格式的主网络接口配置创建实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --sgs 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8,72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --address 10.240.129.10 --auto-delete true --ip-name my-reserved-ip --allow-ip-spoofing true 创建包含安全组，保留 IP 设置和源 IP 电子欺骗设置的主网络接口配置的实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --sgs 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8,72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --reserved-ip 0711-5c7f016e-5bd2-42e3-8dff-81519e4e2469 --allow-ip-spoofing true 使用包含安全组，现有保留 IP 和源 IP 电子欺骗设置的主网络接口配置创建实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --dedicated-host c019b1f7-c4d6-430c-aaa4-e0cc25d47277 创建要放置在所需专用主机中的实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --dedicated-host-group a4738ceb-5e59-4601-849a-61d7895740ee 创建要放置在所需专用主机组中的实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --placement-group 1d2afa0f-b9f2-4d85-ae35-a08885269644 创建要放置在所需放置组中的实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --total-volume-bandwidth 4000 创建具有特定总卷带宽的实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --metadata-service true 在启用或禁用元数据服务的情况下创建实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --metadata-service true --metadata-service-protocol http --metadata-service-response-hop-limit 60 创建具有元数据服务配置的实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --reservation-affinity-policy manual --reservation-affinity-pool r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 创建具有预留亲缘关系的实例。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --reservation-affinity-policy manual --reservation-affinity-pool crn:v1:bluemix:public:is:us-south:a/123456::vpc:4727d842-f94f-4a2d-824a-9bc9b02c523b 创建具有预留亲缘关系的实例。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --host-failure-policy restart 在发生主机故障时使用可用性策略创建实例模板。
  • ibmcloud is instance-template-create my-template-name my-vpc us-south-1 bx2-2x8 my-subnet --image ibm-ubuntu-20-04-2-minimal-amd64-1 --volume-attach '[{"volume": {"name":"my-vol-1"}}]' 使用资源名称在卷连接中创建具有现有卷的实例模板。
  • ibmcloud is instance-template-create my-template-name my-vpc us-south-1 mx2-2x16 my-subnet --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --dedicated-host my-dedicated-host 借助资源名称，创建要放置在所需专用主机中的实例模板。
  • ibmcloud is instance-template-create my-template-name my-vpc us-south-1 mx2-2x16 my-subnet --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --dedicated-host-group my-dedicated-host-group 借助资源名称，创建要放置在所需专用主机组中的实例模板。
  • ibmcloud is instance-template-create my-template-name my-vpc us-south-1 mx2-2x16 my-subnet --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --placement-group my-placement-host-group 借助资源名称，创建要放置在所需放置组中的实例模板。
  • ibmcloud is instance-template-create my-template-name my-vpc us-south-1 bx2-2x8 --image ibm-ubuntu-20-04-2-minimal-amd64-1 --primary-network-interface '{"name": "primary-nic", "allow_ip_spoofing": true, "subnet": {"name":"my-subnet"}, "primary_ip": {"name": "my-reserved-ip"}, "security_groups": [{"name": "my-security-group-1"}, {"name": "my-security-group-2"}]}' 借助资源名称，使用主网络接口配置创建实例模板。
  • ibmcloud is instance-template-create my-template-name my-vpc us-south-1 bx2-2x8 my-subnet --image ibm-ubuntu-20-04-2-minimal-amd64-1 --network-interface '[{"name": "secondary-nic", "allow_ip_spoofing": true, "subnet": {"id":"my-subnet"}, "security_groups": [{"id": "my-security-group-1"}, {"id": "my-security-group-2"}]}]' 借助资源名称，创建连接到辅助网络接口的实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"id": "67531475-bd8a-478e-bcfe-2e53365cd0aa"}}' 从现有引导卷创建实例。
  • ibmcloud is instance-template-create my-template-name my-vpc us-south-1 bx2-2x8 my-subnet --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"name": "my-existing-boot-vol"}}' 使用资源名称从现有引导卷创建实例。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --catalog-offering crn:v1:bluemix:public:globalcatalog-collection:global:a/efe5afc483594adaa8325e2b4d1290df:2497ae83-40cb-46ba-ac7f-5303514a2669:offering:54372a73-7a0a-4799-ac9c-8736620c67f1 使用目录产品创建实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --catalog-offering-version crn:v1:bluemix:public:globalcatalog-collection:global:a/efe5afc483594adaa8325e2b4d1290df:2497ae83-40cb-46ba-ac7f-5303514a2669:offering:54372a73-7a0a-4799-ac9c-8736620c67f1 创建具有目录产品版本的实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --catalog-offering-version crn:v1:bluemix:public:globalcatalog-collection:global:a/efe5afc483594adaa8325e2b4d1290df:2497ae83-40cb-46ba-ac7f-5303514a2669:offering:54372a73-7a0a-4799-ac9c-8736620c67f1 --catalog-offering-plan crn:v1:bluemix:public:globalcatalog-collection:global:a/123456:51c9e0db-2911-45a6-adb0-ac5332d27cf2:plan:sw.51c9e0db-2911-45a6-adb0-ac5332d27cf2.772c0dbe-aa62-482e-adbe-a3fc20101e0e 从目录产品版本和计划创建实例。
  • ibmcloud is instance-template-create --interactive 以交互方式创建实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --pnac-name cli-pnac-1 --pnac-vni 7322-1293a27a-7178-4e62-ba5b-272623c989aa --network-attachments [{"name": "instance-snac-1","virtual_network_interface": {"id":"02h7-56705448-c9d9-43dc-aa11-20d42333cd87"}}] --image --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 创建具有网络连接和现有虚拟网络接口的实例。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --pnac-name cli-pnac-1 --pnac-vni-ais true --pnac-vni-ein true --pnac-vni-auto-delete true --pnac-vni-ips [{"id": "7322-f61b85bd-d963-4069-bb72-b58ed9ebc9f5"}] --pnac-vni-name cli-panc-vni-1 --pnac-vni-rip bee-olympics-perplexed-briskness --network-attachments [{"name": "instance-snac-1","virtual_network_interface": {"id":"02h7-56705448-c9d9-43dc-aa11-20d42333cd87"}}] 使用现有保留 IP 创建具有网络连接和新的虚拟网络接口的实例。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --pnac-name cli-pnac-1 --pnac-vni-ais true --pnac-vni-ein true --pnac-vni-auto-delete true --pnac-vni-ips [{"id": "7322-f61b85bd-d963-4069-bb72-b58ed9ebc9f5"},{"address": "10.240.128.13", "auto_delete" : true, "name": "vni-pnac-sip-1"}] --pnac-vni-name cli-panc-vni-1 --pnac-vni-rip-address 10.240.128.13 --pnac-vni-rip-auto-delete true --pnac-vni-rip-name pnac-vni-rip-1 --pnac-vni-sgs r134-8e0e4ad9-4ca3-4d5f-b9d8-7a967693d231 使用现有保留 IP 创建具有网络连接和新的虚拟网络接口的实例。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --cluster-network-attachments '[{"name": "instance-cnac-1","cluster_network_interface": {"id":"02h7-56705448-c9d9-43dc-aa11-20d42333cd87"}}]' 使用具有现有预留 IP 的现有集群网络接口的集群网络连接，创建实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --cluster-network-attachments '[{"name":"cli-cnac-1", "cluster_network_interface": {"auto_delete": true, "name": "cni-1", "primary_ip": { "auto-delete": true, "name": "my-reserved-ip"}, "subnet": "72b27b5c-f4b0-48bb-b954-5becc7c1dcb8"}}]' 使用集群网络连接创建实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 mx2-2x16 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --volume-bandwidth-qos-mode pooled 创建采用特定卷带宽 QoS 方式的实例。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --vcpu-percentage 50 创建一个具有共享核心的实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 bx2-2x8 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --availability-class spot --preemption-policy stop 创建竞价实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 hx4da-8x32 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --threads-per-core 1 创建一个按每核线程数配置的实例模板。
  • ibmcloud is instance-template-create my-template-name 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 us-south-1 hx4da-8x32 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --threads-per-core 2 创建一个按每核线程数配置的实例模板。

命令选项

  • INSTANCE_TEMPLATE_NAME：实例模板的名称。
  • VPC：VPC 的 ID 或名称。 使用命令 'ibmcloud is vpcs' 来获取 VPC。
  • ZONE_NAME：区域名称。 使用命令 'ibmcloud is zones' 来获取可用专区。
  • PROFILE_NAME：配置文件的名称。 使用命令 'ibmcloud is instance-profiles' 来获取实例概要文件。
  • 子网：子网的 ID 或名称。 使用命令 'ibmcloud is subnets' 来获取子网标识或名称。
  • --image：图片的ID或名称。
  • --catalog-offering：IBM Cloud 产品目录条目的 CRN。 如果指定了此选项，那么将使用该产品的最新版本。 有关创建目录商品的更多信息，请参阅 “将软件接入您的账户”。
  • --catalog-offering-version：IBM Cloud 目录产品版本的 CRN。 有关为目录产品创建版本的更多信息，请参阅《 将软件接入您的账户 》。
  • --catalog-offering-plan：IBM Cloud 目录产品计费方案的 CRN。 如果未指定，则不使用计费套餐（免费）。 必须为需要计费套餐的目录产品版本指定。
  • --total-volume-bandwidth：专门分配给实例存储卷的带宽量（单位为兆比特每秒）。 此值的增加将导致网络总带宽相应降低。
  • --boot-volume: BOOT_VOLUME_JSON|@BOOT_VOLUME_JSON_FILE，以 JSON 或 JSON 文件形式指定的启动卷挂载。 有关数据模式，请参阅 API 文档 中的 boot_volume_attachment 属性。
  • --volume-attach: VOLUME_ATTACH_JSON|@VOLUME_ATTACH_JSON_FILE，以 JSON 或 JSON 文件形式指定的卷挂载信息，包含卷列表。 有关数据模式，请参阅 API 文档 中的 volume_attachments 属性。
  • --keys：以逗号分隔的 SSH 密钥的 ID 或名称。 SSH 密钥可以是 RSA 或 Ed25519 密钥。 仅当操作系统支持此密钥类型时，才能使用 Ed25519。 Ed25519 不能与 Windows 或 VMware 映像配合使用。
  • --dedicated-host：实例所在的目标主机的 ID 或名称。
  • --dedicated-host-group：实例所属的主机组目标的 ID 或名称。
  • --placement-group：放置组的 ID 或名称。 虚拟服务器实例的放置组限制。
  • --reservation-affinity-policy, --res-policy：此虚拟服务器实例应采用的预留亲和性策略。 如果池不为空，策略缺省为“手动”。 如果设置了放置目标，则策略缺省为“禁用”。 在所有其他情况下，策略缺省为“自动”。 其中之一：禁用、手动、自动。
  • --reservation-affinity-pool，--res-pool： 该虚拟服务器实例可使用的预留资源的 ID、名称或 CRN。
  • --user-data: data|@data-file. 要传输到虚拟服务器实例的用户数据。
  • --rip：现有保留 IP 的 ID 或名称。
  • --address：要预留的 IP 地址，该地址在子网中不得已被预留。
  • --auto-delete：如果设置为 true，则当目标被删除时，该预留 IP 地址将自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --ip-name：此预留 IP 的用户自定义名称。 名称在预留 IP 所在的子网中必须是唯一的。 以 ibm- 开头的名称专用于服务商自有资源。
  • --allow-ip-spoofing：禁用该接口上的源地址和目标地址检查。 如果为false，则不允许在此接口上进行源IP欺骗。 其中一个: false，true。
  • --primary-network-interface: PRIMARY_NETWORK_INTERFACE_JSON|@PRIMARY_NETWORK_INTERFACE_JSON_FILE，以 JSON 或 JSON 文件形式指定的主网络接口。 有关数据模式，请参阅 API 文档 中的 primary_network_interface 属性。
  • --network-interface: NETWORK_INTERFACE_JSON|@NETWORK_INTERFACE_JSON_FILE，以 JSON 或 JSON 文件格式指定的网络接口绑定。 有关数据模式，请参阅 API 文档 中的 network_interfaces 属性。
  • --pnac-name：主网络连接的名称。
  • --pnac-vni：与主网络连接关联的虚拟网络接口的 ID 或名称。
  • --pnac-vni-ais：允许 IP 欺骗（AIS）。 指示与主网络连接关联的此虚拟网络接口上是否允许源 IP 电子欺骗。 其中一个: false，true。(缺省值: false)。
  • --pnac-vni-ein：启用基础设施 NAT（EIN）。 如果属实，VPC 基础设施将对 VNI 执行任何必要的 NAT 操作。 要将 VNI 连接到实例，该值必须为 true。 Floating_ips 不得具有多个浮动 IP。 如果为false，则数据包在发往或来自VNI时不会被修改，从而允许VNI执行任何必要的NAT操作。 Allow_ip_spoofing 必须为 false。 只能连接到 resource_type 为 bare_metal _server_network_attachment 的目标。 下列其中一项: true 和 false。(缺省值: true)。
  • --pnac-vni-auto-delete：指示与主网络连接关联的此虚拟网络接口是否会在目标被删除时自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --pnac-vni-ips: VNI_RESERVED_IPS_JSON | @VNI_RESERVED_IPS_JSON_FILE，用于绑定到虚拟网络接口的备用预留 IP 地址，格式为 JSON 或 JSON 文件。 有关数据模式，请参阅 API 文档 中的 IPS 属性。 其中一个: VNI_RESERVED_IPS_JSON，@VNI_RESERVED_IPS_JSON_FILE。
  • --pnac-vni-name：与主网络连接关联的此虚拟网络接口的名称。
  • --pnac-vni-rip：要绑定到与主网络连接关联的虚拟网络接口的保留 IP 的 ID 或名称。
  • --pnac-vni-rip-address：用于绑定到与主网络连接关联的虚拟网络接口的预留 IP 地址。
  • --pnac-vni-rip-auto-delete：指示当任一目标被删除，或者该保留 IP 地址被解除绑定时，该保留 IP 地址是否会自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --pnac-vni-rip-name：此保留 IP 地址的名称，用于将其绑定到与主网络连接关联的虚拟网络接口。
  • --pnac-vni-sgs：用于虚拟网络接口的安全组的 ID 或名称（以逗号分隔），这些安全组与主网络连接相关联。
  • --pnac-vni-psfm：此虚拟网络接口应采用的协议状态过滤模式。 如果设置为“自动”，则协议状态数据包过滤功能是否启用或禁用，取决于虚拟网络接口的 target 资源类型。 其中一个: auto，enabled，disabled。(缺省值: auto)。
  • -- network-Attachment: NETWORK_ATTACHMENTS_JSON |@NETWORK_ATTACHMENTS_JSON_FILE。 网络附件配置在 JSON 或 JSON 文件中。 有关数据模式，请参阅 API 文档 中的 network_attachments 属性。 NETWORK_ATTACHMENTS_JSON，@NETWORK_ATTACHMENTS_JSON_FILE 之一。
  • --sgs：主网络接口或主网络连接的以逗号分隔的安全组 ID 或名称。
  • --metadata-service, --ms：启用或禁用实例元数据服务。 以下选项之一：true、false。
  • --metadata-service-protocol，--msp：元数据服务端点的通信协议。 仅当启用了元数据服务时，协议才适用。 http 和 https 之一。(缺省值: http)。
  • --metadata-service-response-hop-limit，--msrhl： 元数据服务返回的 IP 响应数据包的跳数限制（IP 生存时间）。
  • --host-failure-policy：当计算主机发生故障时应执行的操作。 其中一个: restart，stop。(缺省值: restart)。
  • --confidential-compute-mode：此虚拟服务器实例要使用的机密计算模式。 如果未指定，那么将使用概要文件中的缺省保密计算方式。 残疾、SGX、TDX 其中之一。
  • --enable-secure-boot：指示此虚拟服务器实例是否启用了安全启动。 如果未指定，那么将使用概要文件中的缺省安全引导方式。 以下选项之一：true、false。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --cluster-network-attachments：cluster_network_attachments_json|@cluster_network_attachments_json_file。 集群网络连接配置位于 JSON 或 JSON 文件中。 有关数据模式，请参阅 API 文档 中的 cluster_network_attachments 属性。 有关群集网络的更多信息，请参阅“群集网络”。 以下之一：CLUSTER_NETWORK_ATTACHMENTS _JSON ，@CLUSTER_NETWORK_ATTACHMENTS_JSON_FILE。
  • --volume-bandwidth-qos-mode：此虚拟服务器实例应采用的卷带宽 QoS 模式。 必须在实例概要文件的 volume_bandwidth_qos_modes 中列出指定的值。 其中之一：集合、加权。
  • --vcpu-percentage：分配给该实例的 vCPU 时钟周期的百分比。 范围为 1-100。
  • --availability-class：虚拟服务器实例的可用性类。 其中之一：斑点、标准。
  • --preemption-policy：当虚拟服务器实例被抢占时应执行的操作。 其中之一是：删除，停止。
  • --threads-per-core：此虚拟服务器实例的每核线程数。 如果未指定，则使用配置文件的默认值。 其中一个: 1，2。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --interactive, -i：
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-template-create-override-source-template

通过重写源模板来创建实例模板。

ibmcloud is instance-template-create-override-source-template --source-template SOURCE_TEMPLATE (([--pnac-name PRIMARY_NAC_NAME] [--pnac-vni PNAC_VNI | ((--pnac-vni-subnet PNAC_VNI_SUBNET [--vpc VPC]) --pnac-vni-ais false | true --pnac-vni-ein true | false --pnac-vni-auto-delete true | false --pnac-vni-ips VNI_RESERVED_IPS_JSON | @VNI_RESERVED_IPS_JSON_FILE --pnac-vni-name PNAC_VNI_NAME [--pnac-vni-rip PNAC_VNI_RIP | (--pnac-vni-rip-address PNAC_VNI_RIP_ADDRESS --pnac-vni-rip-auto-delete true | false --pnac-vni-rip-name PNAC_VNI_RIP_NAME)] --pnac-vni-sgs PNAC_VNI_SGS [--pnac-vni-psfm auto | enabled | disabled])] [--network-attachments NETWORK_ATTACHMENTS_JSON | @NETWORK_ATTACHMENTS_JSON_FILE]) | (--subnet SUBNET [--rip RIP | (--address ADDRESS --auto-delete true | false --ip-name IP_NAME)] [--allow-ip-spoofing false | true]) | --primary-network-interface PRIMARY_NETWORK_INTERFACE_JSON | @PRIMARY_NETWORK_INTERFACE_JSON_FILE [--network-interface NETWORK_INTERFACE_JSON | @NETWORK_INTERFACE_JSON_FILE]) [--name NAME] [--profile PROFILE] [--zone ZONE] [--vpc VPC] [--image IMAGE | (--catalog-offering CATALOG_OFFERING | --catalog-offering-version CATALOG_OFFERING_VERSION) [--catalog-offering-plan CATALOG_OFFERING_PLAN]] [--total-volume-bandwidth TOTAL_VOLUME_BANDWIDTH] [--boot-volume BOOT_VOLUME_JSON | @BOOT_VOLUME_JSON_FILE] [--volume-attach VOLUME_ATTACH_JSON | @VOLUME_ATTACH_JSON_FILE] [--keys KEYS] [--dedicated-host DEDICATED_HOST | --dedicated-host-group DEDICATED_HOST_GROUP | --placement-group PLACEMENT_GROUP] [--reservation-affinity-policy, --res-policy disabled | manual | automatic] [--reservation-affinity-pool, --res-pool RESERVATION_AFFINITY_POOL] [--user-data DATA] [--sgs SGS] [--metadata-service, --ms true | false [--metadata-service-protocol, --msp http | https | --metadata-service-response-hop-limit, --msrhl METADATA_SERVICE_RESPONSE_HOP_LIMIT,MSRHL]] [--host-failure-policy restart | stop] [--confidential-compute-mode disabled | sgx | tdx] [--enable-secure-boot true | false] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [[--cluster-network-attachments CLUSTER_NETWORK_ATTACHMENTS_JSON | @CLUSTER_NETWORK_ATTACHMENTS_JSON_FILE]] [--volume-bandwidth-qos-mode pooled | weighted] [--vcpu-percentage VCPU_PERCENTAGE] [--availability-class spot | standard] [--preemption-policy delete | stop] [--threads-per-core 1 | 2] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-template-create-override-source-template --source-template e4a29d1a-2ef0-42a6-8fd2-350deb1c647e 通过从源模板复制，创建实例模板。
  • ibmcloud is instance-template-create-override-source-template --source-template e4a29d1a-2ef0-42a6-8fd2-350deb1c647e --name my-template-name --image r123-72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --profile bx2-2x8 通过覆盖源模板并提供覆盖选项，创建实例模板。
  • ibmcloud is instance-template-create-override-source-template --source-template my-template --name my-instance --subnet my-subnet --image ibm-ubuntu-20-04-2-minimal-amd64-1 --volume-attach '[{"volume": {"name":"my-vol-1"}}]' 借助资源名称，通过使用卷连接中的现有卷覆盖源模板，创建实例模板。
  • ibmcloud is instance-template-create-override-source-template --source-template my-template --name my-instance --subnet my-subnet --image ibm-ubuntu-20-04-2-minimal-amd64-1 --reservation-affinity-policy manual --reservation-affinity-pool r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2s 通过使用预留项亲缘关系池标识覆盖源模板，创建实例模板。
  • ibmcloud is instance-template-create-override-source-template --source-template my-template --name my-instance --subnet my-subnet --image ibm-ubuntu-20-04-2-minimal-amd64-1 --reservation-affinity-policy manual --reservation-affinity-pool crn:v1:bluemix:public:is:us-south:a/123456::vpc:4727d842-f94f-4a2d-824a-9bc9b02c523b 通过使用预留项亲缘关系池 CRN 覆盖源模板，创建实例模板。
  • ibmcloud is instance-template-create-override-source-template --source-template my-template --name my-instance --primary-network-interface '{"name": "primary-nic", "allow_ip_spoofing": true, "subnet": {"name":"my-subnet"}, "primary_ip": {"name": "my-reserved-ip"}, "security_groups": [{"name": "my-security-group-1"}, {"name": "my-security-group-2"}]}' 借助资源名称，通过使用主网络接口配置覆盖源模板，从而创建实例模板。
  • ibmcloud is instance-template-create-override-source-template --source-template e4a29d1a-2ef0-42a6-8fd2-350deb1c647e --cluster-network-attachments [{"name": "instance-cnac-1","cluster_network_interface": {"id":"02h7-56705448-c9d9-43dc-aa11-20d42333cd87"}}] 使用具有现有集群网络接口和现有保留 IP 的集群网络连接，通过覆盖源模板来创建实例模板。
  • ibmcloud is instance-template-create-override-source-template --source-template e4a29d1a-2ef0-42a6-8fd2-350deb1c647e --cluster-network-attachments [{"name":"cli-cnac-1", "cluster_network_interface": {"auto_delete": true, "name": "cni-1", "primary_ip": { "auto-delete": true, "name": "my-reserved-ip"}, "subnet": "72b27b5c-f4b0-48bb-b954-5becc7c1dcb8"}}] 使用集群网络连接，通过覆盖源模板来创建实例模板。
  • ibmcloud is instance-template-create-override-source-template --source-template 0717-9ac0ceaf-f10e-4500-98f6-978d83a7d3d4 --name cli-template --profile bx2-2x8 --vpc r006-1e635d53-6cd2-460f-917d-0737a3664d07 --subnet 0717-53d45c63-d61b-41f3-a784-249b856e7517 --zone us-south-1 --boot-volume '{"name": "boot-vol-attachment-name", "volume": {"name": "boot-vol-name-0", "profile": {"name": "general-purpose"}, "source_snapshot": {"name": "test-cli"}, "allowed_use":{"instance":"true","bare_metal_server":"true","api_version":"2025-05-25"}}}' --volume-attach '[{"volume": {"name":"my-volume-name-0", "capacity":100, "profile": {"name": "general-purpose"}, "source_snapshot": {"id": "r006-523cf6c7-0591-43b9-b4ff-6663791e2814"}, "allowed_use":{"instance":"true","bare_metal_server":"true","api_version":"2025-05-25"}}}]' 通过重写源模板来创建一个实例模板，该模板允许在“启动卷”和“卷挂载”中使用。
  • ibmcloud is instance-template-create-override-source-template --source-template 0717-9ac0ceaf-f10e-4500-98f6-978d83a7d3d4 --vcpu-percentage 50 通过使用共享核心覆盖源模板，来创建实例模板。
  • ibmcloud is instance-template-create-override-source-template --source-template 0717-9ac0ceaf-f10e-4500-98f6-978d83a7d3d4d --availability-class spot --preemption-policy stop 通过可用性等级覆盖源模板，来创建实例模板。

命令选项

  • --source-template：模板的 ID 或名称。
  • --name: 实例模板的名称。
  • --profile：实例配置文件的名称。
  • --zone：区域名称。
  • --vpc：VPC 的 ID 或名称。 只需通过名称指定该 VPC 内的唯一资源，或者在模板中覆盖 VPC 的值即可。
  • --image：图片的ID或名称。
  • --catalog-offering：IBM Cloud 产品目录条目的 CRN。 如果指定了此选项，那么将使用该产品的最新版本。 有关创建目录商品的更多信息，请参阅 “将软件接入您的账户”。
  • --catalog-offering-version：IBM Cloud 目录产品版本的 CRN。 有关为目录产品创建版本的更多信息，请参阅《 将软件接入您的账户 》。
  • --catalog-offering-plan：IBM Cloud 目录产品计费方案的 CRN。 如果未指定，则不使用计费套餐（免费）。 必须为需要计费套餐的目录产品版本指定。
  • --total-volume-bandwidth：专门分配给实例存储卷的带宽量（单位为兆比特每秒）。 此值的增加将导致网络总带宽相应降低。
  • --boot-volume: BOOT_VOLUME_JSON|@BOOT_VOLUME_JSON_FILE，以 JSON 或 JSON 文件形式指定的启动卷挂载。 有关数据模式，请参阅 API 文档 中的 boot_volume_attachment 属性。
  • --volume-attach: VOLUME_ATTACH_JSON|@VOLUME_ATTACH_JSON_FILE，以 JSON 或 JSON 文件形式指定的卷挂载信息，包含卷列表。 有关数据模式，请参阅 API 文档 中的 volume_attachments 属性。
  • --keys：以逗号分隔的 SSH 密钥的 ID 或名称。 SSH 密钥可以是 RSA 或 Ed25519 密钥。 仅当操作系统支持此密钥类型时，才能使用 Ed25519。 Ed25519 不能与 Windows 或 VMware 映像配合使用。
  • --dedicated-host：实例所在的目标主机的 ID 或名称。
  • --dedicated-host-group：实例所属的主机组目标的 ID 或名称。
  • --placement-group：放置组的 ID 或名称。 虚拟服务器实例的放置组限制。
  • --reservation-affinity-policy, --res-policy：此虚拟服务器实例应采用的预留亲和性策略。 如果池不为空，策略缺省为“手动”。 如果设置了放置目标，则策略缺省为“禁用”。 在所有其他情况下，策略缺省为“自动”。 其中之一：禁用、手动、自动。
  • --reservation-affinity-pool，--res-pool： 该虚拟服务器实例可使用的预留资源的 ID、名称或 CRN。
  • --user-data: data|@data-file. 要传输到虚拟服务器实例的用户数据。
  • --subnet：子网的 ID 或名称。 使用命令 ibmcloud is subnets 来获取子网 ID 或名称。
  • --rip：现有保留 IP 的 ID 或名称。
  • --address：要预留的 IP 地址，该地址在子网中不得已被预留。
  • --auto-delete：如果设置为 true，则当目标被删除时，该预留 IP 地址将自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --ip-name：此预留 IP 的用户自定义名称。 名称在预留 IP 所在的子网中必须是唯一的。 以 ibm- 开头的名称专用于服务商自有资源。
  • --allow-ip-spoofing：禁用该接口上的源地址和目标地址检查。 如果为false，则不允许在此接口上进行源IP欺骗。 其中一个: false，true。
  • --primary-network-interface: PRIMARY_NETWORK_INTERFACE_JSON|@PRIMARY_NETWORK_INTERFACE_JSON_FILE，以 JSON 或 JSON 文件形式指定的主网络接口。 有关数据模式，请参阅 API 文档 中的 primary_network_interface 属性。
  • --network-interface: NETWORK_INTERFACE_JSON|@NETWORK_INTERFACE_JSON_FILE，以 JSON 或 JSON 文件格式指定的网络接口绑定。 有关数据模式，请参阅 API 文档 中的 network_interfaces 属性。
  • --pnac-name：主网络连接的名称。
  • --pnac-vni：与主网络连接关联的虚拟网络接口的 ID 或名称。
  • --pnac-vni-subnet：关联的子网。
  • --pnac-vni-ais：允许 IP 欺骗（AIS）。 指示与主网络连接关联的此虚拟网络接口上是否允许源 IP 电子欺骗。 其中一个: false，true。(缺省值: false)。
  • --pnac-vni-ein：启用基础设施 NAT（EIN）。 如果属实，VPC 基础设施将对 VNI 执行任何必要的 NAT 操作。 要将 VNI 连接到实例，该值必须为 true。 Floating_ips 不得具有多个浮动 IP。 如果为false，则数据包在发往或来自VNI时不会被修改，从而允许VNI执行任何必要的NAT操作。 Allow_ip_spoofing 必须为 false。 只能连接到 resource_type 为 bare_metal _server_network_attachment 的目标。 下列其中一项: true 和 false。(缺省值: true)。
  • --pnac-vni-auto-delete：指示与主网络连接关联的此虚拟网络接口是否会在目标被删除时自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --pnac-vni-ips: VNI_RESERVED_IPS_JSON | @VNI_RESERVED_IPS_JSON_FILE，用于绑定到虚拟网络接口的备用预留 IP 地址，格式为 JSON 或 JSON 文件。 有关数据模式，请参阅 API 文档 中的 IPS 属性。 其中一个: VNI_RESERVED_IPS_JSON，@VNI_RESERVED_IPS_JSON_FILE。
  • --pnac-vni-name：与主网络连接关联的此虚拟网络接口的名称。
  • --pnac-vni-rip：要绑定到与主网络连接关联的虚拟网络接口的保留 IP 的 ID 或名称。
  • --pnac-vni-rip-address：用于绑定到与主网络连接关联的虚拟网络接口的预留 IP 地址。
  • --pnac-vni-rip-auto-delete：指示当任一目标被删除，或者该保留 IP 地址被解除绑定时，该保留 IP 地址是否会自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --pnac-vni-rip-name：此保留 IP 地址的名称，用于将其绑定到与主网络连接关联的虚拟网络接口。
  • --pnac-vni-sgs：用于虚拟网络接口的安全组的 ID 或名称（以逗号分隔），这些安全组与主网络连接相关联。
  • --pnac-vni-psfm：此虚拟网络接口应采用的协议状态过滤模式。 如果设置为“自动”，则协议状态数据包过滤功能是否启用或禁用，取决于虚拟网络接口的 target 资源类型。 其中一个: auto，enabled，disabled。(缺省值: auto)。
  • -- network-Attachment: NETWORK_ATTACHMENTS_JSON |@NETWORK_ATTACHMENTS_JSON_FILE。 网络附件配置在 JSON 或 JSON 文件中。 有关数据模式，请参阅 API 文档 中的 network_attachments 属性。 NETWORK_ATTACHMENTS_JSON，@NETWORK_ATTACHMENTS_JSON_FILE 之一。
  • --sgs：主网络接口或主网络连接的以逗号分隔的安全组 ID 或名称。
  • --metadata-service, --ms：启用或禁用实例元数据服务。 以下选项之一：true、false。
  • --metadata-service-protocol，--msp：元数据服务端点的通信协议。 仅当启用了元数据服务时，协议才适用。 http 和 https 之一。(缺省值: http)。
  • --metadata-service-response-hop-limit，--msrhl： 元数据服务返回的 IP 响应数据包的跳数限制（IP 生存时间）。
  • --host-failure-policy：当计算主机发生故障时应执行的操作。 其中一个: restart，stop。
  • --confidential-compute-mode：此虚拟服务器实例要使用的机密计算模式。 如果未指定，那么将使用概要文件中的缺省保密计算方式。 残疾、SGX、TDX 其中之一。
  • --enable-secure-boot：指示此虚拟服务器实例是否启用了安全启动。 如果未指定，那么将使用概要文件中的缺省安全引导方式。 以下选项之一：true、false。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --cluster-network-attachments：cluster_network_attachments_json|@cluster_network_attachments_json_file。 集群网络连接配置位于 JSON 或 JSON 文件中。 有关数据模式，请参阅 API 文档 中的 cluster_network_attachments 属性。 有关群集网络的更多信息，请参阅“群集网络”。 以下之一：CLUSTER_NETWORK_ATTACHMENTS _JSON ，@CLUSTER_NETWORK_ATTACHMENTS_JSON_FILE。
  • --volume-bandwidth-qos-mode：此虚拟服务器实例应采用的卷带宽 QoS 模式。 必须在实例概要文件的 volume_bandwidth_qos_modes 中列出指定的值。 其中之一：集合、加权。
  • --vcpu-percentage：分配给该实例的 vCPU 时钟周期的百分比。 范围为 1-100。
  • --availability-class：虚拟服务器实例的可用性类。 其中之一：斑点、标准。
  • --preemption-policy：当虚拟服务器实例被抢占时应执行的操作。 其中之一是：删除，停止。
  • --threads-per-core：此虚拟服务器实例的每核线程数。 如果未指定，则使用配置文件的默认值。 其中一个: 1，2。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是实例模板更新

更新实例模板。

ibmcloud is instance-template-update TEMPLATE --name NEW_NAME [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-template-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name new-name-template
  • ibmcloud is instance-template-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name new-name-template --output JSON
  • ibmcloud is instance-template-update my-template --name new-name-template 使用资源名称更新实例模板。

命令选项

  • 模板：模板的ID或名称。
  • --name：实例模板的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 实例模板删除

删除一个或多个实例模板。

ibmcloud is instance-template-delete (TEMPLATE1 TEMPLATE2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • TEMPLATE1：模板的ID或名称。
  • TEMPLATE2：模板的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

实例组

ibmcloud 是实例组

列出该区域中的所有实例组。

ibmcloud is instance-groups [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令选项

  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是实例组

查看实例组的详细信息。

ibmcloud is instance-group INSTANCE_GROUP [--output JSON] [-q, --quiet]

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-group-create

创建实例组。

ibmcloud is instance-group-create INSTANCE_GROUP_NAME --instance-template INSTANCE_TEMPLATE --subnets SUBNETS [--membership-count MEMBERSHIP_COUNT] [--lb LB --lb-pool LB_POOL --application-port APPLICATION_PORT] [--vpc VPC] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-group-create group-name --instance-template 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --subnet 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3,72b27b5c-f4b0-48bb-b954-5becc7c1dcb3
  • ibmcloud is instance-group-create group-name --instance-template 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --subnet 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3,72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --membership-count 2
  • ibmcloud is instance-group-create group-name --instance-template 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --subnet 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3,72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --output JSON
  • ibmcloud is instance-group-create group-name --instance-template 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --subnet 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3,72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --lb 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --lb-pool d728d126-f2b9-48e8-ab67-16bb694b88f2 --application-port 2323
  • ibmcloud is instance-group-create group-name --instance-template my-instance-template --subnets my-subnet-1,my-subnet-2 --vpc my-vpc
  • ibmcloud is instance-group-create group-name --instance-template my-instance-template --subnets my-subnet-1,my-subnet-2 --lb my-load-balancer --lb-pool my-load-balancer-pool --application-port 80 --vpc my-vpc

命令选项

  • INSTANCE_GROUP_NAME：实例组的名称。
  • --instance-template：实例模板的 ID。
  • --membership-count：实例组的成员数量。
  • --subnets：用逗号分隔的子网 ID 或名称。
  • --lb：负载均衡器的 ID 或名称。
  • --lb-pool：负载均衡池的 ID 或名称。
  • --application-port：用于路由负载均衡器流量的应用程序端口。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是实例组更新

更新实例组。

ibmcloud is instance-group-update INSTANCE_GROUP [--instance-template INSTANCE_TEMPLATE] [--membership-count MEMBERSHIP_COUNT] [--subnets SUBNETS] [--name NEW_NAME] [--lb LB --lb-pool LB_POOL --application-port APPLICATION_PORT] [--vpc VPC] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-group-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name new-name --instance-template 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479
  • ibmcloud is instance-group-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --membership-count 2
  • ibmcloud is instance-group-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --subnets 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3,72b27b5c-f4b0-48bb-b954-5becc7c1dcb3
  • ibmcloud is instance-group-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name new-name --output JSON
  • ibmcloud is instance-group-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --lb 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --lb-pool d728d126-f2b9-48e8-ab67-16bb694b88f3 --application-port 80
  • ibmcloud is instance-group-update my-instance-group --subnets my-subnet-1,my-subnet-2 --vpc my-vpc
  • ibmcloud is instance-group-update my-instance-group --instance-template my-template
  • ibmcloud is instance-group-update my-instance-group --lb my-load-balancer --lb-pool my-load-balancer-pool --application-port 80 --vpc my-vpc

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • --instance-template：实例模板的 ID。
  • --membership-count：实例组的成员数量。
  • --subnets：用逗号分隔的子网 ID 或名称。
  • --name：实例组的新名称。
  • --lb：负载均衡器的 ID 或名称。
  • --lb-pool：负载均衡池的 ID 或名称。
  • --application-port：用于路由负载均衡器流量的应用程序端口。
  • --vpc：VPC 的 ID 或名称。 只需在此 VPC 中按名称指定唯一资源。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 实例组删除

删除一个或多个实例组。

ibmcloud is instance-group-delete (INSTANCE_GROUP1 INSTANCE_GROUP2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • INSTANCE_GROUP1：实例组的 ID 或名称。
  • INSTANCE_GROUP2：实例组的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-group-load-balancer-delete

删除实例组负载均衡器。

ibmcloud is instance-group-load-balancer-delete INSTANCE_GROUP [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-group-manager

列出实例组的所有管理员。

ibmcloud is instance-group-managers INSTANCE_GROUP [--output JSON] [-q, --quiet]

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-group-manager

查看某位经理的详细信息。

ibmcloud is instance-group-manager INSTANCE_GROUP MANAGER [--output JSON] [-q, --quiet]

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • 管理员：管理员的ID或姓名。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 实例组管理器创建

为实例组创建一个管理器。

ibmcloud is instance-group-manager-create INSTANCE_GROUP [--manager-type autoscale | scheduled] [--aggregation-window AGGREGATION_WINDOW] [--cooldown COOLDOWN] [--max-members MAX_MEMBERS] [--min-members MIN_MEMBERS] [--name NAME] [--management-enabled true | false] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-group-manager-create 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --max-members 20
  • ibmcloud is instance-group-manager-create 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --max-members 20 --output JSON
  • ibmcloud is instance-group-manager-create 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --max-members 20 --min-members 2 --cooldown 400 --aggregation-window 120 --name my-autoscale-manager --management-enabled false
  • ibmcloud is instance-group-manager-create 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name my-scheduled-manager --manager-type scheduled
  • ibmcloud is instance-group-manager-create my-instance-group --max-members 20 --min-members 2 --cooldown 400 --aggregation-window 120 --name my-autoscale-manager --management-enabled false

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • --manager-type：实例组管理器的类型。 其中一个: autoscale，已调度。(缺省值: autoscale)。
  • --aggregation-window：在进行评估之前，用于聚合指标的时间窗口（单位为秒）。 范围：90-600。 可整除 30。(缺省值: 90)。
  • --冷却时间：缩放操作完成后，暂停后续缩放操作的时间（以秒为单位）。 范围 120-3600。(缺省值: 300)。
  • --max-members：受管实例组中的最大成员数。 范围 1-1000。
  • --min-members：受管实例组中的最小成员数。 范围 1-1000。
  • --name: 管理员的姓名。
  • --management-enabled：如果设置为 false，管理器将不会对实例组进行操作。 下列其中一项: true 和 false。(缺省值: true)。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-group-manager-update

更新实例组的管理员。

ibmcloud is instance-group-manager-update INSTANCE_GROUP MANAGER [--aggregation-window AGGREGATION_WINDOW] [--cooldown COOLDOWN] [--max-members MAX_MEMBERS] [--min-members MIN_MEMBERS] [--management-enabled true | false] [--name NEW_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-group-manager-update 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --aggregation-window 120
  • ibmcloud is instance-group-manager-update 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --cooldown 400
  • ibmcloud is instance-group-manager-update 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --max-members 20
  • ibmcloud is instance-group-manager-update 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --min-members 2
  • ibmcloud is instance-group-manager-update 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --aggregation-window false --output JSON
  • ibmcloud is instance-group-manager-update 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --management-enabled false
  • ibmcloud is instance-group-manager-update 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --name new_name
  • ibmcloud is instance-group-manager-update my-instance-group my-instance-group-manager --management-enabled false
  • ibmcloud is instance-group-manager-update my-instance-group my-instance-group-manager --name new_name

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • 管理员：管理员的ID或姓名。
  • --aggregation-window：在进行评估之前，用于聚合指标的时间窗口（单位为秒）。 范围：90-600。 可被 30 整除。
  • --冷却时间：缩放操作完成后，暂停后续缩放操作的时间长度（以秒为单位）。 范围 120-3600。
  • --max-members：受管实例组中的最大成员数。 范围 1-1000。
  • --min-members：受管实例组中的最小成员数。 范围 1-1000。
  • --management-enabled：如果设置为 false，管理器将不会对实例组进行操作。 以下选项之一：true、false。
  • --name：实例组管理器的全新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 实例组管理器删除

删除一个或多个管理器。

ibmcloud is instance-group-manager-delete INSTANCE_GROUP (MANAGER1 MANAGER2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • 管理员1：管理员的ID或姓名。
  • MANAGER2：管理员的ID或姓名。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-group-manager-actions

列出实例组管理器的操作。

ibmcloud is instance-group-manager-actions INSTANCE_GROUP MANAGER [--output JSON] [-q, --quiet]

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • 管理员：管理员的ID或姓名。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-group-manager-action

查看实例组管理器操作的详细信息。

ibmcloud is instance-group-manager-action INSTANCE_GROUP MANAGER ACTION [--output JSON] [-q, --quiet]

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • 管理员：管理员的ID或姓名。
  • 操作：操作的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-group-manager-action-create

创建一个实例组管理器操作。

ibmcloud is instance-group-manager-action-create INSTANCE_GROUP MANAGER [--run-at RUN_AT | --cron CRON] [--membership-count MEMBERSHIP_COUNT | (--max-members MAX_MEMBERS --min-members MIN_MEMBERS)] [--name NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-group-manager-action-create 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --run-at '2024-10-28T21:13:32+08:00' --max-members 20 --min-members 10 创建一次性调度操作，以更新实例组自动缩放管理器。
  • ibmcloud is instance-group-manager-action-create 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --run-at '2024-10-28T21:13:32+08:00' --membership-count 10 --name my-action 创建一次性调度操作，以更新实例组。
  • ibmcloud is instance-group-manager-action-create 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --cron '*/5 1,2,3 * * *' --max-members 20 --min-members 5 --output JSON 使用 cron 规范创建重现调度操作，以更新实例组自动缩放管理器。
  • ibmcloud is instance-group-manager-action-create 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --cron '*/5 1,2,3 * * *' --membership-count 10 --name my-action 使用 cron 规范创建重现调度操作，以更新实例组。
  • ibmcloud is instance-group-manager-action-create my-instance-group --cron '*/5 1,2,3 * * *' --membership-count 10 --name my-action 使用 cron 规范创建重现调度操作以使用资源名称更新实例组。

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • 管理员：管理员的ID或姓名。
  • --run-at：为计划操作指定的日期和时间。 日期和时间必须采用 ISO 8601 格式，例如 2024-03-05T15:31:50.701Z 或 2024-03-05T15:31:50.701+8:00。
  • --cron：用于周期性定时任务的cron规范。
  • --membership-count：实例组在计划时间点必须拥有的成员数量。
  • --max-members：受管实例组中的最大成员数。 范围 1-1000。
  • --min-members：受管实例组中的最小成员数。 范围 1-1000。
  • --name: 操作的名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-group-manager-action-update

更新实例组管理器的操作。

ibmcloud is instance-group-manager-action-update INSTANCE_GROUP MANAGER ACTION (--run-at RUN_AT | --cron CRON) [--membership-count MEMBERSHIP_COUNT | (--min-members MIN_MEMBERS --max-members MAX_MEMBERS)] [--name NEW_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-group-manager-action-update 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --name updatedName
  • ibmcloud is instance-group-manager-action-update 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --max-members 20 --min-members 5
  • ibmcloud is instance-group-manager-action-update 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --membership-count 10 --output JSON
  • ibmcloud is instance-group-manager-action-update 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --run-at 2020-10-28T21:13:32+08:00
  • ibmcloud is instance-group-manager-action-update 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --cron '*/5 1,2,3 * * *'
  • ibmcloud is instance-group-manager-action-update my-instance-group my-instance-group-manager my-instance-group-manager-action --max-members 20 --min-members 5

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • 管理员：管理员的ID或姓名。
  • 操作：操作的ID或名称。
  • --run-at：为计划操作指定的日期和时间。 日期和时间必须采用 ISO 8601 格式，例如 2024-03-05T15:31:50.701Z 或 2024-03-05T15:31:50.701+8:00。
  • --cron：用于周期性定时任务的cron规范。
  • --membership-count：实例组在计划时间点必须拥有的成员数量。
  • --min-members：实例组在计划时间点必须拥有的最小成员数。 范围 1-1000。
  • --max-members：实例组在计划时间点必须拥有的最大成员数。 范围 1-1000。
  • --name：实例组管理器操作的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-group-manager-action-delete

删除一个或多个实例组管理器操作。

ibmcloud is instance-group-manager-action-delete INSTANCE_GROUP MANAGER (ACTION1 ACTION2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • 管理员：管理员的ID或姓名。
  • 操作1：操作的ID或名称。
  • ACTION2：操作的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-group-manager-policies

列出实例组管理器的策略。

ibmcloud is instance-group-manager-policies INSTANCE_GROUP MANAGER [--output JSON] [-q, --quiet]

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • 管理员：管理员的ID或姓名。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是实例组管理器策略

查看实例组管理器策略的详细信息。

ibmcloud is instance-group-manager-policy INSTANCE_GROUP MANAGER POLICY [--output JSON] [-q, --quiet]

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • 管理员：管理员的ID或姓名。
  • 保单：保单编号或保单名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-group-manager-policy-create

创建一个实例组管理器策略。

ibmcloud is instance-group-manager-policy-create INSTANCE_GROUP MANAGER (--metric-type cpu | memory | network_in | network_out) --metric-value METRIC_VALUE [--name NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-group-manager-policy-create 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --metric-type cpu --metric-value 50
  • ibmcloud is instance-group-manager-policy-create 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --metric-type cpu --metric-value 50 --output JSON
  • ibmcloud is instance-group-manager-policy-create 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --metric-type cpu --metric-value 50 --name new_name
  • ibmcloud is instance-group-manager-policy-create my-instance-group my-instance-group-manager --metric-type cpu --metric-value 50 --name new_name

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • 管理员：管理员的ID或姓名。
  • --metric-type：要评估的指标类型：cpu（利用率百分比）、memory（利用率百分比）、network_in（Mbps）、network_out（Mbps）。
  • --metric-value：待评估的指标值。
  • --name: 策略名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是实例组管理器策略删除

删除一个或多个实例组管理器策略。

ibmcloud is instance-group-manager-policy-delete INSTANCE_GROUP MANAGER (POLICY1 POLICY2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • 管理员：管理员的ID或姓名。
  • POLICY1：策略的ID或名称。
  • POLICY2：策略的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-group-manager-policy-update

更新实例组管理器策略。

ibmcloud is instance-group-manager-policy-update INSTANCE_GROUP MANAGER POLICY [--metric-type cpu | memory | network_in | network_out] [--metric-value METRIC_VALUE] [--name NEW_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-group-manager-policy-update 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --metric-value 50
  • ibmcloud is instance-group-manager-policy-update 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --metric-type cpu
  • ibmcloud is instance-group-manager-policy-update 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --metric-value 50 --metric-type cpu --output JSON
  • ibmcloud is instance-group-manager-policy-update 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 72b27b5c-f4b0-48bb-b954-5becc7c1dcb8 --metric-type cpu --name policy-name
  • ibmcloud is instance-group-manager-policy-update my-instance-group my-instance-group-manager my-instance-group-policy --metric-value 50 --metric-type cpu --output JSON

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • 管理员：管理员的ID或姓名。
  • 保单：保单编号或保单名称。
  • --metric-type：要评估的指标类型：cpu（利用率百分比）、memory（利用率百分比）、network_in（Mbps）、network_out（Mbps）。
  • --metric-value：待评估的指标值。
  • --name：实例组管理器策略的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 instance-group-成员资格

查看实例组中某成员的详细信息。

ibmcloud is instance-group-membership INSTANCE_GROUP MEMBER [--output JSON] [-q, --quiet]

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • 会员：会员的ID或姓名。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is instance-group-成员资格-delete

删除实例组的一个或多个成员资格。

ibmcloud is instance-group-membership-delete INSTANCE_GROUP (MEMBER1 MEMBER2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • 成员1：会员的ID或姓名。
  • 成员2：会员的ID或姓名。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is instance-group-成员资格-update

更新实例组的成员关系。

ibmcloud is instance-group-membership-update INSTANCE_GROUP MEMBER [--name NEW_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is instance-group-membership-update 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --name membership-name
  • ibmcloud is instance-group-membership-update 2251a2e-d6c5-42b4-97b0-b5f8e8d1f479 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --name membership-name --output JSON
  • ibmcloud is instance-group-membership-update my-instance-group my-instance-group-membership --name membership-name

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • 会员：会员的ID或姓名。
  • --name：实例组成员资格的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是实例组成员资格

列出实例组中的所有成员。

ibmcloud is instance-group-memberships INSTANCE_GROUP [--output JSON] [-q, --quiet]

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 实例组成员资格删除

删除实例组的所有成员资格。

ibmcloud is instance-group-memberships-delete INSTANCE_GROUP [--output JSON] [-f, --force] [-q, --quiet]

命令选项

  • INSTANCE_GROUP：实例组的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

区域和区域命令

以下部分介绍了用于管理区域和可用区的 CLI 命令的相关信息。

区域

ibmcloud 是区域

查看区域的详细信息。

ibmcloud is region REGION_NAME [--output JSON] [-q, --quiet]

命令选项

  • REGION_NAME：区域名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is regions

列出所有区域。

ibmcloud is regions [--output JSON] [-q, --quiet]

命令选项

  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

专区

ibmcloud 是区域

查看目标区域中专区的详细信息。

ibmcloud is zone ZONE_NAME [--output JSON] [-q, --quiet]

命令选项

  • ZONE_NAME：区域名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是区域

列出目标区域中的所有专区。

ibmcloud is zones [--output JSON] [-q, --quiet]

命令选项

  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

存储命令

卷

以下部分提供了有关卷的 CLI 命令的信息。

ibmcloud is volumes

列出所有卷。

ibmcloud is volumes [--attachment-state attached | unattached | unusable] [--encryption provider_managed | user_managed] [--operating-system-family OPERATING_SYSTEM_FAMILY] [--operating-system-architecture OPERATING_SYSTEM_ARCHITECTURE] [--zone ZONE] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令选项

  • --attachment-state：将集合过滤为具有指定连接状态的卷。 下列其中一项: 已连接，未连接，不可用。
  • -- encryption: 将集合过滤为具有以下指定加密类型之一的资源: provider_managed，user_managed。
  • --operating-system-family：将集合过滤为与指定操作系统家族完全匹配的资源。 该选项还支持值 null 和 not:null，用于将集合过滤为没有操作系统或任何操作系统的资源。
  • --operating-system-architecture: null 将集合过滤为具有与指定操作系统架构完全一致的资源。 该选项还支持值 null 和 not:null，用于将集合过滤为没有操作系统或任何操作系统的资源。
  • --zone：将集合过滤为该区域中名称与指定名称完全一致的资源。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是卷

查看卷的详细信息。

ibmcloud is volume VOLUME [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is volume my-volume
  • ibmcloud is volume 485080f6-86e8-4fd4-a940-fb0e5bc269e0

命令选项

  • 卷：卷的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 volume-create

创建卷。

ibmcloud is volume-create VOLUME_NAME PROFILE_NAME ZONE_NAME [--capacity CAPACITY] [--iops IOPS] [--encryption-key ENCRYPTION_KEY] [--snapshot SNAPSHOT [--allowed-use-api-version, --au-api-version ALLOWED_USE_API_VERSION, AU_API_VERSION] [--allowed-use-bare-metal-server, --au-bms ALLOWED_USE_BARE_METAL_SERVER, AU_BMS] [--allowed-use-instance, --au-ins ALLOWED_USE_INSTANCE, AU_INS]] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--tags  TAG_NAME1,TAG_NAME2,...] [--bandwidth BANDWIDTH] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is volume-create my-volume general-purpose us-south-1
  • ibmcloud is volume-create my-volume general-purpose us-south-1 --capacity 500
  • ibmcloud is volume-create my-volume general-purpose us-south-1 --iops 10000 --capacity 1000
  • ibmcloud is volume-create my-volume general-purpose us-south-1 --snapshot r134-2fbe71a8-126e-4a05-80ad-dad45df491a5 通过快照创建卷
  • ibmcloud is volume-create my-volume general-purpose us-south-1 --snapshot my-snapshot --capacity 500 通过具有容量的快照创建卷
  • ibmcloud is volume-create my-volume general-purpose us-south-1 --tags env:test
  • ibmcloud is volume-create my-volume general-purpose us-south-1 --tags env:test,env:dev
  • ibmcloud is volume-create my-volume general-purpose us-south-1 --encryption-key crn:v1:bluemix:public:kms:us-south:adffc98a0f1f0f95f6613b3b752286b87:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179
  • ibmcloud is volume-create my-volume general-purpose us-south-1 --resource-group-id 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3
  • ibmcloud is volume-create my-volume general-purpose us-south-1 --resource-group-name Default
  • ibmcloud is volume-create my-volume general-purpose us-south-1 --output JSON
  • ibmcloud is volume-create my-volume general-purpose us-south-1 --bandwidth 1000
  • ibmcloud is volume-create my-volume general-purpose us-south-1 --snapshot my-snapshot --capacity 500 --allowed-use-api-version "2024-10-31" --allowed-use-bare-metal-server enable_secure_boot==true --allowed-use-instance true

命令选项

  • VOLUME_NAME：卷的名称。
  • PROFILE_NAME：配置文件的名称。
  • ZONE_NAME：区域名称。
  • --capacity：卷的容量（单位为千兆字节）。 对于定制和通用概要文件卷，范围为 10-16000; 对于 5iops-tier 概要文件卷，范围为 10-9600; 对于 10iops-tier 概要文件卷，范围为 10-4800。 提供源快照后，容量值必须至少为快照的 minimum_capacity，且默认容量值即为源快照的 minimum_capacity。（默认值：100 ）。
  • --iops：卷的每秒输入和输出操作次数，仅适用于自定义配置文件卷。 有关可用的 IOPS 范围，请参阅 [定制 IOPS 概要文件]将软件加载到帐户。
  • --encryption-key：密钥管理服务（KMS）根密钥的 CRN。
  • --快照：快照的 ID、名称或 CRN。
  • --allowed-use-api-version、--au-api-version：用于评估表达式的 API 版本。
  • --allowed-use-bare-metal-server, --au-bms：使用本卷中的镜像数据进行配置的裸机服务器的属性必须满足的条件。
  • --allowed-use-instance、--au-ins：使用此卷进行配置的虚拟服务器实例的属性必须满足的表达式。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --tags：此资源的标签。
  • --bandwidth：该卷的最大带宽（单位为兆比特每秒）。 要指定此属性，卷存储代必须为 2。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是卷-删除

删除一个或多个卷。

ibmcloud is volume-delete (VOLUME1 VOLUME2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is volume-delete my-volume-3
  • ibmcloud is volume-delete 485080f6-86e8-4fd4-a940-fb0e5bc269e0

命令选项

  • 卷1：卷的ID或名称。
  • 卷2：卷的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud is volume-profiles

列出所有卷概要文件。

ibmcloud is volume-profiles [--output JSON] [-q, --quiet]

命令选项

  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是卷概要文件

查看卷概要文件的详细信息。

ibmcloud is volume-profile PROFILE_NAME [--output JSON] [-q, --quiet]

命令选项

  • PROFILE_NAME：配置文件的名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是卷更新

更新卷。

ibmcloud is volume-update VOLUME [--name NAME | --capacity CAPACITY | --profile PROFILE --iops IOPS | --bandwidth BANDWIDTH] [--allowed-use-api-version, --au-api-version ALLOWED_USE_API_VERSION, AU_API_VERSION] [--allowed-use-bare-metal-server, --au-bms ALLOWED_USE_BARE_METAL_SERVER, AU_BMS] [--allowed-use-instance, --au-ins ALLOWED_USE_INSTANCE, AU_INS] [--tags  TAG_NAME1,TAG_NAME2,...] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is volume-update 64bec87d-d175-4fa5-b240-b092fdbcedd6 --name my-volume --output JSON
  • ibmcloud is volume-update 64bec87d-d175-4fa5-b240-b092fdbcedd6 --capacity 250 --output JSON
  • ibmcloud is volume-update my-volume-demo-1 --name my-volume --output JSON
  • ibmcloud is volume-update my-volume-demo-1 --capacity 250
  • ibmcloud is volume-update cli-vol-acadia --iops 32000 --profile sdp
  • ibmcloud is volume-update my-volume-demo-1 --allowed-use-api-version "2024-10-31" --allowed-use-bare-metal-server enable_secure_boot==true --allowed-use-instance true
  • ibmcloud is volume-update cli-vol-acadia --bandwidth 8192
  • ibmcloud is volume-update 64bec87d-d175-4fa5-b240-b092fdbcedd6 --profile 10iops-tier
  • ibmcloud is volume-update 64bec87d-d175-4fa5-b240-b092fdbcedd6 --iops 5000
  • ibmcloud is volume-update a9647a52-06f8-4b19-b904-920f67dcdfcd --capacity 500 --tags env:test
  • ibmcloud is volume-update a9647a52-06f8-4b19-b904-920f67dcdfcd --capacity 500 --tags env:test,env:dev

命令选项

  • 卷：卷的ID或名称。
  • --name: 卷的新名称。
  • --capacity：卷的容量（单位为千兆字节）。 启动卷的容量可扩展至 250，自定义和通用配置文件卷的容量可扩展至 16000，5iops-tier 配置文件卷的容量可扩展至9600，10iops-tier 配置文件卷。 大小只能增加，不能减小。
  • --profile：配置文件的名称。 卷必须附加为数据卷并在 IOPS 层之间进行切换。 不支持将预定义的 IOPS 层概要文件更改为定制概要文件。 不支持将定制概要文件更改为预定义的 IOPS 层概要文件。
  • --iops：卷的每秒输入和输出操作次数，仅适用于自定义配置文件卷。 有关 IOPS 范围的信息，请参阅《 将软件接入您的账户 》。 该卷必须作为数据卷挂载。
  • --bandwidth：该卷的最大带宽（单位为兆比特每秒）。 要指定此属性，卷存储代必须为 2。
  • --allowed-use-api-version、--au-api-version：用于评估表达式的 API 版本。
  • --allowed-use-bare-metal-server, --au-bms：使用本卷中的镜像数据进行配置的裸机服务器的属性必须满足的条件。
  • --allowed-use-instance、--au-ins：使用此卷进行配置的虚拟服务器实例的属性必须满足的表达式。
  • --tags：此资源的标签。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 volume-instance-profiles

列出与卷兼容的实例概要文件。

ibmcloud is volume-instance-profiles VOLUME [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is volume-instance-profiles my-volume
  • ibmcloud is volume-instance-profiles my-volume --output JSON
  • ibmcloud is volume-instance-profiles r134-064dcec0-5e15-42cf-8b28-a9d27f9cd751
  • ibmcloud is volume-instance-profiles r134-064dcec0-5e15-42cf-8b28-a9d27f9cd751 --output JSON

命令选项

  • 卷：卷的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是卷任务创建

为卷创建一个作业。

ibmcloud is volume-job-create VOLUME --profile PROFILE [--name Name] [--bandwidth BANDWIDTH] [--iops IOPS] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is volume-job-create r134-4345a81c-6f86-4ae5-863f-92d6afc160a9 --profile sdp --name cli-test --iops 3000 --bandwidth 1000 --output JSON
  • ibmcloud is volume-job-create 485080f6-86e8-4fd4-a940-fb0e5bc269e0 --name my-job --profile sdp --bandwidth 1000 --iops 3000

命令选项

  • 卷：卷的ID或名称。
  • --profile：配置文件的名称。
  • --name: 批量作业的名称。
  • --bandwidth：该卷的最大带宽（单位为兆比特每秒）。 要指定此属性，卷存储代必须为 2。
  • --iops：卷的每秒输入和输出操作次数，仅适用于自定义配置文件卷。 有关可用的 IOPS 范围，请参阅 [定制 IOPS 概要文件]将软件加载到帐户。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 volume-job-update

更新卷作业。

ibmcloud is volume-job-update VOLUME --job JOB [--name Name] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is volume-job-update my-volume --job my-job --name my-job-update --output JSON
  • ibmcloud is volume-job-update 485080f6-86e8-4fd4-a940-fb0e5bc269e0 --job 485080f6-86e8-4fd4-a940-fb0e5bc279e2 --name my-job-update

命令选项

  • 卷：卷的ID或名称。
  • --job：卷作业标识符。
  • --name: 批量作业的名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是卷任务删除

删除一个或多个卷作业。

ibmcloud is volume-job-delete VOLUME --job JOB [--output JSON] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is volume-job-delete my-volume --job my-job --output JSON
  • ibmcloud is volume-job-delete 485080f6-86e8-4fd4-a940-fb0e5bc269e0 --job 485080f6-86e8-4fd4-a940-fb0e5bc279e2

命令选项

  • 卷：卷的ID或名称。
  • --job：卷作业标识符。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud是volume-job

检索卷作业。

ibmcloud is volume-job VOLUME --job JOB [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is volume-job my-volume --job my-job --output JSON
  • ibmcloud is volume-job 485080f6-86e8-4fd4-a940-fb0e5bc269e0 --job 485080f6-86e8-4fd4-a940-fb0e5bc279e2

命令选项

  • 卷：卷的ID或名称。
  • --job：卷作业标识符。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud是volume-jobs

列出卷中的作业。

ibmcloud is volume-jobs VOLUME [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is volume-jobs my-volume --output JSON
  • ibmcloud is volume-jobs 485080f6-86e8-4fd4-a940-fb0e5bc269e0

命令选项

  • 卷：卷的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是卷任务取消

取消排队中或正在运行的卷作业。

ibmcloud is volume-job-cancel VOLUME --job JOB [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is volume-job-cancel my-volume --job my-job --output JSON
  • ibmcloud is volume-job-cancel 485080f6-86e8-4fd4-a940-fb0e5bc269e0 --job 485080f6-86e8-4fd4-a940-fb0e5bc279e2

命令选项

  • 卷：卷的ID或名称。
  • --job：卷作业标识符。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

快照

以下部分提供有关快照的 CLI 命令的信息。

ibmcloud 是快照

列出所有快照。

ibmcloud is snapshots [--volume VOLUME] [--tag TAG_NAME] [--source-image SOURCE_IMAGE] [--copies COPY1,COPY2,...] [--copies-remote-region COPIES_REMOTE_REGION] [--source-snapshot SOURCE_SNAPSHOT] [--source-snapshot-remote-region SOURCE_SNAPSHOT_REMOTE_REGION] [--volume-remote-region VOLUME_REMOTE_REGION] [--source-image-remote-region SOURCE_IMAGE_REMOTE_REGION] [--backup-policy-plan BACKUP_POLICY_PLAN --backup-policy BACKUP_POLICY] [--snapshot-consistency-group SNAPSHOT_CONSISTENCY_GROUP] [--clones-zone-name CLONES_ZONE_NAME] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is snapshots
  • ibmcloud is snapshots --volume r134-f13fc172-22e0-4e5b-ab81-63f5fe8b3ea0
  • ibmcloud is snapshots --volume vol-bkp-policy-do-not-delete
  • ibmcloud is snapshots --volume crn:v1:staging:public:is:us-south-2:a/efe5afc483594adaa8325e2b4d1290df::volume:r134-f13fc172-22e0-4e5b-ab81-63f5fe8b3ea0
  • ibmcloud is snapshots --tag dev:env
  • ibmcloud is snapshots --source-image r134-24d856e2-6aec-41c2-8f36-5a8a3766f0d6
  • ibmcloud is snapshots --source-image ibm-centos-7-9-minimal-amd64-9
  • ibmcloud is snapshots --source-image crn:v1:staging:public:is:us-east:a/efe5afc483594adaa8325e2b4d1290df::image:r134-24d856e2-6aec-41c2-8f36-5a8a3766f0d6
  • ibmcloud is snapshots --copies r134-fc2a25b9-1cca-4cee-a9c4-0f350d7923f5
  • ibmcloud is snapshots --copies snapshot-copy-us-east
  • ibmcloud is snapshots --copies crn:v1:staging:public:is:us-south:a/efe5afc483594adaa8325e2b4d1290df::snapshot:r134-fc2a25b9-1cca-4cee-a9c4-0f350d7923f5
  • ibmcloud is snapshots --copies-remote-region us-south
  • ibmcloud is snapshots --source-volume-remote-region us-south
  • ibmcloud is snapshots --source-snapshot-remote-region us-south
  • ibmcloud is snapshots --backup-policy-plan r134-7d36a9df-9512-496e-8ad0-054cb4dd854c --backup-policy r134-3f56e0fa-1cfb-4341-9e57-de2a6345e7b3
  • ibmcloud is snapshots --backup-policy-plan bkp-plan-do-not-delete --backup-policy bkp-policy-do-not-delete
  • ibmcloud is snapshots --source-snapshot r142-abb79ab7-d79d-4863-9678-123d1dffee06
  • ibmcloud is snapshots --clones-zone-name us-south-2
  • ibmcloud is snapshots --snapshot-consistency-group scg1
  • ibmcloud is snapshots --snapshot-consistency-group r134-fc2a25b9-1cca-4cee-a9c4-0f350d7923f5

命令选项

  • --volume：源卷的 ID、名称或 CRN。
  • --tag：此资源的标签。
  • --source-image：源映像的 ID、名称或 CRN。
  • --copies：快照副本的 ID、名称或 CRN。 不支持这三种类型的组合。 仅支持传递三种类型之一。
  • --copies-remote-region：快照名称复制自远程区域。
  • --source-snapshot：源快照的 ID 或名称。
  • --source-snapshot-remote-region：源快照远程区域的名称。
  • --volume-remote-region：源卷远程区域的名称。
  • --source-image-remote-region：源图像远程区域的名称。
  • --backup-policy-plan：备份策略计划的 ID 或名称。
  • --backup-policy：备份策略的 ID 或名称。
  • --snapshot-consistency-group：快照一致性组的 ID、名称或 CRN。
  • --clones-zone-name：快照克隆区域的名称。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是快照

查看快照的详细信息。

ibmcloud is snapshot SNAPSHOT [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is snapshot my-snapshot
  • ibmcloud is snapshot r134-2fbe71a8-126e-4a05-80ad-dad45df491a5

命令选项

  • 快照：快照的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 snapshot-create

从卷创建快照。

ibmcloud is snapshot-create (--volume VOLUME | --source-snapshot-crn SOURCE_SNAPSHOT_CRN [--encryption-key ENCRYPTION_KEY]) [--name NAME] [--clone-zones CLONE_ZONES] [--allowed-use-api-version, --au-api-version ALLOWED_USE_API_VERSION, AU_API_VERSION] [--allowed-use-bare-metal-server, --au-bms ALLOWED_USE_BARE_METAL_SERVER, AU_BMS] [--allowed-use-instance, --au-ins ALLOWED_USE_INSTANCE, AU_INS] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--tags  TAG_NAME1,TAG_NAME2,...] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is snapshot-create --name my-snapshot-1 --volume test5-3zwxlnzgqk-9vk99
  • ibmcloud is snapshot-create --name my-snapshot --volume r006-1772e102-0671-48c7-a97a-504247e61e48
  • ibmcloud is snapshot-create --name my-snapshot --volume r006-1772e102-0671-48c7-a97a-504247e61e48 --resource-group-id 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3
  • ibmcloud is snapshot-create --name my-snapshot --volume r006-1772e102-0671-48c7-a97a-504247e61e48 --resource-group-name Default
  • ibmcloud is snapshot-create --name my-snapshot --volume r006-1772e102-0671-48c7-a97a-504247e61e48 --output JSON
  • ibmcloud is snapshot-create --name my-snapshot --volume r006-1772e102-0671-48c7-a97a-504247e61e48 --clone-zones us-south-1,us-south-2,us-south-3
  • ibmcloud is snapshot-create --volume cf88cf1a-6f93-4cf6-bacf-62cafd3de857 --name my-ss70 --tags env:test
  • ibmcloud is snapshot-create --volume cf88cf1a-6f93-4cf6-bacf-62cafd3de857 --name my-ss70 --tags env:test,env:dev
  • ibmcloud is snapshot-create --volume test5-3zwxlnzgqk-9vk99 --name my-ss70 --tags env:test
  • ibmcloud is snapshot-create --name my-snapshot --source-snapshot-crn crn:v1:bluemix:public:is:us-south:a/123456::snapshot:r134-f6bfa329-0e36-433f-a3bb-0df632e79263 --encryption-key crn:v1:bluemix:public:kms:us-south:a/dffc98a0f1f0f95f6613b3b752286b87:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179
  • ibmcloud is snapshot-create --name my-snapshot --source-snapshot-crn crn:v1:bluemix:public:is:us-south:a/123456::snapshot:r134-f6bfa329-0e36-433f-a3bb-0df632e79263 --encryption-key crn:v1:bluemix:public:kms:us-south:a/dffc98a0f1f0f95f6613b3b752286b87:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179 --allowed-use-api-version "2024-10-31" --allowed-use-bare-metal-server true --allowed-use-instance enable_secure_boot==true

命令选项

  • --volume：源卷的 ID、名称或 CRN。
  • --source-snapshot-crn：用于创建此快照的远程快照的 CRN。
  • --encryption-key：用于对快照的数据加密密钥进行封装的根密钥。 如果未指定，那么将使用来自具有相同源卷的最新快照的 encryption_key。 如果此快照是源卷的第一个快照，那么将使用来自源卷的 encryption_key。
  • --name: 快照的新名称。
  • --clone-zones：以逗号分隔的区域名称，用于指定快照克隆应存放的区域。 已在克隆区域中启用快照快速复原。
  • --allowed-use-api-version、--au-api-version：用于评估表达式的 API 版本。
  • --allowed-use-bare-metal-server, --au-bms：使用此快照中的镜像数据进行配置的裸机服务器的属性必须满足的条件。 如果未指定，则表达式将被设置为 true。
  • --allowed-use-instance、--au-ins：使用此快照进行配置的虚拟服务器实例的属性必须满足的表达式。 如果未指定，则表达式将被设置为 true。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --tags：此资源的标签。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 snapshot-delete

删除一个或多个快照。

ibmcloud is snapshot-delete (SNAPSHOT1 SNAPSHOT2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is snapshot-delete my-snapshot
  • ibmcloud is snapshot-delete r134-2fbe71a8-126e-4a05-80ad-dad45df491a5

命令选项

  • 快照1：快照的ID或名称。
  • 快照2：快照的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 snapshot-update

更新快照。

ibmcloud is snapshot-update SNAPSHOT --name NEW_NAME [--allowed-use-api-version, --au-api-version ALLOWED_USE_API_VERSION, AU_API_VERSION] [--allowed-use-bare-metal-server, --au-bms ALLOWED_USE_BARE_METAL_SERVER, AU_BMS] [--allowed-use-instance, --au-ins ALLOWED_USE_INSTANCE, AU_INS] [--tags  TAG_NAME1,TAG_NAME2,...] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is snapshot-update 64bec87d-d175-4fa5-b240-b092fdbcedd6 --name my-snapshot --output JSON
  • ibmcloud is snapshot-update cli-demo-snapshot-1 --name my-snapshot --output JSON
  • ibmcloud is snapshot-update f8d51ab0-961f-4c23-8976-b1e48cc4f260 --name mysnapshot60 --tags env:tfp
  • ibmcloud is snapshot-update f8d51ab0-961f-4c23-8976-b1e48cc4f260 --name mysnapshot60 --tags env:tfp,env:cli
  • ibmcloud is snapshot-update my-snapshot-2 --name mysnapshot60 --tags env:tfp
  • ibmcloud is snapshot-update my-snapshot-2 --allowed-use-api-version "2024-10-31" --allowed-use-bare-metal-server true --allowed-use-instance enable_secure_boot==true

命令选项

  • 快照：快照的 ID 或名称。
  • --name：快照的新名称。
  • --allowed-use-api-version、--au-api-version：用于评估表达式的 API 版本。
  • --allowed-use-bare-metal-server, --au-bms：使用此快照中的镜像数据进行配置的裸机服务器的属性必须满足的条件。 如果未指定，则表达式将被设置为 true。
  • --allowed-use-instance、--au-ins：使用此快照进行配置的虚拟服务器实例的属性必须满足的表达式。 如果未指定，则表达式将被设置为 true。
  • --tags：此资源的标签。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 snapshot-clone

查看区域快照克隆的详细信息。

ibmcloud is snapshot-clone SNAPSHOT ZONE_NAME [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is snapshot-cl f0542d32-2c92-4f64-9d25-8469a5bef29d us-east-2
  • ibmcloud is snapshot-clone aaa-default-snapshot-2 us-east-1

命令选项

  • 快照：快照的 ID 或名称。
  • ZONE_NAME：此快照克隆所在的区域名称。 已在克隆区域中启用快照快速复原。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 snapshot-clone-create

创建一个分区快照克隆。

ibmcloud is snapshot-clone-create SNAPSHOT --zone ZONE [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is snaphost-clone-create r134-77e21079-7291-44c2-866a-8f1848bc10f0 --zone us-south-2
  • ibmcloud is snapshot-clone-create aaa-default-snapshot-2 --zone us-east-1

命令选项

  • 快照：快照的 ID 或名称。
  • --zone：您希望快照克隆所在的区域名称。 已在克隆区域中启用快照快速复原。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 snapshot-clone-delete

删除一个或多个区域中的分区快照克隆。

ibmcloud is snapshot-clone-delete SNAPSHOT (ZONE_NAME1 ZONE_NAME2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is snaphost-clone-delete r134-77e21079-7291-44c2-866a-8f1848bc10f0 us-south-2
  • ibmcloud is snapshot-clone-delete aaa-default-snapshot-2 us-east-1 us-east-2

命令选项

  • 快照：快照的 ID 或名称。
  • ZONE_NAME1：此快照克隆所在的区域名称。
  • ZONE_NAME2：此快照克隆所在的区域名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 snapshot-clones

列出所有区域快照克隆。

ibmcloud is snapshot-clones SNAPSHOT [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is snapshot-clones aaa-default-snapshot-2
  • ibmcloud is snapshot-cls f0542d32-2c92-4f64-9d25-8469a5bef29d

命令选项

  • 快照：快照的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是快照实例-文件

列出与快照兼容的实例概要文件。

ibmcloud is snapshot-instance-profiles SNAPSHOT [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is snapshot-instance-profiles my-snapshot
  • ibmcloud is snapshot-instance-profiles my-snapshot --output JSON
  • ibmcloud is snapshot-instance-profiles r134-064dcec0-5e15-42cf-8b28-a9d27f9cd751
  • ibmcloud is snapshot-instance-profiles r134-064dcec0-5e15-42cf-8b28-a9d27f9cd751 --output JSON

命令选项

  • 快照：快照的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 snapshot-consistency-groups

列出所有快照一致性组。

ibmcloud is snapshot-consistency-groups [--backup-policy-plan BACKUP_POLICY_PLAN --backup-policy BACKUP_POLICY] [--backup-policy-job BACKUP_POLICY_JOB] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is snapshot-consistency-groups
  • ibmcloud is snapshot-consistency-groups --backup-policy-plan r134-7d36a9df-9512-496e-8ad0-054cb4dd854c --backup-policy r134-3f56e0fa-1cfb-4341-9e57-de2a6345e7b3
  • ibmcloud is snapshot-consistency-groups --backup-policy-plan bkp-plan-do-not-delete --backup-policy bkp-policy-do-not-delete
  • ibmcloud is snapshot-consistency-groups --backup-policy-plan r134-7d36a9df-9512-496e-8ad0-054cb4dd854c --backup-policy bkp-policy-do-not-delete
  • ibmcloud is snapshot-consistency-groups --backup-policy-plan bkp-plan-do-not-delete --backup-policy r134-3f56e0fa-1cfb-4341-9e57-de2a6345e7b3
  • ibmcloud is snapshot-consistency-groups --backup-policy-job r134-7d36a9df-9512-496e-8ad0-054cb4dd854c

命令选项

  • --backup-policy-plan：备份策略计划的 ID 或名称。
  • --backup-policy：备份策略的 ID 或名称。
  • -backup-policy-job：将集合筛选为具有备份策略任务 ID 的快照一致性组。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 snapshot-consistency-group

查看快照一致性组的详细信息。

ibmcloud is snapshot-consistency-group SNAPSHOT_CONSISTENCY_GROUP [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is snapshot-consistency-group r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2
  • ibmcloud is snapshot-consistency-group example-snap-cg

命令选项

  • SNAPSHOT_CONSISTENCY_GROUP：快照一致性组的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 snapshot-consistency-group-create

创建快照一致性组。

ibmcloud is snapshot-consistency-group-create ((--snapshots SNAPSHOTS_JSON | @SNAPSHOTS_JSON_FILE) | (--source-volume SOURCE_VOLUME [--snapshot-name SNAPSHOT_NAME] [--user-tags USER_TAG_NAME1,USER_TAG_NAME2,...])) [--name NAME] [--delete-snapshot-on-delete false | true] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is snapshot-consistency-group-create --source-volume r006-1772e102-0671-48c7-a97a-504247e61e48
  • ibmcloud is snapshot-consistency-group-create --source-volume r006-1772e102-0671-48c7-a97a-504247e61e48 --resource-group-id 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3
  • ibmcloud is snapshot-consistency-group-create --source-volume r006-1772e102-0671-48c7-a97a-504247e61e48 --resource-group-name Default
  • ibmcloud is snapshot-consistency-group-create --source-volume r006-1772e102-0671-48c7-a97a-504247e61e48 --snapshot-name snapshot1 --name snapshot-consistency-group-1
  • ibmcloud is snapshot-consistency-group-create --source-volume r006-1772e102-0671-48c7-a97a-504247e61e48 --user-tags env:test,env:stage
  • ibmcloud is snapshot-consistency-group-create --source-volume r006-1772e102-0671-48c7-a97a-504247e61e48 --resource-group-id 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --output json
  • ibmcloud is snapshot-consistency-group-create --source-volume r006-1772e102-0671-48c7-a97a-504247e61e48 --delete-snapshot-on-delete false --resource-group-id 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3 --output json
  • ibmcloud is snapshot-consistency-group-create --snapshots '[{"source_volume":"r006-1772e102-0671-48c7-a97a-504247e61e48"}]'
  • ibmcloud is snapshot-consistency-group-create --snapshots '[{"source_volume":"r006-1772e102-0671-48c7-a97a-504247e61e48","user_tags":["env:test,env:stage"],"name":"snapshot1"}]' --name multi-snapshot-consistency-group --delete-snapshot-on-delete false
  • ibmcloud is snapshot-consistency-group-create --snapshots @snapshots.json --name multi-snapshot-consistency-group --delete-snapshot-on-delete false

命令选项

  • --snapshots：SNAPSHOTS_JSON|@SNAPSHOTS_JSON_FILE，JSON 格式的快照或 JSON 文件，快照列表。 关于数据模式，请查阅 API 文档 中的 snapshots 属性。 其中一个: SNAPSHOTS_JSON，@SNAPSHOTS_JSON_FILE。
  • --source-volume：源卷的 ID、名称或 CRN。
  • --snapshot-name：此快照的名称。
  • --user-tags：与该快照关联的用户标签。
  • --name：快照一致性组的名称。
  • --delete-snapshot-on-delete：指定在删除快照一致性组时，是否同时删除该组中的快照。 其中一个: false，true。(缺省值: true)。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 snapshot-consistency-group-update

更新快照一致性组。

ibmcloud is snapshot-consistency-group-update SNAPSHOT_CONSISTENCY_GROUP [--name NEW_NAME] [--delete-snapshot-on-delete false | true] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is snapshot-consistency-group-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --name snapshot-consistency-group-1
  • ibmcloud is snapshot-consistency-group-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --name snapshot-consistency-group-1 --delete-snapshot-on-delete false
  • ibmcloud is snapshot-consistency-group-update snapshot-consistency-group-1-new --name snapshot-consistency-group-1-updated --delete-snapshot-on-delete false

命令选项

  • SNAPSHOT_CONSISTENCY_GROUP：快照一致性组的 ID 或名称。
  • --name：快照一致性组的新名称。
  • --delete-snapshot-on-delete：指定在删除快照一致性组时，是否同时删除该组中的快照。 其中一个: false，true。(缺省值: true)。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 snapshot-consistency-group-delete

删除一个或多个快照一致性组。

ibmcloud is snapshot-consistency-group-delete (SNAPSHOT_CONSISTENCY_GROUP1 SNAPSHOT_CONSISTENCY_GROUP2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is snapshot-consistency-group-delete r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2
  • ibmcloud is snapshot-consistency-group-delete scg1 scg2

命令选项

  • SNAPSHOT_CONSISTENCY_GROUP1：快照一致性组的 ID 或名称。
  • SNAPSHOT_CONSISTENCY_GROUP2：快照一致性组的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

文件共享

以下部分提供了有关文件共享的 CLI 命令的信息。

ibmcloud 是共享的

查看文件共享的详细信息。 详细信息包括共享的专区、大小、IOPS 或带宽等。 如需了解更多信息，请参阅 VPC 文档。

ibmcloud is share SHARE [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is share r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2
  • ibmcloud is share new-share

命令选项

  • 共享：文件共享的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 share-create

创建容量范围为 10 至 32,000 GB 的文件共享。 对于分区共享，请指定 IOPS。 对于区域共享，请指定带宽。 如需了解更多信息，请参阅 VPC 文档。

ibmcloud is share-create (--profile PROFILE ([--zone ZONE_NAME] | [--snapshot SNAPSHOT --share SHARE]) [--bandwidth BANDWIDTH] [--size SIZE] [--encryption-key ENCRYPTION_KEY] [--initial-owner-gid INITIAL_OWNER_GID] [--initial-owner-uid INITIAL_OWNER_UID] [--iops IOPS] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--allowed-access-protocols, --aacp nfs4] [--replica-share-profile REPLICA_SHARE_PROFILE --replica-share-cron-spec REPLICA_SHARE_CRON_SPEC [--replica-share-zone ZONE_NAME] [--replica-share-iops REPLICA_SHARE_IOPS] [--replica-share-user-tags REPLICA_SHARE_USER_TAGS] [--replica-share-allowed-transit-encryption-modes, --rs-atem stunnel,ipsec,none] [--replica-share-mount-targets MOUNT_TARGETS_JSON | @MOUNT_TARGETS_JSON_FILE] [--replica-share-name REPLICA_SHARE_NAME]] | --origin-share ORIGIN_SHARE) [--allowed-transit-encryption-modes, --atem stunnel,ipsec,none] [--name NAME] [--user-tags USER_TAGS] [--mount-targets MOUNT_TARGETS_JSON | @MOUNT_TARGETS_JSON_FILE] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is share-create --name my-file-share --zone us-south-1 --profile dp2 --size 40
  • ibmcloud is share-create --name my-file-share-1 --zone us-south-1 --profile dp2 --size 40 --initial-owner-gid 100 --initial-owner-uid 200
  • ibmcloud is share-create --name my-file-share --zone us-south-1 --profile dp2 --size 40 --output JSON
  • ibmcloud is share-create --name my-file-share --zone us-south-2 --profile dp2 --size 1000 --iops 1000
  • ibmcloud is share-create --zone us-east-1 --profile dp2 --size 40 --encryption_key crn:v1:bluemix:public:kms:us-south:a/dffc98a0f1f0f95f6613b3b752286b87:e4a29d1a-2ef0-42a6-8fd2-350deb1c647e:key:5437653b-c4b1-447f-9646-b2a2a4cd6179
  • ibmcloud is share-create --name my-file-accessor-share --origin-share crn:v1:bluemix:public:is:au-syd-1:a/1431ea2a7958ad20f0fee592ff85f746::share:r026-02aea1c7-adb6-4072-9799-6ca495561661
  • ibmcloud is share-create --profile dp2 --snapshot r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3
  • ibmcloud is share-create --profile dp2 --snapshot cli-share-snapshot --share my-file-share --user-tags "dev:tags"
  • ibmcloud is share-create --profile dp2 --snapshot crn:v1:staging:public:is:us-south-1:a/efe5afc483594adaa8325e2b4d1290df::share-snapshot:r134-2ae87eb2-b26c-4126-ab34-e6e64f6f1773/r134-6ce54f3b-8971-4b5d-95a7-7dfa897ddfb3 --user-tags "dev:tags"
  • ibmcloud is share-create --name p-share-3 --zone us-south-1 --profile dp2 --replica-share-profile dp2 --replica-share-cron-spec '55 09 * * *' --replica-share-zone us-south-3 --replica-share-name replica-p-share-3 --replica-share-mount-targets '[{"access-protocol": "nfs4","name": "my-target1", "transit_encryption":"stunnel", "vpc": {"id": "r134-fa7c3b16-8a59-4434-8c2c-3230e916d441"}}]' --size 40
  • ibmcloud is share-create --zone us-south-1 --profile dp2 --name my-file-share --user-tags env:dev,env:test --mount-targets '[{"access-protocol": "nfs4", "transit_encryption":"stunnel", "name": "my-target121","vpc": {"name": "test-vpc-18-1"}},{"name": "my-target122","vpc": {"name": "vpc-0413"}}]' --replica-share-profile dp2 --replica-share-cron-spec '55 09 * * *' --replica-share-zone us-south-3 --replica-share-user-tags env:dev,env:prod --replica-share-name my-file-share-replica --replica-share-mount-targets '[{"access-protocol": "nfs4", "transit_encryption":"stunnel", "name": "my-target1", "vpc": {"id": "r006-9265c6c2-13e7-4268-b4e9-658d4df1e2f6"}}]' --size 40
  • ibmcloud is share-create --name my-file-share-3 --zone au-syd-1 --profile dp2 --size 40 --mount-targets '[{"access-protocol": "nfs4", "transit_encryption":"stunnel", "name": "my-target1", "vpc": {"id": "r026-b403cfe8-917e-4fb8-a72c-bb490c735119"}}]' --replica-share-profile dp2 --replica-share-cron-spec '55 09 * * *' --replica-share-zone au-syd-2 --replica-share-name replica-p-share-3 --replica-share-mount-targets '[{"access-protocol": "nfs4", "transit_encryption":"stunnel", "name": "my-replica-target1", "vpc": {"name": "vpc-1006-01"}}]'
  • ibmcloud is share-create --name my-fs-cli-1 --zone us-south-1 --profile dp2 --size 40 --atem ipsec,none --mount-targets '[{"access-protocol": "nfs4", "transit_encryption":"stunnel", "name":"my-target1","virtual_network_interface":{"name":"my-fs-cli-1-vni","primary_ip":{"id":"0716-d2a60008-84ca-4345-86f9-23a65dc75a32"},"resource_group":{"id":"11caaa983d9c4beb82690daab08717e9"},"security_groups":[{"id":"r134-a2f82965-1b8d-4bfe-9949-fe79e47daa86"}]}}]' --replica-share-profile dp2 --replica-share-cron-spec '55 09 * * *' --replica-share-zone us-south-2 --replica-share-name my-fs-cli-1-replica --replica-share-mount-targets '[{"access-protocol": "nfs4", "transit_encryption":"stunnel", "name":"my-target1","virtual_network_interface":{"name":"my-fs-cli-1-vni-2","primary_ip":{"address":"10.240.66.20","auto-delete":true,"name":"rip-vni-target"},"resource_group":{"id":"11caaa983d9c4beb82690daab08717e9"},"security_groups":[{"id":"r134-bd0f8527-c45c-496e-8d34-63bda6dd829b"}],"subnet":{"id":"0726-cf6d55db-284e-40c6-aea7-67dbabfa5542"}}}]'
  • ibmcloud is share-create --profile dp2 --snapshot cli-share-snapshot --allowed-access-protocols nfs4 --share my-file-share --user-tags "dev:tags"
  • ibmcloud is share-create --name my-file-share --profile rfs --size 40 --allowed-access-protocols nfs4 --bandwidth 1000 --atem stunnel,none
  • ibmcloud is share-create --name my-fs-cli-1 --profile rfs --size 40 --bandwidth 125 --allowed-access-protocols nfs4 --atem stunnel,none --mount-targets '[{"access-protocol": "nfs4", "transit_encryption":"stunnel", "name":"my-target1","virtual_network_interface":{"name":"my-fs-cli-vni", "primary_ip":{"address":"10.240.64.51","auto-delete":true,"name":"vni-target-1"},"security_groups":[{"id":"r134-bfa4dea5-3e09-4a76-90ef-cee3b840936b"}],"subnet":{"id":"0726-c5941a73-2e07-46e6-b0c8-db306259341f"}}}]'

命令选项

  • --allowed-transit-encryption-modes, --atem：允许的传输加密模式。 一个或多个以逗号分隔的值：stunnel、ipsec、none。
  • --name：此文件共享的用户自定义名称。
  • --user-tags：此资源的标签。
  • --zone：区域名称。
  • --snapshot：此文件共享的源快照的 ID、名称或 CRN。
  • --share：文件共享的 ID 或名称。
  • --bandwidth：文件共享的最大带宽（单位为兆比特每秒）。
  • --size：文件共享的大小将向上取整至最接近的1千兆字节。
  • --profile：文件共享所使用的配置文件。 所有文件共享都是基于高性能 dp2 概要文件创建的。
  • --encryption-key：用于对共享的数据加密密钥进行封装的根密钥。 如果未指定，那么共享的加密类型为 provider_managed。
  • --initial-owner-gid：文件共享创建时的初始所有者组标识符。 对所有者的后续更改必须由安装了文件共享的虚拟服务器实例执行。
  • --initial-owner-uid：文件共享创建时的初始所有者用户标识符。 对所有者的后续更改必须由安装了文件共享的虚拟服务器实例执行。
  • --iops：文件共享的每秒最大输入/输出操作带宽。 此最大值仅适用于定制概要文件共享。 有关 IOPS 范围，请参阅“已定义的性能配置文件”。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --allowed-access-protocols、--aacp：允许此共享使用的访问协议。 以下内容中的一项或多项，以逗号分隔：nfs4。
  • --replica-share-iops：文件共享的每秒最大输入/输出操作吞吐量。 此最大值仅适用于定制概要文件共享。 有关 IOPS 范围，请参阅“已定义的性能配置文件”。
  • --replica-share-user-tags: 此资源的标记。
  • --replica-share-allowed-transit-encryption-modes, --rs-atem：允许的传输加密模式。 一个或多个以逗号分隔的值：stunnel、ipsec、none。
  • --replica-share-mount-targets: MOUNT_TARGETS_JSON |@MOUNT_TARGETS_JSON_FILE，JSON 或 JSON 文件中的文件共享安装目标之一: MOUNT_TARGETS_JSON，@MOUNT_TARGETS_JSON_FILE。
  • --replica-share-name：此文件共享的用户自定义名称。
  • --replica-share-profile：文件共享所使用的配置文件。
  • --replica-share-cron-spec：文件共享复制计划的 cron 规范。
  • --replica-share-zone：该副本文件共享将位于的区域。 必须是源共享所在区域中的另一专区。
  • --origin-share：访问共享所属的源共享的 ID、名称或 CRN。
  • --mount-targets：MOUNT_TARGETS_JSON|@MOUNT_TARGETS_JSON_FILE，以 JSON 或 JSON 文件格式指定的文件共享挂载目标。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 share-delete

删除一个或多个文件共享。 您无法撤销此删除操作。 如需了解更多信息，请参阅 VPC 文档。

ibmcloud is share-delete (SHARE1 SHARE2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is share-delete my-file-share-99 cli-demo-00
  • ibmcloud is share-delete r006-866fc826-6f30-444f-b55e-0d697cf8b4bb

命令选项

  • SHARE1：文件共享的 ID 或名称。
  • SHARE2：文件共享的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是共享概要文件

查看文件共享概要文件的详细信息，包括容量、IOPS、带宽、允许的传输加密模式、可用性模式以及允许的访问协议。 如需了解更多信息，请参阅 CLI 文档。

ibmcloud is share-profile PROFILE_NAME [--output JSON] [-q, --quiet]

命令选项

  • PROFILE_NAME：文件共享配置文件的名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是共享概要文件

列出该区域的所有文件共享概要文件。 如需了解更多信息，请参阅 VPC 文档。

ibmcloud is share-profiles [--output JSON] [-q, --quiet]

命令选项

  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 share-update

编辑文件共享的名称、大小、概要文件、IOPS 等。 如需了解更多信息，请参阅 VPC 文档。

ibmcloud is share-update SHARE [--name NEW_NAME] [--size SIZE] [--allowed-access-protocols, --aacp nfs4] [--bandwidth BANDWIDTH] [--replication-cron-spec REPLICATION_CRON_SPEC] [--iops IOPS] [--profile PROFILE] [--user-tags USER_TAGS] [--access-control-mode security_group] [--allowed-transit-encryption-modes, --atem stunnel,ipsec,none] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is share-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name new-share
  • ibmcloud is share-update my-file-share-0b88 --name new-share
  • ibmcloud is share-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --name new-share --output JSON
  • ibmcloud is share-update 72251a2e-d6c5-42b4-97b0-b5f8e8d1f479 --size 10000 --output JSON
  • ibmcloud is share-update my-file-share --profile dp2 --iops 1200
  • ibmcloud is share-update my-file-share --profile dp2
  • ibmcloud is share-update my-file-share-1 --iops 1000
  • ibmcloud is share-update p-share-32 --user-tags env:dev,env:prod
  • ibmcloud is share-update my-fs-2-cli --access-control-mode security_group
  • ibmcloud is share-update my-cli --allowed-transit-encryption-modes none,stunnel --allowed-access-protocols nfs4 --bandwidth 1000

命令选项

  • 共享：文件共享的 ID 或名称。
  • --name：文件共享的新名称。
  • --size：文件共享的大小，四舍五入至最接近的1千兆字节。 大小只能增加，不能减小。
  • --allowed-access-protocols、--aacp：允许此共享使用的访问协议。 以下内容中的一项或多项，以逗号分隔：nfs4。
  • --bandwidth：文件共享的最大带宽（单位为兆比特每秒）。
  • --replication-cron-spec：文件共享复制计划的 cron 配置。
  • --iops：文件共享的每秒最大输入/输出操作带宽。 此最大值仅适用于定制概要文件共享。 有关 IOPS 范围，请参阅“已定义的性能配置文件”。
  • --profile：文件共享所使用的配置文件。
  • --user-tags：此资源的标签。
  • --access-control-mode：共享的访问控制模式。（默认：security_group ）。
  • --allowed-transit-encryption-modes, --atem：允许的传输加密模式。 一个或多个以逗号分隔的值：stunnel、ipsec、none。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是共享

列出该区域的所有文件共享。 如需了解更多信息，请参阅 VPC 文档。

ibmcloud is shares [--replication-role none | replica | source] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is shares
  • ibmcloud is shares --replication-role replica

命令选项

  • --replication-role：将集合筛选为具有指定复制角色的文件共享。 其中一个: none，副本，源。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 共享-复制-创建

在同一地理区域的另一个可用区域中，为现有区域文件共享创建一个只读副本。 如需了解更多信息，请参阅 VPC 文档。

ibmcloud is share-replica-create --profile PROFILE [--zone ZONE_NAME] --replication-cron-spec REPLICATION_CRON_SPEC --source-share SOURCE_SHARE [--name NAME] [--replica-share-user-tags REPLICA_SHARE_USER_TAGS] [--encryption-key ENCRYPTION_KEY] [--iops IOPS] [--mount-targets MOUNT_TARGETS_JSON | @MOUNT_TARGETS_JSON_FILE] [--allowed-transit-encryption-modes, --atem stunnel,ipsec,none] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is share-replica-create --name p-replica-share-3 --zone us-south-3 --profile dp2 --replication-cron-spec '10 05 * * *' --source-share r134-2b4c32f9-9d25-43df-9d59-3874a81ec46e
  • ibmcloud is share-replica-create --zone us-south-3 --profile dp2 --iops 1200 --name p-share-replica-32 --replica-share-user-tags env:dev,env:test --mount-targets '[{"name": "my-target1", "vpc": {"name": "test-vpc-18-1"}}]' --replication-cron-spec '10 08 * * *' --source-share r006-0394a827-fe42-4341-b369-186e1a2288d3
  • ibmcloud is share-replica-create --zone au-syd-2 --profile dp2 --mount-targets '[{"access-protocol": "nfs4", "transit_encryption":"ipsec", "name": "my-target1", "vpc": {"id": "r026-b403cfe8-917e-4fb8-a72c-bb490c735119"}}]' --replication-cron-spec '10 05 * * *' --source-share my-file-share --name my-file-share-3-replica
  • ibmcloud is share-replica-create --name p-replica-share-3 --zone us-south-3 --profile dp2 --mount-targets '[{"access-protocol": "nfs4", "transit_encryption":"ipsec", "name": "my-target1", "vpc": {"id": "r134-2f06ca6e-771e-40cc-9553-3838e2cc396d"}}]' --replication-cron-spec '10 05 * * *' --source-share my-file-share
  • ibmcloud is share-replica-create --name p-replica-share-3 --zone us-south-3 --profile dp2 --replication-cron-spec '10 05 * * *' --source-share r134-2b4c32f9-9d25-43df-9d59-3874a81ec46e
  • ibmcloud is share-replica-create --name p-replica-share-3 --zone us-south-3 --profile dp2 --replication-cron-spec '10 05 * * *' --source-share crn:v1:staging:public:is:us-south-2:a/egq5afc483594adaa8325e2b4d1290df::share:r134-ee076f3c-9b82-4e33-953c-866205612fc9 --encryption-key crn:v1:staging:public:kms:us-south:a/efe5afc483594adaa8325e2b4d1290df:1be45161-6dae-44ca-b248-837f98004057:key:3dd21cc5-dc20-4f7c-bc62-8ec9a8a3d1bd

命令选项

  • --profile：文件共享所使用的配置文件。
  • --name：此文件共享的用户自定义名称。
  • --zone：区域名称。
  • --replica-share-user-tags: 此资源的标记。
  • --encryption-key：用于对共享的数据加密密钥进行封装的根密钥。 如果 source_share 加密类型是 user_managed，那么必须指定此属性，否则不得指定此属性。
  • --iops：文件共享的每秒最大输入/输出操作带宽。 此最大值仅适用于定制概要文件共享。 有关 IOPS 范围，请参阅“已定义的性能配置文件”。
  • --mount-targets：MOUNT_TARGETS_JSON|@MOUNT_TARGETS_JSON_FILE，以 JSON 或 JSON 文件格式指定的文件共享挂载目标。
  • --replication-cron-spec：文件共享复制计划的 cron 配置。
  • --source-share：此复制文件共享的源文件共享的 ID、名称或 CRN。 所指定的文件共享不能已经具有副本，并且不能是副本。
  • --allowed-transit-encryption-modes, --atem：允许的传输加密模式。 一个或多个以逗号分隔的值：stunnel、ipsec、none。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 share-副本-故障转移

如果源文件共享不可用，可故障转移至副本文件共享，以确保数据持续可用。 如需了解更多信息，请参阅 VPC 文档。

ibmcloud is share-replica-failover REPLICA_SHARE [--fallback-policy fail | split] [--timeout TIMEOUT] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is share-replica-failover r134-de1e70af-c3cb-44c6-a96d-2ece09b51ae3 --fallback-policy fail --timeout 1200
  • ibmcloud is share-replica-failover r134-8a07129c-e376-4572-9ef3-68c729b315d5 --fallback-policy split --timeout 600

命令选项

  • REPLICA_SHARE：复制文件共享的 ID 或名称。
  • --fallback-policy：当故障转移请求被接受但无法执行或超时时的处理措施。 其中一个: fail，split。
  • --timeout：故障转移超时时间（单位：秒）。 最小超时为 300 秒，最大超时为 3600 秒。 如果达到超时，那么将触发 fallback_policy。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是共享-复制-拆分

将源文件共享与副本共享拆分，使两者之间不再同步数据。 两个共享将继续独立存在。 如需了解更多信息，请参阅 VPC 文档。

ibmcloud is share-replica-split REPLICA_SHARE [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is share-replica-split replica-p-share-3

命令选项

  • REPLICA_SHARE：复制文件共享的 ID 或名称。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 share-mount-target

查看文件共享挂载目标的详细信息，包括其 VPC、虚拟网络接口、安装路径等内容。 如需了解更多信息，请参阅 VPC 文档。

ibmcloud is share-mount-target SHARE MOUNT_TARGET [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is share-mount-target my-file-share-3 my-target1

命令选项

  • 共享：文件共享的 ID 或名称。
  • MOUNT_TARGET：文件共享挂载目标的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 share-mount-targets

列出文件共享的所有共享安装目标。 如需了解更多信息，请参阅 VPC 文档。

ibmcloud is share-mount-targets SHARE [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is share-mount-targets my-file-share-3

命令选项

  • 共享：文件共享的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 share-mount-target-delete

删除一个或多个文件共享安装目标。 您无法撤销此删除操作。 如需了解更多信息，请参阅 VPC 文档。

ibmcloud is share-mount-target-delete SHARE (MOUNT_TARGET1 MOUNT_TARGET2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is share-mount-target-delete r026-b72bae3c-630b-4e06-bdf8-c3b27b8013f7 mount-target-test

命令选项

  • 共享：文件共享的 ID 或名称。
  • MOUNT_TARGET1：文件共享挂载目标的 ID 或名称。
  • MOUNT_TARGET2：文件共享挂载目标的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 share-mount-target-update

编辑文件共享安装目标名称。 如需了解更多信息，请参阅 [VPC 文档] （ https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-managing&interface=cli#rename-mount-target-cli ）。

ibmcloud is share-mount-target-update SHARE MOUNT_TARGET --name NEW_NAME [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is share-mount-target-update r026-b72bae3c-630b-4e06-bdf8-c3b27b8013f7 overbuilt-yogurt-detention-wreaths --name mount-target-test

命令选项

  • 共享：文件共享的 ID 或名称。
  • MOUNT_TARGET：文件共享挂载目标的 ID 或名称。
  • --name：文件共享的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 share-mount-target-create

创建安装目标，将文件共享附加到同一区域的虚拟服务器实例或 Kubernetes 集群。 如需了解更多信息，请参阅 [VPC 文档] （ https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-create&interface=cli#fs-create-mount-target-cli ）。

ibmcloud is share-mount-target-create SHARE (--transit-encryption stunnel | ipsec | none) (--access-protocol nfs4) ([--vni VNI | (--vni-auto-delete true | false [--protocol-state-filtering-mode, --psfm auto | enabled | disabled] --vni-name VNI_NAME [--vni-rip VNI_RIP | (--vni-rip-address VNI_RIP_ADDRESS --vni-rip-auto-delete VNI_RIP_AUTO_DELETE --vni-rip-name VNI_RIP_NAME)] --subnet SUBNET --vni-sgs VNI_SGS --resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME)] | --vpc VPC) [--name NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is share-mount-target-create r026-b72bae3c-630b-4e06-bdf8-c3b27b8013f7 --transit-encryption none --vpc vpc-1006-01 --access-protocol nfs4
  • ibmcloud is share-mount-target-create r026-b72bae3c-630b-4e06-bdf8-c3b27b8013f7 --transit-encryption none --vpc vpc-1006-01 --access-protocol nfs4
  • ibmcloud is share-mount-target-create r042-3afab254-82b7-4627-94b2-35d8bdfcd306 --access-protocol nfs4 --subnet 02u7-62c52bfc-6075-4dad-a588-bdb6a42d925b --vni-name cli-vni --vni-rip-auto-delete true --name my-cli-target --transit-encryption ipsec
  • ibmcloud is share-mount-target-create cli-share-1 --transit-encryption stunnel --access-protocol nfs4 --subnet cli-subnet-1 --name cli-share-mount-target-1 --vni-name cli-share-vni-1 --vni-rip test --vni-sgs concrete-proudly-coastal-obvious,sg-vni --resource-group-name Default --vpc cli-vpc-1
  • ibmcloud is share-mount-target-create cli-share-1 --transit-encryption stunnel --access-protocol nfs4 --subnet cli-subnet-1 --name cli-share-mount-target-1 --vni-name cli-share-vni-1 --psfm enabled --vni-rip test --vni-sgs concrete-proudly-coastal-obvious,sg-vni --resource-group-name Default --vpc cli-vpc-1

命令选项

  • 共享：文件共享的 ID 或名称。
  • --name：此文件共享挂载目标的用户自定义名称。
    • -transit-encryption（传输加密 ）：none：传输中不加密，ipsec：使用实例身份证书进行传输加密，stunnel：使用实例身份证书进行传输加密：ipsec：通过使用实例身份证书在传输过程中加密；stunnel：通过使用stunnel连接在传输过程中加密：ipsec和stunnel适用于只有访问控制模式安全组的共享。 其中之一：stunnel、IPsec、无。
  • --access-protocol：用于访问此共享挂载目标的协议。 之一：nfs4.
  • --vni：虚拟网络接口的 ID 或名称。
  • --vni-auto-delete：指示当目标被删除时，此虚拟网络接口是否会自动删除。 下列其中一项: true 和 false。(缺省值: true)。
  • --protocol-state-filtering-mode: auto,--psfm auto 此虚拟网络接口应采用的协议状态过滤模式。 如果设置为“自动”，则协议状态数据包过滤功能是否启用或禁用，取决于虚拟网络接口的 target 资源类型。 其中一个: auto，enabled，disabled。(缺省值: auto)。
  • --vni-name：此虚拟网络接口的名称。
  • --vni-rip：要绑定到虚拟网络接口的保留 IP 的 ID 或名称。
  • --vni-rip-address：用于绑定到虚拟网络接口的预留 IP 地址。
  • --vni-rip-auto-delete：指定当任一目标被删除，或者该预留 IP 地址被解除绑定时，该预留 IP 地址是否自动删除。
  • --vni-rip-name：此预留 IP 地址用于绑定到虚拟网络接口的名称。
  • --subnet：与该文件共享挂载目标关联的子网。
  • --vni-sgs：用于虚拟网络接口的安全组的 ID 或名称，以逗号分隔。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --vpc：此共享挂载目标允许将文件共享挂载到的 VPC 的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 share-accessor-bindings

列出所有与源共享关联的访问者共享绑定。 如需了解更多信息，请参阅 [VPC 文档] （ https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-view&interface=cli#fs-view-share-bindings-cli ）。

ibmcloud is share-accessor-bindings SHARE [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is share-accessor-bindings r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2

命令选项

  • 共享：文件共享的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 share-accessor-binding

查看特定访问者共享绑定的详细信息，包括其 href、访问者等。 如需了解更多信息，请参阅 [VPC 文档] （ https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-view&interface=cli#fs-view-share-binding-cli ）。

ibmcloud is share-accessor-binding SHARE ACCESSOR_BINDING [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is share-accessor-binding my-cli-accessor-share r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2

命令选项

  • 共享：文件共享的 ID 或名称。
  • ACCESSOR_BINDING：文件共享访问器绑定的标识符。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 share-accessor-binding-delete

删除一个或多个文件共享访问者绑定。 无法撤销此操作。 如需了解更多信息，请参阅 [VPC 文档] （ https://cloud.ibm.com/docs/vpc?topic=vpc-file-storage-managing&interface=cli#delete-bindings-cli ）。

ibmcloud is share-accessor-binding-delete SHARE ACCESSOR_BINDING [-f, --force] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is share-accessor-binding-delete my-file-share-99 r006-866fc826-6f30-444f-b55e-0d697cf8b4bb
  • ibmcloud is share-accessor-binding-delete r006-866fc826-6f30-444f-b55e-0d697cf8b4bb r006-866fc826-6f30-444f-b55e-0d697cf8b4bc

命令选项

  • 共享：文件共享的 ID 或名称。
  • ACCESSOR_BINDING：文件共享访问器绑定的标识符。
  • --force，-f：强制执行操作，无需确认。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是共享-快照

查看文件共享快照的详细信息，包括其指纹、最小大小等。 如需了解更多信息，请参阅 VPC 文档。

ibmcloud is share-snapshot SHARE SNAPSHOT [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is share-snapshot my-cli-share r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2

命令选项

  • 共享：文件共享的 ID 或名称。
  • 快照：文件共享快照的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是共享-快照

列出区域内或特定文件共享的所有快照。 如需了解更多信息，请参阅 VPC 文档。

ibmcloud is share-snapshots [--share SHARE] [--backup-policy-plan BACKUP_POLICY_PLAN [--backup-policy BACKUP_POLICY]] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is share-snapshots --share r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2

命令选项

  • --share：文件共享的 ID 或名称。
  • --backup-policy-plan：备份策略计划的 ID 或名称。
  • --backup-policy：备份策略的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是共享-快照-删除

删除一个或多个文件共享快照。 您无法撤销此删除操作。 如需了解更多信息，请参阅 VPC 文档。

ibmcloud is share-snapshot-delete SHARE (SNAPSHOT1 SNAPSHOT2 ...) [-f, --force] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is share-snapshot-delete my-file-share-99 r006-866fc826-6f30-444f-b55e-0d697cf8b4bb
  • ibmcloud is share-snapshot-delete r006-866fc826-6f30-444f-b55e-0d697cf8b4bb r006-866fc826-6f30-444f-b55e-0d697cf8b4bc

命令选项

  • 共享：文件共享的 ID 或名称。
  • 快照1：文件共享快照的 ID 或名称。
  • 快照2：文件共享快照的 ID 或名称。
  • --force，-f：强制执行操作，无需确认。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是共享-快照-更新

编辑文件共享快照的用户标记。 如需了解更多信息，请参阅 VPC 文档。

ibmcloud is share-snapshot-update SHARE SNAPSHOT [--user-tags USER_TAGS] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is share-snapshot-update my-cli-share r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --user-tags dev:tags

命令选项

  • 共享：文件共享的 ID 或名称。
  • 快照：文件共享快照的 ID 或名称。
  • --user-tags：与该文件共享快照关联的用户标签。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 共享-快照-创建

创建文件共享快照，以在特定日期和时间捕获共享的数据。 如需了解更多信息，请参阅 VPC 文档。

ibmcloud is share-snapshot-create SHARE [--name NAME] [--user-tags USER_TAGS] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is share-snapshot-create r026-b72bae3c-630b-4e06-bdf8-c3b27b8013f7 --name cli-share-snapshot --user-tags env:dev,env:prod
  • ibmcloud is share-snapshot-create cli-share-1 --name cli-share-snapshot --user-tags env:dev,env:prod

命令选项

  • 共享：文件共享的 ID 或名称。
  • --name：此共享快照的用户自定义名称。
  • --user-tags：与该文件共享快照关联的用户标签。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

备份策略

以下部分提供了有关备份策略的 CLI 命令的信息

ibmcloud 是备份策略

列出所有备份策略。

ibmcloud is backup-policies [--tag TAG_NAME] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME | --all-resource-groups] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is backup-policies
  • ibmcloud is backup-policies --tag dev:test

命令选项

  • --tag：将集合过滤为具有该精确标签值的资源。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --all-resource-groups：查询所有资源组。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是备份策略创建

创建备份策略。

ibmcloud is backup-policy-create --match-tags MATCH_TAGS [--name NAME] [--match-resource-type volume | share | instance [--included-content data_volumes | boot_volume | boot_volume,data_volumes]] [[--plans PLANS_JSON | @PLANS_JSON_FILE] | --plan-cron-spec PLAN_CRON_SPEC [--plan-name PLAN_NAME] --plan-active [--plan-attach-tags PLAN_ATTACH_TAGS] [--plan-copy-tags true | false] [[--plan-delete-after PLAN_DELETE_AFTER] [--plan-delete-over-count PLAN_DELETE_OVER_COUNT]] [[--plan-clone-policy-zones  ZONE1,ZONE2,...] [--plan-clone-policy-max-snapshots PLAN_CLONE_POLICY_MAX_SNAPSHOTS]]] [--scope SCOPE] [--resource-group-id RESOURCE_GROUP_ID | --resource-group-name RESOURCE_GROUP_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is backup-policy-create --match-tags dev:test --name demo-bkp-policy-1 --plan-name demo-bkp-plan-1 --plan-cron-spec '45 09 * * *'
  • ibmcloud is backup-policy-create --match-tags dev:test --name demo-bkp-policy-2 --plan-name demo-bkp-plan-2 --plan-attach-tags dev:test --plan-copy-tags false --plan-delete-after 60 --plan-cron-spec '40 09 * * *'
  • ibmcloud is backup-policy-create --match-tags dev:test --name demo-bkp-policy-x1
  • ibmcloud is backup-policy-create --match-tags dev:test --name demo-bkp-policy-x --plan-name demo-bkp-plan-2 --plan-attach-tags dev:test --plan-copy-tags false --plan-delete-after 60 --plan-cron-spec '45 09 * * *' --plan-active --plan-delete-over-count 2
  • ibmcloud is backup-policy-create --match-tags dev:test --name backup-policy-z --plans '[{"active":true,"attach_user_tags":["my-daily-backup-plan"],"copy_user_tags":true,"cron_spec":"45 09 * * *","deletion_trigger":{"delete_after":20,"delete_over_count":20},"name":"my-policy-plan"},{"active":true,"attach_user_tags":["my-daily-backup-plan"],"copy_user_tags":true,"cron_spec":"45 09 * * *","deletion_trigger":{"delete_after":20,"delete_over_count":20},"name":"my-policy-plan-99"}]'
  • ibmcloud is backup-policy-create --match-tags dev:test --name backup-policy-x2 --plans @plans.json
  • ibmcloud is backup-policy-create --match-tags dev:test --name demo-bkp-policy-x --plan-name demo-bkp-plan-2 --plan-attach-tags dev:test --plan-copy-tags false --plan-delete-after 60 --plan-cron-spec '45 09 * * *' --plan-active --plan-clone-policy-max-snapshots 4 --plan-clone-policy-zones us-south-1 --plan-delete-over-count 2 使用快速复原创建备份策略计划
  • ibmcloud is backup-policy-create --match-tags dev:test --name backup-policy-z --plans '[{"active":true,"attach_user_tags":["my-daily-backup-plan"],"clone_policy":{"max_snapshots":2,"zones":[{"name":"us-south-1"}]},"copy_user_tags":true,"cron_spec":"45 09 * * *","deletion_trigger":{"delete_after":20,"delete_over_count":20},"name":"my-policy-plan"},{"active":true,"attach_user_tags":["my-daily-backup-plan"],"clone_policy":{"max_snapshots":2,"zones":[{"name":"us-south-1"}]},"copy_user_tags":true,"cron_spec":"45 09 * * *","deletion_trigger":{"delete_after":20,"delete_over_count":20},"name":"my-policy-plan-99"}]' 使用快速复原创建备份策略计划
  • ibmcloud is backup-policy-create --match-tags dev:test --name demo-bkp-policy-x1 --match-resource-type instance --included-content data_volumes,boot_volume 为匹配资源类型实例创建备份策略，并包括数据和引导卷作为备份
  • ibmcloud is backup-policy-create --match-tags dev:test --name demo-bkp-policy-x1 --match-resource-type instance --included-content data_volumes 为匹配资源类型实例创建备份策略，并仅包括数据卷作为备份
  • ibmcloud is backup-policy-create --match-tags dev:test --name demo-bkp-policy-x1 --match-resource-type instance --included-content boot_volume 为匹配资源类型实例创建备份策略，并仅包括引导卷作为备份
  • ibmcloud is backup-policy-create --match-tags dev:test --name demo-bkp-policy-x1 --match-resource-type instance 为匹配资源类型实例和缺省完全备份（包括数据和引导卷）创建备份策略
  • ibmcloud is backup-policy-create --match-tags dev:test --name backup-scope-1 --scope crn:v1:bluemix:public:enterprise::a/e92d45e305dc4ee0b13e29be392f1c0c::enterprise:ebc2b430240943458b9e91e1432cfcce 为企业支持创建备份策略
  • ibmcloud is backup-policy-create --match-tags dev:tags --match-resource-type share --name demo-bkp-policy-share --plan-name demo-bkp-plan-2 --plan-cron-spec '1 * * * *' 为共享创建备份策略

命令选项

  • --name：备份策略的新名称。
  • --match-resource-type：此备份策略所适用的资源类型。 卷、共享、实例之一。(默认：卷 ）。
  • --included-content：使用此策略创建的备份所包含的内容。 data_volumes，boot_volume，boot_volume，data_volumes 之一。(缺省值: boot_volume，data_volumes)。
  • --match-tags：此备份策略适用的用户标签。
  • --plans：PLANS_JSON|@PLANS_JSON_FILE，以 JSON 或 JSON 文件形式提供的策略方案列表。 有关数据模式，请查阅 API 文档 中的 plans 属性。 其中一个: PLANS_JSON，@PLANS_JSON_FILE。
  • --plan-name：备份策略计划的名称。
  • --plan-active：表示该计划是否处于活动状态。
  • --plan-attach-tags：要附加到该计划所创建的每个资源上的用户标签。
  • --plan-copy-tags：指定是否将源用户的标签复制到创建的资源中。 以下选项之一：true、false。
  • --plan-cron-spec：备份计划的 cron 配置。
  • --plan-delete-after：每个备份创建后保留的天数上限。（默认值：30 ）。
  • --plan-delete-over-count: 要保留的最近备份的最大数量。 如果未指定，那么将保留所有备份。
  • --plan-clone-policy-max-snapshot: 保留克隆的最近快照 (每个源) 的最大数量。(缺省值: 5)。
  • --plan-clone-policy-zones：此备份策略计划用于创建快照克隆的区域。
  • --范围：企业账户的CRN。
  • --resource-group-id：资源组的 ID。 此 ID 与 --resource-group-name 互斥。
  • --resource-group-name：资源组的名称。 此名称与 --resource-group-id 互斥。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 backup-policy-delete

删除一个或多个备份策略。

ibmcloud is backup-policy-delete (POLICY1 POLICY2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is backup-policy-delete r134-7759199b-bc1f-448e-84fa-2aa42bde29af
  • ibmcloud is backup-policy-delete demo-policy-100

命令选项

  • 策略1：备份策略的ID或名称。
  • 策略2：备份策略的ID或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 backup-policy-update

更新备份策略。

ibmcloud is backup-policy-update POLICY [--match-tags MATCH_TAGS] [--included-content data_volumes | boot_volume | boot_volume,data_volumes] [--name NEW_NAME] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is backup-policy-update r134-aa88726e-8b34-4f97-992d-027df9c4bb36 --name my-policy2
  • ibmcloud is backup-policy-update demo-policy-99 --name demo-policy-100
  • ibmcloud is backup-policy-update backup-policy-1001 --match-tags demo:cli
  • ibmcloud is backup-policy-update demo-policy-99 --included-content data_volumes,boot_volume 更新匹配资源类型实例的备份策略以同时包含数据和引导卷作为备份
  • ibmcloud is backup-policy-update demo-policy-99 --included-content data_volumes 为匹配资源类型实例创建备份策略，以包括数据卷作为备份
  • ibmcloud is backup-policy-update demo-policy-99 --included-content boot_volume 为匹配资源类型实例创建备份策略，以包含引导卷作为备份

命令选项

  • 策略：备份策略的 ID 或名称。
  • --included-content：使用此策略创建的备份所包含的内容。 data_volumes，boot_volume，boot_volume，data_volumes 之一。(缺省值: boot_volume，data_volumes)。
  • --match-tags：此备份策略适用的用户标签。
  • --name：备份策略的新名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 backup-policy

查看备份策略的详细信息。

ibmcloud is backup-policy POLICY [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is backup-policy r134-ac2a8be2-aa99-4571-baed-c3ec63a64ce7
  • ibmcloud is backup-policy demo-bkp-policy

命令选项

  • 策略：备份策略的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 backup-policy-plan

查看备份策略计划的详细信息。

ibmcloud is backup-policy-plan POLICY PLAN [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is backup-policy-plan c884526b-e6cc-453d-934d-82bf39a39114 6e5b9ee4-d4f0-4e9b-89d6-18642823a855
  • ibmcloud is backup-policy-plan demo-bkp-policy-b98 cli-demo-policy-plan-3

命令选项

  • 策略：备份策略的 ID 或名称。
  • PLAN：备份策略计划的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 backup-policy-plans

列出该备份策略的所有计划。

ibmcloud is backup-policy-plans POLICY [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is backup-policy-plans c884526b-e6cc-453d-934d-82bf39a39114
  • ibmcloud is backup-policy-plans demo-bkp-policy-b98

命令选项

  • 策略：备份策略的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 backup-policy-plan-create

制定一份备份策略计划。

ibmcloud is backup-policy-plan-create POLICY --cron-spec CRON_SPEC [--name NAME] [--active] [--attach-tags ATTACH_TAGS] [--copy-tags true | false] [[--delete-after DELETE_AFTER] [--delete-over-count DELETE_OVER_COUNT]] [[--clone-policy-zones  ZONE1,ZONE2,...] [--clone-policy-max-snapshots CLONE_POLICY_MAX_SNAPSHOTS]] [--remote-region-policies REMOTE_REGION_POLICY_JSON | @REMOTE_REGION_POLICY_JSON] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is backup-policy-plan-create c9a0e8d9-c592-4175-80cb-3056f6fd1da7 --attach-tags dev:test --copy-tags true --cron-spec '*/5 1,2,3 * * *' --delete-after 80 --name my-policy-plan-1
  • ibmcloud is backup-policy-plan-create c9a0e8d9-c592-4175-80cb-3056f6fd1da7 --cron-spec '*/5 1,2,3 * * *' --name my-policy-plan-2
  • ibmcloud is backup-policy-plan-create backup-policy-1001 --cron-spec '0 0 * * *' --active --name my-policy-plan --attach-tags my-daily-backup-plan --copy-tags true --delete-after 10 --delete-over-count 2 --clone-policy-max-snapshots 1 --clone-policy-zones us-south-1,us-south-2
  • ibmcloud is backup-policy-plan-create backup-policy-1001 --cron-spec '0 0 * * *' --active --name my-policy-plan --attach-tags my-daily-backup-plan --copy-tags true --delete-after 10 --delete-over-count 2
  • ibmcloud is backup-policy-plan-create c9a0e8d9-c592-4175-80cb-3056f6fd1da7 --cron-spec '*/5 1,2,3 * * *' --name my-policy-plan-2 --remote-region-policies '[{"delete_over_count": 5,"region": {"name": "us-east"}},{"delete_over_count": 5,"region": {"name": "us-south"}}]'
  • ibmcloud is backup-policy-plan-create c9a0e8d9-c592-4175-80cb-3056f6fd1da7 --cron-spec '*/5 1,2,3 * * *' --name my-policy-plan-2 --remote-region-policies @/tmp/remote_region_policies.json

命令选项

  • 策略：备份策略的 ID 或名称。
  • --name：备份策略计划的名称。
  • --active：表示该计划是否处于激活状态。
  • --attach-tags：要附加到该计划所创建的每个资源上的用户标签。
  • --copy-tags：指定是否将源用户的标签复制到创建的资源中。 以下选项之一：true、false。
  • --cron-spec：备份计划的cron规范。
  • --delete-after：备份创建后保留的最大天数。
  • --delete-over-count：要保留的最近备份的最大数量。 如果未指定，那么将保留所有备份。
  • --clone-policy-max-snapshots：克隆所保留的最近快照的最大数量（按源计算）。（默认值：5 ）。
  • --clone-policy-zones：此备份策略计划用于创建快照克隆的区域。
  • --remote-region-policies：REMOTE_REGION_POLICY_JSON|@REMOTE_REGION_POLICY_JSON，以 JSON 或 JSON 文件形式指定的远程区域策略。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 backup-policy-plan-delete

删除一个或多个备份策略计划。

ibmcloud is backup-policy-plan-delete POLICY (PLAN1 PLAN2 ...) [--output JSON] [-f, --force] [-q, --quiet]

命令示例

  • ibmcloud is backup-policy-plan-delete backup-policy-1001 437cc10e-eaa5-4eaf-8e9d-5ba5d659f9a1 ec5446a2-5f28-4d25-a501-b6fa14f3c5d8
  • ibmcloud is backup-policy-plan-delete aaa-default-backup-policy-1 my-policy-plan-2 my-policy-plan-3 my-policy-plan-4

命令选项

  • 策略：备份策略的 ID 或名称。
  • PLAN1：备份策略计划的 ID 或名称。
  • PLAN2：备份策略计划的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • --force，-f：强制执行操作，无需确认。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 backup-policy-plan-update

更新备份策略计划。

ibmcloud is backup-policy-plan-update POLICY PLAN [--name NAME] [--active] [--attach-tags ATTACH_TAGS] [--copy-tags true | false] [--cron-spec CRON_SPEC] [[--delete-after DELETE_AFTER] [--delete-over-count DELETE_OVER_COUNT]] [--reset-delete-over-count] [[--clone-policy-zones  ZONE1,ZONE2,...] [--clone-policy-max-snapshots CLONE_POLICY_MAX_SNAPSHOTS]] [--remote-region-policies REMOTE_REGION_POLICY_JSON | @REMOTE_REGION_POLICY_JSON] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is backup-policy-plan-update r134-77e21079-7291-44c2-866a-8f1848bc10f0 r134-fc8e15d9-02f2-4599-a216-8afe0dfeb969 --name myplan
  • ibmcloud is backup-policy-plan-update demo-bkp-policy-b98 my-policy-plan-1 --name cli-demo-policy-plan-3
  • ibmcloud is backup-policy-plan-update backup-policy-1001 2dae356e-f7b5-48dd-8bc3-f3083574885b --cron-spec '42 10 * * *' --name my-policy-plan-1 --attach-tags my-daily-backup-plan --copy-tags false --delete-after 20 --delete-over-count 1 --clone-policy-max-snapshots 3 --clone-policy-zones us-south-1,us-south-2 --active
  • ibmcloud is backup-policy-plan-update backup-policy-1001 2dae356e-f7b5-48dd-8bc3-f3083574885b --cron-spec '42 10 * * *' --name my-policy-plan-1 --attach-tags my-daily-backup-plan --copy-tags false --delete-after 20 --delete-over-count 1
  • ibmcloud is backup-policy-plan-update demo-bkp-policy-x demo-bkp-plan-2 --reset-delete-over-count
  • ibmcloud is backup-policy-plan-update demo-bkp-policy-x demo-bkp-plan-2 --reset-delete-over-count --remote-region-policies '[{"delete_over_count": 5,"region": {"name": "us-east"}},{"delete_over_count": 5,"region": {"name": "us-south"}}]'

命令选项

  • 策略：备份策略的 ID 或名称。
  • PLAN：备份策略计划的 ID 或名称。
  • --name：备份策略计划的新名称。
  • --active：表示该计划是否处于激活状态。
  • --attach-tags：要附加到该计划所创建的每个资源上的用户标签。
  • --copy-tags：指定是否将源用户的标签复制到创建的资源中。 以下选项之一：true、false。
  • --cron-spec：备份计划的cron规范。
  • --delete-after：备份创建后保留的最大天数。
  • --delete-over-count：要保留的最近备份的最大数量。 如果未指定，那么将保留所有备份。
  • --reset-delete-over-count：清除任何现有的“保留最近备份的最大数量”设置。
  • --clone-policy-max-snapshots：克隆所保留的最近快照的最大数量（按源计算）。
  • --clone-policy-zones：此备份策略计划用于创建快照克隆的区域。
  • --remote-region-policies：REMOTE_REGION_POLICY_JSON|@REMOTE_REGION_POLICY_JSON，以 JSON 或 JSON 文件形式指定的远程区域策略。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 backup-policy-jobs

列出该备份策略下的所有作业。

ibmcloud is backup-policy-jobs POLICY [--source SOURCE] [--snapshots SNAPSHOT] [--status failed | running | succeeded] [--plan PLAN] [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is backup-policy-jobs backup-policy-1001
  • ibmcloud is backup-policy-jobs r134-7759199b-bc1f-448e-84fa-2aa42bde29af
  • ibmcloud is backup-policy-jobs r134-0703cdf1-48bb-4af2-9ceb-1edbe8fcb818 --source r134-1a1e25f2-3fc3-4507-8725-e5f1d07256ea --snapshots r143-1a1e25f2-3fc3-4507-8725-e5f1d08956ea --status running --plan r136-3a3e25f2-3fc3-4507-8725-e5f1d08496ea
  • ibmcloud is backup-policy-jobs bkp-policy-do-not-delete --snapshots r134-f1d9b974-14e5-4a2e-8e38-c023164be316
  • ibmcloud is backup-policy-jobs bkp-policy-do-not-delete --snapshots bkp-plan-do-not-delete-31addff28e2b-422b
  • ibmcloud is backup-policy-jobs bkp-policy-do-not-delete --snapshots crn:v1:staging:public:is:us-south:a/efe5afc483594adaa8325e2b4d1290df::snapshot:r134-c4ea5585-0554-40db-bdc8-1ec9fb15098b
  • ibmcloud is backup-policy-jobs bkp-policy-do-not-delete --source r134-71757aee-5e90-40f5-bd7d-0a538c084efb

命令选项

  • 策略：备份策略的 ID 或名称。
  • --source：源卷的 ID 或名称。 仅当源存在于 VPC 中时，才能使用源名称。
  • --snapshots：目标快照的 ID、名称或 CRN。 不支持这三种类型的组合。 这三种类型中只有一种支持传递。
  • --status：备份策略任务的状态。 其中一个 失败，正在运行，已成功。
  • --plan：备份策略计划的 ID 或名称。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。

ibmcloud 是 backup-policy-job

查看备份策略任务的详细信息。

ibmcloud is backup-policy-job POLICY JOB_ID [--output JSON] [-q, --quiet]

命令示例

  • ibmcloud is backup-policy-job r134-7759199b-bc1f-448e-84fa-2aa42bde29af 4cf9171a-0043-4434-8727-15b53dbc374c
  • ibmcloud is backup-policy-job backup-policy-1001 4cf9171a-0043-4434-8727-15b53dbc374c

命令选项

  • 策略：备份策略的 ID 或名称。
  • JOB_ID：备份策略任务的 ID。
  • --output：指定输出格式，仅支持 JSON。 JSON 之一。
  • -q, --quiet: 禁止冗长输出。