Connections - Update Connection Role Assignment

Szolgáltatás:

Core

API-verzió:

v1

Jegyzet

Ez az API előzetes verzióban érhető el.

Frissíti az egyszerű szerepkör-hozzárendelést a kapcsolathoz.
A kérelem törzséhez szükséges egyszerű felhasználói azonosító lekéréséhez lásd: A felhasználói azonosító megkeresése.

Engedélyek

• A hívónak a kapcsolat tulajdonosának kell lennie, vagy rendszergazdai kell lennie a kapcsolathoz kötött átjárón.

Kötelező delegált hatókörök

Connection.ReadWrite.All

Microsoft Entra által támogatott identitások

Ez az API támogatja az ebben a szakaszban felsorolt Microsoft identitásokat.

Azonosság	Támogat
Felhasználó	Igen
szolgáltatásnév és felügyelt identitások	Igen

Interfész

PATCH https://api.fabric.microsoft.com/v1/connections/{connectionId}/roleAssignments/{connectionRoleAssignmentId}

URI-paraméterek

Name	In	Kötelező	Típus	Description
connectionId	path	True	string uuid	A kapcsolat azonosítója
connectionRoleAssignmentId	path	True	string uuid	A szerepkör-hozzárendelés azonosítója

Kérelem törzse

Name	Kötelező	Típus	Description
role	True	ConnectionRole	Az egyszerű kapcsolati szerepkör.

Válaszok

Name	Típus	Description
200 OK	ConnectionRoleAssignment	A kérés sikeresen befejeződött.
Other Status Codes	ErrorResponse	Gyakori hibakódok: UnknownError – Hiba történt.

Példák

Update connection role assignment example

Mintakérelem

HTTP

PATCH https://api.fabric.microsoft.com/v1/connections/fe8e181d-dbb8-471a-99f0-fdbf0a2ad4fd/roleAssignments/43970761-afc9-4428-ae6e-3b08bef098ff

{
  "role": "UserWithReshare"
}

Mintaválasz

Állapotkód:

200

{
  "role": "UserWithReshare",
  "principal": {
    "id": "43970761-afc9-4428-ae6e-3b08bef098ff",
    "type": "User"
  },
  "id": "43970761-afc9-4428-ae6e-3b08bef098ff"
}

Definíciók

Name	Description
ConnectionRole	Kapcsolati szerepkör. Idővel további kapcsolati szerepkörök is hozzáadhatók.
ConnectionRoleAssignment	A kapcsolati szerepkör hozzárendelése egy taghoz.
ErrorRelatedResource	A hibával kapcsolatos erőforrás-részletek objektum.
ErrorResponse	A hibaválasz.
ErrorResponseDetails	A hibaválasz részletei.
GroupDetails	Csoportosítsa a részleteket. Akkor alkalmazható, ha az egyszerű típus Group.
GroupType	A csoport típusa. Idővel további csoporttípusok is hozzáadhatók.
Principal	Identitást vagy Microsoft Entra-csoportot jelöl.
PrincipalType	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.
ServicePrincipalDetails	A szolgáltatásnév konkrét részletei. Akkor alkalmazható, ha az egyszerű típus ServicePrincipal.
ServicePrincipalProfileDetails	A szolgáltatásnév profiladatai. Akkor alkalmazható, ha az egyszerű típus ServicePrincipalProfile.
UpdateConnectionRoleAssignmentRequest	Frissítési kapcsolati szerepkör-hozzárendelési kérelem hasznos adatai.
UserDetails	A felhasználó egyszerű adatai. Akkor alkalmazható, ha az egyszerű típus User.

ConnectionRole

Enumerálás

Kapcsolati szerepkör. Idővel további kapcsolati szerepkörök is hozzáadhatók.

Érték	Description
Owner	Engedélyezi a tulajdonosi hozzáférést a kapcsolathoz.
User	Engedélyezi a felhasználó hozzáférését a kapcsolathoz.
UserWithReshare	Engedélyezi a felhasználó számára a kapcsolat újramegosztási hozzáférését.

ConnectionRoleAssignment

Objektum

A kapcsolati szerepkör hozzárendelése egy taghoz.

Name	Típus	Description
id	string uuid	A kapcsolati szerepkör-hozzárendelés objektumazonosítója.
principal	Principal	Az igazgató.
role	ConnectionRole	Az egyszerű kapcsolati szerepkör.

ErrorRelatedResource

Objektum

A hibával kapcsolatos erőforrás-részletek objektum.

Name	Típus	Description
resourceId	string	A hibában érintett erőforrás-azonosító.
resourceType	string	A hibában érintett erőforrás típusa.

ErrorResponse

Objektum

A hibaválasz.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
moreDetails	ErrorResponseDetails[]	További hibaadatok listája.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.
requestId	string	A hibához társított kérés azonosítója.

ErrorResponseDetails

Objektum

A hibaválasz részletei.

Name	Típus	Description
errorCode	string	Egy adott azonosító, amely információt nyújt egy hibafeltételről, amely lehetővé teszi a szolgáltatás és a felhasználók közötti szabványosított kommunikációt.
message	string	A hiba emberi olvasható ábrázolása.
relatedResource	ErrorRelatedResource	A hibával kapcsolatos erőforrásadatok.

GroupDetails

Objektum

Csoportosítsa a részleteket. Akkor alkalmazható, ha az egyszerű típus Group.

Name	Típus	Description
groupType	GroupType	A csoport típusa. Idővel további csoporttípusok is hozzáadhatók.

GroupType

Enumerálás

A csoport típusa. Idővel további csoporttípusok is hozzáadhatók.

Érték	Description
DistributionList	Az egyszerű egy terjesztési lista.
SecurityGroup	Az egyszerű egy biztonsági csoport.
Unknown	Az egyszerű csoport típusa ismeretlen.

Principal

Objektum

Identitást vagy Microsoft Entra-csoportot jelöl.

Name	Típus	Description
displayName	string	Az egyszerű megjelenítendő neve.
groupDetails	GroupDetails	Csoportosítsa a részleteket. Akkor alkalmazható, ha az egyszerű típus Group.
id	string uuid	Az igazgató azonosítója.
servicePrincipalDetails	ServicePrincipalDetails	A szolgáltatásnév konkrét részletei. Akkor alkalmazható, ha az egyszerű típus ServicePrincipal.
servicePrincipalProfileDetails	ServicePrincipalProfileDetails	A szolgáltatásnév profiladatai. Akkor alkalmazható, ha az egyszerű típus ServicePrincipalProfile.
type	PrincipalType	A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.
userDetails	UserDetails	A felhasználó egyszerű adatai. Akkor alkalmazható, ha az egyszerű típus User.

PrincipalType

Enumerálás

A rendszernév típusa. Idővel további egyszerű típusok is hozzáadhatók.

Érték	Description
Group	Az egyszerű egy biztonsági csoport.
ServicePrincipal	Az egyszerű szolgáltatásnév a Microsoft Entra szolgáltatásnév.
ServicePrincipalProfile	Az egyszerű szolgáltatásnév egy szolgáltatásnév-profil.
User	Az egyszerű felhasználó a Microsoft Entra egyik egyszerű felhasználója.

ServicePrincipalDetails

Objektum

A szolgáltatásnév konkrét részletei. Akkor alkalmazható, ha az egyszerű típus ServicePrincipal.

Name	Típus	Description
aadAppId	string uuid	A szolgáltatásnév Microsoft Entra AppId azonosítója.

ServicePrincipalProfileDetails

Objektum

A szolgáltatásnév profiladatai. Akkor alkalmazható, ha az egyszerű típus ServicePrincipalProfile.

Name	Típus	Description
parentPrincipal	Principal	A szolgáltatásnév-profil szülőnevét.

UpdateConnectionRoleAssignmentRequest

Objektum

Frissítési kapcsolati szerepkör-hozzárendelési kérelem hasznos adatai.

Name	Típus	Description
role	ConnectionRole	Az egyszerű kapcsolati szerepkör.

UserDetails

Objektum

A felhasználó egyszerű adatai. Akkor alkalmazható, ha az egyszerű típus User.

Name	Típus	Description
userPrincipalName	string	A felhasználónév.