建立公用位址範圍

您可以透過定義其大小，並可選擇指定要與之關聯的 VPC（該 VPC 須位於該帳戶內的任何可用區域中），來建立一個公共位址範圍。

如果 VPC 在與公共位址範圍綁定時被刪除，則該位址範圍會繼續存在，並可稍後與任何可用性區域中的不同 VPC 綁定。

您可以使用主控台、CLI、API 和 Terraform 建立公用位址範圍。

開始之前

請務必檢閱公共廣播範圍的 規劃注意事項。

在主控台中建立公用位址範圍

若要在 IBM Cloud 主控台中建立公用位址範圍，請遵循下列步驟：

  1. 從 IBM Cloud 主控台，選擇導覽功能表 功能表圖示，然後按一下基礎結構 VPC 圖示 > 網路 > 公共位址範圍。 出現 Public Address Ranges for VPC 頁面。

  2. 按一下「建立」以進入配置頁面。

  3. 在「位置」區段中，請指定您希望建立公開位址範圍的區域。

  4. 在「詳細資料」區段中，請填寫以下資訊：

    • 大小：選擇位址範圍的大小（IP 位址數量）。 您可以從 1、2、4、8 或 16 個 IP 中選擇要包含在區塊中的 IP。

      建立公用位址範圍後，就無法變更其大小。

    • 名稱：（可選）：為公共位址範圍輸入名稱，例如 my-public-address-range。

    • 資源群組：選取公共位址範圍的資源群組。

      建立公共位址範圍後，就無法變更資源群組。

    • 標籤：(可選) 新增標籤，有助於您整理和查找資源。 您隨時可以在稍後再新增更多標籤。 如需相關資訊，請參閱使用標籤。

  5. （可選）若要將您的公共位址範圍綁定至現有的 VPC，請將「綁定」開關切換至「開啟」。 然後選擇要綁定的 VPC 和可用性區域。

    您可以將公用位址範圍綁定到帳戶中已存在的單一可用性區域中的任何 VPC。 您也可以稍後將位址範圍綁定到 VPC。 如需詳細資訊，請參閱 綁定公用位址範圍。

  6. 按一下建立。 請求使用公共位址範圍。

在「VPC 的公用位址範圍」頁面上，您的位址範圍現在會顯示在表格中。 對於 IBM Cloud 服務，您的公共位址範圍的狀態會從 Updating 變更為 Stable。

從 CLI 建立公用位址範圍

若要從命令列建立公用位址範圍，請遵循下列步驟：

  1. 設定您的 CLI 環境。

  2. 登入 CLI 環境。 輸入密碼後，系統會提示您要使用的帳戶和區域：

    ibmcloud login --sso

  3. 啟用以下功能標誌：

    export IBMCLOUD_IS_FEATURE_PUBLIC_ADDRESS_RANGE=true

    當 IBM Cloud 命令列介面及其外掛程式有更新時，您將在命令列中收到通知。 保持 CLI 更新以存取最新的指令非常重要。 若要檢查所有已安裝外掛程式的目前版本，請執行 ibmcloud plugin list.

  4. 執行下列指令：

    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]

    其中：

    --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
    禁止冗長輸出。

指令範例

建立一個名為 public-address-range-1 的公共位址範圍，位址數量為 8：

ibmcloud is public-address-range-create --name public-address-range-1 --ipv4-address-count 8

建立一個名為 public-address-range-2 的公共位址範圍，位址數量為 4，並建立一個名為 Default 的資源群組：

ibmcloud is public-address-range-create --name public-address-range-2 --ipv4-address-count 4 --resource-group-name Default

建立一個名為 public-address-range-3 的公共位址範圍，位址數量為 8，綁定到 us-south-1 區域中的 VPC cli-test-vpc，資源群組 ID 為 72b27b5c-f4b0-48bb-b954-5becc7c1dcb3：

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

使用 API 建立公共位址範圍

開始之前，請先設定您的 API 環境。

選取下列其中一個選項：

  • 從 IBM 管理的 IP 位址中建立一個公共位址範圍，並將其綁定至 VPC：

    curl -sX POST \
"$vpc_api_endpoint/v1/public_address_ranges?version=$api_version&generation=2" \
-H "Authorization: Bearer $iam_token" \
-H "Content-Type: application/json" \
-d '{
      "ipv4_address_count": 8,
      "name": "my-public-address-range",
      "target": {
         "vpc": {
            "id": "r006-4727d842-f94f-4a2d-824a-9bc9b02c523b"
         },
         "zone": {
            "name": "us-south-1"
         }
      }
   }'

  • 從 IBM 管理的 IP 位址中建立一個未綁定的公共位址範圍：

    curl -sX POST \
"$vpc_api_endpoint/v1/public_address_ranges?version=$api_version&generation=2" \
-H "Authorization: Bearer $iam_token" \
-H "Content-Type: application/json" \
-d '{
      "ipv4_address_count": 8,
      "name": "my-public-address-range"
   }'

如果需要變更位址範圍或資源群組的大小，必須刪除並重 新建立位址範圍。

使用 Terraform 建立公共位址範圍

要使用 Terraform 建立公共位址範圍，請使用以下範例：

resource "ibm_is_public_address_range" "example" {
  ipv4_address_count = 8
  name               = "my-public-address-range"
  resource_group {
    id = data.ibm_resource_group.example.id
  }
  target {
    vpc {
      id = ibm_is_vpc.example.id
    }
    zone {
      name = "us-south-1"
    }
  }
}

相關鏈結