Клиентская библиотека API Azure TopLevelDomains для JavaScript — версия 1.0.0

Этот пакет содержит изоморфный SDK (работает как в Node.js, так и в браузерах) для Azure клиента API TopLevelDomains.

Ключевые ссылки:

Начало работы

Поддерживаемые в настоящее время среды

Чтобы получить дополнительные сведения, ознакомьтесь с нашей политикой поддержки.

Необходимые условия

Установите пакет @azure/arm-domainregistration.

Установите клиентскую библиотеку API Azure TopLevelDomains для JavaScript с помощью npm:

npm install @azure/arm-domainregistration

Создание и проверка подлинности DomainRegistrationManagementClient

Чтобы создать клиентский объект для доступа к API API Azure TopLevelDomains, вам понадобится endpoint вашего Azure TopLevelDomains API и credential. Клиент API Azure TopLevelDomains может использовать Azure Active Directory credentials для аутентификации. Вы можете найти конечную точку для вашего Azure TopLevelDomains API в портал Azure.

Вы можете пройти проверку подлинности с помощью Azure Active Directory с помощью учетных данных из библиотеки @azure/удостоверений или существующего токена AAD.

Чтобы использовать провайдера DefaultAzureCredential, показанного ниже, или других поставщиков учетных данных, предоставленных с SDK Azure, пожалуйста, установите пакет @azure/identity:

npm install @azure/identity

Вам также нужно будет зарегистрировать приложение AAD и предоставить доступ к Azure TopLevelDomains API назначив соответствующую роль вашему руководителю службы (примечание: такие роли, как "Owner", не предоставляют необходимые разрешения).

Дополнительные сведения о создании приложения Azure AD см. в этом руководстве.

Используя среды Node.js и node-like, можно использовать класс DefaultAzureCredential для проверки подлинности клиента.

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);

Для браузерных сред используйте InteractiveBrowserCredential из пакета @azure/identity для аутентификации.

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);

Пакет JavaScript

Чтобы использовать эту клиентную библиотеку в браузере, сначала необходимо использовать пакет. Подробнее о том, как to do это, пожалуйста, обратитесь к нашей документации по bundling.

Основные понятия

DomainRegistrationManagementClient

DomainRegistrationManagementClient является основным интерфейсом для разработчиков, использующих клиентскую библиотеку API Azure TopLevelDomains. Изучите методы на этом клиентском объекте, чтобы понять различные функции API сервиса Azure TopLevelDomains, к которым вы можете получить доступ.

Troubleshooting

Logging

Включение ведения журнала может помочь выявить полезные сведения о сбоях. Чтобы просмотреть журнал HTTP-запросов и ответов, задайте для переменной среды AZURE_LOG_LEVEL значение info. В альтернативном порядке, логирование можно включить во время выполнения, вызвав setLogLevel в @azure/logger:

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

setLogLevel("info");

Дополнительные инструкции по включению журналов см. в документации по пакету @azure/loger.

Дальнейшие действия

Ознакомьтесь с примерами каталога, чтобы получить подробные примеры использования этой библиотеки.

Contributing

Если вы хотите внести вклад в эту библиотеку, пожалуйста, ознакомьтесь с руководством contributing guide чтобы узнать больше о том, как создавать и тестировать код.

  • Last updated on