Biblioteca cliente API Azure TopLevelDomains para JavaScript - versão 1.0.0

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

Links principais:

Como começar

Ambientes com suporte no momento

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

Prerequisites

Instalar o pacote @azure/arm-domainregistration

Instale a biblioteca cliente da API Azure TopLevelDomains para JavaScript com npm:

npm install @azure/arm-domainregistration

Criar e autenticar um DomainRegistrationManagementClient

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

npm install @azure/identity

Você também precisará registrar uma nova aplicação AAD e conceder acesso à API Azure TopLevelDomains 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 obter mais informações sobre como criar um aplicativo do Azure AD, confira este guia.

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

import { DomainRegistrationManagementClient } from "@azure/arm-domainregistration";
import { DefaultAzureCredential } from "@azure/identity";

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

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

import { InteractiveBrowserCredential } from "@azure/identity";
import { DomainRegistrationManagementClient } from "@azure/arm-domainregistration";

const credential = new InteractiveBrowserCredential({
  tenantId: "<YOUR_TENANT_ID>",
  clientId: "<YOUR_CLIENT_ID>",
});
const subscriptionId = "00000000-0000-0000-0000-000000000000";
const client = new DomainRegistrationManagementClient(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

DomainRegistrationManagementClient

DomainRegistrationManagementClient é a interface principal para desenvolvedores que utilizam a biblioteca cliente da API Azure TopLevelDomains. Explore os métodos neste objeto cliente para entender as diferentes funcionalidades do serviço API Azure TopLevelDomains que você pode acessar.

Solução de problemas

Registro em log

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