Partilhar via


Personal Access Tokens - List

Lista todos os detalhes do token de sessão dos PATs (tokens de acesso pessoal) para um usuário específico.

GET https://vssps.dev.azure.com/{organization}/_apis/tokenadmin/personalaccesstokens/{subjectDescriptor}?api-version=7.1-preview.1
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 URI

Nome Em Obrigatório Tipo Description
organization
path True

string

O nome da organização do Azure DevOps.

subjectDescriptor
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 '7.1-preview.1' para usar essa versão da api.

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

isPublic
query

boolean

Defina como false para tokens PAT e true para tokens SSH.

pageSize
query

integer

int32

O número máximo de resultados a serem retornados em cada página.

Respostas

Nome Tipo Description
200 OK

TokenAdminPagedSessionTokens

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 meio de 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

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

Nome Description
vso.tokenadministration Concede a capacidade de gerenciar (exibir e revogar) tokens existentes aos administradores da organização

Exemplos

Sample Request

GET https://vssps.dev.azure.com/fabrikam/_apis/tokenadmin/personalaccesstokens/{subjectDescriptor}?pageSize=20&api-version=7.1-preview.1

Sample Response

{
  "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
}

Definições

Nome Description
SessionToken

Representa um token de sessão usado para acessar recursos do Azure DevOps

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.

SessionToken

Representa um token de sessão usado para acessar recursos do Azure DevOps

Nome Tipo Description
accessId

string

alternateToken

string

Isso é preenchido quando o usuário solicita um token compacto. O valor de token alternativo é o token autodescrevendo.

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 null se não houver uma próxima página.

value

SessionToken[]

A lista de todos os tokens de sessão na página atual.