Azure Marketplace client library for JavaScript - versão 1.0.0

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

APIs REST para Marketplace Privado

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

Instale a biblioteca cliente do Azure Marketplace para JavaScript com npm:

npm install @azure/arm-marketplace

Criar e autenticar um MarketplaceClient

Para criar um objeto cliente para acessar a API do Azure Marketplace, você precisará do endpoint seu recurso do Azure Marketplace e de um credentialarquivo . O cliente do Azure Marketplace pode usar credenciais Azure Active Directory para autenticação. Você pode encontrar o endpoint do seu recurso do Azure Marketplace 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, instale o pacote @azure/identity:

npm install @azure/identity

Você também precisará registrar uma nova aplicação AAD e conceder acesso ao Azure Marketplace atribuindo o papel adequado ao seu principal de serviço (nota: cargos como não "Owner" concedem 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 { MarketplaceClient } from "@azure/arm-marketplace";
import { DefaultAzureCredential } from "@azure/identity";

const client = new MarketplaceClient(new DefaultAzureCredential());

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { MarketplaceClient } from "@azure/arm-marketplace";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const client = new MarketplaceClient(credential);

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

MarketplaceClient

MarketplaceClient é a interface principal para desenvolvedores que utilizam a biblioteca cliente do Azure Marketplace. Explore os métodos neste objeto cliente para entender os diferentes recursos do serviço Azure Marketplace 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 variável de ambiente AZURE_LOG_LEVEL como info. Como alternativa, o registro em log pode ser habilitado em runtime 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.

  • do SDK do Microsoft Azure para JavaScript
  • Last updated on