Personal Access Tokens - List

リファレンス

サービス:: Token Admin

API バージョン:: 7.1

特定のユーザーの個人用アクセストークン (AT) のすべてのセッショントークンの詳細の一覧。

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 のバージョン。このバージョンの API を使用するには、これを '7.1' に設定する必要があります。
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
Authorization URL (承認 URL): https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL (トークン 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	セッショントークンのページ分割された一覧。セッショントークンは、個人用アクセストークン (AT) やその他の OAuth 承認などの 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