Udostępnij za pośrednictwem


Pats - Get

Pobiera pojedynczy osobisty token dostępu (PAT).

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
organization
path True

string

Nazwa organizacji usługi Azure DevOps.

api-version
query True

string

Wersja interfejsu API do użycia. Ta wartość powinna być ustawiona na wartość "7.1-preview.1", aby używać tej wersji interfejsu API.

authorizationId
query True

string

uuid

Identyfikator autoryzacji identyfikujący pojedynczy, unikatowy osobisty token dostępu (PAT)

Odpowiedzi

Nazwa Typ Opis
200 OK

PatTokenResult

operacja zakończona powodzeniem

Zabezpieczenia

accessToken

Osobisty token dostępu. Użyj dowolnej wartości nazwy użytkownika i tokenu jako hasła.

Type: basic

Przykłady

Get a personal access token by authorizationId

Sample Request

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

Sample Response

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

Definicje

Nazwa Opis
PatToken

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

PatTokenResult

Zawiera wynikowy osobisty token dostępu (PAT) i błąd (jeśli istnieje), który wystąpił podczas operacji

SessionTokenError

Błąd (jeśli istnieje), który wystąpił

PatToken

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

Nazwa Typ Opis
authorizationId

string

Unikatowy identyfikator GUID

displayName

string

Nazwa tokenu

scope

string

Zakresy tokenu na potrzeby uzyskiwania dostępu do zasobów usługi Azure DevOps

targetAccounts

string[]

Organizacje, dla których token jest prawidłowy; null, jeśli token ma zastosowanie do wszystkich organizacji dostępnych dla użytkownika

token

string

Unikatowy ciąg tokenu wygenerowany podczas tworzenia

validFrom

string

Data utworzenia tokenu

validTo

string

Data wygaśnięcia tokenu

PatTokenResult

Zawiera wynikowy osobisty token dostępu (PAT) i błąd (jeśli istnieje), który wystąpił podczas operacji

Nazwa Typ Opis
patToken

PatToken

Wynikowy osobisty token dostępu (PAT)

patTokenError

SessionTokenError

Błąd (jeśli istnieje), który wystąpił

SessionTokenError

Błąd (jeśli istnieje), który wystąpił

Nazwa Typ Opis
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