Azure SDK for JavaScript

这个仓库是用于 Azure SDK for JavaScript（Node.js 和浏览器）。它包含了广泛的 Azure 服务库。管理库是用于配置和管理 Azure 资源的包。客户端库是用于使用这些资源并与之交互的包。

入门

以下是一些有助于入门的资源：

• 每个包的 readme 文件包含代码示例和包信息。这个 readme 文件可以在本仓库 /sdk 文件夹中您选择的服务文件夹下的相应包文件夹中找到。同样的 readme 文件也可以在 npm 上该包的登录页面找到。
• 这些包最新版本的 API 参考文档可以在我们的公共开发者文档中找到。
• 旧版本的 API 参考文档可以在我们的版本化开发者文档中找到。

每个服务可能有多个库可用，分为以下类别：

• 客户端
• 管理

注意：这些包中有些有 beta 版本。如果您需要确保您的代码可以用于生产环境，请使用稳定的非 beta 包。

客户端

假设 Azure 资源已经存在，您可以使用客户端库来使用它并与之交互。 这些库中的大多数遵循 Azure SDK JavaScript 和 TypeScript 设计指南，并共享许多核心功能，如重试、日志记录、传输协议、身份验证协议等。其他库将在不久的将来更新以遵循这些指南。

要获取遵循新指南的所有客户端库列表，请访问我们的 Azure SDK 发布页面。

管理

管理库使您能够通过 Azure 资源管理器（ARM） 配置和管理 Azure 资源。您可以通过包名中的 @azure/arm- 识别这些库。这些库完全基于代表资源管理 API 的 swagger 文件自动生成。

这些库的较新版本遵循 Azure SDK TypeScript 设计指南。这些新版本提供了许多在所有 Azure SDK 之间共享的核心功能，包括直观的 Azure Identity 库、具有自定义策略的 HTTP 管道、错误处理、分布式跟踪等。以下是一些有助于入门的资源：

• 遵循新指南的管理库列表
• 文档和代码示例
• 迁移指南，展示如何从旧版库过渡。

注意：如果在升级某些包后遇到管理库的身份验证问题，可能是因为您升级到了新版 SDK 但没有更改身份验证代码，请参考上述迁移指南以获得正确的说明。

需要帮助？

• 详细文档，请访问我们的 Azure SDK for JavaScript 文档
• 通过 GitHub Issues 提交问题
• 查看 之前的问题 或在 StackOverflow 上使用 azure-sdk-js 标签提出新问题。
• 阅读我们的 支持文档。

社区

尝试我们的 社区资源。

报告安全问题和安全漏洞

安全问题和漏洞应该通过电子邮件私下报告给微软安全响应中心 (MSRC) secure@microsoft.com。您应该在 24 小时内收到回复。如果由于某些原因没有收到回复，请通过电子邮件跟进，以确保我们收到了您的原始消息。更多信息，包括 MSRC PGP 密钥，可以在 安全技术中心 找到。

贡献

有关为此仓库贡献的详细信息，请参阅 贡献指南。

本项目欢迎贡献和建议。大多数贡献要求您同意贡献者许可协议 (CLA)，声明您有权并且确实授予我们使用您贡献的权利。有关详细信息，请访问 https://cla.microsoft.com。

当您提交拉取请求时，CLA-bot 将自动确定您是否需要提供 CLA，并相应地修饰 PR（例如，标签、评论）。只需按照机器人提供的说明操作即可。您只需在所有使用我们的 CLA 的仓库中执行一次此操作。

本项目已采用 微软开源行为准则。有关更多信息，请参阅 行为准则常见问题，或联系 opencode@microsoft.com 获取任何其他问题或意见。