建立會議

Important

基於會話的認證目前仍處於預覽階段。 您的訂閱必須先啟用才能預覽,才能使用「建立會話」操作。

Create Session 操作會建立一個五分鐘的會話,範圍限定在容器上。 會話提供憑證,可用來授權對該容器內資源的後續請求。

會話適用於對同一容器執行多個請求的工作負載,能減少後續請求所需的認證與授權處理。

Request

您可以建構 Create Session 要求,如下所示。 必須使用 HTTPS 格式。

Method 要求 URI HTTP 版本
POST https://myaccount.blob.core.windows.net/mycontainer?restype=container&comp=session HTTP/1.1

把 myaccount 替換成你儲存帳號的名稱,mycontainer 替換成建立會話的容器名稱。

URI 參數

請求 URI 需要以下參數。

Parameter Description
restype Required. 一定是容器。 指定請求適用於容器資源。
comp Required. 一定是會議。 指定建立會話操作。

請求標頭

以下請求標頭是必需的:

請求標頭 Description
Authorization Required. 透過使用 Microsoft Entra 存取權杖授權建立會話請求。
Date 或 x-ms-date Required. 指定要求的國際標準時間(UTC)。
x-ms-version Required. 指定要用於此要求的作業版本。 Create Session 僅支援版本或更新版本 2026-02-06 。 如需詳細資訊,請參閱 Azure 儲存體服務的版本。

建立會話必須透過 Microsoft Entra 存取權杖授權。 基於 session 的授權無法用來建立 session。

要求本文

請求主體具有以下 XML 格式:

<?xml version="1.0" encoding="utf-8"?>
<CreateSessionRequest>
  <AuthenticationType>HMAC</AuthenticationType>
</CreateSessionRequest>

下表描述請求體的元素。

Element Required Description
AuthenticationType Yes 規定使用該會話請求的認證機制。 目前支援的金額為 HMAC。 當指定 HMAC 時,Create Session 會回傳一個會話金鑰,客戶端用來簽署後續請求。

範例要求

POST /mycontainer?restype=container&comp=session HTTP/1.1
Host: myaccount.blob.core.windows.net
Authorization: Bearer {Microsoft Entra access token}
x-ms-date: {date}
x-ms-version: {version}
Content-Type: application/xml

<?xml version="1.0" encoding="utf-8"?>
<CreateSessionRequest>
  <AuthenticationType>HMAC</AuthenticationType>
</CreateSessionRequest>

回應

成功操作會回傳狀態碼 201(已建立)。

回應機構

回應實體包含新建立會話的資訊與憑證。

<?xml version="1.0" encoding="utf-8"?>
<CreateSessionResult>
  <Id>4e6a585b-5fd9-49f5-aa81-014a9dbaa5cc</Id>
  <Expiration>2025-08-25T19:48:17.8038151Z</Expiration>
  <AuthenticationType>HMAC</AuthenticationType>
  <Credentials>
    <SessionToken>aB1cD2eF-3gH4iJ5kL6-mN7oP8qR=</SessionToken>
    <SessionKey>aaaaaaaa0b0b1c1c2d2d333333333333==</SessionKey>
  </Credentials>
</CreateSessionResult>

回應內容包括以下要素:

Element Description
Id 會話的唯一識別碼。
Expiration 會議結束的時間點。
AuthenticationType 與會話相關的認證機制。
Credentials 包含授權使用會話請求所需的憑證。
SessionToken 一個不透明的標記,用於授權會話中後續的請求。 將會話令牌視為安全憑證。
SessionKey 對於 HMAC 會話,對稱金鑰用於使用共享金鑰簽署協定簽署請求。 把會話金鑰當作安全憑證來處理。

Authorization

建立會話需要 Microsoft Entra ID 授權。

  • 請用 Microsoft Entra 存取權杖授權請求。

會話的範圍是請求 URI 中指定的容器,且不會授予超過 Microsoft Entra 安全主體權限以外的權限。 主體必須有權限對所請求的資源執行 Get Blob。

使用 Get Blob 的會議

對於 HMAC 會話,請使用回傳的 SessionToken 和 SessionKey 授權後續的 Get Blob 請求。

用戶端使用會話金鑰簽署請求,並在授權標頭中包含所產生的簽章與會話標記:

Authorization: Session {SessionToken}:{Signature}

例如:

GET /mycontainer/myblob HTTP/1.1
Host: myaccount.blob.core.windows.net
Authorization: Session {SessionToken}:{Signature}
x-ms-version: {version}

會話的範圍是建立它的容器。

會話壽命與續期

會話會在五分鐘後到期,但如果所提供的 OAUTH 代幣較早到期,會話可能會更早失效。 當現有會話到期或不再有效時,客戶應該重新申請新會話。

會話狀態

對使用會話授權的請求回應可以包含會話狀態資訊。

會話狀態 Description
session_expiring 該會話即將到期或將失效。 用戶端應在現有會話無法使用前取得新會話。
session_expired 該會話已過期、未被發現或已被撤銷。 該會話已無法再使用。 客戶應該建立一個新的會話。
session_token_invalid 所提供的會話令牌形式錯誤或語法無效。

session_expiring狀態可在回應標頭中回傳x-ms-auth-info。

當 401 未授權時,會話授權失敗時,服務可在標頭中回傳會話錯誤資訊 WWW-Authenticate 。

當所提供的會話有效但未授權該請求的資源或操作時,請求也可能因 403 禁止 而失敗。

備註

Context

當會話建立時,Azure Blob 儲存體 會評估呼叫者的 Microsoft Entra 身份以及適用的 RBAC 和 ABAC 權限。 後續請求會依此會話上下文授權。

Scope

會話的範圍是請求中 Create Session 指定的容器,無法用來存取其他容器。 它不會授予除創建該身份外的權限。

在會話生命週期內所做的權限變更,當建立新會話時生效。

許可評估

建立會話會在會話建立時評估授權。 帳號、容器或權限的變更不會反映在現有的工作階段中。 當現有五分鐘會議結束後,新建會話時,這些變更會反映出來。

網路背景

會話會保留建立時所適用的網路上下文。 後續使用該會話的請求必須來自同一用戶端 IP 位址。 來自不同用戶端 IP 位址的請求會被拒絕。

安全性

SessionToken 和 SessionKey 是安全憑證,應受到保護,避免被揭露。

Limitations

基於會話的認證目前僅支援取得 Blob 操作。 不支援以下案例:

  • 使用 Session 憑證的 Get Blob 請求的 Blob 標籤。
  • 把 Blob 請求傳到次要帳號。
  • Microsoft Purview 使用會話憑證。

其他 Blob 儲存體 操作必須使用現有支援的授權機制。

Billing

定價請求可以來自使用 Blob 儲存體 API 的客戶端,無論是直接透過 Blob 儲存體 REST API 或透過 Azure 儲存體 客戶端函式庫。 這些要求會依交易產生費用。 交易類型決定了帳戶的收費方式。 例如,已讀交易在不同於寫入交易的計費類別中產生費用。

下表顯示根據儲存帳戶類型建立會話請求的計費類別:

作業 記憶體帳戶類型 計費類別
建立會議 進階區塊 Blob
標準一般用途 v2
標準一般用途 v1
寫入操作

欲了解指定計費類別的定價,請參閱 Azure Blob 儲存體 定價。