Megaport Terraform Provider 常見問題 (FAQs)

本主題涵蓋使用 Megaport Terraform Provider 的常見問題。如需更多資訊，請參閱 Megaport Terraform Provider 概覽。

如何查詢 DC 位置資訊？

查詢位置的最簡單方式是使用 Portal 中的位置名稱。

但資料中心位置資訊（例如名稱或站點代碼）可能會在 API 中變更。為了讓 Terraform 組態更可靠且穩定，我們強烈建議使用 Location ID，而不要使用名稱或代碼。如需 Megaport 資料中心位置的最新清單，請參閱 Megaport Location IDs。

Location ID 也可透過 GET /v3/locations Megaport API 取得。

如需更多資訊，請參閱建立 Megaport Terraform Provider 組態檔的步驟 2。

如何在部署 Terraform 組態檔時避免刪除生產環境中的線上服務？

在部署 Terraform 組態檔之前，請透過 Portal 鎖定您的線上服務。如需更多資訊，請參閱鎖定 Megaport 服務。

如何在 Port 上新增新的 VXC？

若生產環境中已存在某個服務（例如 Port），但未納入您的 Terraform 組態檔，則需要先將其匯入。詳情請參閱匯入既有生產環境服務。

之後，在 Terraform 檔案中新增一行組態，於該 Port 底下建立新的 VXC。

如何變更服務名稱？

在 Terraform 組態檔中更新 product_name 欄位。

範例：將 product_name = “Name of Product” 變更為 product_name = “Updated Name of Product”，然後執行 terraform apply 指令。

Megaport Terraform Provider 是否支援管理 IX 服務？

是的，有支援。

訂購 VXC 時如何套用 service key？

首先，請在 Portal 中設定 service key。如需更多資訊，請參閱設定服務金鑰。

建立 service key 後，您可以在訂購 VXC 時於 .tf 組態中套用該金鑰。

在 Megaport GitHub repository 中，resource.tf 提供一個完整示範。

請尋找如下開頭的區塊：

resource "megaport_vxc" "service_key_vxc" {

備註

將 "YOUR-SERVICE-KEY-HERE" 替換為來自 Megaport Portal 的值。
b_end 區塊用於指定遠端端點的 service key。
您仍可視需要定義其他參數（例如 rate_limit、VLAN）。
GitHub 上的 provider 文件包含多個 VXC 範例，包括 MCR 與雲端連線情境。

如何在我的電腦上查詢目前安裝的 Terraform 版本？

執行 terraform version 指令以檢查您已安裝的 Terraform 版本。

這會輸出 Terraform 的版本資訊。

如果輸出類似以下範例，請造訪 Upgrading Guides (HashiCorp) 更新您的系統。

   terraform version 您的 Terraform 版本已過時！
   最新版本為 x.y.z。
   您可以從 https://www.terraform.io/downloads.html 下載以進行更新。

如何查詢 Megaport Terraform Provider 的最新版本？

Megaport 會針對 Terraform 的最新兩個主要版本進行主動測試，以確保相容性與可靠性。

您可以在 Megaport Terraform Provider Releases page 找到最新的 Megaport Terraform Provider 版本。此頁面也包含每個版本的發行說明。

我們強烈建議將 Terraform 組態檔更新至最新的 Provider 版本，以便獲得改進、新功能與重要修正。

應在哪裡更新 Megaport Terraform Provider 的版本號？

請在 provider.tf 檔案中更新 version 欄位。

請參考以下範例中的 version = ">= 1.4.1"。這種版本寫法會指示 Terraform 使用 1.4.1 或更新版本的 Provider。

terraform {
  required_providers {
    megaport = {
      source  = "megaport/megaport"
        version = ">= 1.4.1"
    }
  }
}

是否支援 OpenTofu？

是的，Megaport Terraform Provider 已通過測試，並自 v1.3.7 起與 OpenTofu 相容。

OpenTofu 是 Terraform 的開源、社群驅動分支，與相同的 providers 及 HashiCorp Configuration Language (HCL) 語法保持相容。

雖然我們會針對新的 Megaport Terraform Provider 發行版本進行相容性測試，但仍建議查看 Megaport Terraform Provider GitHub Releases page 以取得最新資訊。

如需使用方式，請參閱 OpenTofu Registry 上的 Megaport Provider，並參考 Megaport Terraform Provider GitHub Readme 檔案。

哪裡可以找到最新的範例？

Ports、VXC、MCR 與 MVE 的範例可在 Provider 的 examples directory 中取得。其他指引可在 Megaport Terraform Provider Registry 的 Guides 區段中找到，該處提供補充範例的背景說明與操作指引。

Provider 中的合約期如何運作？

使用 Terraform 設定服務為合約期限應該沒有問題。

為什麼會有 requested_product_uid 欄位？

原因是當選擇合作夥伴的 Port 時，我們不允許使用者挑選特定的 Port，API 會基於容量因素動態選取一個。這表示此欄位可能與使用者要求的不同，進而導致 Terraform Provider 發生錯誤。