VPC CLI 參考資料

請將以下資訊作為可用於虛擬私有雲 IBM Cloud® Virtual Private Cloud (VPC) 的命令列介面 (CLI) 指令參考依據。

本 CLI 參考手冊分為以下各節:

必要條件

  1. 安裝 IBM Cloud命令列介面

  2. 安裝或更新 VPC 基礎架構服務外掛程式。

    ibmcloud plugin install vpc-infrastructure
    

    若要更新,請使用以下指令:

    ibmcloud plugin update
    

    如果要檢視已安裝的外掛程式和版本,請使用下列指令:

    ibmcloud plugin list
    

網路指令

下節提供網路服務之 CLI 指令的相關資訊。

浮動 IP

ibmcloud 是浮動 IP

檢視浮動 IP 的詳細資訊。

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

指令選項

  • FLOATING_IP:浮動 IP 的識別碼。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 floating-ip-release

釋放浮動 IP。

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

指令選項

  • FLOATING_IP1:浮動 IP 的識別碼。
  • FLOATING_IP2:浮動 IP 的識別碼。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是浮動 IP 儲備

保留浮動 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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 floating-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 的識別碼。
  • --name:浮動 IP 的新名稱。
  • --nic:要綁定的網路介面的 ID 或名稱。
  • --in:要綁定的實例的 ID 或名稱;僅當您使用網路介面名稱而非 ID 時,才需要此 ID。
  • --bm:要綁定的裸機伺服器的 ID 或名稱;僅當您使用網路介面名稱而非 ID 時,才需要此 ID。
  • --vni:虛擬網路介面的 ID 或名稱。
  • --重設目標:從浮動 IP 重設目標。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 floating-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。 此識別碼與 --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:流量日誌的目標類型。 只有在目標作為資源名稱傳遞時,才需要此選項。 下列其中一項: vpcsubnetinstancenicvninac
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --in:實例的 ID 或名稱。 只需要在此「實例」中以名稱指定唯一的資源。
  • --name:流程日誌的新名稱。
  • --active:表示此收集器是否處於活躍狀態。 以下選項之一:TRUEFALSE
  • --resource-group-id:資源群組的 ID。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 flow-log-delete

刪除一個以上流程日誌。

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 則會啟動收集器。 以下選項之一:TRUEFALSE
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 flow-log

檢視流程日誌的詳細資訊。

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

指令選項

  • FLOW_LOG:流量日誌的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 flow-logs

列出該區域內的所有流量日誌。

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。 此識別碼與 --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 是負載平衡器-建立

建立負載平衡器。

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"}}]}]' 建立一個「專用路徑」網路負載平衡器,並將應用程式負載平衡器 ID 設為儲存區成員目標。
  • 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 ID 設定為儲存區成員目標。
  • 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:負載平衡器的存取類型。 只有網路系列中的負載平衡器支援專用路徑存取類型。 其中之一:publicprivateprivate-path
  • --subnet:要為此負載平衡器進行配置的子網的 ID 或名稱。 此選項可以多次指定,以將負載平衡器佈建到多個子網路。 只能給網路負載平衡器指定一個子網路。
  • --vpc:VPC 的 ID 或名稱。 只有在此 VPC 內依名稱指定唯一子網路時,才需要此 ID 或名稱。
  • --family:負載平衡器的家族類型。 下列其中一項: 應用程式網路
  • --route-mode:啟用或停用負載平衡器的路由模式。 如果未指定,則會停用路由模式。 目前,只能對專用網路負載平衡器啟用路由模式。 下列其中一項: falsetrue
  • --sg:以逗號分隔的負載平衡器安全群組 ID 或名稱。 若未指定,則會使用 VPC 的預設安全群組。
  • --logging-datapath-active:啟用或停用此負載平衡器的資料路徑記錄功能。 如果沒有指定,則會停用資料路徑記載功能。 資料路徑記載僅適用於應用程式負載平衡器。 下列其中一項: falsetrue
  • --dns-instance-crn:與該 DNS 區域相關聯的 DNS 實例之 CRN。
  • --dns-zone-id:DNS 區域的 ID。
  • --resource-group-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 是負載平衡器監聽器

檢視負載平衡器監聽器的詳細資訊。

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

指令選項

  • LOAD_BALANCER:負載平衡器的 ID 或名稱。
  • LISTENER_ID:監聽器的識別碼。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 為負載平衡器監聽器建立

建立一個負載平衡器監聽器。

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"}}]' _條件_的可能值為「包含」、「等於」或「符合正規表達式」。 _type_的可能值為「header」、「hostname」或「path」。_field_是HTTP標頭字段,僅適用於「header」規則類型。 「」參數是用來與規則條件進行比對的值。
  • 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:監聽器協定。 該應用程式系列中的負載平衡器支援 tcphttp 以及 https。 網路系列中的負載平衡器支援 tcpudp
  • --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 時,此為必填項目。 此選項不適用於位於網路家族中的負載平衡器。
  • --policiesLISTENER_POLICIES_JSON | @LISTENER_POLICIES_JSON_F ILE,以 JSON 或 JSON 檔案格式儲存的監聽器政策。 此選項不適用於位於網路家族中的負載平衡器。
  • --accept-proxy-protocol:若設定為 true,則會為此監聽器啟用代理協定。 僅支援應用程式負載平衡器。 下列其中一項: falsetrue
  • --http-redirect-listener-id:設定為 HTTP 重定向目標的監聽器 ID。
  • --http-redirect-status-code:重定向回應中回傳的 HTTP 狀態碼。 下列其中一項: 301302303307308
  • --http-redirect-target-uri:流量將被重定向至的目標 URI。 此設定是選用的,如果您設定,則必須以 "/" 開頭。
  • --idle-connection-timeout:監聽器的閒置連線超時時間(以秒為單位)。 僅應用程式系列中的負載平衡器支援此選項。 下限: 50,上限: 7200。(預設值: 50)。
  • --client-auth-ca-crn:此監聽器的客戶端驗證設定。 此選項不適用於位於網路家族中的負載平衡器。
  • --client-auth-crl: CRL | @CRL_FILE,用於驗證客戶端憑證撤銷的憑證撤銷清單。 接聽端必須具備 HTTPS 通訊協定。 證書撤銷清單的內容,若是以 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:監聽器的識別碼。
  • LISTENER_ID2:監聽器的識別碼。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是負載平衡器監聽器策略

列出所有負載平衡器政策。

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

指令選項

  • LOAD_BALANCER:負載平衡器的 ID 或名稱。
  • LISTENER_ID:監聽器的識別碼。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是負載平衡器監聽器策略

檢視負載平衡器監聽器政策的詳細資訊。

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

指令選項

  • LOAD_BALANCER:負載平衡器的 ID 或名稱。
  • LISTENER_ID:監聽器的識別碼。
  • 保單:保單編號或名稱。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 載入平衡器監聽器策略建立

建立一個負載平衡器監聽器政策。

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" 時,需要儲存區 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 70294e14-4e61-11e8-bcf4-0242ac110004 當動作為 "forward_to_pool" 時,需要儲存區 ID 或名稱來指定負載平衡器將資料流量轉送到哪個儲存區。
  • 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"}]' _條件_的可能值為「包含」、「等於」或「符合正規表達式」。 _type_的可能值為「header」、「hostname」或「path」。_field_是HTTP標頭字段,僅適用於「header」規則類型。 「」參數是用來與規則條件進行比對的值。
  • 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:監聽器的識別碼。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --priority:該政策的優先級。 數值越小,優先級越高,例如:5,範圍:[1-10]。
  • --action:政策動作。 以下之一:forward_to_poolforward_to_listenerredirectrejectionhttps_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 動作進行指定。 下列其中一項: 301302303307308
  • --target-uri:流量將被重定向至的目標 URI,需透過 https_redirect 動作進行指定。 此設定是選用的,如果您設定,則必須以 "/" 開頭。
  • --target-http-status-code:重定向回應中的 HTTP 狀態碼,需配合重定向動作一併指定。 下列其中一項: 301302303307308
  • --target-url:重定向目標 URL,需配合重定向動作一併指定。 URL 支援變數協定、主機、連接埠、路徑和查詢的 RFC 6570 1 層次表達式。 這會展開為原始請求中指定的 URL 所對應的值(若請求中未包含這些值,則採用指定的預設值)。
  • --rulesLISTENER_POLICY_RULES_JSON | @LISTENER_POLICY_RULES_JSON_F ILE,以 JSON 或 JSON 檔案格式儲存的監聽器政策規則。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 載入平衡器監聽器策略刪除

從負載平衡器接聽器中刪除一個以上原則。

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:監聽器的識別碼。
  • 政策 1:政策的 ID 或名稱。
  • POLICY2:政策編號或名稱。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是負載平衡器監聽器策略規則

列出單一負載平衡器政策規則。

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:監聽器的識別碼。
  • 保單:保單編號或名稱。
  • RULE_ID:規則的識別碼。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 載入平衡器監聽器策略規則建立

建立一個負載平衡器監聽器政策規則。

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:監聽器的識別碼。
  • 保單:保單編號或名稱。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --條件:該規則的條件。 以下任一條件:包含等於符合正規表達式以...開頭
  • --type:規則的類型。 其中之一:標頭主機名路徑查詢正文sni_hostname
  • --value:用於匹配規則條件的值。
  • --field:HTTP 欄位。 此欄位適用於「標頭」、「查詢」及「正文」這三種規則類型。 對於規則類型「標頭」,此欄位為必填欄位。 對於「查詢」或「主體」類型的規則,此欄位為選填。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 負載平衡器監聽器策略規則刪除

從負載平衡器接聽器中刪除一個以上原則。

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:監聽器的識別碼。
  • 保單:保單編號或名稱。
  • RULE_ID1:規則的識別碼。
  • RULE_ID2:規則的識別碼。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 負載平衡器監聽器策略規則更新

更新負載平衡器聆聽器政策中的規則。

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:監聽器的識別碼。
  • 保單:保單編號或名稱。
  • RULE_ID:規則的識別碼。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --條件:該規則的條件。 以下任一條件:包含等於符合正規表達式以...開頭
  • --type:規則的類型。 其中之一:標頭主機名路徑查詢正文sni_hostname
  • --value:用於匹配規則條件的值。
  • --field:HTTP 欄位。 此欄位適用於「標頭」、「查詢」及「正文」這三種規則類型。 對於規則類型「標頭」,此欄位為必填欄位。 對於「查詢」或「主體」類型的規則,此欄位為選填。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 負載平衡器 監聽器 策略 規則

列出所有負載平衡器政策規則。

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

指令選項

  • LOAD_BALANCER:負載平衡器的 ID 或名稱。
  • LISTENER_ID:監聽器的識別碼。
  • 保單:保單編號或名稱。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 負載平衡器監聽器策略更新

更新負載平衡器監聽器的政策。

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:監聽器的識別碼。
  • 保單:保單編號或名稱。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --name:此政策的使用者自訂名稱。 原則名稱在負載平衡器接聽器中必須是唯一的。
  • --priority:該政策的優先級。 數值越小,優先級越高,例如:5,範圍:[1-10]。
  • --target:透過 forward_to_pool 指定之目標負載平衡器彙集的 ID 或名稱,或透過 forward_to_listener 動作指定之負載平衡器聆聽器 ID。
  • --target-http-status-code:重定向回應中的 HTTP 狀態碼,需配合重定向動作一併指定。 下列其中一項: 301302303307308
  • --target-url:重定向目標 URL,需配合重定向動作一併指定。 URL 支援變數協定、主機、連接埠、路徑和查詢的 RFC 6570 1 層次表達式。 這會展開為原始請求中指定的 URL 所對應的值(若請求中未包含這些值,則採用指定的預設值)。
  • --target-listener-id:您要對其實施 https 重定向的聆聽器 ID,需透過 https_redirect 動作指定。
  • --target-listener-http-status-code:在重定向回應中回傳的 HTTP 狀態碼,需透過 https_redirect 動作進行指定。 下列其中一項: 301302303307308
  • --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:監聽器的識別碼。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --protocol:監聽器協定。 該應用程式系列中的負載平衡器支援 tcphttp 以及 https。 網路系列中的負載平衡器支援 tcpudp
  • --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,則會為此監聽器啟用代理協定。 僅支援應用程式負載平衡器。 下列其中一項: falsetrue
  • --disable-http-redirect:啟用或停用聆聽器上的 HTTP 重定向。
  • --http-redirect-listener-id:設定為 HTTP 重定向目標的監聽器 ID。
  • --http-redirect-status-code:重定向回應中回傳的 HTTP 狀態碼。 下列其中一項: 301302303307308
  • --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 通訊協定。 證書撤銷清單的內容,若是以 PEM 格式編碼,或其檔案路徑中包含該CRL,則符合此條件。 此選項不適用於位於網路家族中的負載平衡器。 以下其中之一:CRL@CRL_FILE
  • --reset-client-auth-crl:從客戶端驗證中移除憑證撤銷清單。
  • --reset-client-auth:從監聽器中移除客戶端驗證設定。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是負載平衡器監聽器

列出所有負載平衡器的監聽器。

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:彙總集的識別碼或名稱。
  • --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"}}]' 建立一個「專用路徑」網路負載平衡器,並將應用程式負載平衡器 ID 設為儲存區成員目標。
  • 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 ID 設定為儲存區成員目標。
  • 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_robinweighted_round_robinleast_connections
  • 通訊協定:泳池通訊協定。 該應用程式系列中的負載平衡器支援 tcphttp 以及 https。 網路系列中的負載平衡器支援 tcpudp
  • HEALTH_DELAY:健康檢查的間隔時間(以秒為單位)。 時間間隔必須大於逾時值。 最小值:2,最大值:60
  • HEALTH_RETRIES:健康檢查的最大重試次數。 最小值:1,最大值:10
  • HEALTH_TIMEOUT:健康檢查的超時時間(以秒為單位)。 最小值:1,最大值:59
  • HEALTH_TYPE:健康檢查協定。 該應用程式系列中的負載平衡器支援 tcphttp 以及 https。 網路系列中的負載平衡器支援 tcphttp
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --health-monitor-url:健康檢查的 URL 路徑。 僅當 HEALTH_TYPE 為 http 或 https 時才適用。
  • --health-monitor-port:狀態檢查的連接埠號碼。 如果指定的話,則將置換伺服器成員資源中的指定埠。
  • --session-persistence-type:會話持久化類型。 下列其中一項: source_iphttp_cookieapp_cookie
  • --session-persistence-cookie-name:會話持久化 Cookie 的名稱。 此選項僅適用於 app_cookie 類型。
  • --proxy-protocol:此彙總的代理協定設定。 Proxy 通訊協定僅支援應用程式負載平衡器。 以下其中一項:身心障礙者v1v2.
  • --members:MEMBERS_JSON|@MEMBERS_JSON_FILE,以 JSON 或 JSON 檔案格式提供的成員清單。
  • --health-monitor-request-method:用於健康檢查的 HTTP 請求方法。 以下其中之一:getpost。 僅當 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,則會驗證後端伺服器的憑證。 以下其中之一:truefalse
  • --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:彙集的識別碼或名稱。
  • POOL2:彙池的識別碼或名稱。
  • --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:彙總集的識別碼或名稱。
  • MEMBER_ID:會員的識別碼。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 為負載平衡器群組成員建立

建立負載平衡器彙集的成員。

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:彙總集的識別碼或名稱。
  • 端口:成員用以接收負載平衡器流量的端口。 僅適用於在具有單一埠的接聽器上接收到的負載平衡器資料流量。 如果在具有埠範圍的接聽器上接收資料流量,則成員會在接聽器接收資料流量所在的相同埠上接收資料流量。 除非在 health_monitor 屬性中指定了 port 屬性,否則此埠也可用於狀態檢查。
  • 目標:屬於應用程式家族的負載平衡器之池成員的 IP 位址或完全限定網域名稱 (FQDN);或是屬於網路家族的負載平衡器之 ALB 的 ID 或名稱,或是該負載平衡器的實例。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --weight:伺服器成員的權重。 此選項僅適用於其負載平衡池的負載平衡演算法為 weighted_round_robin 的情況。
  • --target-type:此資源池成員的目標類型。 以下之一:instanceload_balancerreserved_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:彙總集的識別碼或名稱。
  • MEMBER_ID:會員的識別碼。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --target-address:池成員的 IP 位址。
  • --target-fqdn:要鎖定的完全合格網域名稱(FQDN)。 負載平衡器必須將 fqdn_pool_members_supported 設為 true。
  • --target:對於位於應用程式家族中的負載平衡器,此參數為池成員的 IP 位址或完全合格網域名稱(FQDN);對於位於網路家族中的負載平衡器,此參數則為 ALB 的 ID 或名稱,或是該負載平衡器的實例。
  • --port:成員用於接收負載平衡器流量的埠號。 僅適用於在具有單一埠的接聽器上接收到的負載平衡器資料流量。 如果在具有埠範圍的接聽器上接收資料流量,則成員會在接聽器接收資料流量所在的相同埠上接收資料流量。 除非在 health_monitor 屬性中指定了 port 屬性,否則此埠也可用於狀態檢查。
  • --weight:伺服器成員的權重。 此選項僅適用於其負載平衡池的負載平衡演算法為 weighted_round_robin 的情況。
  • --target-type:此資源池成員的目標類型。 以下之一:instanceload_balancerreserved_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:彙總集的識別碼或名稱。
  • MEMBER_ID1:會員的識別碼。
  • MEMBER_ID2:會員的識別碼。
  • --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:彙總集的識別碼或名稱。
  • --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:彙總集的識別碼或名稱。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --algorithm:負載平衡演算法。 下列其中一項: round_robinweighted_round_robinleast_connections
  • --health-delay:健康檢查的間隔時間(以秒為單位)。 時間間隔必須大於逾時值。 最小值:2,最大值:60
  • --health-max-retries:健康檢查的最大重試次數。 最小值:1,最大值:10
  • --health-timeout:健康檢查的超時時間(以秒為單位)。 最小值:1,最大值:59
  • --health-type:健康檢查協定。 該應用程式系列中的負載平衡器支援 tcphttp 以及 https。 網路系列中的負載平衡器支援 tcphttp
  • --health-monitor-url:健康檢查的 URL 路徑。 僅當 HEALTH_TYPE 為 http 或 https 時才適用。
  • --health-monitor-port:狀態檢查的連接埠號碼。 如果指定的話,則將置換伺服器成員資源中的指定埠。
  • --reset-health-monitor-port:重設健康監控埠。
  • --protocol:池協議。 該應用程式系列中的負載平衡器支援 tcphttp 以及 https。 網路系列中的負載平衡器支援 tcpudp
  • --session-persistence-type:會話持久化類型。 下列其中一項: source_iphttp_cookieapp_cookienone
  • --session-persistence-cookie-name:會話持久化 Cookie 的名稱。 此選項僅適用於 app_cookie 類型。
  • --proxy-protocol:此彙總的代理協定設定。 Proxy 通訊協定僅支援應用程式負載平衡器。 以下其中一項:身心障礙者v1v2.
  • --name:池的新名稱。
  • --failsafe-policy-action:此叢集應使用的故障安全政策。 若未指定,則會採用設定檔中的預設故障安全政策動作。 以下之一:失敗轉送丟棄旁路
  • --failsafe-policy-target:要轉發至的故障安全目標彙集的 ID 或名稱。 若已指定,則故障安全政策動作必須為「轉發」。
  • --health-monitor-request-method:用於健康檢查的 HTTP 請求方法。 以下其中之一:getpost。 僅當 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,則會驗證後端伺服器的憑證。 以下其中之一:truefalse
  • --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 是負載平衡器統計資料

列出負載平衡器的所有統計資料。

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:啟用或停用此負載平衡器的資料路徑記錄功能。 資料路徑記載僅適用於應用程式負載平衡器。 下列其中一項: falsetrue
  • --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。 此識別碼與 --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。 此識別碼與 --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) 的識別碼或名稱。
  • --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:網路存取控制清單的名稱。
  • 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。 此識別碼與 --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) 的識別碼或名稱。
  • --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) 的識別碼或名稱。
  • --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) 的識別碼或名稱。
  • 規則:規則的識別碼或名稱。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 network-acl-rule-add

在網路存取控制清單中新增一則規則。

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) 的識別碼或名稱。
  • ACTION: allowdeny 其中之一。
  • 行車方向:應執行的行車方向。 下列其中一項: inboundoutbound
  • 通訊協定:網路通訊協定的名稱。 以下任一項:anyicmp_tcp_udpicmptcpudpahgreip_in_ipl2tp, rsvp, sctp, vrrp。 若要使用其他通訊協定,請使用 number_ ,其中 的取值範圍為 0 至 255(例如:number_99 )。 常見的通訊協定使用標準名稱(例如,通訊協定 6 稱為 tcp);其「number_ 」這種形式是無效的。 不支援 IPv6 專用的通訊協定: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 流量類型。 有效值範圍為 0254。 此選項僅在協議設定為 icmp 時才會被指定。 如果未指定,容許所有類型。
  • --icmp-code:要允許的 ICMP 流量代碼。 有效值範圍為 0255。 此選項僅在協議設定為 icmp 時才會被指定。 如果未指定,容許所有程式碼。
  • --source-port-min:最小來源連接埠號碼。 有效值範圍為 165535。 此選項僅在協議設定為 tcpudp 時才會指定(預設值:1 )。
  • --source-port-max:來源連接埠號的最大值。 有效值範圍為 165535。 此選項僅在協議設定為 tcpudp 時才會指定(預設值:65535 )。
  • --destination-port-min:最低目的港號碼。 有效值範圍為 165535。 此選項僅在協議設定為 tcpudp 時才會指定(預設值:1 )。
  • --destination-port-max:最大目的端口號。 有效值範圍為 165535。 此選項僅在協議設定為 tcpudp 時才會指定(預設值: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) 的識別碼或名稱。
  • 規則:規則的識別碼或名稱。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --name:規則的新名稱。
  • --direction:應執行的交通行駛方向。 下列其中一項: inboundoutbound
  • -- action: allowdeny 其中之一。
  • --before-rule:此規則將插入於其前方的規則之 ID 或名稱。
  • --reset-before-rule:在規則執行前重置。 指定此選項,以將此規則移至所有現有規則之後。
  • --source:來源 IP 位址或 CIDR 區塊。
  • --dest:目的地 IP 位址或 CIDR 區塊。
  • --icmp-type:要允許的 ICMP 流量類型。 有效值範圍為 0254。 此選項僅在協議設定為 icmp 時才會被指定。 如果未指定,容許所有類型。
  • --icmp-code:要允許的 ICMP 流量代碼。 有效值範圍為 0255。 此選項僅在協議設定為 icmp 時才會被指定。 如果未指定,容許所有程式碼。
  • --source-port-min:最小來源連接埠號碼。 有效值範圍為 165535。 此選項僅在協議設定為 tcpudp 時才會指定(預設值:1 )。
  • --source-port-max:來源連接埠號的最大值。 有效值範圍為 165535。 此選項僅在協議設定為 tcpudp 時才會指定(預設值:65535 )。
  • --destination-port-min:最低目的港號碼。 有效值範圍為 165535。 此選項僅在協議設定為 tcpudp 時才會指定(預設值:1 )。
  • --destination-port-max:最大目的端口號。 有效值範圍為 165535。 此選項僅在協議設定為 tcpudp 時才會指定(預設值: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) 的識別碼或名稱。
  • 規則 1:規則的識別碼或名稱。
  • 規則 2:規則的識別碼或名稱。
  • --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]

指令選項

  • 閘道:公共閘道的識別碼或名稱。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 public-gateway-create

建立公用閘道。

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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 public-gateway-delete

刪除一個以上公用閘道。

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

指令選項

  • GATEWAY1:公共閘道的識別碼或名稱。
  • GATEWAY2:公共閘道的識別碼或名稱。
  • --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

指令選項

  • 閘道:公共閘道的識別碼或名稱。
  • --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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --all-resource-groups:查詢所有資源群組。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

路由表和路由

下一節提供可用於使用 VPC 路由表和路由的 CLI 指令的詳細資料。

ibmcloud 是 vpc-default-routing-table

檢視 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 屬性且該屬性值與指定值相符的路由表。 以下其中之一:truefalse
  • --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 是 vpc-routing-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」的路由表。 下列其中一項: falsetrue
  • --internet-ingress, --internet:指示此路由表是否用於路由源自網際網路的流量。 更新為 "true" 會選取此路由表,但前提是 VPC 中沒有其他路由表已將此內容設為 "true"。 更新為 "false" 會取消選取此路由表。 下列其中一項: falsetrue
  • --transit-gateway-ingress, --transit-gateway:若設定為「true」,則此路由表將用於將源自 Transit Gateway 的流量路由至此 VPC。 若要使路由設定成功,該 VPC 不得已存在一個將此屬性設定為「true」的路由表。 下列其中一項: falsetrue
  • --vpc-zone-ingress,--vpc-zone: 若設定為「true」,則此路由表將用於路由源自此 VPC 中其他區域子網的流量。 若要使路由設定成功,該 VPC 不得已存在一個將此屬性設定為「true」的路由表。 下列其中一項: falsetrue
  • --accept-routes-from-resource-type-filters、--ar-rtf:可在此路由表中建立路由的、以逗號分隔的資源類型篩選器。 下列其中一項: vpn_servervpn_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」的路由表。 下列其中一項: falsetrue
  • --internet-ingress, --internet:指示此路由表是否用於路由源自網際網路的流量。 更新為 "true" 會選取此路由表,但前提是 VPC 中沒有其他路由表已將此內容設為 "true"。 更新為 "false" 會取消選取此路由表。 下列其中一項: falsetrue
  • --transit-gateway-ingress, --transit-gateway:若設定為「true」,則此路由表將用於將源自 Transit Gateway 的流量路由至此 VPC。 若要使路由設定成功,該 VPC 不得已存在一個將此屬性設定為「true」的路由表。 下列其中一項: falsetrue
  • --vpc-zone-ingress,--vpc-zone: 若設定為「true」,則此路由表將用於路由源自此 VPC 中其他區域子網的流量。 若要使路由設定成功,該 VPC 不得已存在一個將此屬性設定為「true」的路由表。 下列其中一項: falsetrue
  • --accept-routes-from-resource-type-filters、--ar-rtf:可在此路由表中建立路由的、以逗號分隔的資源類型篩選器。 移除現有的資源過濾器時,所有從與資源過濾器相符的資源得知的路由都將予以移除。 下列其中一項: vpn_servervpn_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 為 vpc-routing-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-routing-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 是 vpc-routing-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_vpcdelegatedeliverdrop
  • --destination:該路由的目的地 CIDR。 在表格中,每個區域至多有兩條路由可具有相同的目的地,且僅當這兩條路由的動作皆為「交付」時才成立。
  • --priority:該路徑的優先級。 值越小,優先順序越高。 值的範圍可以介於 0-4 之間。(預設值: 2)。
  • --next-hop:若動作為「傳送」,則為封包將被傳送至的下一個跳點之 IP 位址、VPN 連線 ID 或名稱。 對於其他動作值,則必須省略或指定為 0.0.0.0。
  • --vpngw:VPN 閘道的 ID 或名稱。 只有在以名稱格式將下一個躍點指定為 VPN 連線時,才需要此選項。
  • --advertise:指示此路由是否會向由路由表屬性 advertise_routes_to 所指定的入口來源進行路由廣播。 下列其中一項: falsetrue
  • --name:VPC 路由表的名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 VPC 路由表路由更新

更新 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 所指定的入口來源進行路由廣播。 下列其中一項: falsetrue
  • --next-hop:若動作為「傳送」,則為封包將被傳送至的下一個跳點之 IP 位址、VPN 連線 ID 或名稱。 對於其他動作值,則必須省略或指定為 0.0.0.0。
  • --vpngw:VPN 閘道的 ID 或名稱。 只有在以名稱格式將下一個躍點指定為 VPN 連線時,才需要此選項。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 vpc-routing-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-routing-table

檢視與該子網關聯的路由表詳細資訊。

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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 security-group-delete

刪除一個以上安全群組。

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 或名稱。
  • 行車方向:應執行的行車方向。 下列其中一項: inboundoutbound
  • 通訊協定:網路通訊協定的名稱。 以下任一項:anyicmp_tcp_udpicmptcpudpahgreip_in_ipl2tp, rsvp, sctp, vrrp。 若要使用其他通訊協定,請使用 number_ ,其中 的取值範圍為 0 至 255(例如:number_99 )。 常見的通訊協定使用標準名稱(例如,通訊協定 6 稱為 tcp);其「number_ 」這種形式是無效的。 不支援 IPv6 專用的通訊協定:number_0、number_43、number_44、number_58、number_59、number_60、number_135。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --local:此規則允許進站與出站流量使用的本地 IP 位址或本地 IP 位址範圍。 0.0.0.0/0 的 CIDR 區塊容許所有本端 IP 位址的入埠及出埠資料流量。
  • --remote:此規則允許流量來自的網路介面集合。 它可以指定為 REMOTE_ADDRESS、CIDR_BLOCK 或 SECURITY_GROUP。 若未特別指定,則允許來自任何來源的流量(或對於出站規則,則允許前往任何來源的流量)。
  • --icmp-type:要允許的 ICMP 流量類型。 有效值範圍為 0254。 此選項僅在協議設定為 icmp 時才會被指定。 如果未指定,容許所有類型。
  • --icmp-code:要允許的 ICMP 流量代碼。 有效值範圍為 0255。 此選項僅在協議設定為 icmp 時才會被指定。 如果未指定,容許所有程式碼。
  • --port-min:最小埠號。 有效值範圍為 165535。 此選項僅在協議設定為 tcpudp 時才會被指定。 若未指定,則允許所有埠(預設值:1 )。
  • --port-max:最大埠號。 有效值範圍為 165535。 此選項僅在協議設定為 tcpudp 時才會被指定。 若未指定,則允許所有埠(預設值: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:安全群組規則的識別碼。
  • RULE_ID2:安全群組規則的識別碼。
  • --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:應執行的交通行駛方向。 下列其中一項: inboundoutbound
  • --local:此規則允許進站與出站流量使用的本地 IP 位址或本地 IP 位址範圍。 0.0.0.0/0 的 CIDR 區塊容許所有本端 IP 位址的入埠及出埠資料流量。
  • --remote:此規則允許流量來自的網路介面集合。 它可以指定為 REMOTE_ADDRESS、CIDR_BLOCK 或 SECURITY_GROUP。 若未特別指定,則允許來自任何來源的流量(或對於出站規則,則允許前往任何來源的流量)。
  • --icmp-type:要允許的 ICMP 流量類型。 有效值範圍為 0254。 此選項僅在協議設定為 icmp 時才會被指定。 如果未指定,容許所有類型。
  • --reset-icmp-type:重設現有的 ICMP 流量類型值。
  • --icmp-code:要允許的 ICMP 流量代碼。 有效值範圍為 0255。 此選項僅在協議設定為 icmp 時才會被指定。 如果未指定,容許所有程式碼。
  • --reset-icmp-code:重設現有的 ICMP 流量代碼值。
  • --port-min:最小埠號。 有效值範圍為 165535。 此選項僅在協議設定為 tcpudp 時才會被指定。 若未指定,則允許所有埠(預設值:1 )。
  • --reset-port-min:重設最小埠號。
  • --port-max:最大埠號。 有效值範圍為 165535。 此選項僅在協議設定為 tcpudp 時才會被指定。 若未指定,則允許所有埠(預設值: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 是 security-group-update

更新安全群組。

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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --all-resource-groups:查詢所有資源群組。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是安全群組目標

檢視安全性群組目標的詳細資訊。

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_interfaceload_balancerendpoint_gatewayvpn_servervirtual_network_interface
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --trt:已綁定的目標資源類型;僅當您使用目標名稱而非 ID 時,此選項才為必填。 下列其中一項: load_balancerendpoint_gatewayvpn_servervirtual_network_interface
  • --in:要進行綁定的實例的 ID 或名稱。 只有在使用網路介面名稱而非 ID 時才需要。
  • --bm:要綁定的裸機伺服器的 ID 或名稱。 只有在使用網路介面名稱而非 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_interfaceload_balancerendpoint_gatewayvpn_servervirtual_network_interface
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --trt:已綁定的目標資源類型;僅當您使用目標名稱而非 ID 時,此選項才為必填。 下列其中一項: load_balancerendpoint_gatewayvpn_servervirtual_network_interface
  • --in:要進行綁定的實例的 ID 或名稱。 只有在使用網路介面名稱而非 ID 時才需要。
  • --bm:要綁定的裸機伺服器的 ID 或名稱。 只有在使用網路介面名稱而非 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_interfaceload_balancerendpoint_gatewayvpn_servervirtual_network_interface
  • TARGET2:安全群組所綁定的目標資源的 ID 或名稱。 如果您使用名稱格式,則只會提供相同資源類型下的資源。 而對於依名稱的網路介面,所有的網路介面名稱都必須在同一個實例之下。 下列類型是受支援的目標資源類型: network_interfaceload_balancerendpoint_gatewayvpn_servervirtual_network_interface
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --trt:已綁定的目標資源類型;僅當您使用目標名稱而非 ID 時,此選項才為必填。 下列其中一項: load_balancerendpoint_gatewayvpn_servervirtual_network_interface
  • --in:要進行綁定的實例的 ID 或名稱。 只有在使用網路介面名稱而非 ID 時才需要。
  • --bm:要綁定的裸機伺服器的 ID 或名稱。 只有在使用網路介面名稱而非 ID 時才需要。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是安全群組目標

列出安全群組的所有目標。

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 是 subnet-create

建立子網路。

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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 subnet-delete

刪除一個以上子網路。

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 是 subnet-update

更新子網路。

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。 此識別碼與 --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:受支援的目標資源類型。 其中之一:endpoint_gatewayvirtual_network_interface
  • --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 是 subnet-reserved-ip-create

在子網中預留一個 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_gatewayvirtual_network_interface。(預設值: endpoint_gateway)。
  • --auto-delete:指示當任一目標被刪除,或預留 IP 解除綁定時,此預留 IP 成員是否會自動刪除。 如果已取消連結保留 IP,則必須為 false。 下列其中一項: truefalse。(預設值: false)。
  • --target:目標資源的 ID 或名稱。 以下類型是受支援的目標資源類型:endpoint_gatewayvirtual_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。 以下其中之一:truefalse
  • --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 Cloud

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:以 CIDR 格式表示的位元組範圍( IPv4 )所涵蓋的位址前綴範圍。 該位址前綴不得與 VPC 中的任何現有位址前綴重疊,且必須位於 RFC 1918 位址範圍內。 地址前綴的 CIDR 前綴長度必須介於 /9 (8,388,608 個地址)與 /29 (8 個地址)之間。
  • --default:此標誌用以指示此是否為此 VPC 中該區域的預設前綴。 下列其中一項: falsetrue。(預設值: false)。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 vpc-address-prefix-delete

刪除一個以上位址字首。

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 中該區域的預設前綴。 下列其中一項: falsetrue
  • --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 是 vpc-create

建立 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 是否必須連接至您的標準基礎架構。 預設值為 false。
  • --address-prefix-management:此標誌用以指定是否會為此 VPC 中的每個區域自動建立預設位址前綴。 若為手動建立,此 VPC 將不包含任何預設位址前綴。 下列其中一項: automanual。(預設值: auto)。
  • --dns-enable-hub:指示此 VPC 是否已啟用為 DNS 名稱解析樞紐。 下列其中一項: falsetrue
  • --dns-resolver-type:要使用的 DNS 解析器類型。 下列其中一項: 手動系統
  • --dns-resolver-manual-servers:MANUAL_SERVERS|@MANUAL_SERVERS,以 JSON 或 JSON 檔案格式指定的手動伺服器。
  • --resource-group-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 是 vpc-delete

刪除一個以上 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 是 vpc-update

更新 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 名稱解析樞紐。 下列其中一項: falsetrue
  • --dns-resolver-type:要使用的 DNS 解析器類型。 下列其中一項: 手動系統delegated
  • --dns-resolver-manual-servers:MANUAL_SERVERS|@MANUAL_SERVERS,以 JSON 或 JSON 檔案格式指定的手動伺服器。
  • --delegate-to-vpc:要為此 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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --all-resource-groups:查詢所有資源群組。
  • --classic-access:[已廢棄]。建議改用 Transit Gateway 將您的 VPC 連接到經典基礎架構網路。 此旗標列出啟用標準存取的 VPC。 如果未指定,它會傳回啟用與未啟用標準存取的所有 VPC。 以下其中之一:truefalse
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 為 vpc-dns-resolution-binding-create

建立 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 解析度綁定

檢視 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-resolution-binding-delete

刪除一個以上 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 解析綁定

列出所有 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:抑制詳細輸出。

虛擬專用端點閘道

下一節提供可用於使用端點閘道的 CLI 指令的詳細資料。

ibmcloud 是端點-閘道-目標

列出所有可設定為端點閘道目標的資源,適用於所有區域。

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

指令選項

  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是端點-閘道

檢視端點閘道的詳細資訊。

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。 此識別碼與 --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 是 endpoint-gateway-create

建立端點閘道。

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"}}' 在僅使用所需子網路 ID 資料連結新保留 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 配置與子網路 ID、保留 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 ID 建立端點閘道。
  • 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_gatewayprovider_cloud_serviceprovider_infrastruction_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 解析綁定模式可選值:disabledprimaryper_resource_binding
  • --sg:端點閘道的以逗號分隔的安全群組 ID 或名稱。
  • --resource-group-id:資源群組的 ID。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 endpoint-gateway-update

更新端點閘道。

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 解析綁定模式可選值:disabledprimaryper_resource_binding
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 endpoint-gateway-reserved-ip-bind

將預留的 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 是 endpoint-gateway-reserved-ip-unbind

解除端點閘道上已預留的 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 是 endpoint-gateway-delete

刪除一個以上端點閘道。

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。 此識別碼與 --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 盜用功能。 下列其中一項: falsetrue
  • --auto-delete:指示當目標被刪除時,此虛擬網路介面是否會自動刪除。 如果未連結虛擬網路介面,則必須為 false。 下列其中一項: falsetrue
  • --enable-infrastructure-nat:若為 true:VPC 基礎架構將執行任何必要的 NAT 操作。 如果為 false:將未變更的封包傳遞至網路介面,以及從網路介面傳遞封包,容許工作量執行任何所需的 NAT 作業。 下列其中一項: falsetrue
  • --protocol-state-filtering-mode: auto,--psfm auto 此虛擬網路介面應使用的協定狀態過濾模式。 若設定為「自動」,則會根據虛擬網路介面的「target」資源類型,啟用或停用協定狀態封包過濾功能。 下列其中一項: autoenableddisabled。(預設值: 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 盜用功能。 下列其中一項: falsetrue
  • --auto-delete:指示當目標被刪除時,此虛擬網路介面是否會自動刪除。 如果未連結虛擬網路介面,則必須為 false。 下列其中一項: falsetrue
  • --enable-infrastructure-nat:若為 true:VPC 基礎架構將執行任何必要的 NAT 操作。 如果為 false:將未變更的封包傳遞至網路介面,以及從網路介面傳遞封包,容許工作量執行任何所需的 NAT 作業。 下列其中一項: falsetrue
  • --rip:要綁定至虛擬網路介面的預留 IP 位址或名稱。
  • --rip-address:要綁定至虛擬網路介面的預留 IP 位址。
  • --rip-auto-delete:指示當任一目標被刪除,或此保留 IP 解除綁定時,該保留 IP 是否會自動刪除。
  • --rip-name:此預留 IP 位址用於綁定至虛擬網路介面的名稱。
  • --protocol-state-filtering-mode: auto,--psfm auto 此虛擬網路介面應使用的協定狀態過濾模式。 若設定為「自動」,則會根據虛擬網路介面的「target」資源類型,啟用或停用協定狀態封包過濾功能。 下列其中一項: autoenableddisabled。(預設值: 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。 此識別碼與 --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-floating-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-floating-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-floating-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-floating-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。 此識別碼與 --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 使用 Private Path 服務閘道的 ID 檢視其詳細資料。
  • ibmcloud is private-path-service-gateway cli-ppsg-0 透過其名稱檢視「Private Path」服務閘道的詳細資訊。

指令選項

  • PRIVATE_PATH_SERVICE_GATEWAY:私有路徑服務閘道的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 private-path-service-gateway-create

建立一個「私人路徑」服務閘道。

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 透過指定負載平衡器 ID,並將預設存取原則配置為「拒絕」,建立「專用路徑」服務閘道。

指令選項

  • --default-access-policy:針對未設定明確帳戶政策的帳戶所建立的綁定,應使用的政策。 其中之一:拒絕允許審查。(預設值:拒絕)。
  • --load-balancer:此 Private Path 閘道的負載平衡器的 ID 或名稱。
  • --name:此「Private Path」服務閘道的名稱。
  • --service-endpoints:此 Private Path 服務閘道的完全合格網域名稱。 任何大寫字母都會轉換為小寫。
  • --zonal-affinity:指示此 Private Path 服務閘道是否具有區域親和性。 下列其中一項: falsetrue
  • --resource-group-id:資源群組的 ID。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是私有路徑服務閘道更新

更新專用路徑服務閘道。

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 根據 ID 更新「專用路徑」服務閘道,變更其名稱、存取原則、負載平衡器、區域親緣性,並將其發佈。
  • 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 根據 ID 更新「專用路徑」服務閘道,並變更其名稱、存取原則、負載平衡器及區域親緣性。
  • 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:此 Private Path 閘道的負載平衡器的 ID 或名稱。
  • --zonal-affinity:指示此 Private Path 服務閘道是否具有區域親和性。 下列其中一項: falsetrue
  • --name:Private Path 服務閘道的新名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是私有路徑服務閘道刪除

刪除一個或多個專用路徑服務閘道。

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 使用 ID 刪除多個 Private Path 服務閘道。
  • ibmcloud is private-path-service-gateway-delete cli-ppsg-0 cli-ppsg-1 使用名稱刪除多個 Private Path 服務閘道。

指令選項

  • 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 使用 Private Path 服務閘道的 ID,發佈 Private Path 服務閘道並使其可供任何帳戶要求存取。
  • ibmcloud is private-path-service-gateway-publish cli-ppsg-0 使用 Private Path 服務閘道的名稱,發佈 Private Path 服務閘道並使其可供任何帳戶要求存取。

指令選項

  • PRIVATE_PATH_SERVICE_GATEWAY:私有路徑服務閘道的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是私有路徑服務閘道取消發布

取消發佈專用路徑服務閘道。

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

指令範例

  • ibmcloud is ppsgunp r134-01cd30f7-e6f2-432f-9520-76247b1fbbe1 使用 Private Path 服務閘道的 ID,取消發佈 Private Path 服務閘道,以限制存取要求。
  • ibmcloud is private-path-service-gateway-unpublish cli-ppsg-0 使用 Private Path 服務閘道的名稱,取消發佈 Private Path 服務閘道,以限制存取要求。

指令選項

  • 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 使用 Private Path 服務閘道的名稱列出其所有帳戶原則。
  • ibmcloud is ppsg-aps r134-f5926633-81d0-429e-bcf8-91151ade00bf 使用 Private Path 服務閘道的 ID 列出其所有帳戶原則。

指令選項

  • PRIVATE_PATH_SERVICE_GATEWAY1:私有路徑服務閘道的 ID 或名稱。
  • PRIVATE_PATH_SERVICE_GATEWAY2:私有路徑服務閘道的 ID 或名稱。
  • --account-id:此存取政策所屬帳戶的 ID。
  • --resource-group-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 使用 Private Path 服務閘道的閘道名稱和原則 ID,檢視其帳戶原則的詳細資料。
  • ibmcloud is private-path-service-gateway-account-policy r134-f5926633-81d0-429e-bcf8-91151ade00bf e13b4574db1743b1b7897bebca551db1 使用 Private Path 服務閘道的閘道 ID 和原則 ID,檢視其帳戶原則的詳細資料。

指令選項

  • PRIVATE_PATH_SERVICE_GATEWAY:私有路徑服務閘道的 ID 或名稱。
  • ACCOUNT_POLICY:Private Path 服務閘道的帳戶政策識別碼。
  • --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 使用 Private Path 服務閘道的閘道 ID 與拒絕存取原則,為其建立帳戶原則。
  • ibmcloud is private-path-service-gateway-account-policy-create cli-ppsg-0 --account-id 2d1bace7b46e4815a81e52c6ffeba5cf --access-policy review 為 Private Path 服務閘道建立帳戶原則,並使用具有檢閱存取原則的閘道名稱。

指令選項

  • 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 使用 Private Path 服務閘道的閘道 ID 和原則 ID,更新其帳戶原則,並將存取原則變更為「允許」。
  • ibmcloud is ppsg-apu cli-ppsg-0 e13b4574db1743b1b7897bebca551db1 --access-policy review 使用 Private Path 服務閘道的閘道名稱和原則 ID,更新其帳戶原則,並將存取原則變更為「檢閱」。

指令選項

  • PRIVATE_PATH_SERVICE_GATEWAY:私有路徑服務閘道的 ID 或名稱。
  • ACCOUNT_POLICY:Private Path 服務閘道的帳戶政策識別碼。
  • --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 使用 Private Path 服務閘道的閘道 ID 和原則 ID,刪除其帳戶原則。
  • ibmcloud is private-path-service-gateway-account-policy-delete cli-ppsg-0 2d1bace7b46e4815a81e52c6ffeba5cf e13b4574db1743b1b7897bebca551db1 使用Private Path 服務閘道的閘道名稱和原則 ID,刪除其多個帳戶原則。

指令選項

  • PRIVATE_PATH_SERVICE_GATEWAY:私有路徑服務閘道的 ID 或名稱。
  • ACCOUNT_POLICY1:Private Path 服務閘道的帳戶政策識別碼。
  • ACCOUNT_POLICY2:Private Path 服務閘道的帳戶政策識別碼。
  • --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 使用 Private Path 服務閘道的 ID 列出其所有端點閘道連結。
  • ibmcloud is ppsg-egbs cli-ppsg-0 使用 Private Path 服務閘道的名稱,列出其所有端點閘道連結。

指令選項

  • PRIVATE_PATH_SERVICE_GATEWAY1:私有路徑服務閘道的 ID 或名稱。
  • PRIVATE_PATH_SERVICE_GATEWAY2:私有路徑服務閘道的 ID 或名稱。
  • --account-id:此存取政策所屬帳戶的 ID。
  • --status:端點閘道綁定的狀態。
  • --resource-group-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 使用 Private Path 服務閘道的閘道 ID 和連結 ID,檢視其端點閘道連結的詳細資料。
  • ibmcloud is private-path-service-gateway-endpoint-gateway-binding cli-ppsg-0 r134-3aabeae6-830c-40d6-b67e-4b08382989e9 使用 Private Path 服務閘道的閘道名稱和連結 ID,檢視其端點閘道連結的詳細資料。

指令選項

  • PRIVATE_PATH_SERVICE_GATEWAY:私有路徑服務閘道的 ID 或名稱。
  • ENDPOINT_GATEWAY_BINDING:Private Path 服務閘道的端點閘道綁定 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 使用 Private Path 服務閘道的閘道 ID 和連結 ID,拒絕其端點閘道連結,並將此 ID 設為帳戶原則。
  • ibmcloud is ppsg-egb-deny cli-ppsg r134-f7e2b651-0d02-46e1-8811-16ea2157b547 --set-account-policy true 使用 Private Path 服務閘道的閘道名稱和連結 ID,拒絕其端點閘道連結,並將此名稱設為帳戶原則。

指令選項

  • PRIVATE_PATH_SERVICE_GATEWAY:私有路徑服務閘道的 ID 或名稱。
  • ENDPOINT_GATEWAY_BINDING:Private Path 服務閘道的端點閘道綁定 ID。
  • --set-account-policy:指定此政策是否將成為同一帳戶中所有待處理及未來端點閘道綁定之存取政策。 以下其中之一:truefalse
  • --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 使用 Private Path 服務閘道的閘道 ID 和連結 ID,允許其端點閘道連結,並將此 ID 設為帳戶原則。
  • ibmcloud is ppsg-egb-permit cli-ppsg r134-3a30c0b3-8c4b-4a64-bb93-3f3e17459363 --set-account-policy true 使用 Private Path 服務閘道的閘道名稱和連結 ID,允許其端點閘道連結,並將此名稱設為帳戶原則。

指令選項

  • PRIVATE_PATH_SERVICE_GATEWAY:私有路徑服務閘道的 ID 或名稱。
  • ENDPOINT_GATEWAY_BINDING:Private Path 服務閘道的端點閘道綁定 ID。
  • --set-account-policy:指定此政策是否將成為同一帳戶中所有待處理及未來端點閘道綁定之存取政策。 以下其中之一:truefalse
  • --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 使用 Private Path 服務閘道的閘道 ID,撤銷帳戶對 Private Path 服務閘道的存取權限。
  • ibmcloud is ppsg-ar cli-ppsg --account-id efe5afc483594adaa8325e2b4d1290df 使用 Private Path 服務閘道的閘道名稱,撤銷帳戶對 Private Path 服務閘道的存取權限。

指令選項

  • PRIVATE_PATH_SERVICE_GATEWAY1:私有路徑服務閘道的 ID 或名稱。
  • PRIVATE_PATH_SERVICE_GATEWAY2:私有路徑服務閘道的 ID 或名稱。
  • --account-id:此存取政策所屬帳戶的 ID。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

公用位址範圍

ibmcloud 是 public-address-ranges

列出所有公用位址範圍。

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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --all-resource-groups:查詢所有資源群組。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 public-address-range

檢視公用位址範圍的詳細資料。

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 是 public-address-range-create

建立公用位址範圍。

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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 public-address-range-update

更新公用位址範圍。

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。
  • --zone:您希望此公網位址範圍所屬的區域,將取代任何現有的區域。
  • --reset-target:將目標從公開位址範圍中移除。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 public-address-range-delete

刪除一個以上公用位址範圍。

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 閘道(包括 IKE 和 IPsec 政策)的 CLI 指令。

ibmcloud 是 ike-policies

列出所有 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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --all-resource-groups:查詢所有資源群組。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 ike-policy

檢視 IKE 政策詳情。

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

指令選項

  • IKE_POLICY:IKE 政策的身分識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 ike-policy-connections

列出所有使用該 IKE 政策之連線。

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

指令選項

  • IKE_POLICY:IKE 政策的身分識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 ike-policy-create

建立 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 協定版本。 下列其中一項: 12
  • --key-lifetime:金鑰的有效期限(以秒為單位)。 最大值:86400,最小值:1800。(預設值:28800 )。
  • --resource-group-id:資源群組的 ID。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 ike-policy-delete

刪除一個以上 IKE 原則。

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

指令選項

  • IKE_POLICY1:IKE 政策之識別碼或名稱。
  • IKE_POLICY2:IKE 政策之識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 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 政策的身分識別碼或名稱。
  • --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 協定版本。 下列其中一項: 12
  • --key-lifetime:金鑰的有效期限(以秒為單位)。 最大值:86400,最小值:1800
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 ipsec-policies

列出所有 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。 此識別碼與 --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 政策的身分識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 ipsec-policy-connections

列出所有使用該 IPsec 原則的連線。

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

指令選項

  • IPSEC_POLICY:IPsec 政策的身分識別碼或名稱。
  • --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。 此識別碼與 --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 政策的身分識別碼或名稱。
  • IPSEC_POLICY2:IPsec 政策之識別碼或名稱。
  • --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 政策的身分識別碼或名稱。
  • --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-gateway-connection

檢視 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 連線的識別碼或名稱。
  • --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 作為 JSON 結構來建立 VPN 閘道連線
  • 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 閘道連線。 下列其中一項: truefalse。(預設值: true)。
  • --dead-peer-detection-action:死對等節點偵測的處理動作。 下列其中一項: restartclearholdnone。(預設值: restart)。
  • --dead-peer-detection-interval:死對等節點偵測間隔(單位:秒)(預設值:2 )。
  • --dead-peer-detection-timeout:死對等節點偵測的超時時間,單位為秒(預設值:10 )。
  • --ike-policy:IKE 政策的身分識別碼或名稱。
  • --ipsec-policy:IPsec 政策的身分識別碼或名稱。
  • --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 閘道連線的各條上行隧道之間進行分流。 以下其中之一:truefalse
  • --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 連線的識別碼或名稱。
  • --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-gateway-connection-peer-cidr-add

將同儕 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 閘道連線。 以下其中之一:truefalse
  • --dead-peer-detection-action:死對等節點偵測的處理動作。 下列其中一項: restartclearholdnone
  • --dead-peer-detection-interval:偵測連線中斷的間隔時間(以秒為單位)。
  • --dead-peer-detection-timeout:死對等節點偵測的超時時間(以秒為單位)。
  • --ike-policy:IKE 政策的身分識別碼或名稱。
  • --reset-ike-policy:移除 IKE 政策。
  • --ipsec-policy:IPsec 政策的身分識別碼或名稱。
  • --reset-ipsec-policy:移除 IPsec 政策。
  • --peer-address:對等 VPN 閘道的 IP 位址。
  • --peer-fqdn:對等 VPN 閘道的完全合格網域名稱 (FQDN)。
  • --distribute-traffic:指示流量是否會在 VPN 閘道連線的各條上行隧道之間進行分流。 以下其中之一:truefalse
  • --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 閘道的預設模式為「政策」。 下列其中一項: policyroute
  • --advertised-cidrs:以 CIDR 區塊表示法標示的 IP 位址範圍。
  • --local-asn:此 VPN 閘道及其連線所使用的本地自治系統號碼 (ASN)。
  • --resource-group-id:資源群組的 ID。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 vpn-gateway-delete

刪除一個以上 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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --all-resource-groups:查詢所有資源群組。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 vpn-gateway-advertised-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-gateway-advertised-cidr-add

將已通告的 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-gateway-advertised-cidr-delete

從 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-gateway-advertised-cidrs

列出所有已通告的 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-gateway-service-connection

擷取 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 伺服器

列出所有 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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --all-resource-groups:查詢所有資源群組。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 vpn 伺服器

檢視 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:以逗號分隔的客戶端驗證方法清單。 下列其中一項: certificateusernamecertificate、usernameusername、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 伺服器是否已啟用分割隧道功能。 下列其中一項: falsetrue。(預設值: false)。
  • --port:此 VPN 伺服器要使用的埠號。(預設值:443 )。
  • --protocol:此 VPN 伺服器應使用的傳輸協定。 下列其中一項: udptcp。(預設值: udp)。
  • --sg:VPN 伺服器的安全群組 ID 或名稱(以逗號分隔)。
  • --name:VPN 伺服器的新名稱。
  • --resource-group-id:資源群組的 ID。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 vpn-伺服器-更新

更新 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:以逗號分隔的客戶端驗證方法清單。 下列其中一項: certificateusernamecertificate、usernameusername、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 伺服器是否已啟用分割隧道功能。 下列其中一項: falsetrue。(預設值: false)。
  • --port:此 VPN 伺服器要使用的埠號。
  • --protocol:此 VPN 伺服器應使用的傳輸協定。 下列其中一項: udptcp
  • --name:VPN 伺服器的新名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 vpn-伺服器-刪除

刪除一個以上 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 伺服器-用戶端-設定

擷取 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 伺服器-用戶端

列出某個 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 伺服器用戶端

檢視 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 客戶端的識別碼。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 vpn 伺服器-用戶端-disconnect

中斷 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 客戶端的識別碼。
  • --vpc:VPC 的 ID 或名稱。 在此 VPC 內,僅能以名稱指定單一且唯一的資源,此為必要條件。
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 vpn 伺服器路由

列出某個 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 伺服器路由

檢視 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-伺服器-路由-建立

建立 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:針對符合該路由條件的封包所執行的動作。 下列其中一項: translatedeliverdrop。(預設值: deliver)。
  • --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:列出符合指定可見性設定的圖片。 有效的存取權限為:publicprivate
  • --status:根據以逗號分隔的狀態值清單,篩選該集合中的圖片。 可用的值:可用、刪除中、已淘汰、失敗、作廢、部分可用、擱置、無法使用、全部。
  • --user-data-format:根據以逗號分隔的 user-data-format 值清單,將集合篩選為符合該格式的圖片。 可用值:cloud_init、esxi_kickstart、ipxe。
  • --resource-group-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:用於封裝資料金鑰(最終以 encrypted_data_key 形式呈現)的根金鑰之 CRN。 此外,根金鑰會用於加密從此映像檔建立的磁碟區(除非在建立磁碟區時提供了其他加密金鑰 )。
  • --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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --deprecate-at:要為此映像設定的廢止日期與時間。 該日期和時間不得在過去,且必須早於 "obsolete_at"。 日期和時間必須採用 ISO 8601 格式:2024-03-05T15:31:50.701Z2024-03-05T15:31:50.701+8:00
  • --obsolete-at:要為此映像設定的過期日期與時間。 該日期和時間不得在過去,且必須晚於 "deprecate_at"。 日期和時間必須採用 ISO 8601 格式:2024-03-05T15:31:50.701Z2024-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.701Z2024-03-05T15:31:50.701+8:00
  • --reset-deprecate-at:指定此參數可移除現有的廢止日期與時間。 如果映像檔狀態是「已淘汰」,則它會變成「可用」。
  • --obsolete-at:要為此映像設定的過期日期與時間。 該日期和時間不得在過去,且必須晚於 "deprecate_at"。 日期和時間必須採用 ISO 8601 格式:2024-03-05T15:31:50.701Z2024-03-05T15:31:50.701+8:00
  • --reset-obsolete-at:指定此參數可移除現有的過期日期與時間。 如果映像檔狀態為「已作廢」,則如果 "deprecate_at" 是過去的時間,則它會變成「已淘汰」。 否則,它會變成「可用」。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 image-delete

刪除一個以上映像檔。

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:影像匯出工作單的編號或名稱。
  • --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。 下列其中一項: qcow2vhd。(預設值: 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:影像匯出工作單的編號或名稱。
  • --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:影像匯出工作之識別碼或名稱。
  • JOB2:影像匯出工作之 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 為 image-deprecate

淘汰映像檔。

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 已喪失影像功能

映像檔已作廢。

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 是 image-bare-metal-server-profiles

列出與映像檔相容的裸機伺服器設定檔。

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-offerings

列出所有目錄圖片。

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

指令範例

  • ibmcloud is catalog-image-offerings

指令選項

  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是目錄影像提供者

取得型錄映像檔供應項目。

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

指令選項

  • 目錄:目錄的識別碼。
  • 獻祭:獻祭的識別碼。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

實例

ibmcloud 是實例

檢視虛擬伺服器執行個體的詳細資訊。

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

指令選項

  • 實例:實例的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 instance-initialization-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。 此識別碼與 --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 是 instance-console

開啟虛擬伺服器實例的互動式主控台。 依預設,此指令會開啟互動式序列主控台。

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

指令選項

  • 實例:實例的 ID 或名稱。
  • --vnc:取得 VNC 主控台的 WebSocket URI,並在該執行個體的瀏覽器中開啟 IBM Cloud 這個網頁版 VNC 主控台。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 instance-create

建立虛擬伺服器實例。

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 在啟用或停用 meta 資料服務的情況下建立實例。
  • 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 建立具有 meta 資料服務配置的實例。
  • 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"}}}' 從具有開機磁區容量的 Snapshot 建立實例。 容量值可介於快照的最小容量與 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"}}}' 從磁區 Snapshot 建立具有開機磁區連接的實例。
  • 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"}}}]' 使用資源名稱,從磁區 Snapshot 建立具有磁區連接的實例。
  • 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"}}}]' 從磁區 Snapshot 建立具有磁區連接的實例。
  • 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"}}}' 使用資源名稱從磁區 Snapshot 建立具有開機磁區連接的實例。
  • 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' 來提取子網路 ID 或名稱。
  • --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:此虛擬伺服器實例應使用的預留親和性政策。 如果儲存區不為空,則原則預設為手動。 如果已設定 placement_target,則該原則預設為停用。 在所有其他情況下,該原則預設為自動。 其中之一:停用手動自動
  • --reservation-affinity-pool, --res-pool:此虛擬伺服器實例可使用的預留資源之 ID、名稱或 CRN。
  • --user-data: data|@data-file. 將傳輸至虛擬伺服器執行個體的使用者資料。
  • --rip:現有預留 IP 的 ID 或名稱。
  • --address:要預留的 IP 位址,該位址在子網中不得已被預留。
  • --auto-delete:若設定為 true,當目標被刪除時,此保留 IP 將自動刪除。 下列其中一項: truefalse。(預設值: true)。
  • --ip-name:此保留 IP 的使用者自訂名稱。 名稱必須在保留 IP 所在的子網路內是唯一的。 以 ibm- 開頭的名稱,是預留給服務供應商自有資源使用的。
  • --allow-ip-spoofing:停用此介面上的來源與目的地檢查。 若為 false,則不允許在此介面上進行來源 IP 偽造。 下列其中一項: falsetrue
  • --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 盜用。 下列其中一項: falsetrue。(預設值: false)。
  • --pnac-vni-ein:啟用基礎架構 NAT(EIN)。 若屬實,VPC 基礎架構將針對 VNI 執行任何必要的 NAT 操作。 若要將 VNI 連接至實例,值必須為 true。 Floating_ips 不得有多個浮動 IP。 若為 false,則資料包將在傳入或傳出 VNI 時保持原樣,這使其能夠執行任何必要的 NAT 操作。 Allow_ip_spoofing 必須是 false。 只能連接至 resource_type 為 bare_metal_server_network_attachment 的目標。 下列其中一項: truefalse。(預設值: true)。
  • --pnac-vni-auto-delete:指示此與主要網路連接相關聯的虛擬網路介面,是否會在刪除目標時自動刪除。 下列其中一項: truefalse。(預設值: 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 是否會自動刪除。 下列其中一項: truefalse。(預設值: true)。
  • --pnac-vni-rip-name:此保留 IP 位址的名稱,用於綁定至與主要網路連接相關聯的虛擬網路介面。
  • --pnac-vni-sgs:用於虛擬網路介面的安全群組 ID 或名稱(以逗號分隔),這些安全群組須與主要網路連接相關聯。
  • --pnac-vni-psfm:此虛擬網路介面應使用的協定狀態過濾模式。 若設定為「自動」,則會根據虛擬網路介面的「target」資源類型,啟用或停用協定狀態封包過濾功能。 下列其中一項: autoenableddisabled。(預設值: auto)。
  • -- network-attachments: 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:啟用或停用實例元數據服務。 以下其中之一:truefalse
  • --metadata-service-protocol, --msp:元數據服務端點的通訊協定。 只有在啟用 meta 資料服務時,才會套用通訊協定。 下列其中一項: http,****。(預設值: ** http**)。
  • --metadata-service-response-hop-limit, --msrhl:來自元數據服務的 IP 回應封包之跳數限制(IP 存活時間)。
  • --host-failure-policy:當運算主機發生故障時應執行的動作。 下列其中一項: restartstop。(預設值: restart)。
  • --confidential-compute-mode:此虛擬伺服器執行個體應使用的機密運算模式。 如果未指定,則使用設定檔中的預設機密計算模式。 其中一個:DisabledSGXTDX
  • --enable-secure-boot:指示此虛擬伺服器執行個體是否已啟用安全開機。 如果未指定,則使用設定檔中的預設安全開機模式。 以下其中之一:truefalse
  • --resource-group-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:此虛擬伺服器執行個體的每核心執行緒數。 若未指定,則使用設定檔的預設值。 下列其中一項: 12
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • - 互動的,-i:
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是從範本建立執行個體

根據實例範本建立虛擬伺服器實例。

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 從啟用或停用 meta 資料服務的實例範本建立實例。
  • 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:此虛擬伺服器實例應使用的預留親和性政策。 如果儲存區不為空,則原則預設為手動。 如果已設定 placement_target,則該原則預設為停用。 在所有其他情況下,該原則預設為自動。 其中之一:停用手動自動
  • --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 將自動刪除。 下列其中一項: truefalse。(預設值: true)。
  • --ip-name:此保留 IP 的使用者自訂名稱。 名稱必須在保留 IP 所在的子網路內是唯一的。 以 ibm- 開頭的名稱,是預留給服務供應商自有資源使用的。
  • --allow-ip-spoofing:停用此介面上的來源與目的地檢查。 若為 false,則不允許在此介面上進行來源 IP 偽造。 下列其中一項: falsetrue
  • --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 盜用。 下列其中一項: falsetrue。(預設值: false)。
  • --pnac-vni-ein:啟用基礎架構 NAT(EIN)。 若屬實,VPC 基礎架構將針對 VNI 執行任何必要的 NAT 操作。 若要將 VNI 連接至實例,值必須為 true。 Floating_ips 不得有多個浮動 IP。 若為 false,則資料包將在傳入或傳出 VNI 時保持原樣,這使其能夠執行任何必要的 NAT 操作。 Allow_ip_spoofing 必須是 false。 只能連接至 resource_type 為 bare_metal_server_network_attachment 的目標。 下列其中一項: truefalse。(預設值: true)。
  • --pnac-vni-auto-delete:指示此與主要網路連接相關聯的虛擬網路介面,是否會在刪除目標時自動刪除。 下列其中一項: truefalse。(預設值: 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 是否會自動刪除。 下列其中一項: truefalse。(預設值: true)。
  • --pnac-vni-rip-name:此保留 IP 位址的名稱,用於綁定至與主要網路連接相關聯的虛擬網路介面。
  • --pnac-vni-sgs:用於虛擬網路介面的安全群組 ID 或名稱(以逗號分隔),這些安全群組須與主要網路連接相關聯。
  • --pnac-vni-psfm:此虛擬網路介面應使用的協定狀態過濾模式。 若設定為「自動」,則會根據虛擬網路介面的「target」資源類型,啟用或停用協定狀態封包過濾功能。 下列其中一項: autoenableddisabled。(預設值: auto)。
  • -- network-attachments: 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:啟用或停用實例元數據服務。 以下其中之一:truefalse
  • --metadata-service-protocol, --msp:元數據服務端點的通訊協定。 只有在啟用 meta 資料服務時,才會套用通訊協定。 下列其中一項: http,****。(預設值: ** http**)。
  • --metadata-service-response-hop-limit, --msrhl:來自元數據服務的 IP 回應封包之跳數限制(IP 存活時間)。
  • --host-failure-policy:當運算主機發生故障時應執行的動作。 下列其中一項: restartstop
  • --confidential-compute-mode:此虛擬伺服器執行個體應使用的機密運算模式。 如果未指定,則使用設定檔中的預設機密計算模式。 其中一個:DisabledSGXTDX
  • --enable-secure-boot:指示此虛擬伺服器執行個體是否已啟用安全開機。 如果未指定,則使用設定檔中的預設安全開機模式。 以下其中之一:truefalse
  • --resource-group-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:此虛擬伺服器執行個體的每核心執行緒數。 若未指定,則使用設定檔的預設值。 下列其中一項: 12
  • --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 是 instance-disk

檢視虛擬伺服器執行個體磁碟的詳細資訊。

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

指令選項

  • 實例:實例的 ID 或名稱。
  • INSTANCE_DISK:實例磁碟的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 instance-disk-update

更新虛擬伺服器執行個體的磁碟。

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 是 instance-disks

列出虛擬伺服器執行個體的所有磁碟。

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:網路介面的識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 instance-network-interface-create

為虛擬伺服器執行個體建立網路介面。

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 將自動刪除。 下列其中一項: truefalse。(預設值: true)。
  • --ip-name:此保留 IP 的使用者自訂名稱。 名稱必須在保留 IP 所在的子網路內是唯一的。 以 ibm- 開頭的名稱,是預留給服務供應商自有資源使用的。
  • --sg:安全群組的 ID 或名稱。
  • --allow-ip-spoofing:停用此介面上的來源與目的地檢查。 若為 false,則不允許在此介面上進行來源 IP 偽造。 下列其中一項: falsetrue
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 instance-network-interface-delete

從虛擬伺服器實例移除一個以上網路介面。

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

指令選項

  • 實例:實例的 ID 或名稱。
  • NIC1:網路介面的識別碼或名稱。
  • NIC2:網路介面的識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 instance-network-interface-floating-ip

檢視與網路介面相關聯的浮動 IP 的詳細資訊。

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

指令選項

  • 實例:實例的 ID 或名稱。
  • NIC:網路介面的識別碼或名稱。
  • FLOATING_IP:浮動 IP 的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 實例-網路介面-浮動IP-位址

將浮動 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:網路介面的識別碼或名稱。
  • FLOATING_IP:浮動 IP 的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 實例網路介面浮動IP移除

將浮動 IP 與網路介面解除關聯。

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

指令選項

  • 實例:實例的 ID 或名稱。
  • NIC:網路介面的識別碼或名稱。
  • FLOATING_IP:浮動 IP 的 ID 或名稱。
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 instance-network-interface-floating-ips

列出所有與網路介面相關聯的浮動 IP。

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

指令選項

  • 實例:實例的 ID 或名稱。
  • NIC:網路介面的識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 實例網路介面保留 IP

列出與網路介面相關聯的所有保留 IP。

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

指令選項

  • 實例:實例的 ID 或名稱。
  • NIC:網路介面的識別碼或名稱。
  • --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:網路介面的識別碼或名稱。
  • RESERVED_IP:預留 IP 的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 instance-network-interface-update

更新虛擬伺服器實例的網路介面。

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

指令選項

  • 實例:實例的 ID 或名稱。
  • NIC:網路介面的識別碼或名稱。
  • --name:網路介面卡的新名稱。
  • --allow-ip-spoofing:停用此介面上的來源與目的地檢查。 若為 false,則不允許在此介面上進行來源 IP 偽造。 下列其中一項: falsetrue
  • --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 是 instance-profile

檢視虛擬伺服器執行個體設定檔的詳細資訊。

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 是 instance-start

啟動一個虛擬伺服器執行個體。

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

指令選項

  • 實例:實例的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 instance-stop

停止一個虛擬伺服器執行個體。

  • 當您停止一個執行個體並重新啟動它時,若該執行個體在建立時未使用靜態 IP 位址,或透過 CLI 或 API 建立時未設定 ip.private_address 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:此虛擬伺服器實例應使用的預留親和性政策。 如果儲存區不為空,則原則預設為手動。 如果已設定 placement_target,則該原則預設為停用。 在所有其他情況下,該原則預設為自動。 其中之一:停用手動自動
  • --reservation-affinity-pool, --res-pool:此虛擬伺服器實例可使用的預留資源之 ID、名稱或 CRN。
  • --metadata-service, --ms:啟用或停用實例元數據服務。 以下其中之一:truefalse
  • --metadata-service-protocol, --msp:元數據服務端點的通訊協定。 只有在啟用 meta 資料服務時,才會套用通訊協定。 下列其中一項: http,****。(預設值: ** http**)。
  • --metadata-service-response-hop-limit, --msrhl:來自元數據服務的 IP 回應封包之跳數限制(IP 存活時間)。
  • --host-failure-policy:當運算主機發生故障時應執行的動作。 下列其中一項: restartstop
  • --confidential-compute-mode:此虛擬伺服器執行個體應使用的機密運算模式。 如果未指定,則使用設定檔中的預設機密計算模式。 其中一個:DisabledSGXTDX
  • --enable-secure-boot:指示此虛擬伺服器執行個體是否已啟用安全開機。 如果未指定,則使用設定檔中的預設安全開機模式。 以下其中之一:truefalse
  • --volume-bandwidth-qos-mode:此虛擬伺服器執行個體應使用的卷宗頻寬 QoS 模式。 指定的值必須列在實例設定檔的 volume_bandwidth_qos_modes 中。 其中之一:匯集加權
  • --vcpu-percentage:分配給該執行個體的「vCPU」時脈週期所佔的百分比。 範圍 1-100。
  • --availability-class:虛擬伺服器實例的可用性類別。 其中之一:現貨標準
  • --preemption-policy:若虛擬伺服器執行個體遭到預先終止時,應執行的操作。 其中之一:刪除停止
  • --threads-per-core:此虛擬伺服器執行個體的每核心執行緒數。 若未指定,則使用設定檔的預設值。 下列其中一項: 12
  • --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-attachments

列出實例的所有磁碟區附加項目。

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

指令選項

  • 實例:實例的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 實例卷掛載添加

建立儲存體掛載,將儲存體連接到執行個體。

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

指令選項

  • 名稱:卷掛載的名稱。
  • 實例:實例的 ID 或名稱。
  • :卷的識別碼或名稱。
  • --new-volume-name:新卷的名稱。
  • --profile:設定檔名稱。
  • --iops:卷的每秒輸入與輸出操作次數,此參數僅適用於自訂設定檔卷。 如需可用的 IOPS 範圍,請參閱 [自訂 IOPS 設定檔]將軟體上線至帳戶
  • --encryption-key:金鑰管理服務(KMS)根金鑰的 CRN。
  • --容量:卷的容量(以千兆位元組為單位)。 範圍 10-16000 (適用於自訂及一般用途設定檔磁區)、10-9600 (適用於 5iops-tier 設定檔磁區)、10-4800 (適用於 10iops-tier 設定檔磁區)。
  • --bandwidth:該卷的最大頻寬(單位為百萬位元每秒)。 若要指定此屬性,磁碟區 storage_generation 必須是 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:當實例被刪除時,其附屬的儲存卷也會被刪除。 下列其中一項: falsetrue。(預設值: 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:當實例被刪除時,其附屬的儲存卷也會被刪除。 以下其中之一:truefalse
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 instance-network-attachments

列出某個實例的所有網路連接。

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:網路連接的識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 instance-network-attachment-create

為實例建立網路連接。

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 內依名稱指定唯一子網路時,才需要此 ID 或名稱。
  • --vni-ais:允許 IP 偽造(AIS)。 指出在此虛擬網路介面上是否容許來源 IP 盜用。 下列其中一項: falsetrue。(預設值: false)。
  • --vni-ein:啟用基礎架構 NAT(EIN)。 若為真,VPC 基礎架構將執行任何必要的 NAT 操作。 若為 false,則資料包將在傳入或傳出虛擬網路介面時保持原樣不作任何修改,這使得與浮動 IP 關聯的虛擬機器能夠執行任何必要的 NAT 操作。 下列其中一項: truefalse。(預設值: true)。
  • --vni-auto-delete:指示當目標被刪除時,此虛擬網路介面是否會自動刪除。 下列其中一項: truefalse。(預設值: 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 是否會自動刪除。 以下其中之一:truefalse
  • --vni-rip-name:此預留 IP 位址用於綁定至虛擬網路介面的名稱。 子網路中的另一個保留 IP 不得使用該名稱。 以「ibm-」開頭的名稱是保留給服務供應商自有資源使用的,因此不允許使用。
  • --vni-psfm:此虛擬網路介面應使用的協定狀態過濾模式。 若設定為「自動」,則會根據虛擬網路介面的「target」資源類型,啟用或停用協定狀態封包過濾功能。 下列其中一項: autoenableddisabled。(預設值: auto)。
  • --vni-sgs:此虛擬網路介面將使用的安全群組的 ID 或名稱,以逗號分隔。 如果未指定,則會使用子網路的 VPC 預設安全群組。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 instance-network-attachment-update

更新實例的網路連接設定。

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:網路連接的識別碼或名稱。
  • --name:網路連接的新名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 instance-network-attachment-delete

從實例中移除一個以上的網路連接。

ibmcloud is instance-network-attachment-delete INSTANCE (NAC1 NAC2 ...) [--output JSON] [-f, --force] [-q, --quiet]

指令選項

  • 實例:實例的 ID 或名稱。
  • NAC1:網路連接的識別碼或名稱。
  • NAC2:網路連接的識別碼或名稱。
  • --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:叢集網路連接的識別碼或名稱。
  • --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:叢集網路連接的識別碼或名稱。
  • --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:指示當目標被刪除時,此叢集網路介面是否會自動刪除。 以下其中之一:truefalse
  • --cni-name:此叢集網路介面的名稱。
  • --cni-subnet:相關聯的叢集網路子網的 ID 或名稱。
  • --cni-primary-ip:要綁定至叢集網路介面的叢集網路子網保留 IP 的 ID 或名稱。
  • --cni-primary-ip-address:要綁定至叢集網路介面的預留 IP 位址。 需要指定子網路。
  • --cni-primary-ip-auto-delete:指示當任一目標被刪除,或預留 IP 解除綁定時,此預留 IP 是否會自動刪除。 以下其中之一:truefalse
  • --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:叢集網路連接的識別碼或名稱。
  • CNAC2:叢集網路連接的識別碼或名稱。
  • --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 is key KEY [--output JSON] [-q, --quiet]

指令選項

  • KEY:金鑰的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是關鍵-創建

匯入 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-file. 要匯入到系統中的公用 SSH 金鑰。
  • --key-type:此金鑰所使用的加密系統。 預設值為 rsa。 下列其中一項: rsaed25519
  • --resource-group-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。 此識別碼與 --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。 此識別碼與 --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 是 dedicated-host-group-create

建立主機群組。

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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 dedicated-host-group-update

更新主機群組。

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 是 dedicated-host-group-delete

刪除一個以上主機群組。

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。 此識別碼與 --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:啟用或停用主機中的實例配置。 下列其中一項: truefalse。(預設值: true)。
  • --name:主機的新名稱。
  • --resource-group-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:啟用或停用主機中的實例配置。 以下其中之一:truefalse
  • --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:抑制詳細輸出。

裸機伺服器

ibmcloud is bare bare-metal-server

檢視裸機伺服器的詳細資訊。

ibmcloud is bare-metal-server SERVER [--output JSON] [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud is bare bare-metal-server-console

開啟 bare metal server 的互動式主控台。 依預設,此指令會開啟互動式序列主控台。

ibmcloud is bare-metal-server-console SERVER [--vnc] [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • --vnc:取得 VNC 主控台的 WebSocket URI,此選項不會開啟 VNC 主控台。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 bare-metal-server-create

建立一台裸機伺服器。

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 以指定的主要網路介面配置建立 bare metal server。
  • 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 ID 建立裸機伺服器。
  • 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 ID 和頻寬建立裸機伺服器。
  • 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 使用依 NAME 預先建立的保留 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 ID 建立具有次要網路介面的裸機伺服器。 以 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 內依名稱指定唯一子網路時,才需要此 ID 或名稱。
  • --pnic-rip:已綁定至主要網路介面的現有保留 IP 的 ID 或名稱。
  • --pnic-rip-address:要預留的主網路介面的 IP 位址,該位址在子網中不得已被預留。
  • --pnic-rip-auto-delete:若設定為 true,當目標被刪除時,主網路介面的此保留 IP 位址將自動刪除。 下列其中一項: truefalse。(預設值: true)。
  • --pnic-rip-name:此主要網路介面所保留 IP 位址的用戶自訂名稱。 名稱必須在保留 IP 所在的子網路內是唯一的。 以 ibm- 開頭的名稱,是預留給服務供應商自有資源使用的。
  • --pnic-sgs:主要網路介面的以逗號分隔的安全群組 ID。
  • --pnic-allowed-vlans: 以逗點區隔的 VLAN ID。 指出哪些 VLAN ID(僅適用於 VLAN 介面)可以使用主要網路介面。 它可以作為個別值或任何範圍的數字來傳遞。
  • --pnic-ein:啟用基礎架構 NAT(EIN)。 若為真,VPC 基礎架構將執行任何必要的 NAT 操作。 若設定為 false,資料包將在傳入或傳出網路介面時保持原樣,讓與浮動 IP 關聯的虛擬機器能夠執行任何必要的 NAT 操作。 下列其中一項: truefalse。(預設值: true)。
  • --pnic-ais:允許 IP 偽造(AIS)。 若為真,則允許在使用此網路介面的封包進行來源 IP 偽造。 若為 false,則會禁止在此介面上進行來源 IP 偽造。 下列其中一項: falsetrue。(預設值: 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 ID。 指出哪些 VLAN ID(僅適用於 VLAN 介面)可以使用主要網路連接。 它可以作為個別值或任何範圍的數字來傳遞。
  • --pnac-vni:與主要網路連接相關聯的虛擬網路介面的 ID 或名稱。
  • --pnac-vni-subnet:相關聯的子網。
  • --pnac-vni-ais:允許 IP 偽造(AIS)。 指出與主要網路連接相關聯的這個虛擬網路介面上是否容許來源 IP 盜用。 下列其中一項: falsetrue。(預設值: false)。
  • --pnac-vni-ein:啟用基礎架構 NAT(EIN)。 若屬實,VPC 基礎架構將針對 VNI 執行任何必要的 NAT 操作。 若要將 VNI 連接至實例,值必須為 true。 Floating_ips 不得有多個浮動 IP。 若為 false,則資料包將在傳入或傳出 VNI 時保持原樣,這使其能夠執行任何必要的 NAT 操作。 Allow_ip_spoofing 必須是 false。 只能連接至 resource_type 為 bare_metal_server_network_attachment 的目標。 下列其中一項: truefalse。(預設值: true)。
  • --pnac-vni-auto-delete:指示此與主要網路連接相關聯的虛擬網路介面,是否會在刪除目標時自動刪除。 下列其中一項: truefalse。(預設值: 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 是否會自動刪除。 下列其中一項: truefalse。(預設值: true)。
  • --pnac-vni-rip-name:此保留 IP 位址的名稱,用於綁定至與主要網路連接相關聯的虛擬網路介面。
  • --pnac-vni-sgs:用於虛擬網路介面的安全群組 ID 或名稱(以逗號分隔),這些安全群組須與主要網路連接相關聯。
  • --pnac-vni-psfm:此虛擬網路介面應使用的協定狀態過濾模式。 若設定為「自動」,則會根據虛擬網路介面的「target」資源類型,啟用或停用協定狀態封包過濾功能。 下列其中一項: autoenableddisabled。(預設值: auto)。
  • -- network-attachments: NETWORK_ATTACHMENTS_JSON |@NETWORK_ATTACHMENTS_JSON_FILE。 網路連接配置位於 JSON 或 JSON 檔案中。 有關資料結構,請參閱 API 文件 中的 network_attachments 屬性。 下列其中一項: NETWORK_ATTACHMENTS_JSON@NETWORK_ATTACHMENTS_JSON_FILE
  • --enable-secure-boot:指示是否已啟用安全開機。 如果已啟用,則映像檔必須支援安全開機,否則伺服器無法開機。 下列其中一項: falsetrue。(預設值: false)。
  • --tpm-mode:可信平台模組(TPM)的運作模式。 下列其中一項: tpm_2已停用
  • --bandwidth:裸機伺服器各網路介面間共享的總頻寬(單位為百萬位元每秒)。 如果未指定,則會使用設定檔中的預設值。 您可以使用指令 ibmcloud is bare bare-metal-server-profile 來取得有效的頻寬值。
  • --resource-group-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:啟用或停用裸機伺服器的元資料服務。 以下其中之一:truefalse
  • --metadata-service-protocol:元數據服務端點的通訊協定。 只有在啟用 meta 資料服務時,才會套用通訊協定。 下列其中一項: http,****。(預設值: ** http**)。
  • - 互動的,-i:
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud is bare bare-metal-server-delete

刪除一個以上的裸機伺服器。

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 is bare bare-metal-server-disk

檢視裸機伺服器磁碟的詳細資訊。

ibmcloud is bare-metal-server-disk SERVER SERVER_DISK [--output JSON] [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • SERVER_DISK:伺服器磁碟的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud is bare bare-metal-server-disk-update

更新裸機伺服器的磁碟。

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 是 bare-metal-server-disks

列出裸機伺服器上的所有磁碟。

ibmcloud is bare-metal-server-disks SERVER [--output JSON] [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 bare-metal-server-initialization-values

擷取用於初始化裸機伺服器的配置變數。

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 是 bare-metal-server-network-interface

檢視裸機伺服器網路介面的詳細資訊。

ibmcloud is bare-metal-server-network-interface SERVER NIC [--output JSON] [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • NIC:網路介面的識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 裸機伺服器-網路介面-建立

為裸機伺服器建立一個網路介面。

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:網路介面的類型。 下列其中一項: pcivlan。(預設值: pci)。
  • --rip:現有預留 IP 的 ID 或名稱。
  • --address:要預留的 IP 位址,該位址在子網中不得已被預留。
  • --auto-delete:若設定為 true,當目標被刪除時,此保留 IP 將自動刪除。 下列其中一項: truefalse。(預設值: true)。
  • --ip-name:此保留 IP 的使用者自訂名稱。 名稱必須在保留 IP 所在的子網路內是唯一的。 以 ibm- 開頭的名稱,是預留給服務供應商自有資源使用的。
  • --security-groups:以逗號分隔的網路介面安全群組 ID 或名稱。
  • --vpc:VPC 的 ID 或名稱。 只有此 VPC 內按名稱指定唯一子網路和唯一安全群組時才需要此項目。
  • --allowed-vlans:以逗號分隔的 VLAN ID。 指出哪些 VLAN ID(僅適用於 VLAN 介面)可以使用此 PCI 介面。 它可以作為個別值或任何範圍的數字來傳遞。
  • --vlan:指定此 VLAN 介面上的所有流量必須使用的 802.1Q VLAN ID 標籤。
  • --allow-interface-to-float:指示該介面是否可浮動至同一 resource_group 內的任何其他伺服器。 如果網路在資源群組內的另一個 bare metal server 上偵測到 GARP 或 RARP,則會自動浮動顯示其網路介面。 僅適用於 VLAN 介面。 下列其中一項: falsetrue。(預設值: false)。
  • --allow-ip-spoofing:允許 IP 偽造 (AIS)。 若為真,則允許在使用此網路介面的封包進行來源 IP 偽造。 若為 false,則會禁止在此介面上進行來源 IP 偽造。 下列其中一項: falsetrue。(預設值: false)。
  • --enable-infrastructure-nat:啟用基礎架構 NAT(EIN)。 若為真,VPC 基礎架構將執行任何必要的 NAT 操作。 若設定為 false,資料包將在傳入或傳出網路介面時保持原樣,讓與浮動 IP 關聯的虛擬機器能夠執行任何必要的 NAT 操作。 下列其中一項: truefalse。(預設值: true)。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud is bare bare-metal-server-network-interface-delete

從裸機伺服器移除一個以上網路介面。

ibmcloud is bare-metal-server-network-interface-delete SERVER (NIC1 NIC2 ...) [--output JSON] [-f, --force] [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • NIC1:網路介面的識別碼或名稱。
  • NIC2:網路介面的識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud is bare bare-metal-server-network-interface-floating-ip

檢視與網路介面相關聯的浮動 IP 的詳細資訊。

ibmcloud is bare-metal-server-network-interface-floating-ip SERVER NIC FLOATING_IP [--output JSON] [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • NIC:網路介面的識別碼或名稱。
  • FLOATING_IP:浮動 IP 的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud is bare bare-metal-server-network-interface-floating-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 與 bare metal server 上的網路介面相關聯,並指定 JSON 作為輸出格式。

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • NIC:網路介面的識別碼或名稱。
  • FLOATING_IP:浮動 IP 的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud is bare bare-metal-server-network-interface-floating-ip-remove

將浮動 IP 與網路介面解除關聯。

ibmcloud is bare-metal-server-network-interface-floating-ip-remove SERVER NIC FLOATING_IP [-f, --force] [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • NIC:網路介面的識別碼或名稱。
  • FLOATING_IP:浮動 IP 的 ID 或名稱。
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud is bare bare-metal-server-network-interface-floating-ips

列出所有與網路介面相關聯的浮動 IP。

ibmcloud is bare-metal-server-network-interface-floating-ips SERVER NIC [--output JSON] [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • NIC:網路介面的識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud is bare bare-metal-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:網路介面的識別碼或名稱。
  • --name:網路介面的新名稱。
  • --allow-ip-spoofing:允許 IP 偽造 (AIS)。 若為真,則允許在使用此網路介面的封包進行來源 IP 偽造。 若為 false,則會禁止在此介面上進行來源 IP 偽造。 下列其中一項: falsetrue。(預設值: false)。
  • --enable-infrastructure-nat:啟用基礎架構 NAT(EIN)。 若為真,VPC 基礎架構將執行任何必要的 NAT 操作。 若設定為 false,資料包將在傳入或傳出網路介面時保持原樣,讓與浮動 IP 關聯的虛擬機器能夠執行任何必要的 NAT 操作。 下列其中一項: truefalse。(預設值: true)。
  • --allowed-vlans:以逗號分隔的 VLAN ID。 指出哪些 VLAN ID(僅適用於 VLAN 介面)可以使用此 PCI 介面。 它可以作為個別值或任何範圍的數字來傳遞。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud is bare bare-metal-server-network-interfaces

列出裸機伺服器的所有網路介面。

ibmcloud is bare-metal-server-network-interfaces SERVER [--output JSON] [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 bare-metal-server-profile

檢視裸機伺服器設定檔的詳細資訊。

ibmcloud is bare-metal-server-profile PROFILE_NAME [--output JSON] [-q, --quiet]

指令選項

  • PROFILE_NAME:設定檔名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 bare-metal-server-profiles

列出該區域內的所有裸機伺服器設定檔。

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

指令選項

  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud is bare bare-metal-server-restart

重新啟動一台裸機伺服器。

ibmcloud is bare-metal-server-restart SERVER [-f, --force] [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud is bare bare-metal-server-start

啟動一台裸機伺服器。

ibmcloud is bare-metal-server-start SERVER [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • -q,--quiet:抑制詳細輸出。

ibmcloud is bare bare-metal-server-stop

停止一臺裸機伺服器。

ibmcloud is bare-metal-server-stop SERVER [--type soft | hard] [-f, --force] [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • -- type: 指出停止作業的類型。soft: 發出信號指出執行中作業系統已完全靜止並關閉。hard: 立即停止伺服器。 下列其中一項: softhard。(預設值: soft)。
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud is bare bare-metal-server-update

更新一台裸機伺服器。

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:指示是否已啟用安全開機。 如果已啟用,則映像檔必須支援安全開機,否則伺服器無法開機。 在變更此配置之前,裸機伺服器的狀態必須先停止。 下列其中一項: falsetrue
  • --tpm-mode:可信平台模組(TPM)的運作模式。 下列其中一項: tpm_2已停用
  • --bandwidth:裸機伺服器各網路介面間共享的總頻寬(單位為百萬位元每秒)。 如果未指定,則會使用設定檔中的預設值。 您可以使用指令 ibmcloud is bare bare-metal-server-profile 來取得有效的頻寬值。
  • --reservation-affinity-policy, --res-policy:此裸機伺服器應使用的預留親和性政策。 如果儲存區未清空,則原則預設為手動。 否則原則預設為自動。 其中之一:停用手動自動
  • --metadata-service:啟用或停用裸機伺服器的元資料服務。 以下其中之一:truefalse
  • --metadata-service-protocol:元數據服務端點的通訊協定。 只有在啟用 meta 資料服務時,才會套用通訊協定。 下列其中一項: http,****。(預設值: ** http**)。
  • --reservation-affinity-pool, --res-pool:此裸機伺服器可使用的預留資源之 ID、名稱或 CRN。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 bare-metal-servers

列出所有裸機伺服器。

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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --all-resource-groups:查詢所有資源群組。
  • --vpc:VPC 的 ID、名稱或 CRN。
  • --reservation:預訂的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 bare-metal-server-firmware-update

將裸機伺服器更新到最新的韌體。

ibmcloud is bare-metal-server-firmware-update SERVER [--auto-start true | false] [-f, --force] [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • --auto-start:指示在韌體更新成功後,是否要自動啟動裸機伺服器。 下列其中一項: truefalse。(預設值: true)。
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud is bare bare-metal-server-network-interface-reserved-ips

列出連結至裸機伺服器網路介面的所有保留 IP。

ibmcloud is bare-metal-server-network-interface-reserved-ips SERVER NIC [--output JSON] [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • NIC:網路介面的識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 bare-metal-server-network-interface-reserved-ip

如果指定的保留 IP 位址連結至裸機伺服器的網路介面,則擷取該 IP 位址。

ibmcloud is bare-metal-server-network-interface-reserved-ip SERVER NIC RESERVED_IP [--output JSON] [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • NIC:網路介面的識別碼或名稱。
  • RESERVED_IP:預留 IP 的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 bare-metal-server-network-attachments

列出裸機伺服器的所有網路連接。

ibmcloud is bare-metal-server-network-attachments SERVER [--output JSON] [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 bare-metal-server-network-attachment

檢視裸機伺服器的網路連接詳細資訊。

ibmcloud is bare-metal-server-network-attachment SERVER NAC [--output JSON] [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • NAC:網路連接的識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 bare-metal-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:網路連接介面的類型。 下列其中一項: pcivlan。(預設值: pci)。
  • --allowed-vlans:以逗號分隔的 VLAN ID。 指出哪些 VLAN ID(僅適用於 VLAN 類型)可以使用此實體(PCI 類型)連接。 它可以作為個別值或任何範圍的數字來傳遞。
  • --allow-to-float:指示裸機伺服器的網路連接是否可自動切換至同一 resource_group 內的任何其他伺服器。
  • --vlan:指定此連接點上所有流量必須使用的 802.1Q VLAN ID 標籤。
  • --vni:此裸機伺服器用於網路連接的虛擬網路介面的 ID 或名稱。
  • --vni-subnet:相關聯的子網。
  • --vpc:VPC 的 ID 或名稱。 只有在此 VPC 內依名稱指定唯一子網路時,才需要此 ID 或名稱。
  • --vni-ais:允許 IP 偽造(AIS)。 指出在此虛擬網路介面上是否容許來源 IP 盜用。 下列其中一項: falsetrue。(預設值: false)。
  • --vni-ein:啟用基礎架構 NAT(EIN)。 若為真,VPC 基礎架構將執行任何必要的 NAT 操作。 若為 false,則資料包將在傳入或傳出虛擬網路介面時保持原樣不作任何修改,這使得與浮動 IP 關聯的虛擬機器能夠執行任何必要的 NAT 操作。 下列其中一項: truefalse。(預設值: true)。
  • --vni-auto-delete:指示當目標被刪除時,此虛擬網路介面是否會自動刪除。 下列其中一項: truefalse。(預設值: 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」資源類型,啟用或停用協定狀態封包過濾功能。 下列其中一項: autoenableddisabled。(預設值: auto)。
  • --vni-sgs:此虛擬網路介面將使用的安全群組的 ID 或名稱,以逗號分隔。 如果未指定,則會使用子網路的 VPC 預設安全群組。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud is bare bare-metal-server-network-attachment-update

更新裸機伺服器的網路連接設定。

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:網路連接的識別碼或名稱。
  • --name:網路連接的新名稱。
  • --allowed-vlans:以逗號分隔的 VLAN ID。 指出哪些 VLAN ID(僅適用於 VLAN 類型)可以使用此實體(PCI 類型)連接。 它可以作為個別值或任何範圍的數字來傳遞。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud is bare bare-metal-server-network-attachment-delete

從裸機伺服器移除一個以上的網路連接。

ibmcloud is bare-metal-server-network-attachment-delete SERVER (NAC1 NAC2 ...) [--output JSON] [-f, --force] [-q, --quiet]

指令選項

  • 伺服器:伺服器的 ID 或名稱。
  • NAC1:網路連接的識別碼或名稱。
  • NAC2:網路連接的識別碼或名稱。
  • --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。 此識別碼與 --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。 此識別碼與 --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 ID 建立叢集網路介面。
  • ibmcloud is cluster-network-interface-create my-cl-net --rip r134-2fbe71a8-126e-4a05-80ad-dad45df491a5 --subnet my-subnet 使用 RIP ID 建立叢集網路介面。
  • 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 ID 建立叢集網路介面。
  • 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 成員是否會自動刪除。 以下其中之一:truefalse
  • --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 成員是否會自動刪除。 以下其中之一:truefalse
  • --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 是叢集網路子網路保留 ips

列出所有叢集網路子網中已預留的 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 是 cluster-network-subnet-reserved-ip-create

建立叢集網路子網路保留 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 是 cluster-network-subnet-reserved-ip-update

更新集群網路。

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_p張power_p張
  • --name:配置群組的名稱。
  • --resource-group-id:資源群組的 ID。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是放置群組-刪除

刪除一個以上放置群組。

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。 此識別碼與 --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 is reservers

列出所有保留。

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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --all-resource-groups:查詢所有資源群組。
  • --zone:將集合篩選為「zone name」屬性與指定名稱完全相符的資源。
  • --profile-resource-type:設定檔的資源類型。 其中之一:instance_profilebare_metal_server_profile
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是預約-建立

建立保留。

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_yearthree_year
  • --profile:此預訂所使用的個人資料名稱。
  • --profile-resource-type:設定檔的資源類型。 其中之一:instance_profilebare_metal_server_profile
  • --zone:區域名稱。
  • --affinity-policy:此預留應使用的親和性政策。 其中之一:受限自動。(預設值:自動)。
  • --expiration-policy:當已承諾的使用期限屆滿時應適用的政策。 下列其中一項: releaserenew
  • --resource-group-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_yearthree_year
  • --expiration-policy:當已承諾的使用期限屆滿時應適用的政策。 下列其中一項: releaserenew
  • --profile:此預訂所使用的個人資料名稱。
  • --profile-resource-type:設定檔的資源類型。 其中之一:instance_profilebare_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:預訂的編號或名稱。
  • 預訂編號 2:預訂的編號或名稱。
  • --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 是 instance-templates

列出該區域中的所有範本。

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。 此識別碼與 --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 是 instance-template-create

建立實例範本。

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 在啟用或停用 meta 資料服務的情況下建立實例範本。
  • 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 建立具有 meta 資料服務配置的實例範本。
  • 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' 來提取子網路 ID 或名稱。
  • --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:此虛擬伺服器實例應使用的預留親和性政策。 如果儲存區不為空,則原則預設為手動。 如果已設定 placement_target,則該原則預設為停用。 在所有其他情況下,該原則預設為自動。 其中之一:停用手動自動
  • --reservation-affinity-pool, --res-pool:此虛擬伺服器實例可使用的預留資源之 ID、名稱或 CRN。
  • --user-data: data|@data-file. 將傳輸至虛擬伺服器執行個體的使用者資料。
  • --rip:現有預留 IP 的 ID 或名稱。
  • --address:要預留的 IP 位址,該位址在子網中不得已被預留。
  • --auto-delete:若設定為 true,當目標被刪除時,此保留 IP 將自動刪除。 下列其中一項: truefalse。(預設值: true)。
  • --ip-name:此保留 IP 的使用者自訂名稱。 名稱必須在保留 IP 所在的子網路內是唯一的。 以 ibm- 開頭的名稱,是預留給服務供應商自有資源使用的。
  • --allow-ip-spoofing:停用此介面上的來源與目的地檢查。 若為 false,則不允許在此介面上進行來源 IP 偽造。 下列其中一項: falsetrue
  • --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 盜用。 下列其中一項: falsetrue。(預設值: false)。
  • --pnac-vni-ein:啟用基礎架構 NAT(EIN)。 若屬實,VPC 基礎架構將針對 VNI 執行任何必要的 NAT 操作。 若要將 VNI 連接至實例,值必須為 true。 Floating_ips 不得有多個浮動 IP。 若為 false,則資料包將在傳入或傳出 VNI 時保持原樣,這使其能夠執行任何必要的 NAT 操作。 Allow_ip_spoofing 必須是 false。 只能連接至 resource_type 為 bare_metal_server_network_attachment 的目標。 下列其中一項: truefalse。(預設值: true)。
  • --pnac-vni-auto-delete:指示此與主要網路連接相關聯的虛擬網路介面,是否會在刪除目標時自動刪除。 下列其中一項: truefalse。(預設值: 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 是否會自動刪除。 下列其中一項: truefalse。(預設值: true)。
  • --pnac-vni-rip-name:此保留 IP 位址的名稱,用於綁定至與主要網路連接相關聯的虛擬網路介面。
  • --pnac-vni-sgs:用於虛擬網路介面的安全群組 ID 或名稱(以逗號分隔),這些安全群組須與主要網路連接相關聯。
  • --pnac-vni-psfm:此虛擬網路介面應使用的協定狀態過濾模式。 若設定為「自動」,則會根據虛擬網路介面的「target」資源類型,啟用或停用協定狀態封包過濾功能。 下列其中一項: autoenableddisabled。(預設值: auto)。
  • -- network-attachments: NETWORK_ATTACHMENTS_JSON |@NETWORK_ATTACHMENTS_JSON_FILE。 網路連接配置位於 JSON 或 JSON 檔案中。 有關資料結構,請參閱 API 文件 中的 network_attachments 屬性。 下列其中一項: NETWORK_ATTACHMENTS_JSON@NETWORK_ATTACHMENTS_JSON_FILE
  • --sgs:主要網路介面或主要網路連接的、以逗號分隔的安全群組 ID 或名稱。
  • --metadata-service, --ms:啟用或停用實例元數據服務。 以下其中之一:truefalse
  • --metadata-service-protocol, --msp:元數據服務端點的通訊協定。 只有在啟用 meta 資料服務時,才會套用通訊協定。 下列其中一項: http,****。(預設值: ** http**)。
  • --metadata-service-response-hop-limit, --msrhl:來自元數據服務的 IP 回應封包之跳數限制(IP 存活時間)。
  • --host-failure-policy:當運算主機發生故障時應執行的動作。 下列其中一項: restartstop。(預設值: restart)。
  • --confidential-compute-mode:此虛擬伺服器執行個體應使用的機密運算模式。 如果未指定,則使用設定檔中的預設機密計算模式。 其中一個:DisabledSGXTDX
  • --enable-secure-boot:指示此虛擬伺服器執行個體是否已啟用安全開機。 如果未指定,則使用設定檔中的預設安全開機模式。 以下其中之一:truefalse
  • --resource-group-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:此虛擬伺服器執行個體的每核心執行緒數。 若未指定,則使用設定檔的預設值。 下列其中一項: 12
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • - 互動的,-i:
  • -q,--quiet:抑制詳細輸出。

ibmcloud 實例範本建立覆寫來源範本

透過覆寫來源範本來建立實例範本。

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 透過使用保留親緣性儲存區 ID 置換來源範本來建立實例範本。
  • 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"}}}]' 透過覆寫來源範本,並在「boot-volume」和「volume-attachment」中設定允許使用,來建立一個實例範本。
  • 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:此虛擬伺服器實例應使用的預留親和性政策。 如果儲存區不為空,則原則預設為手動。 如果已設定 placement_target,則該原則預設為停用。 在所有其他情況下,該原則預設為自動。 其中之一:停用手動自動
  • --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 將自動刪除。 下列其中一項: truefalse。(預設值: true)。
  • --ip-name:此保留 IP 的使用者自訂名稱。 名稱必須在保留 IP 所在的子網路內是唯一的。 以 ibm- 開頭的名稱,是預留給服務供應商自有資源使用的。
  • --allow-ip-spoofing:停用此介面上的來源與目的地檢查。 若為 false,則不允許在此介面上進行來源 IP 偽造。 下列其中一項: falsetrue
  • --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 盜用。 下列其中一項: falsetrue。(預設值: false)。
  • --pnac-vni-ein:啟用基礎架構 NAT(EIN)。 若屬實,VPC 基礎架構將針對 VNI 執行任何必要的 NAT 操作。 若要將 VNI 連接至實例,值必須為 true。 Floating_ips 不得有多個浮動 IP。 若為 false,則資料包將在傳入或傳出 VNI 時保持原樣,這使其能夠執行任何必要的 NAT 操作。 Allow_ip_spoofing 必須是 false。 只能連接至 resource_type 為 bare_metal_server_network_attachment 的目標。 下列其中一項: truefalse。(預設值: true)。
  • --pnac-vni-auto-delete:指示此與主要網路連接相關聯的虛擬網路介面,是否會在刪除目標時自動刪除。 下列其中一項: truefalse。(預設值: 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 是否會自動刪除。 下列其中一項: truefalse。(預設值: true)。
  • --pnac-vni-rip-name:此保留 IP 位址的名稱,用於綁定至與主要網路連接相關聯的虛擬網路介面。
  • --pnac-vni-sgs:用於虛擬網路介面的安全群組 ID 或名稱(以逗號分隔),這些安全群組須與主要網路連接相關聯。
  • --pnac-vni-psfm:此虛擬網路介面應使用的協定狀態過濾模式。 若設定為「自動」,則會根據虛擬網路介面的「target」資源類型,啟用或停用協定狀態封包過濾功能。 下列其中一項: autoenableddisabled。(預設值: auto)。
  • -- network-attachments: NETWORK_ATTACHMENTS_JSON |@NETWORK_ATTACHMENTS_JSON_FILE。 網路連接配置位於 JSON 或 JSON 檔案中。 有關資料結構,請參閱 API 文件 中的 network_attachments 屬性。 下列其中一項: NETWORK_ATTACHMENTS_JSON@NETWORK_ATTACHMENTS_JSON_FILE
  • --sgs:主要網路介面或主要網路連接的、以逗號分隔的安全群組 ID 或名稱。
  • --metadata-service, --ms:啟用或停用實例元數據服務。 以下其中之一:truefalse
  • --metadata-service-protocol, --msp:元數據服務端點的通訊協定。 只有在啟用 meta 資料服務時,才會套用通訊協定。 下列其中一項: http,****。(預設值: ** http**)。
  • --metadata-service-response-hop-limit, --msrhl:來自元數據服務的 IP 回應封包之跳數限制(IP 存活時間)。
  • --host-failure-policy:當運算主機發生故障時應執行的動作。 下列其中一項: restartstop
  • --confidential-compute-mode:此虛擬伺服器執行個體應使用的機密運算模式。 如果未指定,則使用設定檔中的預設機密計算模式。 其中一個:DisabledSGXTDX
  • --enable-secure-boot:指示此虛擬伺服器執行個體是否已啟用安全開機。 如果未指定,則使用設定檔中的預設安全開機模式。 以下其中之一:truefalse
  • --resource-group-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:此虛擬伺服器執行個體的每核心執行緒數。 若未指定,則使用設定檔的預設值。 下列其中一項: 12
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 instance-template-update

更新實例範本。

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 是 instance-template-delete

刪除一個以上實例範本。

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 是 instance-groups

列出該區域中的所有實例群組。

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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --all-resource-groups:查詢所有資源群組。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 instance-group

檢視實例群組的詳細資訊。

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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 instance-group-update

更新實例群組。

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 是 instance-group-delete

刪除一個以上實例群組。

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-managers

列出某個實例群組的所有管理員。

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 是 instance-group-manager-create

為實例群組建立管理員。

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:實例群組管理員的類型。 下列其中一項: autoscalingscheduled。(預設值: autoscale)。
  • --aggregation-window:在進行評估前,用於彙總指標的時間視窗(以秒為單位)。 範圍 90-600。 可被 30 整除。(預設值: 90)。
  • --cooldown:縮放完成後,暫停後續縮放動作所需的時間(以秒為單位)。 範圍 120-3600。(預設值: 300)。
  • --max-members:受管實例群組中的成員最大數量。 範圍 1-1000。
  • --min-members:受管實例群組中的最小成員數。 範圍 1-1000。
  • --name:管理員的姓名。
  • --management-enabled:若設定為 false,管理員將不會對該實例群組進行操作。 下列其中一項: truefalse。(預設值: 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,管理員將不會對該實例群組進行操作。 以下其中之一:truefalse
  • --name:實例群組管理員的新名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 instance-group-manager-delete

刪除一個以上管理程式。

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.701Z2024-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.701Z2024-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 或姓名。
  • ACTION1:動作的 ID 或名稱。
  • ACTION2:動作的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 實例群組管理員策略

列出實例群組管理員的政策。

ibmcloud is instance-group-manager-policies INSTANCE_GROUP MANAGER [--output JSON] [-q, --quiet]

指令選項

  • INSTANCE_GROUP:實例群組的 ID 或名稱。
  • 經理:經理的 ID 或姓名。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 instance-group-manager-policy

檢視實例群組管理員政策的詳細資訊。

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 或姓名。
  • 政策 1:政策的 ID 或名稱。
  • POLICY2:政策編號或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 實例群組管理政策更新

更新實例群組管理員政策。

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 是 實例群組成員資格

檢視實例群組中某個成員的詳細資訊。

ibmcloud is instance-group-membership INSTANCE_GROUP MEMBER [--output JSON] [-q, --quiet]

指令選項

  • INSTANCE_GROUP:實例群組的 ID 或名稱。
  • 會員:會員編號或姓名。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 實例群組成員資格刪除

刪除實例群組的一個以上成員資格。

ibmcloud is instance-group-membership-delete INSTANCE_GROUP (MEMBER1 MEMBER2 ...) [--output JSON] [-f, --force] [-q, --quiet]

指令選項

  • INSTANCE_GROUP:實例群組的 ID 或名稱。
  • 成員1:會員編號或姓名。
  • 成員 2:會員編號或姓名。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 實例群組成員資格更新

更新實例群組的成員資格。

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 或名稱。
  • 會員:會員編號或姓名。
  • --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:篩選集合,僅保留具有指定連接狀態的卷。 下列其中一項: attachedunattachedunusable
  • -- encryption: 將集合過濾成具有指定加密類型的資源。下列其中一項: provider_manageduser_managed
  • --operating-system-family:將集合篩選為完全符合指定作業系統家族的資源。 此選項亦支援 null 及 not:null 這兩項值,用以將集合篩選為沒有作業系統或任何作業系統的資源。
  • --operating-system-architecture: null 將集合篩選為完全符合指定作業系統架構的資源。 此選項亦支援 null 及 not:null 這兩項值,用以將集合篩選為沒有作業系統或任何作業系統的資源。
  • --zone:將集合篩選為該區域中名稱與指定名稱完全相符的資源。
  • --resource-group-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

指令選項

  • :卷的識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是卷創建

建立磁區。

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 從 snapshot 中建立磁區
  • ibmcloud is volume-create my-volume general-purpose us-south-1 --snapshot my-snapshot --capacity 500 從具有容量的 snapshot 中建立磁區
  • 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:區域名稱。
  • --容量:卷的容量(以千兆位元組為單位)。 範圍 10-16000 (適用於自訂及一般用途設定檔磁區)、10-9600 (適用於 5iops-tier 設定檔磁區)、10-4800 (適用於 10iops-tier 設定檔磁區)。 提供來源快照後,容量值必須至少等於該快照的 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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --tags:此資源的標籤。
  • --bandwidth:該卷的最大頻寬(單位為百萬位元每秒)。 若要指定此屬性,磁碟區 storage_generation 必須是 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:卷的識別碼或名稱。
  • 卷 2:卷的識別碼或名稱。
  • --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 是 volume-profile

檢視成交量曲線圖的詳細資訊。

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

指令選項

  • PROFILE_NAME:設定檔名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 volume-update

更新磁區。

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

指令選項

  • :卷的識別碼或名稱。
  • --name:卷的新名稱。
  • --容量:卷的容量(以千兆位元組為單位)。 啟動磁區的容量可擴充至 250;自訂及通用設定檔磁區的容量可擴充至 16000; 5iops-tier 設定檔磁區的容量可擴充至 9,600,10iops-tier 設定檔磁區。 大小只能增加,不能減小。
  • --profile:設定檔名稱。 此磁區必須連接為資料磁區,並在 IOPS 層級之間切換。 不支援將預先定義的 IOPS 層級設定檔變更為自訂設定檔。 不支援將自訂設定檔變更為預先定義的 IOPS 層級設定檔。
  • --iops:卷的每秒輸入與輸出操作次數,此參數僅適用於自訂設定檔卷。 有關 IOPS 範圍的資訊,請參閱《 將軟體導入您的帳戶 》。 此磁碟區必須以資料磁碟區的形式掛載。
  • --bandwidth:該卷的最大頻寬(單位為百萬位元每秒)。 若要指定此屬性,磁碟區 storage_generation 必須是 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

指令選項

  • :卷的識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 volume-job-create

為磁區建立一個工作。

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

指令選項

  • :卷的識別碼或名稱。
  • --profile:設定檔名稱。
  • --name:卷式工作的名稱。
  • --bandwidth:該卷的最大頻寬(單位為百萬位元每秒)。 若要指定此屬性,磁碟區 storage_generation 必須是 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

指令選項

  • :卷的識別碼或名稱。
  • --job:卷工作識別碼。
  • --name:卷式工作的名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 volume-job-delete

刪除一個或多個磁區工作。

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

指令選項

  • :卷的識別碼或名稱。
  • --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

指令選項

  • :卷的識別碼或名稱。
  • --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

指令選項

  • :卷的識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 volume-job-cancel

取消已佇列或正在執行的磁區工作。

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

指令選項

  • :卷的識別碼或名稱。
  • --job:卷工作識別碼。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

Snapshot

下節提供 Snapshot 的 CLI 指令相關資訊。

ibmcloud 是快照

列出所有 Snapshot。

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。 此識別碼與 --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 是快照-建立

從卷建立快照。

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:用於封裝快照資料加密金鑰的根金鑰。 如果未指定,則會使用具有相同來源磁區之最新 Snapshot 中的 encryption_key。 如果此 Snapshot 是來源磁區的第一個 Snapshot,則會使用來源磁區中的 encryption_key。
  • --name:快照的新名稱。
  • --clone-zones:以逗號分隔的區域名稱,用於指定快照複本應存放的區域。 已在複製的區域中啟用 Snapshot 快速還原。
  • --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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --tags:此資源的標籤。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是快照-刪除

刪除一個以上 Snapshot。

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。

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 是快照複製

檢視區域快照克隆的詳細資訊。

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:此快照克隆所屬的區域名稱。 已在複製的區域中啟用 Snapshot 快速還原。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是快照-clone-創建

建立區域快照克隆。

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:您希望快照克隆所在的區域名稱。 已在複製的區域中啟用 Snapshot 快速還原。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是快照-clone-刪除

刪除一個以上區域中的區域 Snapshot 複本。

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 是快照複製品

列出所有區域快照的複本。

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 是 snapshot-instance-profiles

列出與 Snapshot 相容的實例設定檔。

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 一致性群組。

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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --all-resource-groups:查詢所有資源群組。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是快照一致性群組

檢視 Snapshot 一致性群組的詳細資料。

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 一致性群組。

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_JSON@SNAPSHOTS_JSON_FILE
  • --source-volume:來源卷的 ID、名稱或 CRN。
  • --snapshot-name:此快照的名稱。
  • --user-tags:與此快照相關聯的使用者標籤。
  • --name:快照一致性群組的名稱。
  • --delete-snapshot-on-delete:指定刪除快照一致性群組時,是否同時刪除該群組中的快照。 下列其中一項: falsetrue。(預設值: true)。
  • --resource-group-id:資源群組的 ID。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是快照一致性群組更新

更新 Snapshot 一致性群組。

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:指定刪除快照一致性群組時,是否同時刪除該群組中的快照。 下列其中一項: falsetrue。(預設值: true)。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 為快照一致性群組刪除

刪除一個以上 Snapshot 一致性群組。

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

指令選項

  • 共用:檔案共用的識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是分享-建立

建立容量範圍在 10 GB 至 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"}}}]'

指令選項

  • --允許的傳輸加密模式,--atem:允許的傳輸加密模式。 一個或多個以逗號分隔的值:stunnel、ipsec、none。
  • --name:此檔案共用資料夾的自訂名稱。
  • --user-tags:此資源的標籤。
  • --zone:區域名稱。
  • --snapshot:此檔案共用資料夾的來源快照的 ID、名稱或 CRN。
  • --share:檔案共用資源的 ID 或名稱。
  • --bandwidth:檔案共用資料夾的最大頻寬(單位為百萬位元每秒)。
  • --size:檔案共用空間的大小會向上取整至最接近的 1 GB。
  • --profile:檔案共用所使用的設定檔。 所有建立的檔案共用都以高效能 dp2 設定檔為基礎。
  • --encryption-key:用於封裝該共享資料加密金鑰的根金鑰。 如果未指定,則共用的加密類型是 provider_managed。
  • --initial-owner-gid:檔案共用在建立時的初始擁有者群組識別碼。 擁有者的後續變更必須由裝載檔案共用的虛擬伺服器實例執行。
  • --initial-owner-uid:檔案共用在建立時的初始擁有者使用者識別碼。 擁有者的後續變更必須由裝載檔案共用的虛擬伺服器實例執行。
  • --iops:檔案共用資源每秒的最大輸入/輸出操作效能頻寬。 此最大值僅適用於自訂設定檔檔案共用。 有關 IOPS 範圍,請參閱「定義的效能配置檔」。
  • --resource-group-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-加密-模式,--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 是分享-刪除

刪除一個以上檔案共用。 您無法復原此刪除作業。 如需更多資訊,請參閱 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:檔案共用資源的識別碼或名稱。
  • SHARE2:檔案共用資源的識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 share-profile

檢視檔案共用設定檔的詳細資料,包括容量、IOPS、頻寬、允許的傳輸加密模式、可用性模式和允許的存取通訊協定。 如需更多資訊,請參閱 CLI 文件

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

指令選項

  • PROFILE_NAME:檔案共用設定檔的名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 share-profiles

列出地區中的所有檔案共用設定檔。 如需更多資訊,請參閱 VPC 文件

ibmcloud is share-profiles [--output JSON] [-q, --quiet]

指令選項

  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是分享-更新

編輯檔案共用的名稱、大小、設定檔、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

指令選項

  • 共用:檔案共用的識別碼或名稱。
  • --name:檔案共用的新名稱。
  • --size:檔案共用空間的大小,四捨五入至最接近的 1 GB。 大小只能增加,不能減小。
  • --allowed-access-protocols、--aacp:此共用資料夾允許使用的存取協定。 以下項目之一或多個,以逗號分隔:nfs4。
  • --bandwidth:檔案共用資料夾的最大頻寬(單位為百萬位元每秒)。
  • --replication-cron-spec:檔案共用複製排程的 cron 規格。
  • --iops:檔案共用資源每秒的最大輸入/輸出操作效能頻寬。 此最大值僅適用於自訂設定檔檔案共用。 有關 IOPS 範圍,請參閱「定義的效能配置檔」。
  • --profile:檔案共用所使用的設定檔。
  • --user-tags:此資源的標籤。
  • --access-control-mode:共用資源的存取控制模式。(預設值:security_group )。
  • --允許的傳輸加密模式,--atem:允許的傳輸加密模式。 一個或多個以逗號分隔的值:stunnel、ipsec、none。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud is shars

列出地區中的所有檔案共用。 如需更多資訊,請參閱 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:將集合篩選為具有指定複製角色的檔案共用。 下列其中一項: nonereplicasource
  • --resource-group-id:資源群組的 ID。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --all-resource-groups:查詢所有資源群組。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 share-replica-create

在相同地理位置的另一個區域中,建立現有區域檔案共用的唯讀抄本。 如需更多資訊,請參閱 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。 指定的檔案共用不得已有抄本,且不得是抄本。
  • --允許的傳輸加密模式,--atem:允許的傳輸加密模式。 一個或多個以逗號分隔的值:stunnel、ipsec、none。
  • --resource-group-id:資源群組的 ID。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是共用複製故障移轉器

當原始檔案共用無法使用時,可以失效接手到抄本檔案共用,以確保資料仍然可用。 如需更多資訊,請參閱 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:當故障轉移請求被接受,但無法執行或超時時,應採取的動作。 下列其中一項: failsplit
  • --timeout:故障轉移的超時時間(以秒為單位)。 逾時下限為 300 秒,上限為 3600 秒。 如果達到逾時,則會觸發 fallback_policy。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 share-replica-split

將來源檔案共用從抄本共用分離,使兩者之間不再同步資料。 兩種共用都會繼續獨立存在。 如需更多資訊,請參閱 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 是共用-掛載-目標

檢視檔案共用裝載目標的詳細資料,包括其 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

指令選項

  • 共用:檔案共用的識別碼或名稱。
  • MOUNT_TARGET:檔案共用掛載目標的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是共用-掛載-目標

列出檔案共用的所有裝載目標。 如需更多資訊,請參閱 VPC 文件

ibmcloud is share-mount-targets SHARE [--output JSON] [-q, --quiet]

指令範例

  • ibmcloud is share-mount-targets my-file-share-3

指令選項

  • 共用:檔案共用的識別碼或名稱。
  • --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

指令選項

  • 共用:檔案共用的識別碼或名稱。
  • MOUNT_TARGET1:檔案共用掛載目標的 ID 或名稱。
  • MOUNT_TARGET2:檔案共用掛載目標的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 share-mount-target-update

編輯檔案共用裝載目標的名稱。 如需更多資訊,請參閱 VPC 文件

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

指令選項

  • 共用:檔案共用的識別碼或名稱。
  • MOUNT_TARGET:檔案共用掛載目標的 ID 或名稱。
  • --name:檔案共用的新名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 share-mount-target-create

建立裝載目標,將檔案共用連接到相同地區中的虛擬伺服器實例或 Kubernetes 叢集。 如需更多資訊,請參閱 VPC 文件

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

指令選項

  • 共用:檔案共用的識別碼或名稱。
  • --name:此檔案共用掛載目標的自訂名稱。
    • -transit-encryption:此共用掛載目標的傳輸加密模式。none:傳輸中不加密,ipsec:使用實例身分證書進行傳輸加密,stunnel:ipsec 和 stunnel 適用於只有 access-control-mode security_group 的共用。 其中之一:stunnelipsec無。
  • --access-protocol:用於存取此共用掛載目標所使用的通訊協定。 之一:nfs4.
  • --vni:虛擬網路介面的 ID 或名稱。
  • --vni-auto-delete:指示當目標被刪除時,此虛擬網路介面是否會自動刪除。 下列其中一項: truefalse。(預設值: true)。
  • --protocol-state-filtering-mode: auto,--psfm auto 此虛擬網路介面應使用的協定狀態過濾模式。 若設定為「自動」,則會根據虛擬網路介面的「target」資源類型,啟用或停用協定狀態封包過濾功能。 下列其中一項: autoenableddisabled。(預設值: 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。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --vpc:此共用掛載目標允許將檔案共用掛載至該 VPC 的 VPC 識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是 sharing-accessor-bindings

列出所有鏈結至原始共用的存取元共用連結。 如需更多資訊,請參閱 VPC 文件

ibmcloud is share-accessor-bindings SHARE [--output JSON] [-q, --quiet]

指令範例

  • ibmcloud is share-accessor-bindings r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2

指令選項

  • 共用:檔案共用的識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是共用存取器-綁定

檢視特定存取元共用連結的詳細資料,包括其 href、存取元等。 如需更多資訊,請參閱 VPC 文件

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

指令選項

  • 共用:檔案共用的識別碼或名稱。
  • ACCESSOR_BINDING:檔案共用存取器綁定的識別碼。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是共用存取器-綁定-刪除

刪除一個以上的檔案共用存取元連結。 這個動作無法復原。 如需更多資訊,請參閱 VPC 文件

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

指令選項

  • 共用:檔案共用的識別碼或名稱。
  • ACCESSOR_BINDING:檔案共用存取器綁定的識別碼。
  • --force、-f:不經確認即強制執行該操作。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是共享快照

檢視檔案共用 Snapshot 的詳細資料,包括其指紋、大小下限等。 如需更多資訊,請參閱 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 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是共享快照

列出地區內或特定檔案共用的所有 Snapshot。 如需更多資訊,請參閱 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 是共享-快照-刪除

刪除一個或多個檔案共用 Snapshot。 您無法復原此刪除作業。 如需更多資訊,請參閱 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

指令選項

  • 共用:檔案共用的識別碼或名稱。
  • 快照 1:檔案共用快照的識別碼或名稱。
  • 快照 2:檔案共用快照的識別碼或名稱。
  • --force、-f:不經確認即強制執行該操作。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是共享快照更新

編輯檔案共用 Snapshot 的使用者標籤。 如需更多資訊,請參閱 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 或名稱。
  • --user-tags:與此檔案共享快照相關聯的使用者標籤。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是共享快照創建

建立檔案共用 Snapshot,以擷取特定日期和時間的共用資料。 如需更多資訊,請參閱 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

指令選項

  • 共用:檔案共用的識別碼或名稱。
  • --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。 此識別碼與 --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_volumesboot_volumeboot_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:指示是否將來源使用者標籤複製到所建立的資源中。 以下其中之一:truefalse
  • --plan-cron-spec:備份排程的 cron 規格。
  • --plan-delete-after:每個備份建立後保留的天數上限。(預設值:30 )。
  • --plan-delete-over-count: 要保留的最近備份數目上限。 如果未指定,則會保留所有備份。
  • --plan-clone-policy-max-snapshots: 保留複本的最近 Snapshot 數上限 (每個來源)。(預設值: 5)。
  • --plan-clone-policy-zones:此備份政策計畫用來建立快照複本的區域。
  • --範圍:企業帳戶的 CRN。
  • --resource-group-id:資源群組的 ID。 此識別碼與 --resource-group-name 互斥。
  • --resource-group-name:資源群組的名稱。 此名稱與 --resource-group-id 互斥。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是備份-政策-刪除

刪除一個以上的備份原則。

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 或名稱。
  • POLICY2:備份政策的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是備份-政策-更新

更新備份原則。

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_volumesboot_volumeboot_volume、data_volumes。(預設值: boot_volume,data_volumes)。
  • --match-tags:此備份政策所適用的使用者標籤。
  • --name:備份政策的新名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是備份政策

檢視備份政策的詳細資訊。

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 是備份政策計劃

檢視備份政策方案的詳細資訊。

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:備份政策計畫的識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是備份政策計劃

列出備份政策的所有方案。

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 備份策略計劃建立

制定備份政策計畫。

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:指示是否將來源使用者標籤複製到所建立的資源中。 以下其中之一:truefalse
  • --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 備份政策計劃刪除

刪除一個以上的備份原則計劃。

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:備份政策計畫的識別碼或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • --force、-f:不經確認即強制執行該操作。
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是備份-政策-計劃-更新

更新備份政策計畫。

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:備份政策計畫的識別碼或名稱。
  • --name:備份政策方案的新名稱。
  • --active:表示該方案是否處於有效狀態。
  • --attach-tags:要附加至此計畫所建立的每個資源上的使用者標籤。
  • --copy-tags:指示是否將來源使用者標籤複製到所建立的資源中。 以下其中之一:truefalse
  • --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 是備份政策工作

列出該備份政策的所有工作。

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 或名稱。
  • --來源:來源卷的 ID 或名稱。 僅當來源存在於 VPC 內時,才能使用來源名稱。
  • --snapshots:目標快照的 ID、名稱或 CRN。 不支援這三種類型的組合。 僅支援傳遞這三種類型之一。
  • --status:備份政策工作項的狀態。 下列其中一項: failedrunningsucceeded
  • --plan:備份政策計畫的 ID 或名稱。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。

ibmcloud 是備份政策工作

檢視備份政策工作項目的詳細資訊。

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:備份政策工作項的識別碼。
  • --output:指定輸出格式,僅支援 JSON。 下列其中一項: JSON
  • -q,--quiet:抑制詳細輸出。