重新命名 VM

建立虛擬機器 (VM) 執行個體時，您必須指定名稱。建立 VM 後，您可以選擇重新命名。變更 VM 名稱可能在下列情況下有所助益：

  • 以便更準確地呈現在 VM 上執行的工作負載。
  • 如要參照在 VM 上執行的作業系統。
  • 遵循貴機構規定的命名慣例。

VM 統一資源 ID (URI)

變更 VM 名稱可能會影響您的專案。您可以使用 URI 參照 VM 資源，而非使用名稱參照，因為 URI 是永久的。URI 的格式如下：

projects/PROJECT_ID/zones/ZONE/instances/VM_ID

URI 包含下列值：

  • PROJECT_ID：VM 所在專案的 ID。

  • ZONE：VM 所在區域。

  • VM_ID：現有 VM 的 ID。如要查看現有 VM 的 ID，請查看 VM 的詳細資料，然後查看 id 欄位的值。

定價

重新命名虛擬機不會影響您的帳單金額。此外，由於帳單會根據 VM 的 SKU 顯示 VM，而非名稱，因此您不會在帳單中看到 VM 的名稱。

限制

重新命名虛擬機器時，下列限制會生效：

  • 自動命名的資源：

    • 重新命名 VM 時，系統不會更新任何以原始 VM 名稱為依據的資源名稱。舉例來說，建立 VM 時，開機磁碟的名稱會與 VM 名稱相同。如果您重新命名 VM，啟動磁碟的名稱不會變更。

  • DHCP 伺服器：

    • 重新命名 VM 後，DHCP 伺服器會使用更新後的主機名稱回應 DHCP 要求，格式為全球 DNS 的 HOSTNAME.c.PROJECT_ID.internal，區域 DNS 的 HOSTNAME.ZONE.c.PROJECT_ID.internal。詳情請參閱「內部 DNS 名稱的類型」。

  • Trusted Cloud 控制台：

    • 您必須重新整理瀏覽器， Trusted Cloud 主控台才能更新 VM 名稱。

  • 主機名稱：

    • 變更 Linux 執行個體名稱時，主機名稱會隨之變更。在 Windows 上，即使重新啟動執行個體，主機名稱也不會更新。

    • 具有自訂主機名稱的 VM 不會更新。

    • 直接在主機上變更主機名稱，不會影響 VM 資源的名稱。

  • 代管執行個體群組：

    • 您無法重新命名代管執行個體群組 (MIG) 中的執行個體，因為這些執行個體會自動且不可逆地從無狀態 MIG 的 base instance name 屬性繼承名稱。

  • 命名慣例：

    • 您無法將 VM 重新命名為專案中其他 VM 已使用的名稱。

    • VM 名稱必須遵循資源命名慣例。

  • VM 狀態：

    • 您只能重新命名處於 TERMINATED 狀態的 VM，因此請先停止執行個體再重新命名。舉例來說，您無法重新命名處於 SUSPENDED 狀態的 VM。

事前準備

  • 請查看並視需要更新下列項目：
    • Cloud Monitoring 群組、圖表和快訊： 監控會比對字串，因此當您重新命名 VM 時，這些字串不會更新。如果您重新命名 VM，請更新監控規則，在報表中加入重新命名的 VM。
    • 主控台網址：重新命名 VM 會變更其主控台網址。如果您重新命名 VM，請務必更新連結，例如參照 VM 控制台網址的瀏覽器書籤。
    • Identity and Access Management (IAM) 條件式角色繫結：條件式角色繫結可針對資源名稱授予權限。舉例來說，如果 VM 名稱以特定字串開頭，IAM 可能會將角色授予使用者。變更 VM 名稱時，系統不會更新這些繫結，因此您變更前置字元名稱適用的 VM 集合時，使用者對 VM 資源的存取權可能會受到影響。如果您重新命名 VM，請更新這些繫結。
    • 內部 DNS 服務快取：內部 DNS 服務會將內部 DNS 名稱指派給 VM，其中主機名稱的格式為 HOSTNAME.c.PROJECT_ID.internal (全域 DNS) 和 HOSTNAME.ZONE.c.PROJECT_ID.internal (區域 DNS)。變更 VM 名稱後，這些主機名稱也會變更。接著，內部 DNS 服務會開始解析新主機名稱，而對先前 DNS 名稱的要求會失敗。如果您重新命名 VM，可能需要更新 DNS 快取，才能更新主機名稱。如要進一步瞭解全域 DNS 和區域 DNS 主機名稱，請參閱「內部 DNS 名稱的類型」。
    • 中繼資料查詢： 重新命名 VM 後，中繼資料伺服器會回報新名稱。如果您重新命名 VM，請更新所有查詢中繼資料伺服器的指令碼或程式，讓這些指令碼或程式查詢 VM 的新名稱。
    • 限制外部 IP 位址的機構政策：針對具有外部 IP 位址的 VM 限制，參照 VM 名稱。重新命名 VM 時，系統不會更新這項限制。如果您變更 VM 名稱，請使用 VM 的新名稱更新外部 IP 機構政策。
    • SQL Server 主機名稱：如果您重新命名主機 SQL Server 的 VM，則必須更新 SQL Server VM 名稱。詳情請參閱「為代管 SQL Server 獨立執行個體的電腦重新命名」。
  • 如果尚未設定，請先設定驗證機制。「驗證」是指驗證身分，以便存取 Trusted Cloud by S3NS 服務和 API 的程序。如要從本機開發環境執行程式碼或範例，請選取下列任一選項，以便對 Compute Engine 進行驗證：

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.

    gcloud

    1. After installing the Google Cloud CLI, sign in to the gcloud CLI with your federated identity and then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      如要在本機開發環境中使用本頁的 REST API 範例，請使用您提供給 gcloud CLI 的憑證。

        After installing the Google Cloud CLI, sign in to the gcloud CLI with your federated identity and then initialize it by running the following command: 

        gcloud init

      詳情請參閱 Trusted Cloud 驗證說明文件中的「驗證以使用 REST」。

必要的角色

如要取得重新命名虛擬機器人所需的權限，請要求管理員為您授予專案的 Compute 執行個體管理員 (v1) (roles/compute.instanceAdmin.v1) 身分與存取權管理角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和機構的存取權」。

這個預先定義的角色包含 compute.instances.setName 權限，這是重新命名虛擬機時所需的權限。

您或許還可透過自訂角色或其他預先定義的角色取得此權限。

重新命名 VM

您只能重新命名處於 TERMINATED 狀態的已停止 VM。

主控台

如要重新命名 VM，請按照下列步驟操作：

  1. 前往 Trusted Cloud 控制台的「VM instances」(VM 執行個體) 頁面。

    前往 VM 執行個體

  2. 在「Name」欄中，按一下 VM 名稱。

  3. 如果您尚未停止 VM，請按一下 「Stop」 停止 VM。如果沒有「停止」選項，請依序點選 「更多動作」> 「停止」。

  4. 按一下「Edit」(編輯)。

  5. 在「VM instance name」(VM 執行個體名稱) 欄位中，輸入 VM 的新名稱。

  6. 按一下 [儲存]。

    重新命名虛擬機最多需要一分鐘才能完成。如果變更 VM 名稱後，您收到「找不到 VM」的錯誤訊息，請重新整理瀏覽器。 Trusted Cloud

  7. 如有需要，請按一下 「Start / Resume」，重新啟動 VM。

gcloud

如要重新命名 VM，請按照下列步驟操作：

  1. 如果您尚未停止 VM，請先完成這項操作。

  2. 如要重新命名 VM，請使用 gcloud compute instances set-name 指令。

    gcloud compute instances set-name VM_NAME \
    --new-name=NEW_VM_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

    更改下列內容：

    • VM_NAME：現有 VM 的名稱。

    • NEW_VM_NAME：指定 VM 的新名稱。

    • PROJECT_ID：VM 所在專案的 ID。

    • ZONE：VM 所在區域。

    重新命名虛擬機最多可能需要一分鐘才能完成。

  3. 如有需要，請重新啟動 VM。

REST

如要重新命名 VM，請按照下列步驟操作：

  1. 如果您尚未停止 VM，請先完成這項操作。

  2. 如要重新命名 VM，請對 instances.setName 方法發出 POST 要求。

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME/setName

{
  "currentName": "VM_NAME",
  "name": "NEW_VM_NAME"
}

    更改下列內容：

    • PROJECT_ID：VM 所在專案的 ID。

    • ZONE：VM 所在區域。

    • VM_NAME：現有 VM 的名稱。

    • NEW_VM_NAME：指定 VM 的新名稱。

    重新命名虛擬機最多需要一分鐘才能完成。如要監控重新命名的狀態，請輪詢重新命名 API 傳回的作業 ID。詳情請參閱「處理 API 回應」。

  3. 如有需要，請重新啟動 VM。

後續步驟