Pats - List

Referencia

Service:: Tokens

API Version:: 7.1-preview.1

Obtiene una lista paginada de tokens de acceso personal (PAT) creados en esta organización. Las llamadas posteriores a la API requieren que se proporcionen las mismas opciones de filtrado.

GET https://vssps.dev.azure.com/{organization}/_apis/tokens/pats?api-version=7.1-preview.1

With optional parameters:

GET https://vssps.dev.azure.com/{organization}/_apis/tokens/pats?displayFilterOption={displayFilterOption}&sortByOption={sortByOption}&isSortAscending={isSortAscending}&continuationToken={continuationToken}&$top={$top}&api-version=7.1-preview.1

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
organization	path	True	string	El nombre de la organización de Azure DevOps.
api-version	query	True	string	Versión de la API que se va a usar. Debe establecerse en "7.1-preview.1" para usar esta versión de la API.
$top	query		integer int32	(Opcional) Número de tokens que se van a devolver, límite de 100
continuationToken	query		string	(Opcional) Dónde empezar a devolver tokens de
displayFilterOption	query		DisplayFilterOptions	(Opcional) Hace referencia al estado del token de acceso personal (PAT)
isSortAscending	query		boolean	(Opcional) Ascendente o descendente
sortByOption	query		SortByOptions	(Opcional) Qué campo se va a ordenar por

Respuestas

Nombre	Tipo	Description
200 OK	PagedPatTokens	operación correcta

Seguridad

accessToken

Token de acceso personal. Use cualquier valor para el nombre de usuario y el token como contraseña.

Type: basic

Ejemplos

List personal access tokens

Sample Request

HTTP

GET https://vssps.dev.azure.com/{organization}/_apis/tokens/pats?api-version=7.1-preview.1

Sample Response

Status code:: 200

{
  "continuationToken": "",
  "patTokens": [
    {
      "displayName": "all_access_token",
      "validTo": "2020-11-23T04:04:38.5233333Z",
      "scope": "app_token",
      "targetAccounts": null,
      "validFrom": "2020-10-24T03:04:57.52Z",
      "authorizationId": "4c60c9ed-a378-4883-af16-d655ca025b11",
      "token": null
    },
    {
      "displayName": "work_token",
      "validTo": "2020-11-23T04:03:55.8033333Z",
      "scope": "vso.work_full",
      "targetAccounts": [
        "38aaa865-2c70-4bf7-a308-0c6539c38c1a"
      ],
      "validFrom": "2020-10-24T03:04:19.1466667Z",
      "authorizationId": "eabb38b2-48ef-440b-959b-b9e6cb37a64e",
      "token": null
    },
    {
      "displayName": "new_token",
      "validTo": "2020-12-01T23:46:23.32Z",
      "scope": "app_token",
      "targetAccounts": [
        "38aaa865-2c70-4bf7-a308-0c6539c38c1a"
      ],
      "validFrom": "2020-11-02T22:56:52.1033333Z",
      "authorizationId": "4ab5764f-4193-4f1d-b995-64144880b7d7",
      "token": null
    },
    {
      "displayName": "analytics_token",
      "validTo": "2020-12-01T23:46:23.32Z",
      "scope": "vso.analytics",
      "targetAccounts": [
        "38aaa865-2c70-4bf7-a308-0c6539c38c1a"
      ],
      "validFrom": "2020-10-29T17:26:46.72Z",
      "authorizationId": "3d3aca0c-9ad3-4b07-8334-08ec8b1ddc32",
      "token": null
    }
  ]
}

Definiciones

Nombre	Description
DisplayFilterOptions	(Opcional) Hace referencia al estado del token de acceso personal (PAT)
PagedPatTokens	Devuelto por el método List; contiene una lista de tokens de acceso personal (PAT) y el token de continuación para obtener la siguiente página de resultados.
PatToken	Representa un token de acceso personal (PAT) que se usa para acceder a los recursos de Azure DevOps.
SortByOptions	(Opcional) Qué campo se va a ordenar por

DisplayFilterOptions

(Opcional) Hace referencia al estado del token de acceso personal (PAT)

Nombre	Tipo	Description
active	string	El token está activo (por ejemplo, no se ha revocado y no ha expirado).
all	string	Incluye todos los tokens.
expired	string	El token ha expirado y ya no se puede usar a menos que se actualice con una nueva fecha de expiración.
revoked	string	El token se ha revocado y ya no se puede usar.

PagedPatTokens

Devuelto por el método List; contiene una lista de tokens de acceso personal (PAT) y el token de continuación para obtener la siguiente página de resultados.

Nombre	Tipo	Description
continuationToken	string	Se usa para acceder a la siguiente página de resultados en llamadas API sucesivas para enumerar tokens de acceso personal (PAT)
patTokens	PatToken[]	La lista de tokens de acceso personal (PAT)

PatToken

Representa un token de acceso personal (PAT) que se usa para acceder a los recursos de Azure DevOps.

Nombre	Tipo	Description
authorizationId	string	Identificador guid único
displayName	string	El nombre del token
scope	string	Ámbitos de token para acceder a los recursos de Azure DevOps
targetAccounts	string[]	Las organizaciones para las que el token es válido; null si el token se aplica a todas las organizaciones accesibles del usuario
token	string	Cadena de token única generada durante la creación
validFrom	string	Fecha de creación del token
validTo	string	Fecha de expiración del token

SortByOptions

(Opcional) Qué campo se va a ordenar por

Nombre	Tipo	Description
displayDate	string	Ordenar por fecha de presentación
displayName	string	Ordenar por nombre para mostrar
status	string	Ordenar por estado

Compartir a través de