綁定、解除綁定及移動公用位址範圍

您可以使用主控台、CLI、API 和 Terraform 將公用位址範圍綁定、解除綁定和移動到可用性區域中的 VPC。

開始之前

在綁定、解除綁定或移動公共位址範圍之前，請先檢視以下要求與注意事項：

  • 請務必檢閱公共廣播範圍的 規劃注意事項。
  • 公共位址範圍的綁定必須包括 VPC 和可用性區域。
  • 使用公共位址範圍時，必須在將該位址範圍綁定後，配置入站路由，以將流量導向至適當的資源。 將位址範圍綁定至 VPC 並不會自動將流量路由至該資源。

在主控台中綁定、解除綁定和移動公共位址範圍

您可以在主控台中將公用位址範圍綁定、解除綁定或移動到可用性區域中的 VPC。

在主控台中綁定公佈位址範圍

若要在 IBM Cloud® 主控台綁定公共位址範圍，請遵循下列步驟：

  1. 從 IBM Cloud 主控台，選擇導覽功能表 功能表圖示，然後按一下基礎結構 VPC 圖示 > 網路 > 公共位址範圍。 出現 Public Address Ranges for VPC 頁面。
  2. 反白顯示表中的位址範圍行，然後按一下 「操作」 功能表中的 「綁定」操作圖示。
  3. 在「綁定公用位址範圍」頁面上，選擇您要將該位址範圍綁定的 VPC 及其對應的可用區域。
  4. 按一下綁定，將公用位址範圍綁定到 VPC。

在主控台中解除綁定公共位址範圍

若要在 IBM Cloud 主控台中解除綁定公共位址範圍，請遵循下列步驟：

公共位址解除綁定後，仍會保留並可再次綁定。

  1. 從 IBM Cloud 主控台，選擇導覽功能表 功能表圖示，然後按一下基礎結構 VPC 圖示 > 網路 > 公共位址範圍。 出現 Public Address Ranges for VPC 頁面。
  2. 反白顯示表中位址範圍的行，然後按一下動作功能表 動作圖示 中的解除綁定。
  3. 按一下解除綁定，確認您要從 VPC 解除綁定此位址範圍。

在主控台中移動公共位址範圍

如果公用位址範圍綁定到可用性區域中的 VPC，您可以更新並將其綁定（移動）到不同的 VPC 和可用性區域。 公共位址範圍會自動從其 VPC 和可用性區域解除綁定，然後綁定到新指定的 VPC 和可用性區域。

您不需要先從原始目標解除位址範圍的綁定。

若要在主控台中移動公共位址範圍，請遵循下列步驟：

  1. 從 IBM Cloud 主控台，選擇導覽功能表 功能表圖示，然後按一下基礎結構 VPC 圖示 > 網路 > 公共位址範圍。 出現 Public Address Ranges for VPC 頁面。
  2. 反白顯示表中位址範圍的行，然後按一下動作功能表 動作圖示 中的編輯。
  3. 在「編輯公共位址範圍」頁面上，選取您要將該位址範圍移入的 VPC 及其可用區域。
  4. 按一下儲存，將公用位址範圍綁定到新 VPC。

從 CLI 綁定、解除綁定及移動公用位址範圍

若要從命令列綁定、解除綁定或移動保留的 IP 位址，請遵循下列步驟：

  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-update PUBLIC_ADDRESS_RANGE [--name NAME] ([--vpc VPC --zone ZONE] | [--reset-target]) [--output JSON] [-q, --quiet]

    其中：

    PUBLIC_ADDRESS_RANGE
    要更新的公共位址範圍的 ID 或名稱。
    --name
    公用位址範圍的新識別碼，如果要重新命名。
    --vpc
    您要將公共位址範圍附加到的 VPC。 指定 --vpc 選項時，必須使用 --zone。
    --zone
    您希望此公用位址範圍所處的區域。 指定 --zone 選項時，必須使用 --vpc。
    --reset-target
    解除對一個公共位址區間的綁定。
    -f, --force
    強制執行此作業，無需確認。
    --output
    輸出格式僅支援 JSON。 之一：JSON.
    -q, --quiet
    禁止冗長輸出。

指令範例

如果公共位址沒有綁定到 VPC，您可以將其綁定到任何可用性區域中的 VPC：

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

從 VPC 解除綁定公用位址範圍，使其保持未綁定狀態：

ibmcloud is public-address-range-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --name public-address-range-1 --reset-target

將公用位址範圍從一個 VPC 移動到另一個 VPC：

ibmcloud is public-address-range-update r006-81222eee-b3e0-4dc3-b429-aee9e5c0abf2 --vpc cli-test-vpc --zone us-south-2

使用 API 綁定、解除綁定及移動公用位址範圍

若要使用 API 綁定、解除綁定或移動公用位址範圍，請遵循下列步驟：

  1. 設定您的 API 環境。
  2. 將下列值儲存在變數中，以便在 API 指令中使用：

version (字串)：API 版本，格式為. YYYY-MM-DD

  1. 啟動所有變數後，選擇下列其中一項動作：

    • 將公用位址範圍綁定到特定 VPC：
         curl -X PATCH \
            "$vpc_api_endpoint/v1/public_address_ranges/$par_id?version=$api_version&generation=2" \
            -H "Authorization: Bearer $iam_token" \
            -H "Content-Type: application/json" \
            -d '{
                  "target": {
                     "vpc": {
                        "id": "r006-4727d842-f94f-4a2d-824a-9bc9b02c523b"
                     },
                     "zone": {
                        "name": "us-south-2"
                     }
                  }
               }'

  • 從特定 VPC 解除綁定公用位址範圍：

      curl -X PATCH \
            "$vpc_api_endpoint/v1/public_address_ranges/$par_id?version=$api_version&generation=2" \
            -H "Authorization: Bearer $iam_token" \
            -H "Content-Type: application/json" \
            -d '{
                  "target": null
               }'
   ```
   公共位址解除綁定後，仍會保留並可再次綁定。
   {: note}

* 將公用位址範圍從一個 VPC 移動到另一個 VPC：

```sh {: pre}
      curl -X PATCH \
            "$vpc_api_endpoint/v1/public_address_ranges/$par_id?version=$api_version&generation=2" \
            -H "Authorization: Bearer $iam_token" \
            -H "Content-Type: application/json" \
            -d '{
                  "target": {
                     "vpc": {
                        "id": "r006-9999aaaa-bbbb-cccc-dddd-1234567890ab"
                     },
                     "zone": {
                        "name": "us-south-3"
                     }
                  }
               }'
   ```
## 使用 Terraform 綁定、解除綁定及移動公共位址範圍 {: #par-bind-unbind-terraform terraform}

要使用 Terraform 綁定、解除綁定或移動公共位址範圍，請使用以下範例：

```terraform {: codeblock}
resource "ibm_is_public_address_range" "public_address_range_instance" {
 ipv4_address_count = "16"
name = "example-public-address-range"
resource_group{
   id = "11caaa983d9c4beb82690daab08717e9"
}
target{
 vpc {
   id = ibm_is_vpc.testacc_vpc.id
 }
 zone {
   name = "us-south-3"
 }
}
}

相關鏈結