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 |
---|---|---|---|---|
subject
|
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. |
continuation
|
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. |
|
is
|
query |
boolean |
Se establece en false para los tokens pat y true para los tokens SSH. |
|
page
|
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 |
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 |
---|---|
Session |
|
Token |
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 |
value |
Lista de todos los tokens de sesión de la página actual. |