Personal Access Tokens - List

参考

服务:: Token Admin

API 版本:: 7.1

特定用户个人访问令牌（PAT）的所有会话令牌详细信息的列表。

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

具有可选参数:

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

URI 参数

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

响应

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

安全性

oauth2

类型: oauth2
流向: accessCode
授权 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
令牌 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

作用域

名称	说明
vso.tokenadministration	向组织管理员授予管理现有令牌（查看和撤销）的能力

示例

示例请求

HTTP

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

示例响应

状态代码:: 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

Object

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

名称	类型	说明
accessId	string (uuid)
alternateToken	string	当用户请求压缩令牌时会填充此项。备用令牌值是自描述令牌。
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	这是计算的，而不是在 Get 查询中返回的
userId	string (uuid)
validFrom	string (date-time)
validTo	string (date-time)

TokenAdminPagedSessionTokens