共用方式為


Personal Access Tokens - List

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

GET https://vssps.dev.azure.com/{organization}/_apis/tokenadmin/personalaccesstokens/{subjectDescriptor}?api-version=7.1-preview.1
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

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

Sample Response

{
  "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[]

目前頁面中所有會話權杖的清單。