Personal Access Tokens - List

參考

Service:: Token Admin

API Version:: 7.1-preview.1

特定使用者個人存取權杖的所有會話權杖詳細資料清單， (PAT) 。

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 參數

名稱	位於	必要	類型	Description
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	每個頁面上要傳回的結果數目上限。

回應

名稱	類型	Description
200 OK	TokenAdminPagedSessionTokens	陣列，包含對應至使用者 PAT 的所有會話權杖物件。
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

名稱	Description
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
}

定義

名稱	Description
SessionToken	表示用來存取 Azure DevOps 資源的會話權杖
TokenAdminPagedSessionTokens	會話權杖的編頁清單。會話權杖會對應至 OAuth 認證，例如個人存取權杖 (PAT) 和其他 OAuth 授權。

SessionToken

表示用來存取 Azure DevOps 資源的會話權杖

名稱	類型	Description
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 授權。

名稱	類型	Description
continuationToken	string	可用來擷取會話權杖下一頁的接續權杖，如果沒有 `null` 下一頁，則為。
value	SessionToken[]	目前頁面中所有會話權杖的清單。

共用方式為