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

Получение личного домена клиента

  • Статья

Область применения: Центр партнеров

Получает ресурс CustomDomain.

При создании новой учетной записи клиента в Центре партнеров ей назначается уникальный домен. Этот домен можно использовать для идентификации клиента, и его также можно использовать для других целей, таких как настройка почтового ящика.

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

  • Учетные данные, как описано в разделе об аутентификации Центра партнеров. Этот сценарий поддерживает учетные данные приложения и пользователя или проверку подлинности только для приложений.

  • Идентификатор клиента (customer-tenant-id). Если вы не знаете ID клиента, вы можете найти его в Центре партнеров. Выберите рабочую область Клиенты на домашней странице Центра партнеров. Выберите клиента из списка клиентов и выберите учетную запись. На странице "Учетная запись клиента" найдите идентификатор Майкрософт в разделе сведений об учетной записи клиента. Идентификатор Microsoft совпадает с идентификатором клиента (customer-tenant-id).

Внимание

Роли GDAP необходимы для вызова этого API. DAP не поддерживается. Проверка подлинности партнера по-прежнему требуется (AdminAgent/HelpDeskAgent/SalesAgent)

Роли GDAP

Вам необходимо иметь хотя бы одну из следующих ролей GDAP:

  • Редактор каталогов
  • Всемирный читатель
  • Администратор домена

Запрос REST

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

Способ URI запроса
GET {baseURL}/v1/customers/{customer-tenant-id}/customDomains HTTP/1.1

URI-параметр

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

Имя. Тип Обязательно Описание
customer-tenant-id guid Y Это значение — идентификатор GUID, отформатированный как customer-tenant-id, который позволяет торговому посреднику фильтровать результаты для указанного клиента, принадлежащего этому посреднику.

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

Для получения дополнительной информации см. раздел «Заголовки REST Центра партнеров».

Текст запроса

Нет.

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

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/customDomains HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

Ответ REST

В случае успешного выполнения этот метод возвращает ресурс пользовательского домена в тексте ответа.

Коды успешного и ошибочного ответа

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

Пример ответа

HTTP/1.1 200 OK
Content-Length: 1530
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 74ca1db9-df92-41c6-a362-a16433b0542b

["contosco.onmicrosoft.com"]

Связанный контент

  • Получить информацию об организации клиента