Condividi tramite


Pats - Get

Ottiene un singolo token di accesso personale (PAT).

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
organization
path True

string

Nome dell'organizzazione di Azure DevOps.

api-version
query True

string

Versione dell'API da usare. Questa opzione deve essere impostata su '7.1-preview.1' per usare questa versione dell'API.

authorizationId
query True

string

uuid

AuthorizationId che identifica un singolo token di accesso personale univoco (PAT)

Risposte

Nome Tipo Descrizione
200 OK

PatTokenResult

operazione riuscita

Sicurezza

accessToken

Token di accesso personale. Usare qualsiasi valore per il nome utente e il token come password.

Tipo: basic

Esempio

Get a personal access token by authorizationId

Esempio di richiesta

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

Risposta di esempio

{
  "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"
}

Definizioni

Nome Descrizione
PatToken

Rappresenta un token di accesso personale (PAT) usato per accedere alle risorse di Azure DevOps

PatTokenResult

Contiene il token di accesso personale risultante (PAT) e l'errore (se presente) che si è verificato durante l'operazione

SessionTokenError

Errore (se presente) che si è verificato

PatToken

Rappresenta un token di accesso personale (PAT) usato per accedere alle risorse di Azure DevOps

Nome Tipo Descrizione
authorizationId

string

Identificatore guid univoco

displayName

string

Nome del token

scope

string

Ambiti del token per l'accesso alle risorse di Azure DevOps

targetAccounts

string[]

Le organizzazioni per cui il token è valido; Null se il token si applica a tutte le organizzazioni accessibili dell'utente

token

string

Stringa di token univoca generata alla creazione

validFrom

string

Data di creazione del token

validTo

string

Data di scadenza del token

PatTokenResult

Contiene il token di accesso personale risultante (PAT) e l'errore (se presente) che si è verificato durante l'operazione

Nome Tipo Descrizione
patToken

PatToken

Token di accesso personale risultante (PAT)

patTokenError

SessionTokenError

Errore (se presente) che si è verificato

SessionTokenError

Errore (se presente) che si è verificato

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