Domains - Sync Role Assignments To Subdomains

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

Синхронизируйте назначения ролей из указанного домена с поддоменами.

Permissions

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

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

Tenant.ReadWrite.All.

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

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

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

Интерфейс

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

Параметры URI

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

string (uuid)

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

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

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

DomainRole

Указывает роль элементов, которые необходимо синхронизировать с поддоменами.

Ответы

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

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

ErrorResponse

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

Заголовки

Retry-After: integer
Other Status Codes

ErrorResponse

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

  • SyncingAdminsToSubdomainsIsNotSupported— синхронизация администраторов с поддоменами не поддерживается

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

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

Примеры

Assign domain contributors to subdomains example

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

POST https://api.fabric.microsoft.com/v1/admin/domains/d27d5b23-4a7e-4185-b81e-ac2b20cdd9a8/roleAssignments/syncToSubdomains

{
  "role": "Contributor"
}

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

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

Определения

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

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

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

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

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

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

DomainRole

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

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

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

Администратор домена.
Contributor

Участник домена.

ErrorRelatedResource

Объект

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

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

string

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

string

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

ErrorResponse

Объект

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

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

string

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

string

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

ErrorResponseDetails[]

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

ErrorRelatedResource

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

string (uuid)

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

ErrorResponseDetails

Объект

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

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

string

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

string

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

ErrorRelatedResource

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

SyncRoleAssignmentsToSubdomainsRequest

Объект

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

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

DomainRole

Указывает роль элементов, которые необходимо синхронизировать с поддоменами.