Domains - Create Domain (preview)

Служба:: Admin

Версия API:: v1

Создает новый домен (предварительная версия).

Замечание

Этот api предварительной версии будет устарел 31 марта 2026 г. и заменен стабильной версией, доступной здесь. Новая версия вводит критические изменения и не совместима с обратной совместимостью. При вызове этого API вызывающие серверы должны указать true значение параметра previewзапроса.

Уведомление об отмене использования

Был введен новый параметр preview запроса для упрощения этого перехода:

Параметр preview запроса в настоящее время используется trueпо умолчанию.
Задайте значение preview параметра запроса, чтобы false использовать версию выпуска этого API.
Начиная с 31 марта 2026 г. значение preview по умолчанию изменится falseна .

Рекомендуется перенести интеграцию, чтобы использовать версию выпуска как можно скорее, указав false параметр previewзапроса (значение по умолчанию для preview параметра запроса будет задано false на дату отмены API).

В версии выпуска были введены следующие несовместимые изменения:

Свойство contributorsScope ответа было удалено.

Permissions

Вызывающий объект должен быть администратором Fabric.

Обязательные делегированные области

Tenant.Read.All или Tenant.ReadWrite.All.

Ограничения

Не более 25 запросов в одну минуту на участника.

Идентификаторы, поддерживаемые Microsoft Entra

Этот API поддерживает идентичности Microsoft, перечисленные в этом разделе.

Идентичность	Support
User	Да
Представитель службы и управляемые удостоверения	Да

Интерфейс

POST https://api.fabric.microsoft.com/v1/admin/domains?preview={preview}

Параметры URI

Имя	В	Обязательно	Тип	Описание
preview	query	True	boolean	Этот параметр задает используемую версию API. Установите для `true` использования предварительной версии, описанной на этой странице, или `false` для использования версии выпуска, подробно описанной здесь. Начиная с 31 марта 2026 г. значение `preview` по умолчанию изменится `false`на .

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

Имя	Обязательно	Тип	Описание
displayName	True	string	Отображаемое имя домена. Отображаемое имя не может содержать более 40 символов.
description		string	Описание домена. Описание не может содержать более 256 символов.
parentDomainId		string (uuid)	Идентификатор родительского объекта домена.

Ответы

Имя Тип Описание

201 Created

Имя	Тип	Описание
201 Created	DomainPreview	Домен успешно создан.
429 Too Many Requests	ErrorResponse	Превышено ограничение скорости обслуживания. Сервер возвращает заголовок, указывающий `Retry-After` в секундах, сколько времени клиент должен ждать перед отправкой дополнительных запросов. Заголовки Retry-After: integer
Other Status Codes	ErrorResponse	Распространенные коды ошибок: EntityNotFound — не удалось создать домен, так как родительский идентификатор домена не найден. EntityConflict — не удалось создать домен, так как отображаемое имя домена уже существует. InvalidInput — недопустимый идентификатор родительского домена.

DomainPreview

Домен успешно создан.

429 Too Many Requests

ErrorResponse

Превышено ограничение скорости обслуживания. Сервер возвращает заголовок, указывающий Retry-After в секундах, сколько времени клиент должен ждать перед отправкой дополнительных запросов.

Заголовки

Retry-After: integer

Other Status Codes

ErrorResponse

Распространенные коды ошибок:

EntityNotFound — не удалось создать домен, так как родительский идентификатор домена не найден.
EntityConflict — не удалось создать домен, так как отображаемое имя домена уже существует.
InvalidInput — недопустимый идентификатор родительского домена.

Примеры

Create a domain example

Образец запроса

HTTP

POST https://api.fabric.microsoft.com/v1/admin/domains?preview=True

{
  "displayName": "Finance",
  "description": "This domain is used for identifying financial data and reports.",
  "parentDomainId": "5f6552c3-816c-43e7-8289-842f8b35f9df"
}

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

Код состояния:: 201

{
  "id": "9eba6944-daff-4441-b9b5-630ce34238fd",
  "displayName": "Finance",
  "description": "This domain is used for identifying financial data and reports.",
  "parentDomainId": "5f6552c3-816c-43e7-8289-842f8b35f9df",
  "contributorsScope": "AllTenant"
}

Определения

Имя	Описание
ContributorsScopeType	Область участника. С течением времени могут добавляться дополнительные области участников.
CreateDomainRequest	Полезные данные запроса для создания домена или поддомена.
DomainPreview
ErrorRelatedResource	Объект сведений об ошибках, связанных с ресурсом.
ErrorResponse	Ответ на ошибку.
ErrorResponseDetails	Сведения об ответе на ошибку.

ContributorsScopeType

Перечисление

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

Значение	Описание
AllTenant	Все пользователи клиента.
SpecificUsersAndGroups	Определенные пользователи и группы.
AdminsOnly	Только администраторы клиента и домена.

CreateDomainRequest

Объект

Полезные данные запроса для создания домена или поддомена.

Имя	Тип	Описание
description	string	Описание домена. Описание не может содержать более 256 символов.
displayName	string	Отображаемое имя домена. Отображаемое имя не может содержать более 40 символов.
parentDomainId	string (uuid)	Идентификатор родительского объекта домена.

DomainPreview

Объект

Имя	Тип	Описание
contributorsScope	ContributorsScopeType	Область участников домена.
description	string	Описание домена.
displayName	string	Имя домена.
id	string (uuid)	Идентификатор объекта домена.
parentDomainId	string (uuid)	Идентификатор родительского объекта домена.

ErrorRelatedResource

Объект

Объект сведений об ошибках, связанных с ресурсом.

Имя	Тип	Описание
resourceId	string	Идентификатор ресурса, участвующий в ошибке.
resourceType	string	Тип ресурса, который участвует в ошибке.

ErrorResponse

Объект

Ответ на ошибку.

Имя	Тип	Описание
errorCode	string	Определенный идентификатор, предоставляющий сведения об условии ошибки, что позволяет стандартизировать обмен данными между службой и ее пользователями.
message	string	Удобочитаемое представление ошибки.
moreDetails	ErrorResponseDetails[]	Список дополнительных сведений об ошибке.
relatedResource	ErrorRelatedResource	Сведения об ошибках, связанных с ресурсом.
requestId	string (uuid)	Идентификатор запроса, связанного с ошибкой.

ErrorResponseDetails

Объект

Сведения об ответе на ошибку.

Имя	Тип	Описание
errorCode	string	Определенный идентификатор, предоставляющий сведения об условии ошибки, что позволяет стандартизировать обмен данными между службой и ее пользователями.
message	string	Удобочитаемое представление ошибки.
relatedResource	ErrorRelatedResource	Сведения об ошибках, связанных с ресурсом.