Проверка доступности домена

Статья
06/19/2023

Область применения: Центр партнеров | Центр партнеров, управляемый 21Vianet | Центр партнеров для Microsoft Cloud for US Government

Как определить, доступен ли домен для использования.

Предварительные условия

Учетные данные, описанные в статье о проверке подлинности в Центре партнеров. Этот сценарий поддерживает проверку подлинности с использованием учетных данных автономного приложения и приложения и пользователя.
Домен (например contoso.onmicrosoft.com, ).

C#

Чтобы проверить, доступен ли домен, сначала вызовите IAggregatePartner.Domains , чтобы получить интерфейс для операций с доменом. Затем вызовите метод ByDomain с доменом, чтобы проверка. Этот метод извлекает интерфейс для операций, доступных для определенного домена. Наконец, вызовите метод Exists , чтобы проверить, существует ли домен.

// IAggregatePartner partnerOperations;
// const string domain = "contoso.onmicrosoft.com";

bool result = partnerOperations.Domains.ByDomain(domain).Exists();

Пример: тестовое консольное приложение. Проект: Примеры пакета SDK Центра партнеров , класс: CheckDomainAvailability.cs

Запрос REST

Синтаксис запроса

Метод	Универсальный код ресурса (URI) запроса
HEAD	{baseURL}/v1/domains/{domain} HTTP/1.1

Параметр универсального кода ресурса (URI)

Используйте следующий параметр запроса для проверки доступности домена.

Имя	Тип	Обязательно	Описание
Домена	строка	Да	Строка, которая идентифицирует проверяемый домен.

Заголовки запроса

Дополнительные сведения см. в статье о заголовках REST Центра партнеров.

Тело запроса

Нет

Пример запроса

HEAD https://api.partnercenter.microsoft.com/v1/domains/contoso.onmicrosoft.com HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: cf5b00d6-9240-431c-a973-cc06c904e5bf
MS-CorrelationId: ec57501a-a4c3-45ee-ab2b-da4250545fc9
X-Locale: en-US
Host: api.partnercenter.microsoft.com
Connection: Keep-Alive

Ответ REST

Если домен существует, он недоступен для использования и возвращается код состояния ответа 200 OK. Если домен не найден, он доступен для использования и возвращается код состояния ответа 404 Не найдено.

Коды успешного выполнения и ошибок в ответе

Каждый ответ сопровождается кодом состояния HTTP, обозначающим успешное или неудачное выполнение, и дополнительными сведениями для отладки. Используйте средство трассировки сети, чтобы просматривать этот код, тип ошибки и дополнительные параметры. Полный список ответов есть в статье Коды ошибок REST в Центре партнеров.

Пример ответа, когда домен уже используется

HTTP/1.1 200 OK
Content-Length: 0
MS-CorrelationId: ec57501a-a4c3-45ee-ab2b-da4250545fc9
MS-RequestId: cf5b00d6-9240-431c-a973-cc06c904e5bf
MS-CV: 7UXAHds8J0mNUCSp.0
MS-ServerId: 201022015
Date: Tue, 31 Jan 2017 22:22:35 GMT

Пример ответа, когда домен доступен

HTTP/1.1 404 Not Found
Content-Length: 0
MS-CorrelationId: 54770745-17f0-433c-bd7b-0265e5b38f98
MS-RequestId: 1169a4cd-3be7-4e29-9cb3-0f78ffa2e91e
MS-CV: RRmc+bEw9U2e97CC.0
MS-ServerId: 202010406
Date: Tue, 31 Jan 2017 22:36:01 GMT

Поделиться через