Domains - Role Assignments Bulk Unassign

Služba:

Admin

Verze rozhraní API:

v1

Poznámka

Toto rozhraní API je ve verzi Preview.

Zrušte přiřazení zadaných správců nebo přispěvatelů z domény.

Dovolení

Volající musí být správcem prostředků infrastruktury.

Požadované delegovaná rozsahy

Tenant.ReadWrite.All.

Omezení

Maximálně 25 požadavků za jednu minutu na objekt zabezpečení.

Podporované identity Microsoft Entra

Toto rozhraní API podporuje identity Microsoft uvedené v této části.

Identita	Podpora
Uživatel	Ano
instančního objektu a spravované identity	Ano

Rozhraní

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
domainId	path	True	string uuid	ID domény.

Text požadavku

Name	Vyžadováno	Typ	Description
type	True	DomainRole	Typ žádosti o aktualizaci.
principals		Principal[]	Představuje identitu nebo skupinu Microsoft Entra.

Odpovědi

Name	Typ	Description
200 OK		Žádost byla úspěšně dokončena.
Other Status Codes	ErrorResponse	Běžné kódy chyb: DomainSpecificUsersScopeCannotBeEmptyError – Nepřiřazování členů domény se nezdařilo, protože když je obor přispěvatelů nastavený na Konkrétní uživatelé a skupiny, nemůže být seznam uživatelů nebo skupin prázdný.

Příklady

Unassign domain admins example

Unassign domain contributors example

Unassign domain admins example

Ukázkový požadavek

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"
    }
  ]
}

Ukázková odpověď

Stavový kód:

200

Unassign domain contributors example

Ukázkový požadavek

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"
    }
  ]
}

Ukázková odpověď

Stavový kód:

200

Definice

Name	Description
DomainRole	Představuje členy domény podle typu požadavku objektu zabezpečení. V průběhu času je možné přidat další typy požadavků.
DomainRoleUnassignmentRequest	Datová část požadavku pro zrušení přiřazení členů domény objektem zabezpečení.
ErrorRelatedResource	Chyba související s objektem podrobností o prostředku.
ErrorResponse	Odpověď na chybu.
ErrorResponseDetails	Podrobnosti o odpovědi na chybu.
GroupDetails	Seskupte konkrétní podrobnosti. Použitelné, pokud je typ objektu zabezpečení Group.
GroupType	Typ skupiny. V průběhu času je možné přidat další typy skupin.
Principal	Představuje identitu nebo skupinu Microsoft Entra.
PrincipalType	Typ objektu zabezpečení. V průběhu času je možné přidat další typy objektů zabezpečení.
ServicePrincipalDetails	Podrobnosti specifické pro instanční objekt Použitelné, pokud je typ objektu zabezpečení ServicePrincipal.
ServicePrincipalProfileDetails	Podrobnosti profilu instančního objektu Použitelné, pokud je typ objektu zabezpečení ServicePrincipalProfile.
UserDetails	Podrobnosti specifické pro objekt zabezpečení uživatele. Použitelné, pokud je typ objektu zabezpečení User.

DomainRole

Výčet

Představuje členy domény podle typu požadavku objektu zabezpečení. V průběhu času je možné přidat další typy požadavků.

Hodnota	Description
Admins	Typ žádosti správce domény
Contributors	Typ požadavku přispěvatelů domény

DomainRoleUnassignmentRequest

Objekt

Datová část požadavku pro zrušení přiřazení členů domény objektem zabezpečení.

Name	Typ	Description
principals	Principal[]	Představuje identitu nebo skupinu Microsoft Entra.
type	DomainRole	Typ žádosti o aktualizaci.

ErrorRelatedResource

Objekt

Chyba související s objektem podrobností o prostředku.

Name	Typ	Description
resourceId	string	ID prostředku, které je součástí chyby.
resourceType	string	Typ prostředku, který je součástí chyby.

ErrorResponse

Objekt

Odpověď na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
moreDetails	ErrorResponseDetails[]	Seznam dalších podrobností o chybě
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou
requestId	string	ID požadavku přidruženého k chybě.

ErrorResponseDetails

Objekt

Podrobnosti o odpovědi na chybu.

Name	Typ	Description
errorCode	string	Konkrétní identifikátor, který poskytuje informace o chybovém stavu, což umožňuje standardizovanou komunikaci mezi naší službou a jejími uživateli.
message	string	Lidské čitelné vyjádření chyby.
relatedResource	ErrorRelatedResource	Podrobnosti o prostředku souvisejícím s chybou

GroupDetails

Objekt

Seskupte konkrétní podrobnosti. Použitelné, pokud je typ objektu zabezpečení Group.

Name	Typ	Description
groupType	GroupType	Typ skupiny. V průběhu času je možné přidat další typy skupin.

GroupType

Výčet

Typ skupiny. V průběhu času je možné přidat další typy skupin.

Hodnota	Description
DistributionList	Objekt zabezpečení je distribuční seznam.
SecurityGroup	Objekt zabezpečení je skupina zabezpečení.
Unknown	Typ hlavní skupiny je neznámý.

Principal

Objekt

Představuje identitu nebo skupinu Microsoft Entra.

Name	Typ	Description
displayName	string	Zobrazovaný název objektu zabezpečení.
groupDetails	GroupDetails	Seskupte konkrétní podrobnosti. Použitelné, pokud je typ objektu zabezpečení Group.
id	string uuid	ID objektu zabezpečení.
servicePrincipalDetails	ServicePrincipalDetails	Podrobnosti specifické pro instanční objekt Použitelné, pokud je typ objektu zabezpečení ServicePrincipal.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Podrobnosti profilu instančního objektu Použitelné, pokud je typ objektu zabezpečení ServicePrincipalProfile.
type	PrincipalType	Typ objektu zabezpečení. V průběhu času je možné přidat další typy objektů zabezpečení.
userDetails	UserDetails	Podrobnosti specifické pro objekt zabezpečení uživatele. Použitelné, pokud je typ objektu zabezpečení User.

PrincipalType

Výčet

Typ objektu zabezpečení. V průběhu času je možné přidat další typy objektů zabezpečení.

Hodnota	Description
Group	Objekt zabezpečení je skupina zabezpečení.
ServicePrincipal	Instanční objekt je instanční objekt Microsoft Entra.
ServicePrincipalProfile	Instanční objekt je profil instančního objektu.
User	Objekt zabezpečení je objekt zabezpečení uživatele Microsoft Entra.

ServicePrincipalDetails

Objekt

Podrobnosti specifické pro instanční objekt Použitelné, pokud je typ objektu zabezpečení ServicePrincipal.

Name	Typ	Description
aadAppId	string uuid	Instanční objekt Microsoft Entra AppId.

ServicePrincipalProfileDetails

Objekt

Podrobnosti profilu instančního objektu Použitelné, pokud je typ objektu zabezpečení ServicePrincipalProfile.

Name	Typ	Description
parentPrincipal	Principal	Nadřazený objekt profilu instančního objektu.

UserDetails

Objekt

Podrobnosti specifické pro objekt zabezpečení uživatele. Použitelné, pokud je typ objektu zabezpečení User.

Name	Typ	Description
userPrincipalName	string	Hlavní název uživatele.