你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
此包包含用于 Azure CarbonOptimizationManagement 客户端的同构 SDK(在 Node.js 和浏览器中运行)。
碳报告资源提供程序查询 API。
Key links:
Getting started
当前支持的环境
- LTS 版本的 Node.js
- 最新版本的 Safari、Chrome、Edge 和 Firefox。
有关更多详细信息,请参阅我们的 支持政策 。
Prerequisites
- 一个 Azure 订阅。
安装 @azure/arm-carbonoptimization
包
使用以下命令 npm
安装适用于 JavaScript 的 Azure CarbonOptimizationManagement 客户端库:
npm install @azure/arm-carbonoptimization
创建和验证 CarbonOptimizationManagementClient
要创建客户端对象以访问 Azure CarbonOptimizationManagement API,您需要 endpoint
Azure CarbonOptimizationManagement 资源的 credential
. Azure CarbonOptimizationManagement 客户端可以使用 Azure Active Directory 凭据进行身份验证。
可以在 Azure 门户中找到 Azure CarbonOptimizationManagement 资源的终结点。
可以使用 @azure/标识 库中的凭据或 现有 AAD 令牌向 Azure Active Directory 进行身份验证。
若要使用下面显示的 DefaultAzureCredential 提供程序或随 Azure SDK 提供的其他凭据提供程序,请安装该 @azure/identity
包:
npm install @azure/identity
还需要注册新的 AAD 应用程序,并通过向服务主体分配合适的角色来 授予对 Azure CarbonOptimizationManagement 的访问权限 (注意:诸如此类 "Owner"
的角色不会授予必要的权限)。
有关如何创建 Azure AD 应用程序的详细信息,请查看 本指南。
使用 Node.js 和类似 Node 的环境,可以使用 DefaultAzureCredential
类对客户端进行身份验证。
import { CarbonOptimizationManagementClient } from "@azure/arm-carbonoptimization";
import { DefaultAzureCredential } from "@azure/identity";
const client = new CarbonOptimizationManagementClient(new DefaultAzureCredential());
对于浏览器环境,请使用 InteractiveBrowserCredential
包中的 @azure/identity
进行身份验证。
import { InteractiveBrowserCredential } from "@azure/identity";
import { CarbonOptimizationManagementClient } from "@azure/arm-carbonoptimization";
const credential = new InteractiveBrowserCredential({
tenantId: "<YOUR_TENANT_ID>",
clientId: "<YOUR_CLIENT_ID>",
});
const client = new CarbonOptimizationManagementClient(credential);
JavaScript Bundle
若要在浏览器中使用此客户端库,首先需要使用捆绑程序。 有关如何执行此作的详细信息,请参阅我们的 捆绑文档。
Key concepts
CarbonOptimizationManagementClient
CarbonOptimizationManagementClient
是使用 Azure CarbonOptimizationManagement 客户端库的开发人员的主要界面。 探索此客户端对象上的方法,以了解可以访问的 Azure CarbonOptimizationManagement 服务的不同功能。
Troubleshooting
Logging
启用日志记录可能有助于发现有关故障的有用信息。 若要查看 HTTP 请求和响应的日志,请将 AZURE_LOG_LEVEL
环境变量设置为 info
。 或者,可以通过在 setLogLevel
中调用 @azure/logger
在运行时启用日志记录:
import { setLogLevel } from "@azure/logger";
setLogLevel("info");
有关如何启用日志的更详细说明,可以查看 @azure/记录器包文档。
Next steps
请查看 示例 目录,了解如何使用此库的详细示例。
Contributing
如果您想为该库做出贡献,请阅读 贡献指南 以了解有关如何构建和测试代码的更多信息。