Personal Access Tokens - List

Odwołanie

Usługa:: Token Admin

Wersja interfejsu API:: 7.1

Lista wszystkich szczegółów tokenu sesji osobistych tokenów dostępu (PAT) dla określonego użytkownika.

GET https://vssps.dev.azure.com/{organization}/_apis/tokenadmin/personalaccesstokens/{subjectDescriptor}?api-version=7.1

Z parametrami opcjonalnymi:

GET https://vssps.dev.azure.com/{organization}/_apis/tokenadmin/personalaccesstokens/{subjectDescriptor}?pageSize={pageSize}&continuationToken={continuationToken}&isPublic={isPublic}&api-version=7.1

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
organization	path	True	string	Nazwa organizacji usługi Azure DevOps.
subjectDescriptor	path	True	string	Deskryptor użytkownika docelowego.
api-version	query	True	string	Wersja interfejsu API do użycia. Należy ustawić wartość "7.1", aby używać tej wersji interfejsu API.
continuationToken	query		string	Nieprzezroczystym obiekt blob danych, który umożliwia wznowienie następnej strony danych natychmiast po zakończeniu poprzedniej strony. Jedynym niezawodnym sposobem, aby dowiedzieć się, czy pozostało więcej danych, jest obecność tokenu kontynuacji.
isPublic	query		boolean	Ustaw wartość false dla tokenów PAT i wartość true dla tokenów SSH.
pageSize	query		integer (int32)	Maksymalna liczba wyników do zwrócenia na każdej stronie.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	TokenAdminPagedSessionTokens	Tablica zawierająca wszystkie obiekty tokenu sesji odpowiadające numerom PAT użytkownika.
400 Bad Request		Dane wejściowe są nieprawidłowe, na przykład przez zawieranie nieprawidłowego deskryptora podmiotu, rozmiaru strony lub tokenu kontynuacji
401 Unauthorized		Jeśli obiekt wywołujący nie ma uprawnień do administrowania tokenami
404 Not Found		Jeśli nie można odnaleźć użytkownika z danym deskryptorem tematu.

Zabezpieczenia

oauth2

Typ: oauth2
Flow: accessCode
Adres URL autoryzacji: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Adres URL tokenu: 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

Zakresy

Nazwa	Opis
vso.tokenadministration	Umożliwia zarządzanie istniejącymi tokenami (wyświetlanie i odwoływanie) administratorom organizacji

Przykłady

Przykładowe żądanie

HTTP

GET https://vssps.dev.azure.com/fabrikam/_apis/tokenadmin/personalaccesstokens/{subjectDescriptor}?pageSize=20&api-version=7.1

Przykładowa odpowiedź

Kod stanu:: 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
}

Definicje

Nazwa	Opis
SessionToken	Reprezentuje token sesji używany do uzyskiwania dostępu do zasobów usługi Azure DevOps
TokenAdminPagedSessionTokens	Lista tokenów sesji z podziałem na strony. Tokeny sesji odpowiadają poświadczeń protokołu OAuth, takich jak osobiste tokeny dostępu (PAT) i inne autoryzacje protokołu OAuth.

SessionToken

Objekt

Reprezentuje token sesji używany do uzyskiwania dostępu do zasobów usługi Azure DevOps

Nazwa	Typ	Opis
accessId	string (uuid)
alternateToken	string	Jest to wypełniane, gdy użytkownik żąda tokenu kompaktowego. Wartość tokenu alternatywnego jest samoopisem opisującym token.
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	Jest to obliczane i nie zwracane w obszarze Pobieranie zapytań
userId	string (uuid)
validFrom	string (date-time)
validTo	string (date-time)

TokenAdminPagedSessionTokens