Sdílet prostřednictvím


Domains - Role Assignments Bulk Unassign

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

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ěď

Unassign domain contributors example

Ukázkový požadavek

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ěď

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

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

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

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

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

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

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

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

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

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

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

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

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.