Personal Access Tokens - List

Reference

Service:: Token Admin

API Version:: 7.1-preview.1

Seznam všech podrobností tokenů relace pro tokeny PAT pro konkrétního uživatele

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
organization	path	True	string	Název organizace Azure DevOps.
subjectDescriptor	path	True	string	Popisovač cílového uživatele.
api-version	query	True	string	Verze rozhraní API, která se má použít. Aby se tato verze rozhraní API používala, měla by být nastavená na 7.1-preview.1.
continuationToken	query		string	Neprůshlený objekt blob dat, který umožňuje obnovení další stránky dat hned po ukončení předchozí stránky. Jediným spolehlivým způsobem, jak zjistit, jestli zbývá více dat, je přítomnost pokračovacího tokenu.
isPublic	query		boolean	Pro tokeny PAT nastavte hodnotu false a hodnotu true pro tokeny SSH.
pageSize	query		integer int32	Maximální počet výsledků, které se mají vrátit na každé stránce.

Odpovědi

Name	Typ	Description
200 OK	TokenAdminPagedSessionTokens	Pole obsahující všechny objekty tokenu relace odpovídající patům uživatele.
400 Bad Request		Vstup je neplatný, například obsahuje neplatný popisovač předmětu, velikost stránky nebo token pokračování.
401 Unauthorized		Pokud volající nemá oprávnění ke správě tokenů
404 Not Found		Pokud nelze najít uživatele s daným popisovačem předmětu.

Zabezpečení

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	Uděluje správcům organizace možnost spravovat (zobrazit a odvolat) existující tokeny.

Příklady

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
}

Definice

Name	Description
SessionToken	Představuje token relace používaný pro přístup k prostředkům Azure DevOps.
TokenAdminPagedSessionTokens	Stránkovaný seznam tokenů relací. Tokeny relací odpovídají přihlašovacím údajům OAuth, jako jsou osobní přístupové tokeny (PAT) a další autorizace OAuth.

SessionToken

Představuje token relace používaný pro přístup k prostředkům Azure DevOps.

Name	Typ	Description
accessId	string
alternateToken	string	Tato hodnota se vyplní, když uživatel požádá o kompaktní token. Alternativní hodnota tokenu je vlastní popis tokenu.
authorizationId	string
claims	object
clientId	string
displayName	string
hostAuthorizationId	string
isPublic	boolean
isValid	boolean
publicData	string
scope	string
source	string
targetAccounts	string[]
token	string	Tato hodnota se vypočítá a nevrátí se v dotazech Get.
userId	string
validFrom	string
validTo	string

TokenAdminPagedSessionTokens

Stránkovaný seznam tokenů relací. Tokeny relací odpovídají přihlašovacím údajům OAuth, jako jsou osobní přístupové tokeny (PAT) a další autorizace OAuth.

Name	Typ	Description
continuationToken	string	Pokračovací token, který lze použít k načtení další stránky tokenů relace, nebo `null` pokud neexistuje žádná další stránka.
value	SessionToken[]	Seznam všech tokenů relací na aktuální stránce.

Sdílet prostřednictvím