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 매개 변수

Name	In(다음 안에)	필수	형식	Description
organization	path	True	string	Azure DevOps 조직의 이름입니다.
api-version	query	True	string	사용할 API의 버전입니다. 이 버전의 api를 사용하려면 '7.1-preview.1'로 설정해야 합니다.

요청 본문

Name	형식	Description
allOrgs	boolean	True이면 이 PAT(개인용 액세스 토큰)가 사용자의 모든 액세스 가능한 조직을 위한 것입니다. False이면(예: 토큰이 특정 organization 대한 경우)
displayName	string	토큰 이름
scope	string	Azure DevOps 리소스에 액세스하기 위한 토큰 범위
validTo	string	토큰 만료 날짜

응답

Name	형식	Description
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"
}

정의

Name	Description
PatToken	Azure DevOps 리소스에 액세스하는 데 사용되는 PAT(개인용 액세스 토큰)를 나타냅니다.
PatTokenCreateRequest	새 PAT(개인용 액세스 토큰)를 만들기 위한 요청 매개 변수를 캡슐화합니다.
PatTokenResult	결과 PAT(개인용 액세스 토큰) 및 작업 중에 발생한 오류(있는 경우)를 포함합니다.
SessionTokenError	발생한 오류(있는 경우)

PatToken

Azure DevOps 리소스에 액세스하는 데 사용되는 PAT(개인용 액세스 토큰)를 나타냅니다.

Name	형식	Description
authorizationId	string	고유 GUID 식별자
displayName	string	토큰 이름
scope	string	Azure DevOps 리소스에 액세스하기 위한 토큰 범위
targetAccounts	string[]	토큰이 유효한 조직입니다. 토큰이 사용자의 액세스 가능한 모든 조직에 적용되는 경우 null
token	string	만들 때 생성된 고유 토큰 문자열
validFrom	string	토큰 생성 날짜
validTo	string	토큰 만료 날짜

PatTokenCreateRequest

새 PAT(개인용 액세스 토큰)를 만들기 위한 요청 매개 변수를 캡슐화합니다.

Name	형식	Description
allOrgs	boolean	True이면 이 PAT(개인용 액세스 토큰)가 사용자의 모든 액세스 가능한 조직을 위한 것입니다. False이면(예: 토큰이 특정 organization 대한 경우)
displayName	string	토큰 이름
scope	string	Azure DevOps 리소스에 액세스하기 위한 토큰 범위
validTo	string	토큰 만료 날짜

PatTokenResult

결과 PAT(개인용 액세스 토큰) 및 작업 중에 발생한 오류(있는 경우)를 포함합니다.

Name	형식	Description
patToken	PatToken	결과 PAT(개인용 액세스 토큰)
patTokenError	SessionTokenError	발생한 오류(있는 경우)

SessionTokenError

발생한 오류(있는 경우)

Name	형식	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

다음을 통해 공유