Personal Access Tokens - List

Riferimento

Service:: Token Admin

API Version:: 7.1-preview.1

Elenchi di tutti i dettagli del token di sessione dei token di accesso personale per un determinato utente.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
organization	path	True	string	Nome dell'organizzazione di Azure DevOps.
subjectDescriptor	path	True	string	Descrittore dell'utente di destinazione.
api-version	query	True	string	Versione dell'API da usare. Questa opzione deve essere impostata su '7.1-preview.1' per usare questa versione dell'API.
continuationToken	query		string	BLOB di dati opaco che consente alla pagina successiva di dati di riprendere immediatamente dopo la fine della pagina precedente. L'unico modo affidabile per sapere se sono presenti più dati a sinistra è la presenza di un token di continuazione.
isPublic	query		boolean	Impostare su false per i token PAT e true per i token SSH.
pageSize	query		integer int32	Numero massimo di risultati da restituire in ogni pagina.

Risposte

Nome	Tipo	Descrizione
200 OK	TokenAdminPagedSessionTokens	Matrice contenente tutti gli oggetti token di sessione corrispondenti alle API dell'utente.
400 Bad Request		L'input non è valido, ad esempio contenente un descrittore di soggetto non valido, dimensioni di pagina o token di continuazione
401 Unauthorized		Se il chiamante non dispone dell'autorizzazione per l'amministrazione dei token
404 Not Found		Se non è possibile trovare l'utente con il descrittore soggetto specificato.

Sicurezza

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

Nome	Descrizione
vso.tokenadministration	Concede la possibilità di gestire (visualizzare e revocare) i token esistenti agli amministratori dell'organizzazione

Esempio

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
}

Definizioni

Nome	Descrizione
SessionToken	Rappresenta un token di sessione usato per accedere alle risorse di Azure DevOps
TokenAdminPagedSessionTokens	Elenco impaginato dei token di sessione. I token di sessione corrispondono a credenziali OAuth, ad esempio token di accesso personale (PAT) e altre autorizzazioni OAuth.

SessionToken

Rappresenta un token di sessione usato per accedere alle risorse di Azure DevOps

Nome	Tipo	Descrizione
accessId	string
alternateToken	string	Viene popolato quando l'utente richiede un token compatto. Il valore del token alternativo è l'autodescrizione del 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	Viene calcolato e non restituito nelle query Get
userId	string
validFrom	string
validTo	string

TokenAdminPagedSessionTokens

Elenco impaginato dei token di sessione. I token di sessione corrispondono a credenziali OAuth, ad esempio token di accesso personale (PAT) e altre autorizzazioni OAuth.

Nome	Tipo	Descrizione
continuationToken	string	Token di continuazione che può essere usato per recuperare la pagina successiva dei token di sessione o `null` se non è presente alcuna pagina successiva.
value	SessionToken[]	Elenco di tutti i token di sessione nella pagina corrente.

Share via