Personal Access Tokens - List

Referência

Service:: Token Admin

API Version:: 7.1-preview.1

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

With optional parameters:

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

HTTP

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

Sample Response

Status code:: 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

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.

Partilhar via