Azure Extensions biblioteca cliente para JavaScript - versão 1.0.0

Este pacote contém um SDK isomorfo (executa tanto em Node.js como em navegadores) para Azure cliente Extensions.

Use estas APIs para criar recursos de extensão através do ARM, para Clusters Kubernetes.

Ligações principais:

Como Começar

Ambientes atualmente suportados

Consulte a nossa política apoio para mais detalhes.

Pré-requisitos

  • Uma subscrição Azure.

Instalar o pacote @azure/arm-kubernetesconfiguration-extensions

Instale a biblioteca cliente Azure Extensions para JavaScript com npm:

npm install @azure/arm-kubernetesconfiguration-extensions

Criar e autenticar um ExtensionsClient

Para criar um objeto cliente para aceder à API Azure Extensions, vai precisar do endpoint do seu recurso Azure Extensions e de um credential. O cliente Azure Extensions pode usar credenciais do Azure Active Directory para autenticar. Podes encontrar o endpoint para o teu recurso Azure Extensões no portal do Azure.

Pode autenticar-se com Azure Active Directory usando uma credencial da biblioteca @azure/identity ou um Token AAD existente.

Para usar o fornecedor DefaultAzureCredential mostrado abaixo, ou outros fornecedores de credenciais fornecidos com o SDK do Azure, por favor instale o pacote @azure/identity:

npm install @azure/identity

Também terá de registar uma nova candidatura AAD e conceder acesso às Azure Extensões atribuindo o papel adequado ao seu principal de serviço (nota: funções como "Owner" não concedem as permissões necessárias).

Para mais informações sobre como criar uma Azure Aplicação AD, consulte este guia.

Usando ambientes Node.js e Node-like, você pode usar a classe DefaultAzureCredential para autenticar o cliente.

import { ExtensionsClient } from "@azure/arm-kubernetesconfiguration-extensions";
import { DefaultAzureCredential } from "@azure/identity";

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

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { ExtensionsClient } from "@azure/arm-kubernetesconfiguration-extensions";

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

Pacote JavaScript

Para usar essa biblioteca de cliente no navegador, primeiro você precisa usar um bundler. Para detalhes sobre como to do isto, consulte a nossa documentação de agrupamento.

Conceitos-chave

ExtensionsClient

ExtensionsClient é a interface principal para programadores que utilizam a biblioteca cliente Azure Extensions. Explore os métodos neste objeto cliente para compreender as diferentes funcionalidades do serviço Azure Extensions a que pode aceder.

Troubleshooting

Registo

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 ambiente AZURE_LOG_LEVEL como info. Alternativamente, o registo pode ser ativado em tempo de execução chamando setLogLevel no @azure/logger:

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

setLogLevel("info");

Para instruções mais detalhadas sobre como ativar registos, pode consultar o pacote @azure/logger docs.

Passos seguintes

Por favor, consulte o diretório samples para exemplos detalhados de como usar esta biblioteca.

Contributing

Se quiser contribuir para esta biblioteca, por favor leia o guia contribuição para saber mais sobre como construir e testar o código.