Personal Access Tokens - List

Referenz

Service:: Token Admin

API Version:: 7.1-preview.1

Listet alle Sitzungstokendetails der persönlichen Zugriffstoken (PATs) für einen bestimmten Benutzer auf.

GET https://vssps.dev.azure.com/{organization}/_apis/tokenadmin/personalaccesstokens/{subjectDescriptor}?api-version=7.1-preview.1

With optional parameters:

GET https://vssps.dev.azure.com/{organization}/_apis/tokenadmin/personalaccesstokens/{subjectDescriptor}?pageSize={pageSize}&continuationToken={continuationToken}&isPublic={isPublic}&api-version=7.1-preview.1

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
organization	path	True	string	Der Name der Azure DevOps-Organisation.
subjectDescriptor	path	True	string	Die Deskriptor des Zielbenutzers.
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.
continuationToken	query		string	Ein undurchsichtiges Datenblob, mit dem die nächste Datenseite unmittelbar nach dem Ende der vorherigen Seite fortgesetzt werden kann. Die einzige zuverlässige Möglichkeit, um zu ermitteln, ob noch mehr Daten vorhanden sind, ist das Vorhandensein eines Fortsetzungstokens.
isPublic	query		boolean	Legen Sie für PAT-Token auf false und für SSH-Token auf true fest.
pageSize	query		integer int32	Die maximale Anzahl von Ergebnissen, die auf jeder Seite zurückgegeben werden sollen.

Antworten

Name	Typ	Beschreibung
200 OK	TokenAdminPagedSessionTokens	Ein Array, das alle Sitzungstokenobjekte enthält, die den PATs des Benutzers entsprechen.
400 Bad Request		Die Eingabe ist ungültig, z. B. indem sie einen ungültigen Betreffdeskriptor, eine Seitengröße oder ein Fortsetzungstoken enthält.
401 Unauthorized		Wenn der Aufrufer nicht über die Berechtigung zum Verwalten von Token verfügt
404 Not Found		Wenn der Benutzer mit dem angegebenen Betreffdeskriptor nicht gefunden werden kann.

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.tokenadministration	Ermöglicht das Verwalten (Anzeigen und Widerrufen) vorhandener Token für organization Administratoren

Beispiele

Sample Request

HTTP

GET https://vssps.dev.azure.com/fabrikam/_apis/tokenadmin/personalaccesstokens/{subjectDescriptor}?pageSize=20&api-version=7.1-preview.1

Sample Response

Status code:: 200

{
  "value": [
    {
      "clientId": "00000000-0000-0000-0000-000000000000",
      "accessId": "00000000-0000-0000-0000-000000000000",
      "authorizationId": "952858d3-7084-4635-964e-3c2a57645185",
      "hostAuthorizationId": "00000000-0000-0000-0000-000000000000",
      "userId": "bb5bb6c8-ef0a-400f-8987-92b3674d2043",
      "validFrom": "2018-07-19T00:00:00",
      "validTo": "2018-07-19T00:00:00",
      "displayName": null,
      "scope": "app_token",
      "targetAccounts": null,
      "token": null,
      "alternateToken": null,
      "isValid": true,
      "isPublic": false,
      "publicData": null,
      "source": null
    },
    {
      "clientId": "00000000-0000-0000-0000-000000000000",
      "accessId": "00000000-0000-0000-0000-000000000000",
      "authorizationId": "c2e0abd5-85a8-40b0-a179-88e98538ec7c",
      "hostAuthorizationId": "00000000-0000-0000-0000-000000000000",
      "userId": "bb5bb6c8-ef0a-400f-8987-92b3674d2043",
      "validFrom": "2018-07-19T00:00:00",
      "validTo": "2018-07-19T00:00:00",
      "displayName": null,
      "scope": "vso.dashboards vso.taskgroups_manage",
      "targetAccounts": null,
      "token": null,
      "alternateToken": null,
      "isValid": true,
      "isPublic": false,
      "publicData": null,
      "source": null
    },
    {
      "clientId": "00000000-0000-0000-0000-000000000000",
      "accessId": "00000000-0000-0000-0000-000000000000",
      "authorizationId": "e1bd9361-1120-4227-a258-da80545884b9",
      "hostAuthorizationId": "00000000-0000-0000-0000-000000000000",
      "userId": "bb5bb6c8-ef0a-400f-8987-92b3674d2043",
      "validFrom": "2018-07-19T00:00:00",
      "validTo": "2018-07-19T00:00:00",
      "displayName": null,
      "scope": "vso.graph_manage vso.identity_manage",
      "targetAccounts": null,
      "token": null,
      "alternateToken": null,
      "isValid": true,
      "isPublic": false,
      "publicData": null,
      "source": null
    }
  ],
  "continuationToken": null
}

Definitionen

Name	Beschreibung
SessionToken	Stellt ein Sitzungstoken dar, das für den Zugriff auf Azure DevOps-Ressourcen verwendet wird
TokenAdminPagedSessionTokens	Eine paginierte Liste von Sitzungstoken. Sitzungstoken entsprechen OAuth-Anmeldeinformationen wie persönliche Zugriffstoken (PATs) und anderen OAuth-Autorisierungen.

SessionToken

Stellt ein Sitzungstoken dar, das für den Zugriff auf Azure DevOps-Ressourcen verwendet wird

Name	Typ	Beschreibung
accessId	string
alternateToken	string	Diese wird aufgefüllt, wenn ein Benutzer ein kompaktes Token anfordert. Der alternative Tokenwert ist ein selbstbeschreibtes Token.
authorizationId	string
claims	object
clientId	string
displayName	string
hostAuthorizationId	string
isPublic	boolean
isValid	boolean
publicData	string
scope	string
source	string
targetAccounts	string[]
token	string	Dies wird berechnet und in Abfragen abrufen nicht zurückgegeben.
userId	string
validFrom	string
validTo	string

TokenAdminPagedSessionTokens

Eine paginierte Liste von Sitzungstoken. Sitzungstoken entsprechen OAuth-Anmeldeinformationen wie persönliche Zugriffstoken (PATs) und anderen OAuth-Autorisierungen.

Name	Typ	Beschreibung
continuationToken	string	Das Fortsetzungstoken, das verwendet werden kann, um die nächste Seite von Sitzungstoken abzurufen, oder `null` wenn keine nächste Seite vorhanden ist.
value	SessionToken[]	Die Liste aller Sitzungstoken auf der aktuellen Seite.