Token Personal Access Tokens - List
Listas de todos os detalhes do token de sessão dos PATs (tokens de acesso pessoal) para um usuário específico.
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 URI
Nome | Em | Obrigatório | Tipo | Description |
---|---|---|---|---|
subject
|
path | True |
string |
O descritor do usuário de destino. |
api-version
|
query | True |
string |
Versão da API a ser usada. Isso deve ser definido como '5.1-preview.1' para usar essa versão da API. |
continuation
|
query |
string |
Um blob de dados opaco que permite que a próxima página de dados seja retomada imediatamente após o término da página anterior. A única maneira confiável de saber se há mais dados restantes é a presença de um token de continuação. |
|
is
|
query |
boolean |
Defina como false para tokens PAT e true para tokens SSH. |
|
page
|
query |
integer int32 |
O número máximo de resultados a serem retornados em cada página. |
Corpo da solicitação
Nome | Tipo | Description |
---|---|---|
body |
string[] |
Respostas
Nome | Tipo | Description |
---|---|---|
200 OK |
Uma matriz que contém todos os objetos de token de sessão correspondentes aos PATs do usuário. |
|
400 Bad Request |
A entrada é inválida, como por conter um descritor de assunto inválido, tamanho da página ou token de continuação |
|
401 Unauthorized |
Se o chamador não tiver permissão para administrar tokens |
|
404 Not Found |
Se o usuário com o descritor de assunto fornecido não puder ser encontrado. |
Segurança
oauth2
Tipo:
oauth2
Flow:
accessCode
URL de Autorização:
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
URL do 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
Escopos
Nome | Description |
---|---|
vso.tokenadministration | Concede a capacidade de gerenciar (exibir e revogar) tokens existentes para administradores da organização |
Definições
Nome | Description |
---|---|
Session |
|
Token |
Uma lista paginada de tokens de sessão. Os tokens de sessão correspondem às credenciais do OAuth, como PATs (tokens de acesso pessoal) e outras autorizações OAuth. |
SessionToken
Nome | Tipo | Description |
---|---|---|
accessId |
string |
|
alternateToken |
string |
Isso é preenchido quando o usuário solicita um token compacto. O valor de token alternativo é autodescritivo do 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 |
Isso é calculado e não retornado em Obter consultas |
userId |
string |
|
validFrom |
string |
|
validTo |
string |
TokenAdminPagedSessionTokens
Uma lista paginada de tokens de sessão. Os tokens de sessão correspondem às credenciais do OAuth, como PATs (tokens de acesso pessoal) e outras autorizações OAuth.
Nome | Tipo | Description |
---|---|---|
continuationToken |
string |
O token de continuação que pode ser usado para recuperar a próxima página de tokens de sessão ou |
value |
A lista de todos os tokens de sessão na página atual. |