Personal Access Tokens - List

Service:

Token Admin

API Version:

7.1-preview.1

Répertorie tous les détails des jetons de session des jetons d’accès personnels (PAT) pour un utilisateur particulier.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
organization	path	True	string	Nom de l’organisation Azure DevOps.
subjectDescriptor	path	True	string	Descripteur de l’utilisateur cible.
api-version	query	True	string	Version de l’API à utiliser. Cette valeur doit être définie sur « 7.1-preview.1 » pour utiliser cette version de l’API.
continuationToken	query		string	Objet blob de données opaque qui permet à la page suivante de reprendre immédiatement après la fin de la page précédente. La seule façon fiable de savoir s’il reste plus de données est la présence d’un jeton de continuation.
isPublic	query		boolean	Définissez sur false pour les jetons PAT et true pour les jetons SSH.
pageSize	query		integer int32	Nombre maximal de résultats à retourner sur chaque page.

Réponses

Nom	Type	Description
200 OK	TokenAdminPagedSessionTokens	Tableau contenant tous les objets de jeton de session correspondant aux PAT de l’utilisateur.
400 Bad Request		L’entrée n’est pas valide, par exemple en contenant un descripteur d’objet, une taille de page ou un jeton de continuation non valide
401 Unauthorized		Si l’appelant n’est pas autorisé à administrer des jetons
404 Not Found		Si l’utilisateur avec le descripteur d’objet donné est introuvable.

Sécurité

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

Nom	Description
vso.tokenadministration	Accorde la possibilité de gérer (afficher et révoquer) les jetons existants aux administrateurs organization

Exemples

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
}

Définitions

Nom	Description
SessionToken	Représente un jeton de session utilisé pour accéder aux ressources Azure DevOps
TokenAdminPagedSessionTokens	Liste paginée de jetons de session. Les jetons de session correspondent aux informations d’identification OAuth telles que les jetons d’accès personnels (PAT) et d’autres autorisations OAuth.

SessionToken

Représente un jeton de session utilisé pour accéder aux ressources Azure DevOps

Nom	Type	Description
accessId	string
alternateToken	string	Ce paramètre est renseigné lorsque l’utilisateur demande un jeton compact. L’autre valeur de jeton est un jeton auto-décrivant.
authorizationId	string
claims	object
clientId	string
displayName	string
hostAuthorizationId	string
isPublic	boolean
isValid	boolean
publicData	string
scope	string
source	string
targetAccounts	string[]
token	string	Cette valeur est calculée et n’est pas retournée dans Obtenir des requêtes
userId	string
validFrom	string
validTo	string

TokenAdminPagedSessionTokens

Liste paginée de jetons de session. Les jetons de session correspondent aux informations d’identification OAuth telles que les jetons d’accès personnels (PAT) et d’autres autorisations OAuth.

Nom	Type	Description
continuationToken	string	Jeton de continuation qui peut être utilisé pour récupérer la page suivante de jetons de session, ou null s’il n’y a pas de page suivante.
value	SessionToken[]	Liste de tous les jetons de session dans la page active.