Compartilhar via


Biblioteca de clientes da API do Azure ContainerApps para JavaScript – versão 3.0.0

Esse pacote contém um SDK isomórfico (executado em Node.js e em navegadores) para o cliente da API containerApps do Azure.

O aplicativo lógico é um recurso de extensão no aplicativo de contêiner e o recurso de extensão permite operações lógicas específicas no aplicativo de contêiner por meio das APIs listadas.

Código-fonte | Pacote (NPM) | Documentação | Amostras

Como começar

Ambientes com suporte no momento

Consulte nossa política de suporte para obter mais detalhes.

Pré-requisitos

Instalar o pacote @azure/arm-appcontainers

Instale a biblioteca de clientes da API containerApps do Azure para JavaScript com npm:

npm install @azure/arm-appcontainers

Criar e autenticar um ContainerAppsAPIClient

Para criar um objeto cliente para acessar a API de API containerApps do Azure, você precisará do endpoint recurso da API do Azure ContainerApps e de um credential. O cliente da API containerApps do Azure pode usar credenciais do Azure Active Directory para autenticar. Você pode encontrar o ponto de extremidade para o recurso de API do Azure ContainerApps no Portal do Azure.

Você pode autenticar com o Azure Active Directory usando uma credencial da biblioteca de de @azure/identidade ou um token do AAD existente.

Para usar o provedor DefaultAzureCredential mostrado abaixo ou outros provedores de credenciais fornecidos com o SDK do Azure, instale o @azure/identity pacote:

npm install @azure/identity

Você também precisará registrar um novo aplicativo do AAD e conceder acesso à API do Azure ContainerApps atribuindo a função adequada à entidade de serviço (observação: funções como "Owner" não concederão as permissões necessárias).

Para obter mais informações sobre como criar um aplicativo do Azure AD, confira este guia.

Usando ambientes semelhantes a Node.js e nó, você pode usar a classe DefaultAzureCredential para autenticar o cliente.

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);

Para ambientes de navegador, use o InteractiveBrowserCredential do pacote @azure/identity para autenticar.

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

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

Pacote JavaScript

Para usar essa biblioteca de clientes no navegador, primeiro você precisa usar um empacotador. Para obter detalhes sobre como fazer isso, consulte nossa documentação de agrupamento.

Conceitos principais

ContainerAppsAPIClient

ContainerAppsAPIClient é a interface principal para desenvolvedores que usam a biblioteca de clientes da API containerApps do Azure. Explore os métodos neste objeto cliente para entender os diferentes recursos do serviço de API ContainerApps do Azure que você pode acessar.

Resolução de problemas

Registro

Habilitar o registro em log pode ajudar a descobrir informações úteis sobre falhas. Para ver um log de solicitações e respostas HTTP, defina a variável de AZURE_LOG_LEVEL ambiente como info. Como alternativa, o registro em log pode ser habilitado em runtime chamandosetLogLevel:@azure/logger

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

setLogLevel("info");

Para obter instruções mais detalhadas sobre como habilitar logs, você pode examinar os documentos do pacote de @azure/agente.

Próximas etapas

Examine os exemplos de diretório para obter exemplos detalhados sobre como usar essa biblioteca.

Contribuindo

Se você quiser contribuir com essa biblioteca, leia o guia de contribuição para saber mais sobre como criar e testar o código.

  • do SDK do Microsoft Azure para JavaScript