Compartir a través de


Token Personal Access Tokens - List

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

POST https://dev.azure.com/_apis/tokenadministration/tokenpersonalaccesstokens/{subjectDescriptor}?api-version=5.1-preview.1
POST https://dev.azure.com/_apis/tokenadministration/tokenpersonalaccesstokens/{subjectDescriptor}?pageSize={pageSize}&continuationToken={continuationToken}&isPublic={isPublic}&api-version=5.1-preview.1

Parámetros de identificador URI

Nombre En Requerido Tipo Description
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 "5.1-preview.1" para usar esta versión de la API.

continuationToken
query

string

Un blob de datos opaco que permite que la siguiente página de datos se reanude inmediatamente después de la finalización de la página anterior. La única manera confiable de saber si quedan más datos es la presencia de un token de continuación.

isPublic
query

boolean

Se establece en false para los tokens pat y true para los tokens SSH.

pageSize
query

integer

int32

Número máximo de resultados que se devolverán en cada página.

Cuerpo de la solicitud

Nombre Tipo Description
body

string[]

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, al contener un descriptor de asunto, un tamaño de página o un token de continuación no válidos.

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

Tipo: oauth2
Flujo: accessCode
Dirección URL de autorización: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Dirección URL del token: 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

Ámbitos

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

Definiciones

Nombre Description
SessionToken
TokenAdminPagedSessionTokens

Una 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

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 se 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

Una 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.