Azure Blob 儲存體

Microsoft Azure 儲存體可為雲端上的資料提供可大幅調整、持久且高可用性的儲存體,並可作為新式應用程式的資料儲存體解決方案。 連線到 Blob 儲存體,以執行各種作業,例如在 Azure 儲存體帳戶中的 Blob 上建立、更新、取得和刪除。

此連接器適用於以下產品和區域:

服務 Class Regions
Copilot Studio 進階 所有 Power Automate 區域
Logic Apps 標準 所有 Logic Apps 區域
Power Apps 進階 所有 Power Apps 區域
Power Automate 進階 所有 Power Automate 區域
連絡人​​
名稱 Microsoft
URL https://azure.microsoft.com/support/
連接器中繼資料
Publisher Microsoft
網站 https://azure.microsoft.com/services/storage/blobs/
隱私策略 https://privacy.microsoft.com/
類別 生產力

本文說明Azure Blob 儲存體 管理連接器的操作,該連接器可用於Copilot Studio、Azure Logic Apps、Microsoft Power Automate及MicrosoftPower Apps。

關於如何使用此連接器,請參考下表:

服務 如何做
Azure Logic Apps Connect to Azure Blob 儲存體 from Azure Logic Apps
Microsoft Power Apps(微軟的應用程式開發平台) Connect to Azure Blob 儲存體 from Power Apps

一般已知問題和限制

  • 連接器不支援包含 URL 可解碼字元的 blob 名稱和路徑,例如+%後面跟兩個十六進位數字。

  • 對於 V2 操作,只有在使用基於金鑰的驗證時,才會自動填充名為 Storage account name 的參數。 當你使用 Microsoft Entra ID 或管理身份驗證時,請輸入儲存帳號名稱作為自訂值。

  • 名為「 當新增或修改 blob(僅屬性)」(V2) 的觸發器,若子資料夾中檔案被新增或更新,則不會觸發。 如果你需要觸發器來處理子資料夾,建議使用多個觸發器。

  • 名為「 當新增或修改 blob(僅屬性)」(僅屬性) 的觸發器有時會延遲立即回傳 blob,並將新建立或修改過的 blob 延後到後續觸發執行。 當 Split on 設定被關閉時,觸發器並不保證一次就能回傳所有檔案。

  • 名為 When a blob is added or modified (僅屬性)(V2) 的觸發器,其行為狀態設定為 idleconflict或 。 當上傳單一檔案時,觸發器的行為會略有不同,而上傳多個檔案時則不同。

    • 對於單一檔案,觸發器會立即觸發、處理該檔案並發送適當的回應。

    • 對於多個具有相同時間戳記的檔案,觸發器會進入衝突狀態並採取以下動作:

      • 發送包含 HTTP 200 OK 狀態碼和 retry-after 設定為 6 秒標頭的回應。
      • 6 秒後,觸發器會處理所有時間戳相同的檔案。

    舉例來說,假設你從 SFTP 伺服器上傳檔案到 Azure Blob 儲存體,檔案上傳時間可能長達一秒鐘。 如果沒有 6 秒的等待,觸發器可能會錯過部分上傳的檔案。 重試時間確保所有檔案在下一次觸發檢查前上傳完成。

  • 名為「 將壓縮檔到資料夾 」的動作會忽略壓縮檔中的空檔案和資料夾。 這些物品不會被提取到目的地。

  • 當你使用名為 Create block blob (V2) 的動作且不允許分塊時,該動作偶爾會產生將內容類型設為 application/octet-stream的 blob。 要找到分區設定,請到 設定 標籤。

  • 連接器可能會向後端發送 no-op 請求。

  • 訊息大小限制為設計上的 100 MB,依據 Azure Logic Apps 中的 限制。 當你透過連接器傳送檔案時,整體有效載荷大小必須低於 100 MB,而不只是檔案大小。 為了繞過這個限制,可以考慮允許分塊,你可以在動作的 設定 標籤中找到。

  • 在 Azure Logic Apps 中,連接器無法直接存取位於防火牆後方的儲存帳號,前提是它們都在同一區域。 作為一個變通方法,將你的儲存帳號放在不同地區。 欲了解更多資訊,請參閱 「防火牆後的存取儲存帳戶」。

  • 在 Power Platform 服務中,連接器不支援連接防火牆後的儲存帳號。 即使現在連線正常,也不要依賴未來連線才能正常運作。 目前唯一的解決方法是不要為儲存帳號使用防火牆。

  • 在 Power Apps 中,當你使用名為 Create blob (V2) 的動作並進行存取金鑰認證時,請確保 dataset 參數使用「AccountNameFromSettings」,而不是 blob 端點。

  • 這個連接器不支援閘道器。 當你建立Azure Blob 儲存體連線時,可能會跳出錯誤的選項,例如選擇閘道。

  • 名為 Create SAS URI by path (V2) 的動作總是產生 SAS URI StartTime。utcNow() - 1 hour 任何提供的 StartTime 值都會被忽略。

Support for Azure Data Lake Storage Gen2

你可以使用 多協定存取連接Azure Data Lake Storage Gen2(ADLS Gen2)帳號。 欲了解更多資訊,包括可用性與已知限制,請參閱Silo busting 2.0—Azure Data Lake Storage。

Microsoft Entra ID 認證

若要使用 Microsoft Entra ID 驗證,使用者帳戶需要特定的角色指派。 欲了解更多資訊,請參見 Assign a Azure role for access to blob data - Azure 儲存體。

備註

只有明確定義資料存取的角色,才允許安全性主體存取 Blob 或佇列資料。 內建角色 (例如擁有者、參與者和儲存體帳戶參與者) 可讓安全性主體管理儲存體帳戶,但不會透過 Microsoft Entra ID 提供該帳戶內 Blob 或佇列資料的存取權。

以下快速測試確認使用者帳號是否具備對 blob 容器執行操作所需的角色:

  1. 在 Azure 入口網站,使用使用者帳號登入。

  2. 進入儲存帳號和 blob 容器。 在容器工具列中,Authentication Method: Access Key旁,選擇 Switch to Microsoft Entra user account。

    這個選項會直接出現在 blob 搜尋框的正上方。

若出現未授權訊息,該使用者帳號需要特定的儲存帳號權限。 針對此任務,儲存帳戶經理可以依照以下步驟操作:

  1. 在容器側邊欄,選擇 存取控制 (IAM)。

  2. 在工具列中,選擇 新增>角色指派。

  3. 在 角色 標籤中,尋找並選擇使用者帳號所需的適當 儲存帳號 角色,例如儲存 帳號貢獻者。 選取 下一步。

  4. 在 會員 標籤中,選擇 + 選擇成員,找到並選擇使用者帳號,選擇 選擇,然後選擇 審核 + 指派。

欲了解更多關於Blob 儲存體容器存取角色的資訊,請參見 授權使用 Microsoft Entra ID

管理式身份驗證

目前,只有 Azure Logic Apps 支援受管理身份驗證。 要在邏輯應用程式工作流程中為Azure Blob 儲存體連線設定並使用此認證,請參見Azure Logic Apps<>中認證對Azure資源的存取與連線。

Microsoft Entra ID 與管理身份驗證的已知限制

  • 由於目前認證管線的限制,Microsoft Entra ID 訪客用戶不支援 Microsoft Entra ID 連接至 Azure Blob 儲存體。

  • 只有 V2 動作支援 Microsoft Entra ID 和受管理身份驗證。 棄用的動作仍可與存取金鑰驗證合作,但若搭配 Microsoft Entra ID 或受管身份驗證使用,這些動作會失敗。

    作為例外,以下 V2 動作目前不支援 Microsoft Entra ID 或受管理身份驗證。 作為一個變通方法,你可以使用存取金鑰認證。

Connect to Azure Blob 儲存體 using a blob endpoint

對於 V2 操作或存取金鑰認證連線,請輸入完整的 Azure 儲存體 blob 端點,如描述所示:

  • 如果你的連線使用存取金鑰驗證,在名為 Azure 儲存體 Account Name Or Blob Endpoint 的參數中輸入完整的 Azure 儲存體 blob 端點。

  • 如果你使用 V2 操作,連線使用存取金鑰認證,也必須在 dataset 參數中提供完整的 Azure 儲存體 blob 端點。

  • 完整的 blob 端點包含該結構,例如:

    • https://{account-name}.blob.core.windows.net/

    • https://{account-name-secondary}.blob.core.windows.net/ 如果你連接到次要端點

    • 相對路徑如 將 {account-name}.blob.core.windows.net 被拒絕。

取得特定儲存帳戶的 Azure 儲存體 blob 端點

你可以透過以下方式獲得完整的 blob 端點:

Azure 入口網站

  1. 在Azure入口網站,前往你的Azure 儲存體帳號。

  2. 在帳號側邊欄的 設定中,選擇 端點。

  3. 在 Blob 服務 區塊中,找到 Blob 服務 屬性值,這是以下格式的完整 blob 端點: https://{account-name}.blob.core.windows.net/

REST API

如果你有 Azure 儲存體 帳號的存取權,可以依照以下步驟呼叫名為 Get Properties 的 REST API 方法:

  1. 在Azure入口網站,前往你的Azure 儲存體帳號。 在帳戶側邊欄,選擇 「總覽」。

  2. 在 概覽 頁面的 Essentials 底下,複製並儲存儲存帳號的 訂閱 ID 和 資源群組 名稱,方便下一步操作。

  3. 前往名為 Storage Accounts - 取得屬性的 REST API 參考頁面。

  4. 在 HTTP 欄位右上角,選擇「嘗試」。

  5. 如果您還沒登入,請立即登入。 否則,確認你想繼續。

  6. 選擇有儲存帳號的 Azure 租戶。

  7. 輸入儲存帳號名稱、資源群組名稱,並選擇與儲存帳號相關的訂閱。

  8. 完成後,選擇 「奔跑」。

  9. 在回應的 Body 區塊,找到 primaryEndpoints JSON 物件。 在此物件中,尋找 blob 屬性值,即以下格式的完整 blob 端點: https://{account-name}.blob.core.windows.net/

一般限制

名稱 價值觀
啟用區塊的檔案大小上限 (以 MB 為單位) 1024
停用區塊的檔案大小上限、擷取的封存大小上限、絕對 Uri 的情況下複製 Blob 作業的來源大小上限 (以 MB 為單位) 50
封存中的檔案數目上限 100
封存中檔案的總大小上限 (以 MB 為單位) 750
清單 Blob 的頁面大小上限 5000
觸發器虛擬資料夾內可追蹤的專案數目上限 30000
在頻寬時間間隔內傳輸至/從連接器傳輸的 MB 數目上限 (每個連線) 300
頻寬時間間隔 (以毫秒為單位) 1000
連接器同時處理的要求數目上限 100
連接器同時傳輸的回應數目上限 200
每 1 分鐘每個連線的 API 呼叫數,用於「將存檔擷取至資料夾作業」 150

正在建立連線

連接器支援下列驗證類型:

[variables('keyBasedAuthDefaultDisplayName')] [variables('keyBasedAuthDefaultDescription')] 除了Azure Government和國防部(DoD)在Azure Government、MOONCAKE和美國政府(GCC-High)和美國政府(GCC)之外,所有地區都適用。 可共用
[variables('oauthDefaultDisplayName')] [variables('oauthDefaultDescription')] 除了Azure Government和國防部(DoD)在Azure Government、MOONCAKE和美國政府(GCC-High)和美國政府(GCC)之外,所有地區都適用。 不可共享
存取鑰匙 提供 Azure 儲存體帳戶名稱 (或 Blob 端點) 和存取金鑰,以存取您的 Azure Blob 儲存體。 只吃月餅 可共用
Access Key (Azure Government) 提供 Azure 儲存體帳戶名稱 (或 Blob 端點) 和存取金鑰,以存取您的 Azure Blob 儲存體。 僅限 Azure Government 和美國政府 (GCC-High) 中的 Azure Government 和國防部 (DoD) 可共用
Access Key (Azure Government) 提供 Azure 儲存體帳戶名稱 (或 Blob 端點) 和存取金鑰,以存取 Azure 政府中的 Azure Blob 儲存體。 僅限美國政府 (GCC) 可共用
用戶端憑證認證 使用 PFX 憑證和密碼提供 Microsoft Entra ID 認證 所有區域 可共用
管理身份 使用受控識別建立連線 僅限 LOGICAPPS 可共用
Microsoft Entra ID 整合 使用 Microsoft Entra ID 來存取您的 Azure Blob 儲存體。 只吃月餅 不可共享
Microsoft Entra ID Integrated (Azure Commercial) 使用 Microsoft Entra ID 在 Azure 商業版中存取 Azure Blob 儲存體。 僅限美國政府 (GCC) 不可共享
Microsoft Entra ID Integrated (Azure Government) 使用 Microsoft Entra ID 來存取您的 Azure Blob 儲存體。 僅限 Azure Government 和美國政府 (GCC-High) 中的 Azure Government 和國防部 (DoD) 不可共享
Microsoft Entra ID Integrated (Azure Government) 使用 Microsoft Entra ID 存取 Azure 政府中的 Azure Blob 儲存體。 僅限美國政府 (GCC) 不可共享
服務主體認證 使用您自己的 Microsoft Entra ID 應用程式進行服務主體驗證。 所有區域 不可共享
預設 [已棄用] 此選項僅適用於沒有明確驗證類型的舊連線,並且僅用於回溯相容性。 所有區域 不可共享

[variables('keyBasedAuthDefaultDisplayName')]

驗證 ID:keyBasedAuth

適用:除Azure Government及國防部(DoD)在Azure Government和月餅之外的所有地區,以及美國政府(GCC-High)和美國政府(GCC)

[variables('keyBasedAuthDefaultDescription')]

這是可共享的連接。 如果 Power App 與其他使用者共用,也會共用連線。 如需詳細資訊,請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件

名稱 類型 Description 為必填項目
Azure 儲存體帳戶名稱或 Blob 端點 字串 連接器應該使用的 Azure 儲存體帳戶的名稱或 Blob 端點。 對
Azure 儲存體帳戶存取金鑰 securestring 指定有效的主要/次要 Azure 儲存體帳戶存取金鑰。

[variables('oauthDefaultDisplayName')]

驗證識別碼:tokenBasedAuth

適用:除Azure Government及國防部(DoD)在Azure Government和月餅之外的所有地區,以及美國政府(GCC-High)和美國政府(GCC)

[variables('oauthDefaultDescription')]

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

存取鍵

驗證 ID:keyBasedAuth

適用:僅限月餅

提供 Azure 儲存體帳戶名稱 (或 Blob 端點) 和存取金鑰,以存取您的 Azure Blob 儲存體。

這是可共享的連接。 如果 Power App 與其他使用者共用,也會共用連線。 如需詳細資訊,請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件

名稱 類型 Description 為必填項目
Azure 儲存體帳戶名稱或 Blob 端點 字串 連接器應該使用的 Azure 儲存體帳戶的名稱或 Blob 端點。 對
Azure 儲存體帳戶存取金鑰 securestring 指定有效的主要/次要 Azure 儲存體帳戶存取金鑰。

存取金鑰 (Azure 政府)

驗證 ID:keyBasedAuth

適用:僅限 Azure Government 和美國政府 (GCC-High) 中的 Azure Government 和國防部 (DoD)

提供 Azure 儲存體帳戶名稱 (或 Blob 端點) 和存取金鑰,以存取您的 Azure Blob 儲存體。

這是可共享的連接。 如果 Power App 與其他使用者共用,也會共用連線。 如需詳細資訊,請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件

名稱 類型 Description 為必填項目
Azure 儲存體帳戶名稱或 Blob 端點 字串 連接器應該使用的 Azure 儲存體帳戶的名稱或 Blob 端點。 對
Azure 儲存體帳戶存取金鑰 securestring 指定有效的主要/次要 Azure 儲存體帳戶存取金鑰。

存取金鑰 (Azure 政府)

驗證 ID:keyBasedAuth

適用:僅限美國政府 (GCC)

提供 Azure 儲存體帳戶名稱 (或 Blob 端點) 和存取金鑰,以存取 Azure 政府中的 Azure Blob 儲存體。

這是可共享的連接。 如果 Power App 與其他使用者共用,也會共用連線。 如需詳細資訊,請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件

名稱 類型 Description 為必填項目
Azure 儲存體帳戶名稱或 Blob 端點 字串 連接器應該使用的 Azure 儲存體帳戶的名稱或 Blob 端點。 對
Azure 儲存體帳戶存取金鑰 securestring 指定有效的主要/次要 Azure 儲存體帳戶存取金鑰。

用戶端憑證驗證

驗證 ID:certOauth

適用:所有地區

使用 PFX 憑證和密碼提供 Microsoft Entra ID 認證

這是可共享的連接。 如果 Power App 與其他使用者共用,也會共用連線。 如需詳細資訊,請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件

名稱 類型 Description 為必填項目
用戶端識別碼 字串 對
用戶端憑證密碼 客戶憑證 此應用程式允許的用戶端憑證密碼 對
租戶 字串 對

受控識別

驗證 ID:managedIdentityAuth

適用:僅限 LOGICAPPS

使用受控識別建立連線

這是可共享的連接。 如果 Power App 與其他使用者共用,也會共用連線。 如需詳細資訊,請參閱 畫布應用程式的連接器概觀 - Power Apps |Microsoft 文件

名稱 類型 Description 為必填項目
受控識別 managedIdentity 使用受控識別登入 對

Microsoft Entra ID 整合

驗證識別碼:tokenBasedAuth

適用:僅限月餅

使用 Microsoft Entra ID 來存取您的 Azure Blob 儲存體。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

Microsoft Entra ID 整合式 (Azure 商業版)

驗證 ID:oauthCom

適用:僅限美國政府 (GCC)

使用 Microsoft Entra ID 在 Azure 商業版中存取 Azure Blob 儲存體。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

Microsoft Entra ID 整合式 (Azure 政府)

驗證識別碼:tokenBasedAuth

適用:僅限 Azure Government 和美國政府 (GCC-High) 中的 Azure Government 和國防部 (DoD)

使用 Microsoft Entra ID 來存取您的 Azure Blob 儲存體。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

Microsoft Entra ID 整合式 (Azure 政府)

驗證識別碼:tokenBasedAuth

適用:僅限美國政府 (GCC)

使用 Microsoft Entra ID 存取 Azure 政府中的 Azure Blob 儲存體。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

服務主體帳戶驗證

驗證識別碼:servicePrincipalAuth

適用:所有地區

使用您自己的 Microsoft Entra ID 應用程式進行服務主體驗證。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
用戶端識別碼 字串 對
用戶端密碼 securestring 對
租戶 字串 對

預設 [已棄用]

適用:所有地區

此選項僅適用於沒有明確驗證類型的舊連線,並且僅用於回溯相容性。

這不是可共用的連線。 如果 Power App 與其他使用者共用,系統會明確提示其他使用者建立新連線。

名稱 類型 Description 為必填項目
Azure 儲存體帳戶名稱或 Blob 端點 字串 連接器應該使用的 Azure 儲存體帳戶的名稱或 Blob 端點。 對
Azure 儲存體帳戶存取金鑰 securestring 指定有效的主要/次要 Azure 儲存體帳戶存取金鑰。

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 1500 60 秒

動作

使用路徑 (V2) 取得 Blob 中繼資料

此作業會使用路徑擷取 Blob 中繼資料。

使用路徑取得 Blob 中繼資料 [已淘汰]

此動作已被取代。 請改用 [ 使用路徑 (V2) 取得 Blob 中繼資料 ]。

此操作透過路徑取得 blob 元資料。

使用路徑取得 Blob 內容 [已取代]

此動作已被取代。 請改用 [ 使用路徑 (V2) 取得 Blob 內容 ]。

此操作透過路徑取得 blob 內容。

使用路徑取得 Blob 內容 (V2)

此作業會使用 path 擷取 Blob 內容。

依路徑建立 SAS URI [已淘汰]

此動作已被取代。 請改用 [ 依路徑建立 SAS URI (V2) ]。

此操作會為 blob 建立一條 SAS 連結,使用該路徑。

依路徑建立 SAS URI (V2)

此作業會使用路徑建立 Blob 的 SAS 連結。

依路徑設定 Blob 層 [已淘汰]

此動作已被取代。 請改用 [ 依路徑設定 Blob 層 (V2) ]。

此操作會為標準儲存帳號上的區塊 blob 設定層級,使用路徑。

依路徑設定 Blob 層 (V2)

此作業會使用路徑在標準儲存體帳戶上設定區塊 Blob 的層。

列出 Blob [已淘汰]

此動作已被取代。 請改用 Lists Blob (V2)。

此操作會列出容器中的 blob。

列出 Blob (V2)

此作業會列出容器中的 Blob。

列出根資料夾中的 Blob [已淘汰]

此動作已被取代。 請改用根 資料夾 (V2) 中的 Lists Blob 。

此操作會列出 Azure Blob 儲存體 根目錄中的 blob。

列出根資料夾中的 Blob (V2)

此作業會列出 Azure Blob 儲存體根資料夾中的 Blob。

刪除 Blob [已淘汰]

此動作已被取代。 請改用 [刪除 Blob (V2)]。

此操作會刪除一個 blob。

刪除 Blob (V2)

此作業會刪除 Blob。

取得 Blob 中繼資料 [已淘汰]

此動作已被取代。 請改用 [取得 Blob 中繼資料 (V2)]。

此操作使用 blob ID 取得 blob 的元資料。

取得 Blob 中繼資料 (V2)

此作業會使用 Blob 識別碼擷取 Blob 中繼資料。

取得 Blob 內容 [已取代]

此動作已被取代。 請改用 [取得 Blob 內容 (V2)]。

此操作利用 id 取得 blob 內容。

取得 Blob 內容 (V2)

此作業會使用 id 擷取 Blob 內容。

取得可用的存取原則 [已淘汰]

此動作已被取代。 請改用取得可用的存取原則 (V2)。

此操作會取得 blob 可用的共享存取政策。

取得可用的存取原則 (V2)

此作業會取得 Blob 可用的共用存取原則。

將存檔解壓縮到資料夾 [已棄用]

此動作已被取代。 請改用 將存檔解壓縮到文件夾 (V2)。

此操作會將壓縮包 blob 解壓到資料夾中(例如:.zip)。

將存檔解壓縮到資料夾 (V2)

此作業會將封存 Blob 擷取到資料夾中 (例如:.zip)。

建立 Blob [已淘汰]

此動作已被取代。 請改用 [建立 Blob (V2)]。

此操作會將 blob 上傳到 Azure Blob 儲存體。

建立 Blob (V2)

此作業會將 Blob 上傳至 Azure Blob 儲存體。

建立區塊 Blob [已淘汰]

此動作已被取代。 請改用建立區塊 Blob (V2)。

此操作會將區塊 blob 上傳至 Azure Blob 儲存體。

建立區塊 Blob (V2)

此作業會將區塊 Blob 上傳至 Azure Blob 儲存體。

更新 Blob [已淘汰]

此動作已被取代。 請改用更新 Blob (V2)。

此操作會更新 Azure Blob 儲存體 中的 blob。

更新 Blob (V2)

此作業會更新 Azure Blob 儲存體中的 Blob。

複製 Blob [已淘汰]

此動作已被取代。 請改用 [複製 Blob (V2)]。

此作業會複製 Blob。 如果 Blob 在複製之後立即在伺服器上刪除/重新命名,連接器可能會根據其設計傳回 HTTP 404 錯誤。 請先延遲 1 分鐘,再刪除或重新命名新建立的 Blob。 此動作不支援區塊傳輸。 如果來源和目的地存在於相同的儲存體帳戶中,請使用相對路徑。 否則,複製 Blob 作業的來源大小上限為 50 MB。

複製 Blob (V2)

此作業會複製 Blob。 如果 Blob 在複製之後立即在伺服器上刪除/重新命名,連接器可能會根據其設計傳回 HTTP 404 錯誤。 請先延遲 1 分鐘,再刪除或重新命名新建立的 Blob。 此動作不支援區塊傳輸。 如果來源和目的地存在於相同的儲存體帳戶中,請使用相對路徑。 否則,複製 Blob 作業的來源大小上限為 50 MB。

使用路徑 (V2) 取得 Blob 中繼資料

此作業會使用路徑擷取 Blob 中繼資料。

參數

名稱 機碼 必要 類型 Description
儲存體帳戶名稱或 Blob 端點
dataset True string

Azure 儲存體帳戶名稱或 Blob 端點。

Blob 路徑
path True string

指定 Blob 的唯一路徑。

擷取MIP標籤
extractSensitivityLabel boolean

指定是否要擷取 MIP 標籤。

Purview Acccount 名稱
purviewAccountName string

除非特別說明,否則會查詢預設集合。

傳回

帶有敏感度標籤資訊的資料

使用路徑取得 Blob 中繼資料 [已淘汰]

此動作已被取代。 請改用 [ 使用路徑 (V2) 取得 Blob 中繼資料 ]。

此操作透過路徑取得 blob 元資料。

參數

名稱 機碼 必要 類型 Description
Blob 路徑
path True string

指定 Blob 的唯一路徑。

傳回

Blob 中繼資料

身體
BlobMetadata

使用路徑取得 Blob 內容 [已取代]

此動作已被取代。 請改用 [ 使用路徑 (V2) 取得 Blob 內容 ]。

此操作透過路徑取得 blob 內容。

參數

名稱 機碼 必要 類型 Description
Blob 路徑
path True string

指定 Blob 的唯一路徑。

推斷內容類型
inferContentType boolean

根據擴充功能推斷內容類型。

傳回

檔案的內容。

檔案內容
binary

使用路徑取得 Blob 內容 (V2)

此作業會使用 path 擷取 Blob 內容。

參數

名稱 機碼 必要 類型 Description
儲存體帳戶名稱或 Blob 端點
dataset True string

Azure 儲存體帳戶名稱或 Blob 端點。

Blob 路徑
path True string

指定 Blob 的唯一路徑。

推斷內容類型
inferContentType boolean

根據擴充功能推斷內容類型。

擷取MIP標籤
extractSensitivityLabel boolean

指定是否要擷取 MIP 標籤。

Purview Acccount 名稱
purviewAccountName string

除非特別說明,否則會查詢預設集合。

傳回

檔案的內容。

檔案內容
binary

依路徑建立 SAS URI [已淘汰]

此動作已被取代。 請改用 [ 依路徑建立 SAS URI (V2) ]。

此操作會為 blob 建立一條 SAS 連結,使用該路徑。

參數

名稱 機碼 必要 類型 Description
Blob 路徑
path True string

Blob 的唯一路徑。

群組原則識別碼
GroupPolicyIdentifier string

識別預存存取原則的字串。 群組原則參數 (例如開始時間和結束時間) 優先於動作中提及的輸入參數。

權限
Permissions string

SAS 上指定的權限 (以逗號分隔的值)。

開始時間
StartTime date-time

SAS 變成有效的日期和時間 (例如:「2017-11-01T15:30:00+00:00')。 預設值 = now()。

到期時間
ExpiryTime date-time

SAS 不再有效的日期和時間 (例如:「2017-12-01T15:30:00+00:00')。 預設值 = now() + 24h。

共用存取通訊協定
AccessProtocol string

允許的通訊協定 (僅限 https,或 http 和 https)。 如果您不想限制通訊協定,則為 Null。

IP 位址或 IP 位址範圍
IpAddressOrRange string

允許的 IP 位址或 IP 位址範圍。 如果您不想根據 IP 位址進行限制,則為 Null。

傳回

共用存取簽章

依路徑建立 SAS URI (V2)

此作業會使用路徑建立 Blob 的 SAS 連結。

參數

名稱 機碼 必要 類型 Description
儲存體帳戶名稱或 Blob 端點
storageAccountName True string

Azure 儲存體帳戶名稱或 Blob 端點。

Blob 路徑
path True string

Blob 的唯一路徑。

群組原則識別碼
GroupPolicyIdentifier string

識別預存存取原則的字串。 群組原則參數 (例如開始時間和結束時間) 優先於動作中提及的輸入參數。

權限
Permissions string

SAS 上指定的權限 (以逗號分隔的值)。

開始時間
StartTime date-time

SAS 變成有效的日期和時間 (例如:「2017-11-01T15:30:00+00:00')。 預設值 = now()。

到期時間
ExpiryTime date-time

SAS 不再有效的日期和時間 (例如:「2017-12-01T15:30:00+00:00')。 預設值 = now() + 24h。

共用存取通訊協定
AccessProtocol string

允許的通訊協定 (僅限 https,或 http 和 https)。 如果您不想限制通訊協定,則為 Null。

IP 位址或 IP 位址範圍
IpAddressOrRange string

允許的 IP 位址或 IP 位址範圍。 如果您不想根據 IP 位址進行限制,則為 Null。

傳回

共用存取簽章

依路徑設定 Blob 層 [已淘汰]

此動作已被取代。 請改用 [ 依路徑設定 Blob 層 (V2) ]。

此操作會為標準儲存帳號上的區塊 blob 設定層級,使用路徑。

參數

名稱 機碼 必要 類型 Description
Blob 路徑
path True string

Blob 的唯一路徑。

Blob 層
newTier True string

Blob 的新層。

依路徑設定 Blob 層 (V2)

此作業會使用路徑在標準儲存體帳戶上設定區塊 Blob 的層。

參數

名稱 機碼 必要 類型 Description
儲存體帳戶名稱或 Blob 端點
storageAccountName True string

Azure 儲存體帳戶名稱或 Blob 端點。

Blob 路徑
path True string

Blob 的唯一路徑。

Blob 層
newTier True string

Blob 的新層。

列出 Blob [已淘汰]

此動作已被取代。 請改用 Lists Blob (V2)。

此操作會列出容器中的 blob。

參數

名稱 機碼 必要 類型 Description
資料夾
id True string

指定資料夾。

分頁標記
nextPageMarker string

標識要與清單作業一起傳回的清單部分的標記」。

平面房源
useFlatListing boolean

是否要在平面清單中列出 blob」。

傳回

代表 Blob 中繼資料的頁面。

列出 Blob (V2)

此作業會列出容器中的 Blob。

參數

名稱 機碼 必要 類型 Description
儲存體帳戶名稱或 Blob 端點
dataset True string

Azure 儲存體帳戶名稱或 Blob 端點。

資料夾
id True string

指定資料夾。

分頁標記
nextPageMarker string

標識要與清單作業一起傳回的清單部分的標記」。

平面房源
useFlatListing boolean

是否要在平面清單中列出 blob」。

擷取MIP標籤
extractSensitivityLabel boolean

指定是否要擷取 MIP 標籤。

Purview Acccount 名稱
purviewAccountName string

除非特別說明,否則會查詢預設集合。

傳回

代表一份 blob 清單及其敏感度標籤的元資料。

列出根資料夾中的 Blob [已淘汰]

此動作已被取代。 請改用根 資料夾 (V2) 中的 Lists Blob 。

此操作會列出 Azure Blob 儲存體 根目錄中的 blob。

參數

名稱 機碼 必要 類型 Description
分頁標記
nextPageMarker string

標識要與清單作業一起傳回的清單部分的標記。

傳回

代表 Blob 中繼資料的頁面。

列出根資料夾中的 Blob (V2)

此作業會列出 Azure Blob 儲存體根資料夾中的 Blob。

參數

名稱 機碼 必要 類型 Description
儲存體帳戶名稱或 Blob 端點
dataset True string

Azure 儲存體帳戶名稱或 Blob 端點。

分頁標記
nextPageMarker string

標識要與清單作業一起傳回的清單部分的標記。

傳回

代表 Blob 中繼資料的頁面。

刪除 Blob [已淘汰]

此動作已被取代。 請改用 [刪除 Blob (V2)]。

此操作會刪除一個 blob。

參數

名稱 機碼 必要 類型 Description
Blob
id True string

指定要刪除的 Blob。

刪除 Blob (V2)

此作業會刪除 Blob。

參數

名稱 機碼 必要 類型 Description
儲存體帳戶名稱或 Blob 端點
dataset True string

Azure 儲存體帳戶名稱或 Blob 端點。

Blob
id True string

指定要刪除的 Blob。

取得 Blob 中繼資料 [已淘汰]

此動作已被取代。 請改用 [取得 Blob 中繼資料 (V2)]。

此操作使用 blob ID 取得 blob 的元資料。

參數

名稱 機碼 必要 類型 Description
Blob
id True string

指定 Blob。

傳回

Blob 中繼資料

身體
BlobMetadata

取得 Blob 中繼資料 (V2)

此作業會使用 Blob 識別碼擷取 Blob 中繼資料。

參數

名稱 機碼 必要 類型 Description
儲存體帳戶名稱或 Blob 端點
dataset True string

Azure 儲存體帳戶名稱或 Blob 端點。

Blob
id True string

指定 Blob。

擷取MIP標籤
extractSensitivityLabel boolean

指定是否要擷取 MIP 標籤。

Purview Acccount 名稱
purviewAccountName string

除非特別說明,否則會查詢預設集合。

傳回

帶有敏感度標籤資訊的資料

取得 Blob 內容 [已取代]

此動作已被取代。 請改用 [取得 Blob 內容 (V2)]。

此操作利用 id 取得 blob 內容。

參數

名稱 機碼 必要 類型 Description
Blob
id True string

指定 Blob。

推斷內容類型
inferContentType boolean

根據擴充功能推斷內容類型。

傳回

檔案的內容。

檔案內容
binary

取得 Blob 內容 (V2)

此作業會使用 id 擷取 Blob 內容。

參數

名稱 機碼 必要 類型 Description
儲存體帳戶名稱或 Blob 端點
dataset True string

Azure 儲存體帳戶名稱或 Blob 端點。

Blob
id True string

指定 Blob。

推斷內容類型
inferContentType boolean

根據擴充功能推斷內容類型。

擷取MIP標籤
extractSensitivityLabel boolean

指定是否要擷取 MIP 標籤。

Purview Acccount 名稱
purviewAccountName string

除非特別說明,否則會查詢預設集合。

傳回

檔案的內容。

檔案內容
binary

取得可用的存取原則 [已淘汰]

此動作已被取代。 請改用取得可用的存取原則 (V2)。

此操作會取得 blob 可用的共享存取政策。

參數

名稱 機碼 必要 類型 Description
Blob 路徑
path True string

Blob 的唯一路徑。

傳回

取得可用的存取原則 (V2)

此作業會取得 Blob 可用的共用存取原則。

參數

名稱 機碼 必要 類型 Description
儲存體帳戶名稱或 Blob 端點
storageAccountName True string

Azure 儲存體帳戶名稱或 Blob 端點。

Blob 路徑
path True string

Blob 的唯一路徑。

傳回

將存檔解壓縮到資料夾 [已棄用]

此動作已被取代。 請改用 將存檔解壓縮到文件夾 (V2)。

此操作會將壓縮包 blob 解壓到資料夾中(例如:.zip)。

參數

名稱 機碼 必要 類型 Description
來源封存 Blob 路徑
source True string

指定封存 Blob 的路徑。

目的地資料夾路徑
destination True string

在 Azure Blob 儲存體中指定路徑,以擷取封存內容。

覆蓋?
overwrite boolean

是否應該覆寫目的地 Blob (true/false)?。

傳回

將存檔解壓縮到資料夾 (V2)

此作業會將封存 Blob 擷取到資料夾中 (例如:.zip)。

參數

名稱 機碼 必要 類型 Description
儲存體帳戶名稱或 Blob 端點
dataset True string

Azure 儲存體帳戶名稱或 Blob 端點。

來源封存 Blob 路徑
source True string

指定封存 Blob 的路徑。

目的地資料夾路徑
destination True string

在 Azure Blob 儲存體中指定路徑,以擷取封存內容。

覆蓋?
overwrite boolean

是否應該覆寫目的地 Blob (true/false)?。

傳回

建立 Blob [已淘汰]

此動作已被取代。 請改用 [建立 Blob (V2)]。

此操作會將 blob 上傳到 Azure Blob 儲存體。

參數

名稱 機碼 必要 類型 Description
資料夾路徑
folderPath True string

指定要上傳的資料夾路徑。

Blob 名稱
name True string

指定要建立的 Blob 名稱。

Blob 內容
body True binary

指定要上傳的 Blob 內容。

內容-類型
Content-Type string

指定要上傳之 Blob 的內容類型。

傳回

Blob 中繼資料

身體
BlobMetadata

建立 Blob (V2)

此作業會將 Blob 上傳至 Azure Blob 儲存體。

參數

名稱 機碼 必要 類型 Description
儲存體帳戶名稱或 Blob 端點
dataset True string

Azure 儲存體帳戶名稱或 Blob 端點。

資料夾路徑
folderPath True string

指定要上傳的資料夾路徑。

Blob 名稱
name True string

指定要建立的 Blob 名稱。

Blob 內容
body True binary

指定要上傳的 Blob 內容。

內容-類型
Content-Type string

指定要上傳之 Blob 的內容類型。

傳回

Blob 中繼資料

身體
BlobMetadata

建立區塊 Blob [已淘汰]

此動作已被取代。 請改用建立區塊 Blob (V2)。

此操作會將區塊 blob 上傳至 Azure Blob 儲存體。

參數

名稱 機碼 必要 類型 Description
指定要上傳的資料夾路徑
folderPath True string

指定要上傳的資料夾路徑。

指定要建立的 Blob 名稱
name True string

指定要建立的 Blob 名稱。

Blob 內容
body True binary

指定要上傳的 Blob 內容。

內容-類型
Content-Type string

指定要上傳之 Blob 的內容類型。

建立區塊 Blob (V2)

此作業會將區塊 Blob 上傳至 Azure Blob 儲存體。

參數

名稱 機碼 必要 類型 Description
儲存體帳戶名稱或 Blob 端點
storageAccountName True string

儲存體帳戶名稱。

指定要上傳的資料夾路徑
folderPath True string

指定要上傳的資料夾路徑。

指定要建立的 Blob 名稱
name True string

指定要建立的 Blob 名稱。

Blob 內容
body True binary

指定要上傳的 Blob 內容。

內容-類型
Content-Type string

指定要上傳之 Blob 的內容類型。

更新 Blob [已淘汰]

此動作已被取代。 請改用更新 Blob (V2)。

此操作會更新 Azure Blob 儲存體 中的 blob。

參數

名稱 機碼 必要 類型 Description
Blob
id True string

指定要更新的 Blob。

Blob 內容
body True binary

指定要更新的 Blob 內容。

內容-類型
Content-Type string

指定要上傳之 Blob 的內容類型。

傳回

Blob 中繼資料

身體
BlobMetadata

更新 Blob (V2)

此作業會更新 Azure Blob 儲存體中的 Blob。

參數

名稱 機碼 必要 類型 Description
儲存體帳戶名稱或 Blob 端點
dataset True string

Azure 儲存體帳戶名稱或 Blob 端點。

Blob
id True string

指定要更新的 Blob。

Blob 內容
body True binary

指定要更新的 Blob 內容。

內容-類型
Content-Type string

指定要上傳之 Blob 的內容類型。

傳回

Blob 中繼資料

身體
BlobMetadata

複製 Blob [已淘汰]

此動作已被取代。 請改用 [複製 Blob (V2)]。

此作業會複製 Blob。 如果 Blob 在複製之後立即在伺服器上刪除/重新命名,連接器可能會根據其設計傳回 HTTP 404 錯誤。 請先延遲 1 分鐘,再刪除或重新命名新建立的 Blob。 此動作不支援區塊傳輸。 如果來源和目的地存在於相同的儲存體帳戶中,請使用相對路徑。 否則,複製 Blob 作業的來源大小上限為 50 MB。

參數

名稱 機碼 必要 類型 Description
來源網址
source True string

指定來源 Blob 的 URL。

目的地 Blob 路徑
destination True string

指定目的地 Blob 路徑,包括目標 Blob 名稱。

覆蓋?
overwrite boolean

是否應該覆寫目的地 Blob (true/false)?。

傳回

Blob 中繼資料

身體
BlobMetadata

複製 Blob (V2)

此作業會複製 Blob。 如果 Blob 在複製之後立即在伺服器上刪除/重新命名,連接器可能會根據其設計傳回 HTTP 404 錯誤。 請先延遲 1 分鐘,再刪除或重新命名新建立的 Blob。 此動作不支援區塊傳輸。 如果來源和目的地存在於相同的儲存體帳戶中,請使用相對路徑。 否則,複製 Blob 作業的來源大小上限為 50 MB。

參數

名稱 機碼 必要 類型 Description
儲存體帳戶名稱或 Blob 端點
dataset True string

Azure 儲存體帳戶名稱或 Blob 端點。

來源網址
source True string

指定來源 Blob 的 URL。

目的地 Blob 路徑
destination True string

指定目的地 Blob 路徑,包括目標 Blob 名稱。

覆蓋?
overwrite boolean

是否應該覆寫目的地 Blob (true/false)?。

傳回

Blob 中繼資料

身體
BlobMetadata

觸發程序

新增或修改 Blob 時 (僅限屬性) [已取代]

此動作已被取代。 請改用新增或修改 Blob 時 (僅限屬性) (V2)。

當在容器中新增或修改一或多個 Blob 時,此作業會觸發流程。 此觸發器只會擷取檔案中繼資料。 若要取得檔案內容,您可以使用「取得檔案內容」操作。 如果在子資料夾中新增/更新檔案,則不會觸發觸發程式。 如果需要在子資料夾上觸發,則應建立多個觸發程式。

新增或修改 Blob 時 (僅限屬性) (V2)

當在容器中新增或修改一或多個 Blob 時,此作業會觸發流程。 此觸發器只會擷取檔案中繼資料。 若要取得檔案內容,您可以使用「取得檔案內容」操作。 如果在子資料夾中新增/更新檔案,則不會觸發觸發程式。 如果需要在子資料夾上觸發,則應建立多個觸發程式。

新增或修改 Blob 時 (僅限屬性) [已取代]

此動作已被取代。 請改用新增或修改 Blob 時 (僅限屬性) (V2)。

當在容器中新增或修改一或多個 Blob 時,此作業會觸發流程。 此觸發器只會擷取檔案中繼資料。 若要取得檔案內容,您可以使用「取得檔案內容」操作。 如果在子資料夾中新增/更新檔案,則不會觸發觸發程式。 如果需要在子資料夾上觸發,則應建立多個觸發程式。

參數

名稱 機碼 必要 類型 Description
容器
folderId True string

選取容器。

要傳回的 Blob 數目
maxFileCount integer

要從觸發程式傳回的 Blob 數目上限 (1-100)。

傳回

Blob 中繼資料

檔案清單
BlobMetadata

新增或修改 Blob 時 (僅限屬性) (V2)

當在容器中新增或修改一或多個 Blob 時,此作業會觸發流程。 此觸發器只會擷取檔案中繼資料。 若要取得檔案內容,您可以使用「取得檔案內容」操作。 如果在子資料夾中新增/更新檔案,則不會觸發觸發程式。 如果需要在子資料夾上觸發,則應建立多個觸發程式。

參數

名稱 機碼 必要 類型 Description
儲存體帳戶名稱或 Blob 端點
dataset True string

Azure 儲存體帳戶名稱或 Blob 端點。

容器
folderId True string

選取容器。

要傳回的 Blob 數目
maxFileCount integer

要從觸發程式傳回的 Blob 數目上限 (1-100)。

傳回

Blob 中繼資料

檔案清單
BlobMetadata

定義

Blob中繼資料

Blob 中繼資料

名稱 路徑 類型 Description
Id
Id string

檔案或資料夾的唯一識別碼。

名稱
Name string

檔案或資料夾的名稱。

顯示名稱
DisplayName string

檔案或資料夾的顯示名稱。

路徑
Path string

檔案或資料夾的路徑。

最後修改
LastModified date-time

上次修改檔案或資料夾的日期和時間。

大小
Size integer

檔案或資料夾的大小。

媒體類型
MediaType string

檔案或資料夾的媒體類型。

Is資料夾
IsFolder boolean

布林值 (true、false) ,指出 Blob 是否為資料夾。

Etag
ETag string

檔案或資料夾的 etag。

檔案定位器
FileLocator string

檔案或資料夾的檔案定位器。

BlobsWithSensitivityLabels 列表

代表一份 blob 清單及其敏感度標籤的元資料。

名稱 路徑 類型 Description
value
value array of DataWithSensitivityLabelInfo

Blobs 列表

DataWithSensitivityLabelInfo

帶有敏感度標籤資訊的資料

名稱 路徑 類型 Description
Id
Id string

檔案或資料夾的唯一識別碼。

名稱
Name string

檔案或資料夾的名稱。

顯示名稱
DisplayName string

檔案或資料夾的顯示名稱。

路徑
Path string

檔案或資料夾的路徑。

最後修改
LastModified date-time

上次修改檔案或資料夾的日期和時間。

大小
Size integer

檔案或資料夾的大小。

媒體類型
MediaType string

檔案或資料夾的媒體類型。

Is資料夾
IsFolder boolean

布林值 (true、false) ,指出 Blob 是否為資料夾。

Etag
ETag string

檔案或資料夾的 etag。

檔案定位器
FileLocator string

檔案或資料夾的檔案定位器。

敏感度標籤資訊
SensitivityLabelInfo array of SensitivityLabelMetadata

敏感度標籤元資料資訊清單

BlobMetadataPage

代表 Blob 中繼資料的頁面。

名稱 路徑 類型 Description
value
value array of BlobMetadata

Blob 中繼資料收集。

nextLink
nextLink string

可用來擷取下一頁的 URL。

下一頁標記
nextPageMarker string

可用來擷取下一頁的標記。

SensitivityLabel中繼資料

SensitivityLabel 元資料資訊

名稱 路徑 類型 Description
敏感度標籤標識
sensitivityLabelId string

SensitivityLabel 標識碼。

name
name string

SensitivityLabel 名稱。

displayName
displayName string

SensitivityLabel displayName 資訊

工具提示
tooltip string

SensitivityLabel 詳細資料。

priority
priority integer

SensitivityLabel 優先順序。

色彩
color string

SensitivityLabel 色彩。

是否已加密
isEncrypted boolean

是 SensitivityLabel 加密的。

isEnabled
isEnabled boolean

是否已啟用 SensitivityLabel。

是父項
isParent boolean

SensitivityLabel 是否為父系。

parentSensitivityLabelId
parentSensitivityLabelId string

父 SensitivityLabel 識別碼。

SharedAccessSignatureBlobPolicy

產生 SAS 連結的參數集。

名稱 路徑 類型 Description
群組原則識別碼
GroupPolicyIdentifier string

識別預存存取原則的字串。 群組原則參數 (例如開始時間和結束時間) 優先於動作中提及的輸入參數。

權限
Permissions string

SAS 上指定的權限 (以逗號分隔的值)。

開始時間
StartTime date-time

SAS 變成有效的日期和時間 (例如:「2017-11-01T15:30:00+00:00')。 預設值 = now()。

到期時間
ExpiryTime date-time

SAS 不再有效的日期和時間 (例如:「2017-12-01T15:30:00+00:00')。 預設值 = now() + 24h。

共用存取通訊協定
AccessProtocol string

允許的通訊協定 (僅限 https,或 http 和 https)。 如果您不想限制通訊協定,則為 Null。

IP 位址或 IP 位址範圍
IpAddressOrRange string

允許的 IP 位址或 IP 位址範圍。 如果您不想根據 IP 位址進行限制,則為 Null。

共用存取簽章

共用存取簽章

名稱 路徑 類型 Description
網址
WebUrl uri

具有存取權杖之物件的 URL。

二進位

這是基本數據類型 『binary』。