Domains - Assign Domain Workspaces By Ids

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

Назначение рабочих областей указанному домену по идентификатору рабочей области.
Предварительные назначения домена будут переопределены, если массовый переназначение не блокируется параметрами клиента управления доменами.

Permissions

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

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

Tenant.ReadWrite.All.

Limitations

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

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

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

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

Interface

POST https://api.fabric.microsoft.com/v1/admin/domains/{domainId}/assignWorkspaces

Параметры URI

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

string (uuid)

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

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

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

string[] (uuid)

Идентификаторы рабочих областей, которые будут назначены данному домену.

Ответы

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

Запрос успешно завершен.
429 Too Many Requests

ErrorResponse

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

Заголовки

Retry-After: integer
Other Status Codes

ErrorResponse

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

  • DomainNotFound — предоставленный домен не найден

  • UnknownError — произошла ошибка.

Примеры

Assign domain workspaces example

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

POST https://api.fabric.microsoft.com/v1/admin/domains/97dd1d38-a4c6-41ed-bc4f-1e383f8ddd0f/assignWorkspaces

{
  "workspacesIds": [
    "e8de1852-7382-480a-8404-d5b1f5e1ab65",
    "5348d3a9-c096-4074-9083-09e3ca69c8e5",
    "ac561643-c5c5-4cf1-868e-8755a90e6fa3"
  ]
}

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

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

Определения

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

Полезные данные запроса для назначения рабочих областей домену по идентификатору рабочей области.
ErrorRelatedResource

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

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

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

AssignDomainWorkspacesByIdsRequest

Объект

Полезные данные запроса для назначения рабочих областей домену по идентификатору рабочей области.

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

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

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