Azure Deployments biblioteca cliente para JavaScript - versão 1.0.0-beta.2

Este pacote contém um SDK isomórfico (executado em Node.js e em navegadores) para o cliente de Implantações do Azure.

Fornece operações para trabalhar com implantações.

Ligações principais:

Como Começar

Ambientes atualmente suportados

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

Prerequisites

  • Uma assinatura do Azure.

Instalar o pacote @azure/arm-resourcesdeployments

Instale a biblioteca de cliente do Azure Deployments para JavaScript com npm:

npm install @azure/arm-resourcesdeployments

Criar e autenticar um DeploymentsClient

Para criar um objeto de cliente para acessar a API de Implantações do Azure, você precisará endpoint do recurso Implantações do Azure e de um credentialarquivo . O cliente de Implantações do Azure pode usar as credenciais do Azure Ative Directory para autenticar. Pode encontrar o endpoint para o seu recurso de Azure Deployments no portal do Azure.

Você pode autenticar com o Azure Ative Directory usando uma credencial da biblioteca de @azure/identidade ou umde token 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 AAD e conceder acesso às Implantações do Azure atribuindo a função adequada à sua entidade de serviço (observação: funções como as que "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 Node.js e Node-like, você pode usar a classe DefaultAzureCredential para autenticar o cliente.

import { DeploymentsClient } from "@azure/arm-resourcesdeployments";
import { DefaultAzureCredential } from "@azure/identity";

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

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { DeploymentsClient } from "@azure/arm-resourcesdeployments";

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

Pacote JavaScript

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

Conceitos principais

DeploymentsClient

DeploymentsClient é a interface principal para desenvolvedores que usam a biblioteca de cliente do Azure Deployments. Explore os métodos neste objeto de cliente para entender os diferentes recursos do serviço Implantações do Azure que você pode acessar.

Troubleshooting

Logging

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 AZURE_LOG_LEVEL variável de ambiente como info. Como alternativa, o registro em log pode ser habilitado em tempo de execução chamando setLogLevel o @azure/logger:

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

setLogLevel("info");

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

Passos seguintes

Por favor, dê uma olhada no diretório de exemplos para obter exemplos detalhados sobre como usar esta biblioteca.

Contributing

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