技能 @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 Storage 文件共享。他们需要上传模式、流处理和生产环境错误处理的指导。

试试这些提示

基本文件上传 
展示如何使用 TypeScript 上传文件到 Azure 文件共享
列出目录内容 
提供代码以列出 Azure 文件共享目录中的所有文件和目录
流式大文件上传 
如何在 Node.js 中使用流将大文件上传到 Azure 文件共享？
生成 SAS 令牌 
展示如何生成具有特定权限的 SAS 令牌以实现安全文件访问

最佳实践

  • 在生产环境中使用 DefaultAzureCredential 而不是硬编码凭据
  • 为共享设置配额以防止因无限文件增长而产生意外的存储成本
  • 对大文件使用流式方法以避免将整个文件加载到内存中
  • 通过检查 statusCode 处理 RestError 异常以处理特定错误条件

避免

  • 切勿在源代码中硬编码存储账户密钥或连接字符串
  • 当 uploadStream 更高效时，避免对大文件使用 uploadRange
  • 不要跳过错误处理 - Azure 操作可能因网络或身份验证问题而失败
  • 切勿在错误消息中记录或暴露 SAS 令牌或存储账户密钥

常见问题

我应该使用什么身份验证方法？
本地开发使用连接字符串。生产环境使用 DefaultAzureCredential 配合托管标识实现安全的无密钥身份验证。
我可以在浏览器应用程序中使用此技能吗？
某些功能（如 SAS 生成和文件操作）仅支持 Node.js。浏览器应用程序必须使用预生成的 SAS 令牌进行身份验证。
如何处理大文件上传？
对于大于 256MB 的文件，使用 uploadStream() 方法并配置缓冲区大小和并发性以避免内存问题。
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