Azure ContainerAppsAPI client library for JavaScript - version 4.0.0

此套件包含一個同構的 SDK(可在 Node.js 與瀏覽器中執行),用於 ContainerAppsAPI 用戶端Azure

Functions 是修訂的延伸模塊資源,而列出的 API 是用來將 Web RP 呼叫 Proxy 至函式應用程式的主機進程,此 API 不會公開給使用者,而且只允許 Web RP 叫用函式擴充資源。

主要連結:

入門指南

目前支援的環境

如需詳細資訊,請參閱我們的 支持原則 。

先決條件

安裝 @azure/arm-appcontainers 套件

安裝 Azure ContainerAppsAPI 用戶端函式庫,JavaScript 格式為 npm:

npm install @azure/arm-appcontainers

建立及驗證 ContainerAppsAPIClient

要建立客戶端物件來存取 Azure ContainerAppsAPI API,你需要你Azure ContainerAppsAPI 資源的 endpoint 以及一個 credential。 Azure ContainerAppsAPI 用戶端可以使用 Azure Active Directory 憑證來認證。 你可以在 Azure 入口網站 找到你Azure ContainerAppsAPI 資源的端點。

您可以使用 來自@azure/身分識別 連結庫或 現有 AAD 令牌的認證,向 Azure Active Directory 進行驗證。

若要使用如下所示 的 DefaultAzureCredential 提供者,或 Azure SDK 所提供的其他認證提供者,請安裝 @azure/identity 套件:

npm install @azure/identity

你還需要註冊一個新的 AAD 應用程式,並透過指派適當的角色給你的服務主體,授予 Azure ContainerAppsAPI 的存取權(注意:像是 "Owner" 這類角色不會授予必要的權限)。

如需如何建立 Azure AD 應用程式的詳細資訊,請參閱本指南 。

使用 Node.js 和類似節點的環境,您可以使用 DefaultAzureCredential 類別來驗證用戶端。

import { ContainerAppsAPIClient } from "@azure/arm-appcontainers";
import { DefaultAzureCredential } from "@azure/identity";

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

針對瀏覽器環境,請使用來自 InteractiveBrowserCredential 套件的 @azure/identity 進行驗證。

import { InteractiveBrowserCredential } from "@azure/identity";
import { ContainerAppsAPIClient } from "@azure/arm-appcontainers";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new ContainerAppsAPIClient(credential, subscriptionId);

JavaScript 套件組合

若要在瀏覽器中使用此用戶端連結庫,您必須先使用配套程式。 如需如何執行這項作的詳細資訊,請參閱我們的 統合檔。

重要概念

ContainerAppsAPIClient

ContainerAppsAPIClient 是開發者使用 Azure ContainerAppsAPI 用戶端函式庫的主要介面。 探索這個客戶端物件上的方法,以了解你可以存取的 Azure ContainerAppsAPI 服務的不同功能。

故障排除

森林伐木業

啟用記錄可能有助於找出有關失敗的實用資訊。 若要檢視 HTTP 要求和回應的記錄,請將 AZURE_LOG_LEVEL 環境變數設定為 info。 或者,您可以在 執行時間呼叫 setLogLevel@azure/logger來啟用記錄:

import { setLogLevel } from "@azure/logger";

setLogLevel("info");

如需如何啟用記錄的詳細指示,您可以查看 @azure/記錄器套件檔。

後續步驟

如需如何使用此連結庫的詳細範例,請參閱 範例 目錄。

貢獻

如果您想要參與此連結庫,請閱讀 參與指南 ,以深入瞭解如何建置和測試程序代碼。