Pats - Get

Referenz

Service:: Tokens

API Version:: 7.0-preview.1

Ruft ein einzelnes persönliches Zugriffstoken (Personal Access Token, PAT) ab.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
organization	path	True	string	Der Name der Azure DevOps-Organisation.
api-version	query	True	string	Version der zu verwendenden API. Dies sollte auf "7.0-preview.1" festgelegt werden, um diese Version der API zu verwenden.
authorizationId	query	True	string uuid	Die authorizationId, die ein einzelnes, eindeutiges persönliches Zugriffstoken (PAT) identifiziert

Antworten

Name	Typ	Beschreibung
200 OK	PatTokenResult	Erfolgreicher Vorgang

Sicherheit

accessToken

Persönliches Zugriffstoken. Verwenden Sie einen beliebigen Wert für den Benutzernamen und das Token als Kennwort.

Type: basic

Beispiele

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.0-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"
}

Definitionen

Name	Beschreibung
PatToken	Stellt ein persönliches Zugriffstoken (Personal Access Token, PAT) dar, das für den Zugriff auf Azure DevOps-Ressourcen verwendet wird.
PatTokenResult	Enthält das resultierende persönliche Zugriffstoken (Personal Access Token, PAT) und den Fehler (falls vorhanden), der während des Vorgangs aufgetreten ist.
SessionTokenError	Der Fehler (falls vorhanden), der aufgetreten ist

PatToken

Stellt ein persönliches Zugriffstoken (Personal Access Token, PAT) dar, das für den Zugriff auf Azure DevOps-Ressourcen verwendet wird.

Name	Typ	Beschreibung
authorizationId	string	Eindeutiger GUID-Bezeichner
displayName	string	Der Tokenname
scope	string	Die Tokenbereiche für den Zugriff auf Azure DevOps-Ressourcen
targetAccounts	string[]	Die Organisationen, für die das Token gültig ist; NULL, wenn das Token für alle zugänglichen Organisationen des Benutzers gilt
token	string	Die bei der Erstellung generierte eindeutige Tokenzeichenfolge
validFrom	string	Das Tokenerstellungsdatum
validTo	string	Das Ablaufdatum des Tokens

PatTokenResult

Enthält das resultierende persönliche Zugriffstoken (Personal Access Token, PAT) und den Fehler (falls vorhanden), der während des Vorgangs aufgetreten ist.

Name	Typ	Beschreibung
patToken	PatToken	Das resultierende persönliche Zugriffstoken (Personal Access Token, PAT)
patTokenError	SessionTokenError	Der Fehler (falls vorhanden), der aufgetreten ist

SessionTokenError

Der Fehler (falls vorhanden), der aufgetreten ist

Name	Typ	Beschreibung
accessDenied	string
authorizationNotFound	string
displayNameRequired	string
duplicateHash	string
failedToIssueAccessToken	string
failedToReadTenantPolicy	string
failedToUpdateAccessToken	string
fullScopePatPolicyViolation	string
globalPatPolicyViolation	string
hostAuthorizationNotFound	string
invalidAuthorizationId	string
invalidClient	string
invalidClientId	string
invalidClientType	string
invalidDisplayName	string
invalidScope	string
invalidSource	string
invalidSourceIP	string
invalidTargetAccounts	string
invalidToken	string
invalidUserId	string
invalidUserType	string
invalidValidTo	string
none	string
patLifespanPolicyViolation	string
sourceNotSupported	string
sshPolicyDisabled	string
tokenNotFound	string
userIdRequired	string