通过

你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

适用于 JavaScript 的 Azure ImageBuilder 客户端库 - 版本 4.1.0

  • 项目

此包包含 Azure ImageBuilder 客户端的同态 SDK（在 Node.js 和浏览器中运行）。

Azure 虚拟机映像生成器客户端

源代码 | 包（NPM） | API 参考文档 | 示例

开始

当前支持的环境

有关详细信息，请参阅我们的 支持策略。

先决条件

安装 @azure/arm-imagebuilder 包

使用 npm安装适用于 JavaScript 的 Azure ImageBuilder 客户端库：

npm install @azure/arm-imagebuilder

创建和验证 ImageBuilderClient

若要创建用于访问 Azure ImageBuilder API 的客户端对象，需要 Azure ImageBuilder 资源的 endpoint 和 credential。 Azure ImageBuilder 客户端可以使用 Azure Active Directory 凭据进行身份验证。 可以在 Azure 门户中找到 Azure ImageBuilder 资源的终结点。

可以使用来自 @azure/标识 库的凭据或使用现有 AAD 令牌Azure Active Directory 进行身份验证。

若要使用如下所示的 DefaultAzureCredential 提供程序，或 Azure SDK 提供的其他凭据提供程序，请安装 @azure/identity 包：

npm install @azure/identity

还需要 注册新的 AAD 应用程序，并通过向服务主体分配合适的角色来授予对 Azure ImageBuilder 的访问权限（注意："Owner" 等角色不会授予必要的权限）。 将 AAD 应用程序的客户端 ID、租户 ID 和客户端机密的值设置为环境变量：AZURE_CLIENT_ID、AZURE_TENANT_ID、AZURE_CLIENT_SECRET。

有关如何创建 Azure AD 应用程序的详细信息，请参阅本指南 。

const { ImageBuilderClient } = require("@azure/arm-imagebuilder");
const { DefaultAzureCredential } = require("@azure/identity");
// For client-side applications running in the browser, use InteractiveBrowserCredential instead of DefaultAzureCredential. See https://aka.ms/azsdk/js/identity/examples for more details.

const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new ImageBuilderClient(new DefaultAzureCredential(), subscriptionId);

// For client-side applications running in the browser, use this code instead:
// const credential = new InteractiveBrowserCredential({
//   tenantId: "<YOUR_TENANT_ID>",
//   clientId: "<YOUR_CLIENT_ID>"
// });
// const client = new ImageBuilderClient(credential, subscriptionId);

JavaScript 捆绑包

若要在浏览器中使用此客户端库，首先需要使用捆绑程序。 有关如何执行此操作的详细信息，请参阅我们的 捆绑文档。

关键概念

ImageBuilderClient

ImageBuilderClient 是开发人员使用 Azure ImageBuilder 客户端库的主要界面。 探索此客户端对象上的方法，了解可以访问的 Azure ImageBuilder 服务的不同功能。

故障 排除

伐木

启用日志记录可能有助于发现有关故障的有用信息。 若要查看 HTTP 请求和响应的日志，请将 AZURE_LOG_LEVEL 环境变量设置为 info。 或者，可以通过在 @azure/logger中调用 setLogLevel 在运行时启用日志记录：

const { setLogLevel } = require("@azure/logger");
setLogLevel("info");

有关如何启用日志的更详细说明，可以查看 @azure/记录器包文档。

后续步骤

有关如何使用此库的详细示例，请查看 示例 目录。

贡献

若要参与此库，请阅读 贡献指南 了解有关如何生成和测试代码的详细信息。

印象