Personal Access Tokens - List

Referência

Serviço:: Token Admin

Versão da API:: 7.1

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

Com parâmetros opcionais:

GET https://vssps.dev.azure.com/{organization}/_apis/tokenadmin/personalaccesstokens/{subjectDescriptor}?pageSize={pageSize}&continuationToken={continuationToken}&isPublic={isPublic}&api-version=7.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' 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 ainda há mais dados é a presença de um token de continuação.
isPublic	query		boolean	Definido 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, por exemplo, contendo 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 especificado 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 aos administradores da organização

Exemplos

Solicitação de exemplo

HTTP

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

Resposta de exemplo

Código de status:: 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
}

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

Objeto

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

Nome	Tipo	Description
accessId	string (uuid)
alternateToken	string	Isso é preenchido quando o usuário solicita um token compacto. O valor de token alternativo é o token de auto-descrição.
authorizationId	string (uuid)
claims	object
clientId	string (uuid)
displayName	string
hostAuthorizationId	string (uuid)
isPublic	boolean
isValid	boolean
publicData	string
scope	string
source	string
targetAccounts	string[] (uuid)
token	string	Isso é computado e não retornado em Obter consultas
userId	string (uuid)
validFrom	string (date-time)
validTo	string (date-time)

TokenAdminPagedSessionTokens