Domains - Role Assignments Bulk Unassign

Tjeneste:

Admin

API-versjon:

v1

Notat

Denne API-en er i forhåndsvisning.

Oppheve tilordningen av de angitte administratorene eller bidragsyterne fra domenet.

Tillatelser

Innringeren må være en fabric-administrator.

Nødvendige delegerte omfang

Tenant.ReadWrite.All.

Begrensninger

Maksimalt 25 forespørsler per minutt per hovedstol.

Microsoft Entra-støttede identiteter

Denne API-en støtter Microsoft -identiteter oppført i denne delen.

Identitet	Støtte
Bruker	Ja
tjenestekontohaver og administrerte identiteter	Ja

Grensesnitt

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

URI-parametere

Navn	I	Obligatorisk	Type	Beskrivelse
domainId	path	True	string uuid	Domene-ID-en.

Brødtekst for forespørsel

Navn	Obligatorisk	Type	Beskrivelse
type	True	DomainRole	Oppdateringsforespørselstypen.
principals		Principal[]	Representerer en identitet eller en Microsoft Entra-gruppe.

Svar

Navn	Type	Beskrivelse
200 OK		Forespørselen er fullført.
Other Status Codes	ErrorResponse	Vanlige feilkoder: DomainSpecificUsersScopeCannotBeEmptyError – Ikke tilordnede domenemedlemmer mislyktes fordi når bidragsyteromfanget er satt til Bestemte brukere og grupper, kan ikke bruker- eller gruppelisten være tom.

Eksempler

Unassign domain admins example

Unassign domain contributors example

Unassign domain admins example

Eksempelforespørsel

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

Eksempelsvar

Statuskode:

200

Unassign domain contributors example

Eksempelforespørsel

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

Eksempelsvar

Statuskode:

200

Definisjoner

Navn	Beskrivelse
DomainRole	Representerer domenemedlemmene etter hovedstolens forespørselstype. Flere forespørselstyper kan legges til over tid.
DomainRoleUnassignmentRequest	Forespørselsnyttelasten for ikke-tilordnede domenemedlemmer etter hovedstol.
ErrorRelatedResource	Objektet for feilrelaterte ressursdetaljer.
ErrorResponse	Feilsvaret.
ErrorResponseDetails	Feilsvardetaljene.
GroupDetails	Grupper bestemte detaljer. Gjelder når hovedtypen er Group.
GroupType	Typen gruppe. Flere gruppetyper kan legges til over tid.
Principal	Representerer en identitet eller en Microsoft Entra-gruppe.
PrincipalType	Typen hovedstol. Flere hovedstoltyper kan legges til over tid.
ServicePrincipalDetails	Spesifikke detaljer for tjenestekontohaver. Gjelder når hovedtypen er ServicePrincipal.
ServicePrincipalProfileDetails	Detaljer for tjenestekontohaverprofil. Gjelder når hovedtypen er ServicePrincipalProfile.
UserDetails	Spesifikke detaljer for brukerkontohaver. Gjelder når hovedtypen er User.

DomainRole

Opplisting

Representerer domenemedlemmene etter hovedstolens forespørselstype. Flere forespørselstyper kan legges til over tid.

Verdi	Beskrivelse
Admins	Forespørselstype for domeneadministratorer.
Contributors	Forespørselstype for domenebidragsytere.

DomainRoleUnassignmentRequest

Object

Forespørselsnyttelasten for ikke-tilordnede domenemedlemmer etter hovedstol.

Navn	Type	Beskrivelse
principals	Principal[]	Representerer en identitet eller en Microsoft Entra-gruppe.
type	DomainRole	Oppdateringsforespørselstypen.

ErrorRelatedResource

Object

Objektet for feilrelaterte ressursdetaljer.

Navn	Type	Beskrivelse
resourceId	string	Ressurs-ID-en som er involvert i feilen.
resourceType	string	Typen ressurs som er involvert i feilen.

ErrorResponse

Object

Feilsvaret.

Navn	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message	string	En menneskelig lesbar representasjon av feilen.
moreDetails	ErrorResponseDetails[]	Liste over flere feildetaljer.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.
requestId	string	ID for forespørselen som er knyttet til feilen.

ErrorResponseDetails

Object

Feilsvardetaljene.

Navn	Type	Beskrivelse
errorCode	string	En bestemt identifikator som gir informasjon om en feilbetingelse, noe som gir standardisert kommunikasjon mellom tjenesten og brukerne.
message	string	En menneskelig lesbar representasjon av feilen.
relatedResource	ErrorRelatedResource	Feilrelaterte ressursdetaljer.

GroupDetails

Object

Grupper bestemte detaljer. Gjelder når hovedtypen er Group.

Navn	Type	Beskrivelse
groupType	GroupType	Typen gruppe. Flere gruppetyper kan legges til over tid.

GroupType

Opplisting

Typen gruppe. Flere gruppetyper kan legges til over tid.

Verdi	Beskrivelse
DistributionList	Hovedstol er en distribusjonsliste.
SecurityGroup	Hovedstol er en sikkerhetsgruppe.
Unknown	Hovedgruppetypen er ukjent.

Principal

Object

Representerer en identitet eller en Microsoft Entra-gruppe.

Navn	Type	Beskrivelse
displayName	string	Hovedkontohaverens visningsnavn.
groupDetails	GroupDetails	Grupper bestemte detaljer. Gjelder når hovedtypen er Group.
id	string uuid	Hovedkontohaverens ID.
servicePrincipalDetails	ServicePrincipalDetails	Spesifikke detaljer for tjenestekontohaver. Gjelder når hovedtypen er ServicePrincipal.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	Detaljer for tjenestekontohaverprofil. Gjelder når hovedtypen er ServicePrincipalProfile.
type	PrincipalType	Typen hovedstol. Flere hovedstoltyper kan legges til over tid.
userDetails	UserDetails	Spesifikke detaljer for brukerkontohaver. Gjelder når hovedtypen er User.

PrincipalType

Opplisting

Typen hovedstol. Flere hovedstoltyper kan legges til over tid.

Verdi	Beskrivelse
Group	Hovedstol er en sikkerhetsgruppe.
ServicePrincipal	Principal er en Microsoft Entra-tjenestekontohaver.
ServicePrincipalProfile	Principal er en tjenestekontohaverprofil.
User	Principal er en Microsoft Entra-brukerkontohaver.

ServicePrincipalDetails

Object

Spesifikke detaljer for tjenestekontohaver. Gjelder når hovedtypen er ServicePrincipal.

Navn	Type	Beskrivelse
aadAppId	string uuid	Tjenestekontohaverens Microsoft Entra AppId.

ServicePrincipalProfileDetails

Object

Detaljer for tjenestekontohaverprofil. Gjelder når hovedtypen er ServicePrincipalProfile.

Navn	Type	Beskrivelse
parentPrincipal	Principal	Overordnet hovedkontohaver for tjenestekontohaverprofilen.

UserDetails

Object

Spesifikke detaljer for brukerkontohaver. Gjelder når hovedtypen er User.

Navn	Type	Beskrivelse
userPrincipalName	string	Brukerhovednavn.