Pats - Get

Referencia

Service:: Tokens

API Version:: 7.1-preview.1

Obtiene un único token de acceso personal (PAT).

GET https://vssps.dev.azure.com/{organization}/_apis/tokens/pats?authorizationId={authorizationId}&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.
authorizationId	query	True	string uuid	AuthorizationId que identifica un único token de acceso personal (PAT)

Respuestas

Nombre	Tipo	Description
200 OK	PatTokenResult	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

Get a personal access token by authorizationId

Sample Request

HTTP

GET https://vssps.dev.azure.com/{organization}/_apis/tokens/pats?authorizationId=cf42cc9f-f170-4375-92ba-c13d58a6545f&api-version=7.1-preview.1

Sample Response

Status code:: 200

{
  "patToken": {
    "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
  },
  "patTokenError": "none"
}

Definiciones

Nombre	Description
PatToken	Representa un token de acceso personal (PAT) que se usa para acceder a los recursos de Azure DevOps.
PatTokenResult	Contiene el token de acceso personal (PAT) resultante y el error (si existe) que se produjo durante la operación.
SessionTokenError	Error (si existe) que se produjo

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	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 al crearse
validFrom	string	Fecha de creación del token
validTo	string	Fecha de expiración del token

PatTokenResult

Contiene el token de acceso personal (PAT) resultante y el error (si existe) que se produjo durante la operación.

Nombre	Tipo	Description
patToken	PatToken	Token de acceso personal (PAT) resultante
patTokenError	SessionTokenError	Error (si existe) que se produjo

SessionTokenError

Error (si existe) que se produjo

Nombre	Tipo	Description
accessDenied	string
authorizationNotFound	string
deploymentHostNotSupported	string
displayNameRequired	string
duplicateHash	string
failedToIssueAccessToken	string
failedToReadTenantPolicy	string
failedToUpdateAccessToken	string
fullScopePatPolicyViolation	string
globalPatPolicyViolation	string
hostAuthorizationNotFound	string
invalidAudience	string
invalidAuthorizationId	string
invalidClient	string
invalidClientId	string
invalidClientType	string
invalidDisplayName	string
invalidScope	string
invalidSource	string
invalidSourceIP	string
invalidSubject	string
invalidTargetAccounts	string
invalidToken	string
invalidTokenType	string
invalidUserId	string
invalidUserType	string
invalidValidTo	string
none	string
patLifespanPolicyViolation	string
sourceNotSupported	string
sshPolicyDisabled	string
tokenNotFound	string
userIdRequired	string

Compartir a través de