Pats - Create

Ссылка

Service:: Tokens

API Version:: 7.1-preview.1

Создает новый личный маркер доступа (PAT) для запрашивающего пользователя.

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
organization	path	True	string	Название организации Azure DevOps.
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение 7.1-preview.1.

Текст запроса

Имя	Тип	Описание
allOrgs	boolean	Значение True, если этот личный маркер доступа (PAT) предназначен для всех доступных организаций пользователя. False, если в противном случае (например, если маркер предназначен для определенной организации).
displayName	string	Имя токена
scope	string	Области маркера для доступа к ресурсам Azure DevOps
validTo	string	Дата окончания срока действия маркера

Ответы

Имя	Тип	Описание
200 OK	PatTokenResult	успешная операция

Безопасность

accessToken

Личный маркер доступа. Используйте любое значение для имени пользователя и маркера в качестве пароля.

Type: basic

Примеры

Create a new personal access token

Sample Request

HTTP

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

{
  "displayName": "new_token",
  "scope": "app_token",
  "validTo": "2020-12-01T23:46:23.319Z",
  "allOrgs": false
}

Sample Response

Status code:: 200

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

Определения

Имя	Описание
PatToken	Представляет личный маркер доступа (PAT), используемый для доступа к ресурсам Azure DevOps.
PatTokenCreateRequest	Инкапсулирует параметры запроса для создания нового личного маркера доступа (PAT)
PatTokenResult	Содержит полученный личный маркер доступа (PAT) и ошибку (при наличии), возникшую во время операции.
SessionTokenError	Произошла ошибка (при наличии).

PatToken

Представляет личный маркер доступа (PAT), используемый для доступа к ресурсам Azure DevOps.

Имя	Тип	Описание
authorizationId	string	Уникальный идентификатор GUID
displayName	string	Имя токена
scope	string	Области маркера для доступа к ресурсам Azure DevOps
targetAccounts	string[]	Организации, для которых маркер действителен; значение null, если маркер применяется ко всем организациям, доступным для пользователя.
token	string	Строка уникального маркера, созданная при создании
validFrom	string	Дата создания маркера
validTo	string	Дата окончания срока действия маркера

PatTokenCreateRequest

Инкапсулирует параметры запроса для создания нового личного маркера доступа (PAT)

Имя	Тип	Описание
allOrgs	boolean	Значение True, если этот личный маркер доступа (PAT) предназначен для всех доступных организаций пользователя. False, если в противном случае (например, если маркер предназначен для определенной организации).
displayName	string	Имя токена
scope	string	Области маркера для доступа к ресурсам Azure DevOps
validTo	string	Дата окончания срока действия маркера

PatTokenResult

Содержит полученный личный маркер доступа (PAT) и ошибку (при наличии), возникшую во время операции.

Имя	Тип	Описание
patToken	PatToken	Полученный личный маркер доступа (PAT)
patTokenError	SessionTokenError	Произошла ошибка (при наличии).

SessionTokenError

Произошла ошибка (при наличии).

Имя	Тип	Описание
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

Поделиться через