技能 @azure/storage-file-share (TypeScript/JavaScript)
📦

@azure/storage-file-share (TypeScript/JavaScript)

安全

使用 TypeScript 管理 Azure 檔案共用

透過現成的 TypeScript 範例簡化 Azure 檔案共用整合。此參考技能提供 SMB 檔案操作、驗證和錯誤處理的程式碼模式。

支援: Claude Codex Code(CC)
🥉 72 青銅
1

下載技能 ZIP

2

在 Claude 中上傳

前往 設定 → 功能 → 技能 → 上傳技能

3

開啟並開始使用

測試它

正在使用「@azure/storage-file-share (TypeScript/JavaScript)」。 示範如何建立檔案共用並上傳檔案

預期結果:

使用您的連接字串建立 ShareServiceClient，取得共用名稱的 ShareClient，呼叫 create() 方法，然後取得 FileClient 並使用 uploadRange() 上傳內容。

正在使用「@azure/storage-file-share (TypeScript/JavaScript)」。 如何從 Azure 檔案共用下載檔案？

預期結果:

使用 ShareFileClient.download() 方法取得可下載的串流，然後從 readableStreamBody 屬性讀取區塊並將其串連成 Buffer。

安全審計

安全
v1 • 2/25/2026

Prompt-only documentation skill with no executable code. Contains TypeScript examples for Azure SDK usage. No security risks detected. All code examples are reference documentation demonstrating legitimate Azure Storage File Share operations.

0
已掃描檔案
0
分析行數
0
發現項
1
審計總數
未發現安全問題
審計者: claude

品質評分

38
架構
100
可維護性
87
內容
50
社群
100
安全
74
規範符合性

你能建構什麼

整合 Azure 檔案儲存體的後端開發者

正在建置 Node.js 應用程式的開發者需要��用 SMB 通訊協定從 Azure 檔案共用儲存和擷取檔案。他們需要驗證和檔案操作的快速參考程式碼。

設定雲端儲存體的 DevOps 工程師

正在設定與 Azure 檔案共用互動的自動化工作流程的工程師。他們需要以程式方式建立共用、設定配額和管理目錄的範例。

遷移檔案儲存體的全端開發者

正在從本機檔案系統遷移到 Azure 儲存體檔案共用的開發者。他們需要關於生產環境使用的上傳模式、串流處理和錯誤處理的指導。

試試這些提示

基本檔案上傳 
示範如何使用 TypeScript 上傳檔案到 Azure 檔案共用
列出目錄內容 
提供程式碼以列出 Azure 檔案共用目錄中��所有檔案和目錄
串流大型檔案上傳 
如何在 Node.js 中使用串流上傳大型檔案到 Azure 檔案共用？
產生 SAS 權杖 
示範如何產生具有特定權限的 SAS 權杖以進行安全檔案存取

最佳實務

  • 在生產環境中使用 DefaultAzureCredential 而非硬��編碼的憑證
  • 在共用上設定配額以防止無限檔案成長造成的意外儲存成本
  • 對大型檔案使用串流方法以避免將整個檔案載入記憶體
  • 透過檢查 statusCode 來處理特定錯誤條件的 RestError 例外

避免

  • 絕不���在原始碼中硬式編碼儲存體帳號金鑰或連接字串
  • 當 uploadStream 更有效率時，避免對大型檔案使用 uploadRange
  • 不要跳過錯誤處理——Azure 操作可能因為網路或驗證問題而失敗
  • 絕不要在錯誤訊息中記錄或暴露 SAS 權杖或儲存體帳號金鑰

常見問題

我應該使用哪種驗證方法？
在本機開發中使用連接字串。在生產環境中，使用 DefaultAzureCredential 與受控識別進行安全、無金鑰的驗證。
我可以在瀏覽器應用程式中使用此技能嗎？
部分功能如 SAS 產生和檔案操作僅適用於 Node.js。瀏覽器應用程式必須使用預先產生的 SAS 權杖進行驗證。
如何處理大型檔案上傳？
使用 uploadStream() 方法並搭配可設定的緩衝區大小和並行性來處理大於 256MB 的檔案，以避免記憶體問題。
ShareClient 和 ShareDirectoryClient 有什麼區別？
ShareClient 在共用層級操作配額和快照。ShareDirectoryClient 處理共用內的目錄和檔案操作。
如何實作錯誤處理？
捕捉 RestError 例外並檢查 statusCode 屬性。處理 404（找不到）、409（衝突）�� 403（拒絕存取）錯誤。
我可以建立檔案共用的快照嗎？
可以，使用 shareClient.createSnapshot() 建立時間點快照。使用 withSnapshot() 方法存取快照，並使用 deleteSnapshots 選項刪除。

開發者詳情

作者

sickn33

授權

MIT

儲存庫

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/azure-storage-file-share-ts

引用

main

檔案結構

📄 SKILL.md