Domains - Role Assignments Bulk Unassign

服務:

Admin

API 版本:

v1

注意

此 API 處於預覽狀態。

從網域取消指派指定的系統管理員或參與者。

權限

呼叫端必須是網狀架構系統管理員。

必要的委派範圍

Tenant.ReadWrite.All。

局限性

每個主體每分鐘最多 25 個要求。

Microsoft Entra 支援的身分識別

此 API 支援本節中列出的Microsoft 身分識別。

身份	支援
使用者	是的
服務主體 和 受控識別	是的

介面

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

URI 參數

名稱	位於	必要	類型	Description
domainId	path	True	string uuid	網域標識碼。

要求本文

名稱	必要	類型	Description
type	True	DomainRole	更新要求類型。
principals		Principal[]	代表身分識別或Microsoft Entra 群組。

回應

名稱	類型	Description
200 OK		要求成功完成。
Other Status Codes	ErrorResponse	常見的錯誤碼： DomainSpecificUsersScopeCannotBeEmptyError - 取消指派網域成員失敗，因為當參與者範圍設定為 「特定使用者和群組」時，使用者或群組清單不能是空的。

範例

Unassign domain admins example

Unassign domain contributors example

Unassign domain admins example

範例要求

HTTP

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

{
  "type": "Admins",
  "principals": [
    {
      "id": "796ce6ad-9163-4c16-9559-c68192a251de",
      "type": "User"
    }
  ]
}

範例回覆

狀態碼:

200

Unassign domain contributors example

範例要求

HTTP

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

{
  "type": "Contributors",
  "principals": [
    {
      "id": "796ce6ad-9163-4c16-9559-c68192a251de",
      "type": "User"
    }
  ]
}

範例回覆

狀態碼:

200

定義

名稱	Description
DomainRole	表示主體要求類型的網域成員。 可能會隨著時間新增其他要求類型。
DomainRoleUnassignmentRequest	依主體取消指派網域成員的要求承載。
ErrorRelatedResource	錯誤相關的資源詳細資料物件。
ErrorResponse	錯誤回應。
ErrorResponseDetails	錯誤回應詳細數據。
GroupDetails	群組特定詳細數據。 當主體類型 Group時適用。
GroupType	群組的類型。 可能會隨著時間新增其他群組類型。
Principal	代表身分識別或Microsoft Entra 群組。
PrincipalType	主體的類型。 可能會隨著時間新增其他主體類型。
ServicePrincipalDetails	服務主體特定詳細數據。 當主體類型 ServicePrincipal時適用。
ServicePrincipalProfileDetails	服務主體配置檔詳細數據。 當主體類型 ServicePrincipalProfile時適用。
UserDetails	用戶主體特定詳細數據。 當主體類型 User時適用。

DomainRole

Enumeration

表示主體要求類型的網域成員。 可能會隨著時間新增其他要求類型。

值	Description
Admins	網域管理員要求類型。
Contributors	網域參與者要求類型。

DomainRoleUnassignmentRequest

Object

依主體取消指派網域成員的要求承載。

名稱	類型	Description
principals	Principal[]	代表身分識別或Microsoft Entra 群組。
type	DomainRole	更新要求類型。

ErrorRelatedResource

Object

錯誤相關的資源詳細資料物件。

名稱	類型	Description
resourceId	string	發生錯誤的資源識別碼。
resourceType	string	發生錯誤的資源類型。

ErrorResponse

Object

錯誤回應。

名稱	類型	Description
errorCode	string	提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
message	string	錯誤的人類可讀取表示法。
moreDetails	ErrorResponseDetails[]	其他錯誤詳細數據的清單。
relatedResource	ErrorRelatedResource	錯誤相關的資源詳細數據。
requestId	string	與錯誤相關聯的要求標識碼。

ErrorResponseDetails

Object

錯誤回應詳細數據。

名稱	類型	Description
errorCode	string	提供錯誤狀況相關信息的特定標識碼，允許服務與其使用者之間的標準化通訊。
message	string	錯誤的人類可讀取表示法。
relatedResource	ErrorRelatedResource	錯誤相關的資源詳細數據。

GroupDetails

Object

群組特定詳細數據。 當主體類型 Group時適用。

名稱	類型	Description
groupType	GroupType	群組的類型。 可能會隨著時間新增其他群組類型。

GroupType

Enumeration

群組的類型。 可能會隨著時間新增其他群組類型。

值	Description
DistributionList	主體是通訊組清單。
SecurityGroup	主體是安全組。
Unknown	主體群組類型未知。

Principal

Object

代表身分識別或Microsoft Entra 群組。

名稱	類型	Description
displayName	string	主體的顯示名稱。
groupDetails	GroupDetails	群組特定詳細數據。 當主體類型 Group時適用。
id	string uuid	主體的標識碼。
servicePrincipalDetails	ServicePrincipalDetails	服務主體特定詳細數據。 當主體類型 ServicePrincipal時適用。
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	服務主體配置檔詳細數據。 當主體類型 ServicePrincipalProfile時適用。
type	PrincipalType	主體的類型。 可能會隨著時間新增其他主體類型。
userDetails	UserDetails	用戶主體特定詳細數據。 當主體類型 User時適用。

PrincipalType

Enumeration

主體的類型。 可能會隨著時間新增其他主體類型。

值	Description
Group	主體是安全組。
ServicePrincipal	主體是Microsoft Entra 服務主體。
ServicePrincipalProfile	主體是服務主體配置檔。
User	主體是 entra 用戶主體Microsoft。

ServicePrincipalDetails

Object

服務主體特定詳細數據。 當主體類型 ServicePrincipal時適用。

名稱	類型	Description
aadAppId	string uuid	服務主體的 Microsoft Entra AppId。

ServicePrincipalProfileDetails

Object

服務主體配置檔詳細數據。 當主體類型 ServicePrincipalProfile時適用。

名稱	類型	Description
parentPrincipal	Principal	服務主體配置檔的父主體。

UserDetails

Object

用戶主體特定詳細數據。 當主體類型 User時適用。

名稱	類型	Description
userPrincipalName	string	用戶主體名稱。