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

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

回應

名稱	類型	Description
200 OK	TokenAdminPagedSessionTokens	數位列，包含對應至使用者 PAT 的所有工作階段令牌物件。
400 Bad Request		輸入無效，例如包含無效的主體描述元、頁面大小或接續令牌
401 Unauthorized		如果呼叫端沒有管理令牌的許可權
404 Not Found		如果找不到具有指定主體描述元的使用者。

安全性

oauth2

類型: oauth2
Flow: 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

範圍

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

定義

名稱	Description
SessionToken	表示用來存取 Azure DevOps 資源的會話令牌
TokenAdminPagedSessionTokens	工作階段令牌的編頁清單。會話令牌會對應至 OAuth 認證，例如個人存取令牌（PAT）和其他 OAuth 授權。

SessionToken

Object

表示用來存取 Azure DevOps 資源的會話令牌

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