共用方式為

Domains - Assign Domain Workspaces By Principals

  • 參考
服務:
Admin
API 版本:
v1

注意

此 API 處於預覽狀態。

當其中一個指定的主體具有工作區中的系統管理員許可權時，將工作區指派給指定的網域。
除非網域管理租使用者設定封鎖大量重新指派，否則將會覆寫預先存在的網域指派。

此 API 支援 長時間執行的作業 （LRO）。

權限

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

必要的委派範圍

Tenant.ReadWrite.All。

局限性

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

Microsoft Entra 支援的身分識別

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

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

介面

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

URI 參數

名稱 位於 必要 類型 Description
domainId
 path True

string

uuid

網域標識碼。

要求本文

名稱 類型 Description
principals

Principal[]

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

回應

名稱 類型 Description
202 Accepted

作業正在進行中

標題

  • Location: string
  • Retry-After: integer
  • x-ms-operation-id: string
Other Status Codes

ErrorResponse

常見的錯誤碼：

  • UnknownError - 發生錯誤。

範例

Assign domain workspaces example

範例要求

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

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

範例回覆

狀態碼:
202 
Location: https://api.fabric.microsoft.com/operations/cfafbeb1-8037-4d0c-896e-a46fb27ff227
x-ms-operation-id: cfafbeb1-8037-4d0c-896e-a46fb27ff227
Retry-After: 30

定義

名稱 Description
AssignDomainWorkspacesByPrincipalsRequest

依主體將工作區指派給網域的要求承載。
ErrorRelatedResource

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

錯誤回應。
ErrorResponseDetails

錯誤回應詳細數據。
GroupDetails

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

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

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

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

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

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

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

AssignDomainWorkspacesByPrincipalsRequest

Object

依主體將工作區指派給網域的要求承載。

名稱 類型 Description
principals

Principal[]

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

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

用戶主體名稱。