Azure MicrosoftSerialConsole biblioteca cliente para JavaScript - versão 3.0.0

Este pacote contém um SDK isomorfo (roda tanto em Node.js quanto em navegadores) para Azure cliente MicrosoftSerialConsole.

O Azure Serial Console permite que você acesse o console serial de uma Máquina Virtual ou de uma instância de conjunto de escalas de VM

Links de chave:

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-serialconsole

Instale a biblioteca cliente Azure MicrosoftSerialConsole para JavaScript com npm:

npm install @azure/arm-serialconsole

Criar e autenticar um MicrosoftSerialConsoleClient

Para criar um objeto cliente para acessar a API Azure MicrosoftSerialConsole, você precisará do endpoint do seu recurso Azure MicrosoftSerialConsole e de um credential. O cliente MicrosoftSerialConsole do Azure pode usar credenciais do Azure Active Directory para autenticar. Você pode encontrar o endpoint para seu recurso Azure MicrosoftSerialConsole no portal do Azure.

Você pode autenticar com Azure Active Directory usando uma credencial da biblioteca @azure/identity ou um Token AAD existente.

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

npm install @azure/identity

Você também precisará registrar uma nova aplicação AAD e conceder acesso ao Azure MicrosoftSerialConsole atribuindo o papel adequado ao seu principal de serviço (nota: funções como "Owner" não concederão as permissões necessárias).

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

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

import { MicrosoftSerialConsoleClient } from "@azure/arm-serialconsole";
import { DefaultAzureCredential } from "@azure/identity";

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

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { MicrosoftSerialConsoleClient } from "@azure/arm-serialconsole";

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

Pacote JavaScript

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

Conceitos principais

MicrosoftSerialConsoleClient

MicrosoftSerialConsoleClient é a interface principal para desenvolvedores que utilizam a biblioteca cliente Azure MicrosoftSerialConsole. Explore os métodos neste objeto cliente para entender os diferentes recursos do serviço Azure MicrosoftSerialConsole que você pode acessar.

Solução de problemas

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 variável de ambiente AZURE_LOG_LEVEL como info. Alternativamente, o logging pode ser ativado em tempo de execução chamando setLogLevel no @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.

Próximas Etapas 

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

Contributing

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