Personal Access Tokens - List

Referensi

Service:: Token Admin

API Version:: 7.1-preview.1

Daftar semua detail token sesi token akses pribadi (PATs) untuk pengguna tertentu.

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
organization	path	True	string	Nama organisasi Azure DevOps.
subjectDescriptor	path	True	string	Pendeskripsi pengguna target.
api-version	query	True	string	Versi API yang akan digunakan. Ini harus diatur ke '7.1-preview.1' untuk menggunakan versi api ini.
continuationToken	query		string	Blob data buram yang memungkinkan halaman data berikutnya dilanjutkan segera setelah halaman sebelumnya berakhir. Satu-satunya cara yang dapat diandalkan untuk mengetahui apakah ada lebih banyak data yang tersisa adalah adanya token kelanjutan.
isPublic	query		boolean	Atur ke false untuk token PAT dan true untuk token SSH.
pageSize	query		integer int32	Jumlah maksimum hasil yang akan dikembalikan di setiap halaman.

Respons

Nama	Jenis	Deskripsi
200 OK	TokenAdminPagedSessionTokens	Array yang berisi semua objek token sesi yang sesuai dengan PATs pengguna.
400 Bad Request		Input tidak valid, seperti dengan berisi deskriptor subjek, ukuran halaman, atau token kelanjutan yang tidak valid
401 Unauthorized		Jika pemanggil tidak memiliki izin untuk mengelola token
404 Not Found		Jika pengguna dengan pendeskripsi subjek yang diberikan tidak dapat ditemukan.

Keamanan

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

Nama	Deskripsi
vso.tokenadministration	Memberikan kemampuan untuk mengelola (melihat dan mencabut) token yang ada kepada administrator organisasi

Contoh

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
}

Definisi

Nama	Deskripsi
SessionToken	Mewakili token sesi yang digunakan untuk mengakses sumber daya Azure DevOps
TokenAdminPagedSessionTokens	Daftar token sesi yang dipaginasi. Token sesi sesuai dengan kredensial OAuth seperti token akses pribadi (PATs) dan otorisasi OAuth lainnya.

SessionToken

Mewakili token sesi yang digunakan untuk mengakses sumber daya Azure DevOps

Nama	Jenis	Deskripsi
accessId	string
alternateToken	string	Ini diisi ketika pengguna meminta token ringkas. Nilai token alternatif adalah sendiri yang menjelaskan token.
authorizationId	string
claims	object
clientId	string
displayName	string
hostAuthorizationId	string
isPublic	boolean
isValid	boolean
publicData	string
scope	string
source	string
targetAccounts	string[]
token	string	Ini dihitung dan tidak dikembalikan di Dapatkan kueri
userId	string
validFrom	string
validTo	string

TokenAdminPagedSessionTokens

Daftar token sesi yang dipaginasi. Token sesi sesuai dengan kredensial OAuth seperti token akses pribadi (PATs) dan otorisasi OAuth lainnya.

Nama	Jenis	Deskripsi
continuationToken	string	Token kelanjutan yang dapat digunakan untuk mengambil halaman token sesi berikutnya, atau `null` jika tidak ada halaman berikutnya.
value	SessionToken[]	Daftar semua token sesi di halaman saat ini.