Personal Access Tokens - List

Odwołanie

Service:: Token Admin

API Version:: 7.1-preview.1

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

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 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. Powinno to być ustawione na wartość "7.1-preview.1", aby używać tej wersji interfejsu API.
continuationToken	query		string	Nieprzezroczysty obiekt blob danych, który umożliwia wznowienie następnej strony danych bezpośrednio 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 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 utworzenie nieprawidłowego deskryptora tematu, 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

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

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

Przykłady

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
}

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 (PATs) i inne autoryzacje OAuth.

SessionToken

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

Nazwa	Typ	Opis
accessId	string
alternateToken	string	Jest to wypełniane, gdy użytkownik żąda tokenu kompaktowego. Wartość tokenu alternatywnego jest samoopisującą tokenem.
authorizationId	string
claims	object
clientId	string
displayName	string
hostAuthorizationId	string
isPublic	boolean
isValid	boolean
publicData	string
scope	string
source	string
targetAccounts	string[]
token	string	Jest to obliczane i nie jest zwracane w obszarze Pobieranie zapytań
userId	string
validFrom	string
validTo	string

TokenAdminPagedSessionTokens

Lista tokenów sesji z podziałem na strony. Tokeny sesji odpowiadają poświadczeń protokołu OAuth, takich jak osobiste tokeny dostępu (PATs) i inne autoryzacje OAuth.

Nazwa	Typ	Opis
continuationToken	string	Token kontynuacji, którego można użyć do pobrania następnej strony tokenów sesji lub `null` jeśli nie ma następnej strony.
value	SessionToken[]	Lista wszystkich tokenów sesji na bieżącej stronie.

Udostępnij za pośrednictwem