Personal Access Tokens - List

Ссылка

Service:: Token Admin

API Version:: 7.1-preview.1

Список всех сведений о маркерах сеанса личных маркеров доступа (PAT) для конкретного пользователя.

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

Имя	В	Обязательно	Тип	Описание
organization	path	True	string	Название организации Azure DevOps.
subjectDescriptor	path	True	string	Дескриптор целевого пользователя.
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение 7.1-preview.1.
continuationToken	query		string	Непрозрачный BLOB-объект данных, который позволяет возобновить работу следующей страницы данных сразу после завершения предыдущей страницы. Единственный надежный способ узнать, осталось ли больше данных, — это наличие маркера продолжения.
isPublic	query		boolean	Установите значение false для маркеров PAT и значение true для маркеров SSH.
pageSize	query		integer int32	Максимальное количество результатов, возвращаемых на каждой странице.

Ответы

Имя	Тип	Описание
200 OK	TokenAdminPagedSessionTokens	Массив, содержащий все объекты маркера сеанса, соответствующие pat пользователя.
400 Bad Request		Недопустимые входные данные, например, содержащие недопустимый дескриптор субъекта, размер страницы или маркер продолжения.
401 Unauthorized		Если вызывающий объект не имеет разрешения на администрирование маркеров
404 Not Found		Не удается найти пользователя с заданным дескриптором субъекта.

Безопасность

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

Имя	Описание
vso.tokenadministration	Предоставляет администраторам организации возможность управлять (просматривать и отзывать) существующие маркеры.

Примеры

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
}

Определения

Имя	Описание
SessionToken	Представляет маркер сеанса, используемый для доступа к ресурсам Azure DevOps.
TokenAdminPagedSessionTokens	Список маркеров сеанса с разбивкой на страницы. Маркеры сеанса соответствуют учетным данным OAuth, таким как личные маркеры доступа (PAT) и другие разрешения OAuth.

SessionToken

Представляет маркер сеанса, используемый для доступа к ресурсам Azure DevOps.

Имя	Тип	Описание
accessId	string
alternateToken	string	Он заполняется, когда пользователь запрашивает компактный маркер. Альтернативным значением маркера является самоописывующий токен.
authorizationId	string
claims	object
clientId	string
displayName	string
hostAuthorizationId	string
isPublic	boolean
isValid	boolean
publicData	string
scope	string
source	string
targetAccounts	string[]
token	string	Это вычисляется и не возвращается в запросе Get
userId	string
validFrom	string
validTo	string

TokenAdminPagedSessionTokens

Список маркеров сеанса с разбивкой на страницы. Маркеры сеанса соответствуют учетным данным OAuth, таким как личные маркеры доступа (PAT) и другие разрешения OAuth.

Имя	Тип	Описание
continuationToken	string	Маркер продолжения, который можно использовать для получения следующей страницы маркеров сеанса, или `null` , если следующая страница отсутствует.
value	SessionToken[]	Список всех маркеров сеанса на текущей странице.

Поделиться через