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 パラメーター

名前	/	必須	型	説明
organization	path	True	string	Azure DevOps 組織の名前です。
subjectDescriptor	path	True	string	ターゲットユーザーの記述子。
api-version	query	True	string	使う API のバージョン。このバージョンの API を使用するには、これを '7.1-preview.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

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

名前	説明
vso.tokenadministration	organization管理者に対して既存のトークンを管理 (表示および取り消し) する機能を付与します

例

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
}

定義

名前	説明
SessionToken	Azure DevOps リソースへのアクセスに使用されるセッショントークンを表します
TokenAdminPagedSessionTokens	セッショントークンのページ分割された一覧。セッショントークンは、個人用アクセストークン (PAT) やその他の OAuth 承認などの OAuth 資格情報に対応します。

SessionToken

Azure DevOps リソースへのアクセスに使用されるセッショントークンを表します

名前	型	説明
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	これは計算され、Get クエリでは返されません
userId	string
validFrom	string
validTo	string

TokenAdminPagedSessionTokens

セッショントークンのページ分割された一覧。セッショントークンは、個人用アクセストークン (PAT) やその他の OAuth 承認などの OAuth 資格情報に対応します。

名前	型	説明
continuationToken	string	セッショントークンの次のページを取得するために使用できる継続トークン。 `null` 次のページがない場合は。
value	SessionToken[]	現在のページ内のすべてのセッショントークンの一覧。

次の方法で共有