Personal Access Tokens - List

Başvuru

Service:: Token Admin

API Version:: 7.1-preview.1

Belirli bir kullanıcı için kişisel erişim belirteçlerinin (PAT) tüm oturum belirteci ayrıntılarının listesi.

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 Parametreleri

Name	İçinde	Gerekli	Tür	Description
organization	path	True	string	Azure DevOps kuruluşunun adı.
subjectDescriptor	path	True	string	Hedef kullanıcının tanımlayıcısı.
api-version	query	True	string	Kullanılacak API'nin sürümü. Bu, api'nin bu sürümünü kullanmak için '7.1-preview.1' olarak ayarlanmalıdır.
continuationToken	query		string	Sonraki veri sayfasının önceki sayfanın sona erdiği yerden hemen sonra sürdürülmesini sağlayan opak bir veri blobu. Daha fazla veri olup olmadığını bilmenin tek güvenilir yolu devamlılık belirtecinin varlığıdır.
isPublic	query		boolean	PAT belirteçleri için false, SSH belirteçleri için true olarak ayarlayın.
pageSize	query		integer int32	Her sayfada döndürülecek en fazla sonuç sayısı.

Yanıtlar

Name	Tür	Description
200 OK	TokenAdminPagedSessionTokens	Kullanıcının PAT'lerine karşılık gelen tüm oturum belirteci nesnelerini içeren bir dizi.
400 Bad Request		Giriş geçersiz, örneğin geçersiz bir konu tanımlayıcısı, sayfa boyutu veya devamlılık belirteci içeriyor
401 Unauthorized		Çağıranın belirteçleri yönetim izni yoksa
404 Not Found		Verilen konu tanımlayıcısı olan kullanıcı bulunamazsa.

Güvenlik

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

Name	Description
vso.tokenadministration	Kuruluş yöneticilerine mevcut belirteçleri yönetme (görüntüleme ve iptal etme) olanağı verir

Örnekler

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
}

Tanımlar

Name	Description
SessionToken	Azure DevOps kaynaklarına erişmek için kullanılan oturum belirtecini temsil eder
TokenAdminPagedSessionTokens	Oturum belirteçlerinin sayfalandırılmış listesi. Oturum belirteçleri, kişisel erişim belirteçleri (PAT) ve diğer OAuth yetkilendirmeleri gibi OAuth kimlik bilgilerine karşılık gelir.

SessionToken

Azure DevOps kaynaklarına erişmek için kullanılan oturum belirtecini temsil eder

Name	Tür	Description
accessId	string
alternateToken	string	Bu, kullanıcı sıkıştırılmış belirteç istediğinde doldurulur. Alternatif belirteç değeri, belirteci kendi kendine açıklar.
authorizationId	string
claims	object
clientId	string
displayName	string
hostAuthorizationId	string
isPublic	boolean
isValid	boolean
publicData	string
scope	string
source	string
targetAccounts	string[]
token	string	Bu işlem hesaplanır ve Get sorgularında döndürülmüyor
userId	string
validFrom	string
validTo	string

TokenAdminPagedSessionTokens

Oturum belirteçlerinin sayfalandırılmış listesi. Oturum belirteçleri, kişisel erişim belirteçleri (PAT) ve diğer OAuth yetkilendirmeleri gibi OAuth kimlik bilgilerine karşılık gelir.

Name	Tür	Description
continuationToken	string	Oturum belirteçlerinin sonraki sayfasını almak için kullanılabilecek devamlılık belirteci veya `null` sonraki sayfa yoksa.
value	SessionToken[]	Geçerli sayfadaki tüm oturum belirteçlerinin listesi.

Aracılığıyla paylaş