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 |
---|---|---|---|---|
domain
|
path | True |
string uuid |
ID domény. |
Text požadavku
Name | Vyžadováno | Typ | Description |
---|---|---|---|
type | True |
Typ žádosti o aktualizaci. |
|
principals |
Představuje identitu nebo skupinu Microsoft Entra. |
Odpovědi
Name | Typ | Description |
---|---|---|
200 OK |
Žádost byla úspěšně dokončena. |
|
Other Status Codes |
Běžné kódy chyb:
|
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 |
---|---|
Domain |
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ů. |
Domain |
Datová část požadavku pro zrušení přiřazení členů domény objektem zabezpečení. |
Error |
Chyba související s objektem podrobností o prostředku. |
Error |
Odpověď na chybu. |
Error |
Podrobnosti o odpovědi na chybu. |
Group |
Seskupte konkrétní podrobnosti. Použitelné, pokud je typ objektu zabezpečení |
Group |
Typ skupiny. V průběhu času je možné přidat další typy skupin. |
Principal |
Představuje identitu nebo skupinu Microsoft Entra. |
Principal |
Typ objektu zabezpečení. V průběhu času je možné přidat další typy objektů zabezpečení. |
Service |
Podrobnosti specifické pro instanční objekt Použitelné, pokud je typ objektu zabezpečení |
Service |
Podrobnosti profilu instančního objektu Použitelné, pokud je typ objektu zabezpečení |
User |
Podrobnosti specifické pro objekt zabezpečení uživatele. Použitelné, pokud je typ objektu zabezpečení |
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 |
Představuje identitu nebo skupinu Microsoft Entra. |
|
type |
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 |
Seznam dalších podrobností o chybě |
|
relatedResource |
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 |
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 |
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 |
Seskupte konkrétní podrobnosti. Použitelné, pokud je typ objektu zabezpečení |
|
id |
string uuid |
ID objektu zabezpečení. |
servicePrincipalDetails |
Podrobnosti specifické pro instanční objekt Použitelné, pokud je typ objektu zabezpečení |
|
servicePrincipalProfileDetails |
Podrobnosti profilu instančního objektu Použitelné, pokud je typ objektu zabezpečení |
|
type |
Typ objektu zabezpečení. V průběhu času je možné přidat další typy objektů zabezpečení. |
|
userDetails |
Podrobnosti specifické pro objekt zabezpečení uživatele. Použitelné, pokud je typ objektu zabezpečení |
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 |
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. |