用于 js 的 azure sdk

适用于 JavaScript 的 Azure SDK

此存储库适用于 Azure SDK for JavaScript（Node.js 和浏览器）。它包含适用于各种 Azure 服务的库。管理库是用于预配和管理 Azure 资源的包。客户端库是您用来使用这些资源并与它们交互的包。

入门

一些有用的入门资源是：

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

每个服务可能有以下每个类别的多个可用库：

• 客户
• 管理

注意：其中一些软件包有测试版。如果您需要确保代码已准备好用于生产，请使用稳定的非测试版软件包之一。

客户

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

要获取遵循新准则的所有客户端库的列表，请访问我们的 Azure SDK 版本页面。

管理

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

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

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

注意：如果您在升级某些软件包后遇到管理库的身份验证问题，可能是您升级到新版本的 SDK 时未更改身份验证代码，请参阅上面提到的迁移指南以获取正确的说明。

需要帮助吗？

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

社区

尝试我们的社区资源。

报告安全问题和安全错误

安全问题和错误应通过电子邮件私下报告给 Microsoft 安全响应中心 (MSRC) [email protected]。您应该会在 24 小时内收到回复。如果由于某种原因您没有这样做，请通过电子邮件跟进，以确保我们收到您的原始消息。可以在安全技术中心找到更多信息，包括 MSRC PGP 密钥。

贡献

有关对此存储库做出贡献的详细信息，请参阅贡献指南。

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

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

该项目采用了微软开源行为准则。有关详细信息，请参阅行为准则常见问题解答或联系 [email protected] 提出任何其他问题或意见。