Personal Access Tokens - List

参考

Service:: Token Admin

API Version:: 7.1-preview.1

个人访问令牌的所有会话令牌详细信息列表， (特定用户的 PAC) 。

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

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
subjectDescriptor	path	True	string	目标用户的描述符。
api-version	query	True	string	要使用的 API 版本。应将其设置为“7.1-preview.1”才能使用此版本的 API。
continuationToken	query		string	一个不透明的数据 Blob，它允许在上一页结束之后立即恢复下一页数据。了解剩余数据是否更多的唯一可靠方法是是否存在延续标记。
isPublic	query		boolean	对于 PAT 令牌，设置为 false;对于 SSH 令牌，设置为 true。
pageSize	query		integer int32	每页返回的最大结果数。

响应

名称	类型	说明
200 OK	TokenAdminPagedSessionTokens	一个数组，其中包含与用户的 PAC 对应的所有会话令牌对象。
400 Bad Request		输入无效，例如包含无效的主题描述符、页面大小或延续标记
401 Unauthorized		如果调用方没有管理令牌的权限
404 Not Found		如果找不到具有给定主题描述符的用户。

安全性

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

名称	说明
vso.tokenadministration	向组织管理员授予管理 (视图和撤销) 现有令牌的能力

示例

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
}

定义

名称	说明
SessionToken	表示用于访问 Azure DevOps 资源的会话令牌
TokenAdminPagedSessionTokens	会话令牌的分页列表。会话令牌对应于 OAuth 凭据，例如个人访问令牌 (PAT) 和其他 OAuth 授权。

SessionToken

表示用于访问 Azure DevOps 资源的会话令牌

名称	类型	说明
accessId	string
alternateToken	string	当用户请求压缩令牌时，会填充此令牌。备用令牌值是自描述令牌。
authorizationId	string
claims	object
clientId	string
displayName	string
hostAuthorizationId	string
isPublic	boolean
isValid	boolean
publicData	string
scope	string
source	string
targetAccounts	string[]
token	string	这是计算的，不会在获取查询中返回
userId	string
validFrom	string
validTo	string

TokenAdminPagedSessionTokens

会话令牌的分页列表。会话令牌对应于 OAuth 凭据，例如个人访问令牌 (PAT) 和其他 OAuth 授权。

名称	类型	说明
continuationToken	string	可用于检索会话令牌的下一页的延续标记;如果没有下一页， `null` 则为。
value	SessionToken[]	当前页中所有会话令牌的列表。

通过