Personal Access Tokens - List

Referencia

Service:: Token Admin

API Version:: 7.1-preview.1

Listas de todos los detalles del token de sesión de los tokens de acceso personal (PAT) para un usuario determinado.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
organization	path	True	string	El nombre de la organización de Azure DevOps.
subjectDescriptor	path	True	string	Descriptor del usuario de destino.
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "7.1-preview.1" para usar esta versión de la API.
continuationToken	query		string	Un blob de datos opaco que permite que la página siguiente de datos se reanude inmediatamente después de la finalización de la página anterior. La única manera confiable de saber si hay más datos a la izquierda es la presencia de un token de continuación.
isPublic	query		boolean	Establézcalo en false para los tokens pat y true para los tokens SSH.
pageSize	query		integer int32	Número máximo de resultados que se van a devolver en cada página.

Respuestas

Nombre	Tipo	Description
200 OK	TokenAdminPagedSessionTokens	Matriz que contiene todos los objetos de token de sesión correspondientes a las PAT del usuario.
400 Bad Request		La entrada no es válida, por ejemplo, con un descriptor de asunto no válido, un tamaño de página o un token de continuación
401 Unauthorized		Si el autor de la llamada no tiene permiso para administrar tokens
404 Not Found		Si no se encuentra el usuario con el descriptor de asunto especificado.

Seguridad

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

Nombre	Description
vso.tokenadministration	Concede la capacidad de administrar (ver y revocar) tokens existentes a los administradores de la organización.

Ejemplos

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
}

Definiciones

Nombre	Description
SessionToken	Representa un token de sesión que se usa para acceder a los recursos de Azure DevOps.
TokenAdminPagedSessionTokens	Lista paginada de tokens de sesión. Los tokens de sesión corresponden a credenciales de OAuth, como tokens de acceso personal (PAT) y otras autorizaciones de OAuth.

SessionToken

Representa un token de sesión que se usa para acceder a los recursos de Azure DevOps.

Nombre	Tipo	Description
accessId	string
alternateToken	string	Esto se rellena cuando el usuario solicita un token compacto. El valor del token alternativo es el token que describe automáticamente.
authorizationId	string
claims	object
clientId	string
displayName	string
hostAuthorizationId	string
isPublic	boolean
isValid	boolean
publicData	string
scope	string
source	string
targetAccounts	string[]
token	string	Esto se calcula y no se devuelve en las consultas Get.
userId	string
validFrom	string
validTo	string

TokenAdminPagedSessionTokens

Lista paginada de tokens de sesión. Los tokens de sesión corresponden a credenciales de OAuth, como tokens de acceso personal (PAT) y otras autorizaciones de OAuth.

Nombre	Tipo	Description
continuationToken	string	Token de continuación que se puede usar para recuperar la página siguiente de tokens de sesión o `null` si no hay ninguna página siguiente.
value	SessionToken[]	Lista de todos los tokens de sesión de la página actual.

Compartir a través de