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

Domains - Create Domain

  • Ссылка
Служба:
Admin
Версия API:
v1

Заметка

Этот API находится в предварительной версии.

Создает новый домен.

Разрешения

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

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

Tenant.ReadWrite.All.

Ограничения

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

Поддерживаемые удостоверения Microsoft Entra

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

Тождество Поддержка
Пользователь Да
субъекта-службы и управляемых удостоверений Да

Интерфейс

POST https://api.fabric.microsoft.com/v1/admin/domains

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

Имя Обязательно Тип Описание
displayName True

string

Отображаемое имя домена. Отображаемое имя не может содержать более 40 символов.
description

string

Описание домена. Описание не может содержать более 256 символов.
parentDomainId

string

uuid

Идентификатор родительского объекта домена.

Ответы

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

Domain

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

ErrorResponse

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

  • EntityNotFound — не удалось создать домен, так как родительский идентификатор домена не найден.

  • EntityConflict — не удалось создать домен, так как отображаемое имя домена уже существует.

  • InvalidInput — недопустимый идентификатор родительского домена.

Примеры

Create a domain example

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

POST https://api.fabric.microsoft.com/v1/admin/domains

{
  "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

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

Представляет домен или поддомен.
ErrorRelatedResource

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

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

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

ContributorsScopeType

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

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

Значение Описание
AdminsOnly

Только администраторы клиента и домена.
AllTenant

Все пользователи клиента.
SpecificUsersAndGroups

Определенные пользователи и группы.

CreateDomainRequest

Object

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

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

string

Описание домена. Описание не может содержать более 256 символов.
displayName

string

Отображаемое имя домена. Отображаемое имя не может содержать более 40 символов.
parentDomainId

string

uuid

Идентификатор родительского объекта домена.

Domain

Object

Представляет домен или поддомен.

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

ContributorsScopeType

Область участников домена.
description

string

Описание домена.
displayName

string

Имя домена.
id

string

uuid

Идентификатор объекта домена.
parentDomainId

string

uuid

Идентификатор родительского объекта домена.

ErrorRelatedResource

Object

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

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

string

Идентификатор ресурса, участвующий в ошибке.
resourceType

string

Тип ресурса, который участвует в ошибке.

ErrorResponse

Object

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

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

string

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

string

Удобочитаемое представление ошибки.
moreDetails

ErrorResponseDetails[]

Список дополнительных сведений об ошибке.
relatedResource

ErrorRelatedResource

Сведения об ошибках, связанных с ресурсом.
requestId

string

Идентификатор запроса, связанного с ошибкой.

ErrorResponseDetails

Object

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

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

string

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

string

Удобочитаемое представление ошибки.
relatedResource

ErrorRelatedResource

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