Freigeben über


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.

servicePrincipalId
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

Operation

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

ServicePrincipalEntitlementsPatchResponse

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
AccessLevel

Einem Benutzer zugewiesene Lizenz

AccountLicenseType

Art der Kontolizenz (z. B. Express, Stakeholder usw.). Um accountLicenseType zu verwenden, sollte LicensingSource im Anforderungstext als "Konto" definiert werden.

AccountUserStatus

Benutzer-status im Konto

AssignmentSource

Zuweisungsquelle der Lizenz (z. B. Gruppe, Unbekannt usw.)

GraphGroup

Graph-Gruppenentität

GraphServicePrincipal
GraphUser
Group

Projektgruppe (z.B. Mitwirkender, Leser usw.)

GroupEntitlement

Eine Gruppenentität mit zusätzlichen Eigenschaften, einschließlich Lizenz, Erweiterungen und Projektmitgliedschaft

GroupLicensingRuleStatus

Die status der Gruppenregel.

GroupType

Gruppentyp

JsonPatchDocument

Das JSON-Modell für JSON-Patchvorgänge

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.

Operation

Der Patchvorgang

ProjectEntitlement

Beziehung zwischen einem Projekt und den effektiven Berechtigungen des Benutzers in diesem Projekt.

ProjectPermissionInherited

Gibt an, ob der Benutzer Berechtigungen für ein Projekt über eine Azure DevOps- oder AAD-Gruppenmitgliedschaft erbt.

ProjectRef

Ein Verweis auf ein Projekt

ReferenceLinks

Die -Klasse, die eine Auflistung von REST-Verweislinks darstellt.

ServicePrincipalEntitlement
ServicePrincipalEntitlementOperationResult
ServicePrincipalEntitlementsPatchResponse
TeamRef

Ein Verweis auf ein Team

UserEntitlement

Eine Benutzerentität mit zusätzlichen Eigenschaften, einschließlich Lizenz, Erweiterungen und Projektmitgliedschaft

AccessLevel

Einem Benutzer zugewiesene Lizenz

Name Typ Beschreibung
accountLicenseType

AccountLicenseType

Art der Kontolizenz (z. B. Express, Stakeholder usw.). Um accountLicenseType zu verwenden, sollte LicensingSource im Anforderungstext als "Konto" definiert werden.

assignmentSource

AssignmentSource

Zuweisungsquelle der Lizenz (z. B. Gruppe, Unbekannt usw.)

licenseDisplayName

string

Anzeigename der Lizenz

licensingSource

LicensingSource

Lizenzierungsquelle (z. B. Konto. MSDN usw.)

msdnLicenseType

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

AccountUserStatus

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

ReferenceLinks

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

ReferenceLinks

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

ReferenceLinks

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

GroupType

Gruppentyp

GroupEntitlement

Eine Gruppenentität mit zusätzlichen Eigenschaften, einschließlich Lizenz, Erweiterungen und Projektmitgliedschaft

Name Typ Beschreibung
group

GraphGroup

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

AccessLevel

Lizenzregel.

members

UserEntitlement[]

Gruppenmitglieder. Wird nur beim Erstellen einer neuen Gruppe verwendet.

projectEntitlements

ProjectEntitlement[]

Beziehung zwischen einem Projekt und den effektiven Berechtigungen des Mitglieds in diesem Projekt.

status

GroupLicensingRuleStatus

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

Operation

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

AssignmentSource

Zuweisungsquelle (z. B. Gruppe oder Unbekannt).

group

Group

Projektgruppe (z.B. Mitwirkender, Leser usw.)

projectPermissionInherited

ProjectPermissionInherited

Gibt an, ob der Benutzer Berechtigungen für ein Projekt über eine Azure DevOps- oder AAD-Gruppenmitgliedschaft erbt.

projectRef

ProjectRef

Projektreferenz

teamRefs

TeamRef[]

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.

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

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

GroupEntitlement[]

[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

ProjectEntitlement[]

Beziehung zwischen einem Projekt und den effektiven Berechtigungen des Mitglieds in diesem Projekt.

servicePrincipal

GraphServicePrincipal

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

ServicePrincipalEntitlementOperationResult[]

servicePrincipalEntitlement

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

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

GroupEntitlement[]

[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

ProjectEntitlement[]

Beziehung zwischen einem Projekt und den effektiven Berechtigungen des Mitglieds in diesem Projekt.

user

GraphUser

Benutzerreferenz.