Pats - List

参考

Service:: Tokens

API Version:: 7.1-preview.1

获取此组织中) 创建的个人访问令牌 (分页列表。对 API 的后续调用需要提供相同的筛选选项。

GET https://vssps.dev.azure.com/{organization}/_apis/tokens/pats?api-version=7.1-preview.1

With optional parameters:

GET https://vssps.dev.azure.com/{organization}/_apis/tokens/pats?displayFilterOption={displayFilterOption}&sortByOption={sortByOption}&isSortAscending={isSortAscending}&continuationToken={continuationToken}&$top={$top}&api-version=7.1-preview.1

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
api-version	query	True	string	要使用的 API 版本。这应设置为“7.1-preview.1”才能使用此版本的 API。
$top	query		integer int32	(可选) 要返回的令牌数，限制为 100
continuationToken	query		string	(可选) 从何处开始返回令牌
displayFilterOption	query		DisplayFilterOptions	(可选) 指个人访问令牌 (PAT) 的状态
isSortAscending	query		boolean	(可选) 升序或降序
sortByOption	query		SortByOptions	(可选) 排序依据的字段

响应

名称	类型	说明
200 OK	PagedPatTokens	成功的操作

安全性

accessToken

个人访问令牌。将任何值用作用户名和令牌作为密码。

Type: basic

示例

List personal access tokens

Sample Request

HTTP

GET https://vssps.dev.azure.com/{organization}/_apis/tokens/pats?api-version=7.1-preview.1

Sample Response

Status code:: 200

{
  "continuationToken": "",
  "patTokens": [
    {
      "displayName": "all_access_token",
      "validTo": "2020-11-23T04:04:38.5233333Z",
      "scope": "app_token",
      "targetAccounts": null,
      "validFrom": "2020-10-24T03:04:57.52Z",
      "authorizationId": "4c60c9ed-a378-4883-af16-d655ca025b11",
      "token": null
    },
    {
      "displayName": "work_token",
      "validTo": "2020-11-23T04:03:55.8033333Z",
      "scope": "vso.work_full",
      "targetAccounts": [
        "38aaa865-2c70-4bf7-a308-0c6539c38c1a"
      ],
      "validFrom": "2020-10-24T03:04:19.1466667Z",
      "authorizationId": "eabb38b2-48ef-440b-959b-b9e6cb37a64e",
      "token": null
    },
    {
      "displayName": "new_token",
      "validTo": "2020-12-01T23:46:23.32Z",
      "scope": "app_token",
      "targetAccounts": [
        "38aaa865-2c70-4bf7-a308-0c6539c38c1a"
      ],
      "validFrom": "2020-11-02T22:56:52.1033333Z",
      "authorizationId": "4ab5764f-4193-4f1d-b995-64144880b7d7",
      "token": null
    },
    {
      "displayName": "analytics_token",
      "validTo": "2020-12-01T23:46:23.32Z",
      "scope": "vso.analytics",
      "targetAccounts": [
        "38aaa865-2c70-4bf7-a308-0c6539c38c1a"
      ],
      "validFrom": "2020-10-29T17:26:46.72Z",
      "authorizationId": "3d3aca0c-9ad3-4b07-8334-08ec8b1ddc32",
      "token": null
    }
  ]
}

定义

名称	说明
DisplayFilterOptions	(可选) 指个人访问令牌 (PAT) 的状态
PagedPatTokens	由 List 方法返回;包含个人访问令牌列表 (PAC) ，以及用于获取下一页结果的继续令牌
PatToken	表示用于访问 Azure DevOps 资源 (PAT) 的个人访问令牌
SortByOptions	(可选) 排序依据的字段

DisplayFilterOptions

(可选) 指个人访问令牌 (PAT) 的状态

名称	类型	说明
active	string	令牌处于活动状态 (例如尚未吊销且) 尚未过期。
all	string	包括所有令牌。
expired	string	令牌已过期，除非使用新的到期日期进行更新，否则不再可用。
revoked	string	令牌已被吊销，不再可用。

PagedPatTokens

由 List 方法返回;包含个人访问令牌列表 (PAC) ，以及用于获取下一页结果的继续令牌

名称	类型	说明
continuationToken	string	用于在连续 API 调用中访问下一页结果，以列出个人访问令牌 (PAC)
patTokens	PatToken[]	PAC (个人访问令牌列表)

PatToken

表示用于访问 Azure DevOps 资源 (PAT) 的个人访问令牌

名称	类型	说明
authorizationId	string	唯一 GUID 标识符
displayName	string	令牌名称
scope	string	用于访问 Azure DevOps 资源的令牌范围
targetAccounts	string[]	令牌有效的组织;如果令牌应用于所有用户的可访问组织，则为 null
token	string	创建时生成的唯一令牌字符串
validFrom	string	令牌创建日期
validTo	string	令牌过期日期

SortByOptions

(可选) 排序依据的字段

名称	类型	说明
displayDate	string	按显示日期排序
displayName	string	按显示名称排序
status	string	按状态排序

通过