Service Principal Entitlements - Update Service Principal Entitlement
Bearbeiten Sie die Berechtigungen (Lizenz, Erweiterungen, Projekte, Teams usw.) für einen Dienstprinzipal.
PATCH https://vsaex.dev.azure.com/{organization}/_apis/serviceprincipalentitlements/{servicePrincipalId}?api-version=7.1-preview.1
URI-Parameter
Name | In | Erforderlich | Typ | Beschreibung |
---|---|---|---|---|
organization
|
path | True |
string |
Der Name der Azure DevOps-Organisation. |
service
|
path | True |
string uuid |
ID des Dienstprinzipals. |
api-version
|
query | True |
string |
Version der zu verwendenden API. Dies sollte auf "7.1-preview.1" festgelegt werden, um diese Version der API zu verwenden. |
Anforderungstext
Media Types: "application/json-patch+json"
Name | Typ | Beschreibung |
---|---|---|
from |
string |
Der Pfad, aus dem für den Vorgang "Verschieben/Kopieren" kopiert werden soll. |
op |
Der Patchvorgang |
|
path |
string |
Der Pfad für den Vorgang. Bei einem Array kann ein nullbasierter Index verwendet werden, um die Position im Array anzugeben (z. B. /kekse/0/name). Das Zeichen "-" kann anstelle eines Indexes zum Einfügen am Ende des Arrays (z. B. /keks/-) verwendet werden. |
value |
object |
Der Wert für den Vorgang. Dies ist entweder ein Primitiver oder ein JToken. |
Antworten
Name | Typ | Beschreibung |
---|---|---|
200 OK |
Erfolgreicher Vorgang |
Sicherheit
oauth2
Type:
oauth2
Flow:
accessCode
Authorization URL:
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL:
https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer
Scopes
Name | Beschreibung |
---|---|
vso.memberentitlementmanagement_write | Ermöglicht die Verwaltung von Benutzern, deren Lizenzen sowie Projekten und Erweiterungen, auf die sie zugreifen können. |
Beispiele
Sample Request
PATCH https://vsaex.dev.azure.com/{organization}/_apis/serviceprincipalentitlements/593F6716-627C-6CCB-833E-77A7F9CA422F?api-version=7.1-preview.1
[
{
"from": "",
"op": "replace",
"path": "/accessLevel",
"value": {
"accountLicenseType": "express",
"licensingSource": "account"
}
},
{
"from": "",
"op": "add",
"path": "/projectEntitlements/6fa35aad-6755-4dd7-8c69-e13f702af0f9",
"value": {
"group": {
"groupType": "projectAdministrator"
},
"projectRef": {
"id": "6fa35aad-6755-4dd7-8c69-e13f702af0f9"
}
}
},
{
"from": "",
"op": "remove",
"path": "/projectEntitlements/fca61097-56a1-464f-85ba-1b126cf02cd1",
"value": ""
}
]
Sample Response
{
"operationResults": [
{
"servicePrincipalId": "ed82811a-0890-6f7f-813e-69dd9ebd5ba3",
"isSuccess": true,
"errors": [],
"result": {
"servicePrincipal": {
"subjectKind": "servicePrincipal",
"applicationId": "d1a24244-f6cc-488b-bca7-42eb10f13c5b",
"metaType": "application",
"directoryAlias": "00ed1ce5-4257-4bbd-946e-1b57718e203e",
"domain": "faab4a73-0db3-4a5e-8e8a-02188f1d3f4b",
"principalName": "00ed1ce5-4257-4bbd-946e-1b57718e203e",
"mailAddress": null,
"origin": "aad",
"originId": "00ed1ce5-4257-4bbd-946e-1b57718e203e",
"displayName": "Service principal",
"_links": {
"self": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/ServicePrincipals/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"memberships": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/Memberships/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"membershipState": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/MembershipStates/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"storageKey": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/StorageKeys/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"avatar": {
"href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
}
},
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/ServicePrincipals/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz",
"descriptor": "aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"id": "ed82811a-0890-6f7f-813e-69dd9ebd5ba3",
"accessLevel": {
"licensingSource": "account",
"accountLicenseType": "earlyAdopter",
"msdnLicenseType": "none",
"licenseDisplayName": "Early Adopter",
"status": "pending",
"statusMessage": "",
"assignmentSource": "unknown"
},
"lastAccessedDate": "0001-01-01T00:00:00",
"dateCreated": "0001-01-01T00:00:00",
"projectEntitlements": null,
"groupAssignments": null
}
},
{
"servicePrincipalId": "ed82811a-0890-6f7f-813e-69dd9ebd5ba3",
"isSuccess": true,
"errors": [],
"result": null
},
{
"servicePrincipalId": "ed82811a-0890-6f7f-813e-69dd9ebd5ba3",
"isSuccess": true,
"errors": [],
"result": null
}
],
"isSuccess": true,
"servicePrincipalEntitlement": {
"servicePrincipal": {
"subjectKind": "servicePrincipal",
"applicationId": "d1a24244-f6cc-488b-bca7-42eb10f13c5b",
"metaType": "application",
"directoryAlias": "00ed1ce5-4257-4bbd-946e-1b57718e203e",
"domain": "faab4a73-0db3-4a5e-8e8a-02188f1d3f4b",
"principalName": "00ed1ce5-4257-4bbd-946e-1b57718e203e",
"mailAddress": null,
"origin": "aad",
"originId": "00ed1ce5-4257-4bbd-946e-1b57718e203e",
"displayName": "Service principal",
"_links": {
"self": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/ServicePrincipals/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"memberships": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/Memberships/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"membershipState": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/MembershipStates/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"storageKey": {
"href": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/StorageKeys/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"avatar": {
"href": "https://dev.azure.com/fabrikam/_apis/GraphProfile/MemberAvatars/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
}
},
"url": "https://vssps.dev.azure.com/fabrikam/_apis/Graph/ServicePrincipals/aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz",
"descriptor": "aadsp.ZWQ4MjgxMWEtMDg5MC03ZjdmLTgxM2UtNjlkZDllYmQ1YmEz"
},
"id": "ed82811a-0890-6f7f-813e-69dd9ebd5ba3",
"accessLevel": {
"licensingSource": "account",
"accountLicenseType": "earlyAdopter",
"msdnLicenseType": "none",
"licenseDisplayName": "Early Adopter",
"status": "pending",
"statusMessage": "",
"assignmentSource": "unknown"
},
"lastAccessedDate": "0001-01-01T00:00:00Z",
"dateCreated": "2023-02-08T11:20:12.3155446Z",
"projectEntitlements": [
{
"projectRef": {
"id": "6fa35aad-6755-4dd7-8c69-e13f702af0f9",
"name": "TestProject2"
},
"group": {
"groupType": "projectAdministrator",
"displayName": "Project Administrators"
},
"projectPermissionInherited": "notInherited",
"teamRefs": [],
"assignmentSource": "unknown"
}
],
"groupAssignments": []
}
}
Definitionen
Name | Beschreibung |
---|---|
Access |
Einem Benutzer zugewiesene Lizenz |
Account |
Art der Kontolizenz (z. B. Express, Stakeholder usw.). Um accountLicenseType zu verwenden, sollte LicensingSource im Anforderungstext als "Konto" definiert werden. |
Account |
Benutzer-status im Konto |
Assignment |
Zuweisungsquelle der Lizenz (z. B. Gruppe, Unbekannt usw.) |
Graph |
Graph-Gruppenentität |
Graph |
|
Graph |
|
Group |
Projektgruppe (z.B. Mitwirkender, Leser usw.) |
Group |
Eine Gruppenentität mit zusätzlichen Eigenschaften, einschließlich Lizenz, Erweiterungen und Projektmitgliedschaft |
Group |
Die status der Gruppenregel. |
Group |
Gruppentyp |
Json |
Das JSON-Modell für JSON-Patchvorgänge |
Licensing |
Lizenzierungsquelle (z. B. Konto. MSDN usw.) |
Msdn |
Typ der MSDN-Lizenz (z. B. Visual Studio Professional, Visual Studio Enterprise usw.). Um msdnLicenseType zu verwenden, sollte LicensingSource im Anforderungstext als "msdn" definiert werden. |
Operation |
Der Patchvorgang |
Project |
Beziehung zwischen einem Projekt und den effektiven Berechtigungen des Benutzers in diesem Projekt. |
Project |
Gibt an, ob der Benutzer Berechtigungen für ein Projekt über eine Azure DevOps- oder AAD-Gruppenmitgliedschaft erbt. |
Project |
Ein Verweis auf ein Projekt |
Reference |
Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt. |
Service |
|
Service |
|
Service |
|
Team |
Ein Verweis auf ein Team |
User |
Eine Benutzerentität mit zusätzlichen Eigenschaften, einschließlich Lizenz, Erweiterungen und Projektmitgliedschaft |
AccessLevel
Einem Benutzer zugewiesene Lizenz
Name | Typ | Beschreibung |
---|---|---|
accountLicenseType |
Art der Kontolizenz (z. B. Express, Stakeholder usw.). Um accountLicenseType zu verwenden, sollte LicensingSource im Anforderungstext als "Konto" definiert werden. |
|
assignmentSource |
Zuweisungsquelle der Lizenz (z. B. Gruppe, Unbekannt usw.) |
|
licenseDisplayName |
string |
Anzeigename der Lizenz |
licensingSource |
Lizenzierungsquelle (z. B. Konto. MSDN usw.) |
|
msdnLicenseType |
Typ der MSDN-Lizenz (z. B. Visual Studio Professional, Visual Studio Enterprise usw.). Um msdnLicenseType zu verwenden, sollte LicensingSource im Anforderungstext als "msdn" definiert werden. |
|
status |
Benutzer-status im Konto |
|
statusMessage |
string |
Statusmeldung. |
AccountLicenseType
Art der Kontolizenz (z. B. Express, Stakeholder usw.). Um accountLicenseType zu verwenden, sollte LicensingSource im Anforderungstext als "Konto" definiert werden.
Name | Typ | Beschreibung |
---|---|---|
advanced |
string |
|
earlyAdopter |
string |
|
express |
string |
|
none |
string |
|
professional |
string |
|
stakeholder |
string |
AccountUserStatus
Benutzer-status im Konto
Name | Typ | Beschreibung |
---|---|---|
active |
string |
Der Benutzer hat sich mindestens einmal beim VSTS-Konto angemeldet. |
deleted |
string |
Der Benutzer wird vom VSTS-Kontoadministrator aus dem VSTS-Konto entfernt. |
disabled |
string |
Der Benutzer kann sich nicht anmelden. wird in erster Linie vom Administrator verwendet, um einen Benutzer vorübergehend aufgrund von Abwesenheit oder Lizenzumsetzung zu entfernen. |
expired |
string |
Der Benutzer kann sich anmelden. wird hauptsächlich verwendet, wenn sich die Lizenz im abgelaufenen Zustand befindet und wir eine Karenzzeit gewähren. |
none |
string |
|
pending |
string |
Der Benutzer wird vom VSTS-Kontoadministrator zum Beitritt zum VSTS-Konto eingeladen, hat sich aber noch nicht registriert bzw. angemeldet. |
pendingDisabled |
string |
Der Benutzer ist deaktiviert; wenn sie erneut aktiviert werden, befinden sie sich weiterhin im Status Ausstehend. |
AssignmentSource
Zuweisungsquelle der Lizenz (z. B. Gruppe, Unbekannt usw.)
Name | Typ | Beschreibung |
---|---|---|
groupRule |
string |
|
none |
string |
|
unknown |
string |
GraphGroup
Graph-Gruppenentität
Name | Typ | Beschreibung |
---|---|---|
_links |
Dieses Feld enthält null oder interessantere Links zum Diagrammthema. Diese Links können aufgerufen werden, um zusätzliche Beziehungen oder ausführlichere Informationen zu diesem Graph-Thema zu erhalten. |
|
description |
string |
Ein kurzer Ausdruck, der menschlichen Lesern hilft, Gruppen mit ähnlichen Namen zu unterscheiden. |
descriptor |
string |
Der Deskriptor ist die primäre Möglichkeit, auf den Graphengegenstand zu verweisen, während das System ausgeführt wird. In diesem Feld wird derselbe Graph-Betreff sowohl für Konten als auch für Organisationen eindeutig identifiziert. |
displayName |
string |
Dies ist der nicht eindeutige Anzeigename des Diagrammsubjekts. Um dieses Feld zu ändern, müssen Sie seinen Wert im Quellanbieter ändern. |
domain |
string |
Dies stellt den Namen des Ursprungscontainers für einen Graphmember dar. (Für MSA ist dies "Windows Live ID", für AD der Name der Domäne, für AAD die mandanten-ID des Verzeichnisses, für VSTS-Gruppen die ScopeId usw.) |
legacyDescriptor |
string |
[Nur interne Verwendung] Der Legacydeskriptor ist hier für den Fall, dass Sie mithilfe des Identitätsdeskriptors auf IMS der alten Version zugreifen müssen. |
mailAddress |
string |
Die E-Mail-Adresse des Datensatzes für einen bestimmten Graph-Member. Dieser kann sich vom Prinzipalnamen unterscheiden. |
origin |
string |
Der Typ des Quellanbieters für den Ursprungsbezeichner (z. B. AD, AAD, MSA) |
originId |
string |
Der eindeutige Bezeichner aus dem Ursprungssystem. In der Regel eine Sid, eine Objekt-ID oder eine GUID. Verknüpfungs- und Verknüpfungsvorgänge können dazu führen, dass sich dieser Wert für einen Benutzer ändert, da der Benutzer nicht von einem anderen Anbieter unterstützt wird und im neuen Anbieter über eine andere eindeutige ID verfügt. |
principalName |
string |
Dies ist der PrincipalName dieses Graphelements aus dem Quellanbieter. Der Quellanbieter kann dieses Feld im Laufe der Zeit ändern, und es ist nicht garantiert, dass es für die Lebensdauer des Graphelements durch VSTS unveränderlich ist. |
subjectKind |
string |
Dieses Feld identifiziert den Typ des Graph-Betreffs (z. B. Gruppe, Bereich, Benutzer). |
url |
string |
Diese URL ist die vollständige Route zur Quellressource dieses Graph-Betreffs. |
GraphServicePrincipal
Name | Typ | Beschreibung |
---|---|---|
_links |
Dieses Feld enthält null oder interessantere Links zum Graphthema. Diese Links können aufgerufen werden, um zusätzliche Beziehungen oder ausführlichere Informationen zu diesem Graphthema zu erhalten. |
|
applicationId |
string |
|
descriptor |
string |
Der Deskriptor ist die primäre Methode, um auf den Graph-Betreff zu verweisen, während das System ausgeführt wird. In diesem Feld wird derselbe Graph-Betreff sowohl für Konten als auch für Organisationen eindeutig identifiziert. |
directoryAlias |
string |
Der kurze, im Allgemeinen eindeutige Name für den Benutzer im Sicherungsverzeichnis. Für AAD-Benutzer entspricht dies dem E-Mail-Spitznamen, der oft, aber nicht unbedingt dem Teil der E-Mail-Adresse des Benutzers vor dem @-Zeichen ähnelt. Für GitHub-Benutzer entspricht dies dem GitHub-Benutzerhandle. |
displayName |
string |
Dies ist der nicht eindeutige Anzeigename des Graph-Betreffs. Um dieses Feld zu ändern, müssen Sie seinen Wert im Quellanbieter ändern. |
domain |
string |
Dies stellt den Namen des Ursprungscontainers für einen Graphmember dar. (Für MSA ist dies "Windows Live ID", für AD der Name der Domäne, für AAD die mandanten-ID des Verzeichnisses, für VSTS-Gruppen die ScopeId usw.) |
isDeletedInOrigin |
boolean |
Wenn true, wurde die Gruppe im Identitätsanbieter gelöscht. |
legacyDescriptor |
string |
[Nur interne Verwendung] Der Legacydeskriptor ist hier für den Fall, dass Sie mithilfe des Identitätsdeskriptors auf IMS der alten Version zugreifen müssen. |
mailAddress |
string |
Die E-Mail-Adresse des Datensatzes für einen bestimmten Graph-Member. Dieser kann sich vom Prinzipalnamen unterscheiden. |
metaType |
string |
Der Metatyp des Benutzers im Ursprung, z. B. "Member", "Gast" usw. Den Satz möglicher Werte finden Sie unter UserMetaType. |
origin |
string |
Der Typ des Quellanbieters für den Ursprungsbezeichner (z. B. AD, AAD, MSA) |
originId |
string |
Der eindeutige Bezeichner aus dem Ursprungssystem. In der Regel eine Sid, eine Objekt-ID oder eine GUID. Verknüpfungs- und Verknüpfungsvorgänge können dazu führen, dass sich dieser Wert für einen Benutzer ändert, da der Benutzer nicht von einem anderen Anbieter unterstützt wird und im neuen Anbieter über eine andere eindeutige ID verfügt. |
principalName |
string |
Dies ist der PrincipalName dieses Graphelements aus dem Quellanbieter. Der Quellanbieter kann dieses Feld im Laufe der Zeit ändern, und es ist nicht garantiert, dass es für die Lebensdauer des Graphelements durch VSTS unveränderlich ist. |
subjectKind |
string |
Dieses Feld identifiziert den Typ des Graph-Betreffs (z. B. Gruppe, Bereich, Benutzer). |
url |
string |
Diese URL ist die vollständige Route zur Quellressource dieses Graph-Betreffs. |
GraphUser
Name | Typ | Beschreibung |
---|---|---|
_links |
Dieses Feld enthält null oder interessantere Links zum Diagrammthema. Diese Links können aufgerufen werden, um zusätzliche Beziehungen oder ausführlichere Informationen zu diesem Graph-Thema zu erhalten. |
|
descriptor |
string |
Der Deskriptor ist die primäre Möglichkeit, auf den Graphengegenstand zu verweisen, während das System ausgeführt wird. In diesem Feld wird derselbe Graph-Betreff sowohl für Konten als auch für Organisationen eindeutig identifiziert. |
directoryAlias |
string |
Der kurze, im Allgemeinen eindeutige Name für den Benutzer im Sicherungsverzeichnis. Für AAD-Benutzer entspricht dies dem E-Mail-Spitznamen, der oft, aber nicht unbedingt dem Teil der E-Mail-Adresse des Benutzers vor dem @-Zeichen ähnelt. Für GitHub-Benutzer entspricht dies dem GitHub-Benutzerhandle. |
displayName |
string |
Dies ist der nicht eindeutige Anzeigename des Diagrammsubjekts. Um dieses Feld zu ändern, müssen Sie seinen Wert im Quellanbieter ändern. |
domain |
string |
Dies stellt den Namen des Ursprungscontainers für ein Graphmember dar. (Für MSA ist dies "Windows Live ID", für AD der Name der Domäne, für AAD die Mandanten-ID des Verzeichnisses, für VSTS-Gruppen die ScopeId usw.) |
isDeletedInOrigin |
boolean |
Wenn true, wurde die Gruppe im Identitätsanbieter gelöscht. |
legacyDescriptor |
string |
[Nur interne Verwendung] Der Legacydeskriptor ist hier, falls Sie mithilfe des Identitätsdeskriptors auf IMS der alten Version zugreifen müssen. |
mailAddress |
string |
Die E-Mail-Adresse des Datensatzes für ein bestimmtes Graphelement. Dies kann sich vom Prinzipalnamen unterscheiden. |
metaType |
string |
Der Metatyp des Benutzers im Ursprung, z. B. "Member", "Guest" usw. Informationen zu den möglichen Werten finden Sie unter UserMetaType. |
origin |
string |
Der Typ des Quellanbieters für den Ursprungsbezeichner (z. B. AD, AAD, MSA) |
originId |
string |
Der eindeutige Bezeichner aus dem Ursprungssystem. In der Regel eine Sid- oder Objekt-ID oder guid. Verknüpfungs- und Verknüpfungsvorgänge können dazu führen, dass sich dieser Wert für einen Benutzer ändert, da der Benutzer nicht von einem anderen Anbieter unterstützt wird und eine andere eindeutige ID im neuen Anbieter aufweist. |
principalName |
string |
Dies ist der PrincipalName dieses Graphmembers vom Quellanbieter. Der Quellanbieter kann dieses Feld im Laufe der Zeit ändern, und es ist nicht garantiert, dass es für die Lebensdauer des Graphelements durch VSTS unveränderlich ist. |
subjectKind |
string |
Dieses Feld identifiziert den Typ des Graph-Betreffs (z. B. Gruppe, Bereich, Benutzer). |
url |
string |
Diese URL ist die vollständige Route zur Quellressource dieses Graph-Betreffs. |
Group
Projektgruppe (z.B. Mitwirkender, Leser usw.)
Name | Typ | Beschreibung |
---|---|---|
displayName |
string |
Anzeigename der Gruppe |
groupType |
Gruppentyp |
GroupEntitlement
Eine Gruppenentität mit zusätzlichen Eigenschaften, einschließlich Lizenz, Erweiterungen und Projektmitgliedschaft
Name | Typ | Beschreibung |
---|---|---|
group |
Memberreferenz. |
|
id |
string |
Der eindeutige Bezeichner, der mit der ID des GraphMember übereinstimmt. |
lastExecuted |
string |
[Readonly] Die letzte Ausführung der Gruppenlizenzregel (unabhängig davon, ob Änderungen vorgenommen wurden). |
licenseRule |
Lizenzregel. |
|
members |
Gruppenmitglieder. Wird nur beim Erstellen einer neuen Gruppe verwendet. |
|
projectEntitlements |
Beziehung zwischen einem Projekt und den effektiven Berechtigungen des Mitglieds in diesem Projekt. |
|
status |
Die status der Gruppenregel. |
GroupLicensingRuleStatus
Die status der Gruppenregel.
Name | Typ | Beschreibung |
---|---|---|
applied |
string |
Regel wird angewendet |
applyPending |
string |
Regel wird erstellt oder aktualisiert, aber anwenden ist ausstehend |
incompatible |
string |
Die Gruppenregel war inkompatibel. |
unableToApply |
string |
Die Regel konnte nicht unerwartet angewendet werden und sollte erneut ausgeführt werden. |
GroupType
Gruppentyp
Name | Typ | Beschreibung |
---|---|---|
custom |
string |
|
projectAdministrator |
string |
|
projectContributor |
string |
|
projectReader |
string |
|
projectStakeholder |
string |
JsonPatchDocument
Das JSON-Modell für JSON-Patchvorgänge
Name | Typ | Beschreibung |
---|---|---|
from |
string |
Der Pfad, aus dem kopiert werden soll, für den Vorgang Verschieben/Kopieren. |
op |
Der Patchvorgang |
|
path |
string |
Der Pfad für den Vorgang. Im Fall eines Arrays kann ein nullbasierter Index verwendet werden, um die Position im Array anzugeben (z. B. /biscuits/0/name). Das Zeichen "-" kann anstelle eines Indexes verwendet werden, um am Ende des Arrays (z. B. /biscuits/-) einzufügen. |
value |
object |
Der Wert für den Vorgang. Dies ist entweder ein Primitiver oder ein JToken. |
LicensingSource
Lizenzierungsquelle (z. B. Konto. MSDN usw.)
Name | Typ | Beschreibung |
---|---|---|
account |
string |
|
auto |
string |
|
msdn |
string |
|
none |
string |
|
profile |
string |
|
trial |
string |
MsdnLicenseType
Typ der MSDN-Lizenz (z. B. Visual Studio Professional, Visual Studio Enterprise usw.). Um msdnLicenseType zu verwenden, sollte LicensingSource im Anforderungstext als "msdn" definiert werden.
Name | Typ | Beschreibung |
---|---|---|
eligible |
string |
|
enterprise |
string |
|
none |
string |
|
platforms |
string |
|
premium |
string |
|
professional |
string |
|
testProfessional |
string |
|
ultimate |
string |
Operation
Der Patchvorgang
Name | Typ | Beschreibung |
---|---|---|
add |
string |
|
copy |
string |
|
move |
string |
|
remove |
string |
|
replace |
string |
|
test |
string |
ProjectEntitlement
Beziehung zwischen einem Projekt und den effektiven Berechtigungen des Benutzers in diesem Projekt.
Name | Typ | Beschreibung |
---|---|---|
assignmentSource |
Zuweisungsquelle (z. B. Gruppe oder Unbekannt). |
|
group |
Projektgruppe (z.B. Mitwirkender, Leser usw.) |
|
projectPermissionInherited |
Gibt an, ob der Benutzer Berechtigungen für ein Projekt über eine Azure DevOps- oder AAD-Gruppenmitgliedschaft erbt. |
|
projectRef |
Projektreferenz |
|
teamRefs |
Team |
Team-Ref. |
ProjectPermissionInherited
Gibt an, ob der Benutzer Berechtigungen für ein Projekt über eine Azure DevOps- oder AAD-Gruppenmitgliedschaft erbt.
Name | Typ | Beschreibung |
---|---|---|
inherited |
string |
|
notInherited |
string |
|
notSet |
string |
ProjectRef
Ein Verweis auf ein Projekt
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Die Projekt-ID. |
name |
string |
Projektname. |
ReferenceLinks
Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt.
Name | Typ | Beschreibung |
---|---|---|
links |
object |
Die schreibgeschützte Ansicht der Links. Da Verweislinks schreibgeschützter Sind, möchten wir sie nur als schreibgeschützter Link verfügbar machen. |
ServicePrincipalEntitlement
Name | Typ | Beschreibung |
---|---|---|
accessLevel |
Die Zugriffsebene des Mitglieds, die durch eine Lizenz gekennzeichnet ist. |
|
dateCreated |
string |
[Readonly] Datum, an dem das Element der Auflistung hinzugefügt wurde. |
groupAssignments |
[Readonly] GroupEntitles gibt an, dass dieses Mitglied gehört. |
|
id |
string |
Der eindeutige Bezeichner, der mit der ID der Identität übereinstimmt, die dem GraphMember zugeordnet ist. |
lastAccessedDate |
string |
[Readonly] Datum, an dem das Mitglied zuletzt auf die Auflistung zugegriffen hat. |
projectEntitlements |
Beziehung zwischen einem Projekt und den effektiven Berechtigungen des Mitglieds in diesem Projekt. |
|
servicePrincipal |
ServicePrincipal-Referenz. |
ServicePrincipalEntitlementOperationResult
Name | Typ | Beschreibung |
---|---|---|
errors |
object[] |
Liste der Fehlercodes, die mit den entsprechenden Fehlermeldungen gekoppelt sind. |
isSuccess |
boolean |
Erfolg status des Vorgangs. |
result |
string |
Resultierende Berechtigungseigenschaft. Informationen zu bestimmten Implementierungen finden Sie auch unter: |
servicePrincipalId |
string |
Bezeichner des ServicePrincipal, auf den reagiert wird. |
ServicePrincipalEntitlementsPatchResponse
Name | Typ | Beschreibung |
---|---|---|
isSuccess |
boolean |
|
operationResults | ||
servicePrincipalEntitlement |
TeamRef
Ein Verweis auf ein Team
Name | Typ | Beschreibung |
---|---|---|
id |
string |
Team-ID |
name |
string |
Teamname |
UserEntitlement
Eine Benutzerentität mit zusätzlichen Eigenschaften, einschließlich Lizenz, Erweiterungen und Projektmitgliedschaft
Name | Typ | Beschreibung |
---|---|---|
accessLevel |
Die Zugriffsebene des Mitglieds, die durch eine Lizenz gekennzeichnet ist. |
|
dateCreated |
string |
[Readonly] Datum, an dem das Element der Auflistung hinzugefügt wurde. |
groupAssignments |
[Readonly] GroupEntitlements, zu denen dieses Mitglied gehört. |
|
id |
string |
Der eindeutige Bezeichner, der mit der ID der Identität übereinstimmt, die dem GraphMember zugeordnet ist. |
lastAccessedDate |
string |
[Readonly] Datum, an dem das Mitglied zuletzt auf die Auflistung zugegriffen hat. |
projectEntitlements |
Beziehung zwischen einem Projekt und den effektiven Berechtigungen des Mitglieds in diesem Projekt. |
|
user |
Benutzerreferenz. |