裸機伺服器身分存取標記概念

裸機伺服器身分存取令牌提供存取元資料服務的安全憑證。 它是一個經過簽署的令牌，具有一組基於裸金屬伺服器資訊和令牌請求中傳遞的資訊的主張。

要存取裸機伺服器身份，請 PUT "http://api.metadata.cloud.ibm.com /identity/v1/token 透過使用呼叫裸機伺服器主機名稱的 元資料服務 API 進行呼叫。 裸機伺服器與元資料服務之間的通訊從未離開主機。 您可以從裸機伺服器內取得標記。 如果在裸機伺服器上啟用了對裸機伺服器元資料服務的安全存取，請使用 https 通訊協定，而不是 http 通訊協定。

在請求中，您指定令牌的到期時間。 預設為 5 分鐘，但您可以指定過期時間早晚（5 秒至 1 小時）。

回應 (JSON 有效負載) 包含裸機伺服器身分存取代碼。 使用此標記存取元資料服務。

您也可以從這個令牌產生 IAM 令牌，並使用 API 來呼叫啟用 IAM 的服務。 如需詳細資訊，請參閱 從裸露金屬伺服器身分存取令牌產生 IAM 令牌。

取得裸機伺服器身分存取代碼

使用 Metadata 服務 API，進行 PUT "http://api.metadata.cloud.ibm.com /identity/v1/token 呼叫以取得裸機伺服器身分存取權限。 以下範例使用 jq 解析 JSON API 回應，然後擷取裸機伺服器身分存取權杖值。 您可以使用自己喜歡的 JSON 解析器。

在本範例中，CURL 指令的回傳值是裸金屬伺服器的身分存取代碼，由 jq 擷取並置於 identity_token 環境變數中。 您可以在 GET 對元資料服務的呼叫中指定此變數來達到元資料端點。 如需詳細資訊，請參閱 從執行中的裸機伺服器擷取元資料。

此範例使用 jq 作為解析器，這是一個依據 MIT 授權條款 發佈的第三方工具。 某些作業系統預設並未內建 jq。 使用前請安裝 jq ，或改用其他 JSON 解析器。

identity_token=`curl -X PUT "http://api.metadata.cloud.ibm.com /identity/v1/token?version=2025-06-30"\
  -H "Metadata-Flavor: ibm"\
  -d '{
        "expires_in": 3600
      }' | jq -r '(.access_token)'`

以下 JSON 回應會顯示裸露金屬伺服器身分存取權標的字元串、建立日期和時間、過期日期和時間，以及您設定的過期時間。 請記住，代幣將在 5 分鐘後失效。

{
  "access_token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IlZTSS1DUl91cy1lYXN0X2I5...",
  "created_at": "2022-08-08T11:08:39.363Z",
  "expires_at": "2022-08-08T11:13:39.363Z",
  "expires_in": 3600
}