Domains - Role Assignments Bulk Unassign

Palvelu:

Admin

Ohjelmointirajapinnan versio:

v1

Muistiinpano

Tämä ohjelmointirajapinta on esikatselutilassa.

Poista määritetyt järjestelmänvalvojat tai osallistujat toimialueesta.

Käyttöoikeudet

Soittajan on oltava Fabric-järjestelmänvalvoja.

Vaaditut delegoidut vaikutusalueet

Tenant.ReadWrite.All.

Rajoitukset

Enintään 25 pyyntöä minuuttia kohti per päänimi.

Microsoft Entran tukemat käyttäjätiedot

Tämä ohjelmointirajapinta tukee tässä osiossa lueteltuja Microsoft -käyttäjätietoja.

Identiteetti	Tuki
Käyttäjä	Kyllä
palvelun päänimen ja Hallittujen käyttäjätietojen	Kyllä

Rajapinta

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

URI-parametrit

Nimi	Kohteessa	Pakollinen	Tyyppi	Description
domainId	path	True	string uuid	Toimialuetunnus.

Pyynnön leipäteksti

Nimi	Pakollinen	Tyyppi	Description
type	True	DomainRole	Päivityspyynnön tyyppi.
principals		Principal[]	Edustaa käyttäjätietoja tai Microsoft Entra -ryhmää.

Vastaukset

Nimi	Tyyppi	Description
200 OK		Pyynnön valmistuttua.
Other Status Codes	ErrorResponse	Yleiset virhekoodit: DomainSpecificUsersScopeCannotBeEmptyError – Määrittämättömät toimialueen jäsenet epäonnistuivat, koska kun osallistujien vaikutusalueena on "Tietyt käyttäjät ja ryhmät", käyttäjät tai ryhmät -luettelo ei voi olla tyhjä.

Esimerkit

Unassign domain admins example

Unassign domain contributors example

Unassign domain admins example

Mallipyyntö

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

Mallivastaus

Tilakoodi:

200

Unassign domain contributors example

Mallipyyntö

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

Mallivastaus

Tilakoodi:

200

Määritelmät

Nimi	Description
DomainRole	Edustaa toimialueen jäseniä päänimen pyyntötyypin mukaan. Muita pyyntötyyppejä voidaan lisätä ajan mittaan.
DomainRoleUnassignmentRequest	Pyynnön tiedot määrittämättömille toimialueen jäsenille päänimellä.
ErrorRelatedResource	Virheeseen liittyvä resurssitieto-objekti.
ErrorResponse	Virhevastaus.
ErrorResponseDetails	Virheen vastauksen tiedot.
GroupDetails	Ryhmäkohtaiset tiedot. Soveltuu, kun päätyyppi on Group.
GroupType	Ryhmän tyyppi. Muita ryhmätyyppejä voidaan lisätä ajan mittaan.
Principal	Edustaa käyttäjätietoja tai Microsoft Entra -ryhmää.
PrincipalType	Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.
ServicePrincipalDetails	Palvelun päänimen tarkat tiedot. Soveltuu, kun päätyyppi on ServicePrincipal.
ServicePrincipalProfileDetails	Palvelun pääprofiilin tiedot. Soveltuu, kun päätyyppi on ServicePrincipalProfile.
UserDetails	Käyttäjän päänimen tarkat tiedot. Soveltuu, kun päätyyppi on User.

DomainRole

Luettelointi

Edustaa toimialueen jäseniä päänimen pyyntötyypin mukaan. Muita pyyntötyyppejä voidaan lisätä ajan mittaan.

Arvo	Description
Admins	Toimialueen järjestelmänvalvojien pyyntötyyppi.
Contributors	Toimialueen osallistujien pyyntötyyppi.

DomainRoleUnassignmentRequest

Object

Pyynnön tiedot määrittämättömille toimialueen jäsenille päänimellä.

Nimi	Tyyppi	Description
principals	Principal[]	Edustaa käyttäjätietoja tai Microsoft Entra -ryhmää.
type	DomainRole	Päivityspyynnön tyyppi.

ErrorRelatedResource

Object

Virheeseen liittyvä resurssitieto-objekti.

Nimi	Tyyppi	Description
resourceId	string	Virheestä liittyvä resurssitunnus.
resourceType	string	Virheestä liittyvän resurssin tyyppi.

ErrorResponse

Object

Virhevastaus.

Nimi	Tyyppi	Description
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
moreDetails	ErrorResponseDetails[]	Luettelo virheiden lisätiedoista.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.
requestId	string	Virheeseen liittyvän pyynnön tunnus.

ErrorResponseDetails

Object

Virheen vastauksen tiedot.

Nimi	Tyyppi	Description
errorCode	string	Tietty tunniste, joka antaa tietoja virheehdosta ja mahdollistaa standardoidun tietoliikenteen palvelumme ja sen käyttäjien välillä.
message	string	Ihmisen luettavissa oleva esitys virheestä.
relatedResource	ErrorRelatedResource	Virheisiin liittyvät resurssitiedot.

GroupDetails

Object

Ryhmäkohtaiset tiedot. Soveltuu, kun päätyyppi on Group.

Nimi	Tyyppi	Description
groupType	GroupType	Ryhmän tyyppi. Muita ryhmätyyppejä voidaan lisätä ajan mittaan.

GroupType

Luettelointi

Ryhmän tyyppi. Muita ryhmätyyppejä voidaan lisätä ajan mittaan.

Arvo	Description
DistributionList	Principal on jakeluluettelo.
SecurityGroup	Principal on käyttöoikeusryhmä.
Unknown	Pääryhmän tyyppi on tuntematon.

Principal

Object

Edustaa käyttäjätietoja tai Microsoft Entra -ryhmää.

Nimi	Tyyppi	Description
displayName	string	Tämä on päänimen näyttönimi.
groupDetails	GroupDetails	Ryhmäkohtaiset tiedot. Soveltuu, kun päätyyppi on Group.
id	string uuid	Päänimen tunnus.
servicePrincipalDetails	ServicePrincipalDetails	Palvelun päänimen tarkat tiedot. Soveltuu, kun päätyyppi on ServicePrincipal.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Palvelun pääprofiilin tiedot. Soveltuu, kun päätyyppi on ServicePrincipalProfile.
type	PrincipalType	Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.
userDetails	UserDetails	Käyttäjän päänimen tarkat tiedot. Soveltuu, kun päätyyppi on User.

PrincipalType

Luettelointi

Principal-kohteen tyyppi. Muita päänimityyppejä voidaan lisätä ajan kuluessa.

Arvo	Description
Group	Principal on käyttöoikeusryhmä.
ServicePrincipal	Principal on Microsoft Entra -palvelun päänimi.
ServicePrincipalProfile	Principal on palvelun pääprofiili.
User	Principal on Microsoft Entra -käyttäjäobjekti.

ServicePrincipalDetails

Object

Palvelun päänimen tarkat tiedot. Soveltuu, kun päätyyppi on ServicePrincipal.

Nimi	Tyyppi	Description
aadAppId	string uuid	Palvelun päänimen Microsoft Entra AppId.

ServicePrincipalProfileDetails

Object

Palvelun pääprofiilin tiedot. Soveltuu, kun päätyyppi on ServicePrincipalProfile.

Nimi	Tyyppi	Description
parentPrincipal	Principal	Palvelun pääprofiilin pääobjekti.

UserDetails

Object

Käyttäjän päänimen tarkat tiedot. Soveltuu, kun päätyyppi on User.

Nimi	Tyyppi	Description
userPrincipalName	string	Täydellinen käyttäjänimi.