你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
该包包含一个同构的 SDK(可在 Node.js 和浏览器中运行),用于 AppLink 客户端Azure。
关键链接:
入门
目前支持的环境
- Node.js的 LTS 版本
- 最新版本的 Safari、Chrome、Edge 和 Firefox。
有关更多详细信息,请参阅我们的支持政策。
Prerequisites
安装 @azure/arm-appnetwork 包
安装 JavaScript 的 Azure AppLink 客户端库,使用:npm
npm install @azure/arm-appnetwork
创建和验证 AppLinkClient
要创建客户端对象访问 Azure AppLink API,你需要 Azure AppLink 资源中的 和endpoint一个 credential。 Azure AppLink 客户端可以使用 Azure Active Directory 凭证进行认证。
你可以在 Azure 门户 中找到你的 Azure AppLink 资源的端点。
可以使用来自
若要使用如下所示的 DefaultAzureCredential 提供程序,或 Azure SDK 提供的其他凭据提供程序,请安装 @azure/identity 包:
npm install @azure/identity
你还需要注册一个新的AAD应用程序,并通过将合适的角色分配给服务主体来授予Azure AppLink的访问权限(注意:此类"Owner"角色不会授予必要的权限)。
有关如何创建 Azure AD 应用程序的详细信息,请参阅本指南 。
使用 Node.js 和类似 Node 的环境,可以使用 DefaultAzureCredential 类对客户端进行身份验证。
import { AppLinkClient } from "@azure/arm-appnetwork";
import { DefaultAzureCredential } from "@azure/identity";
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new AppLinkClient(new DefaultAzureCredential(), subscriptionId);
对于浏览器环境,请使用 InteractiveBrowserCredential 包中的 @azure/identity 进行身份验证。
import { InteractiveBrowserCredential } from "@azure/identity";
import { AppLinkClient } from "@azure/arm-appnetwork";
const credential = new InteractiveBrowserCredential({
tenantId: "<YOUR_TENANT_ID>",
clientId: "<YOUR_CLIENT_ID>",
});
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new AppLinkClient(credential, subscriptionId);
JavaScript 捆绑包
若要在浏览器中使用此客户端库,首先需要使用捆绑程序。 有关如何执行此作的详细信息,请参阅我们的 捆绑文档。
重要概念
AppLink客户端
AppLinkClient是开发者使用 Azure AppLink 客户端库的主要接口。 探索该客户端对象的方法,了解您可以访问的 Azure AppLink 服务的不同功能。
Troubleshooting
伐木业
启用日志记录可能有助于发现有关故障的有用信息。 若要查看 HTTP 请求和响应的日志,请将 AZURE_LOG_LEVEL 环境变量设置为 info。 或者,可以通过在 setLogLevel中调用 @azure/logger 在运行时启用日志记录:
import { setLogLevel } from "@azure/logger";
setLogLevel("info");
有关如何启用日志的更详细说明,可以查看 @azure/记录器包文档。
后续步骤
请查看 示例 目录,获取有关如何使用此库的详细示例。
Contributing
若要参与此库,请阅读 参与指南 ,详细了解如何生成和测试代码。