Pats - Update

참조

Service:: Tokens

API Version:: 7.1-preview.1

새 매개 변수를 사용하여 기존 PAT(개인용 액세스 토큰)를 업데이트. 토큰을 업데이트하려면 유효해야 합니다(해지되지 않음).

PUT 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 대한 경우)
authorizationId	string	PAT(단일 고유한 개인용 액세스 토큰)를 식별하는 authorizationId
displayName	string	(선택 사항) 토큰 이름
scope	string	(선택 사항) Azure DevOps 리소스에 액세스하기 위한 토큰 범위
validTo	string	(선택 사항) 토큰 만료 날짜

응답

Name	형식	Description
200 OK	PatTokenResult	성공적인 작업

보안

accessToken

개인용 액세스 토큰. 사용자 이름 및 토큰에 대한 모든 값을 암호로 사용합니다.

Type: basic

예제

Update a personal access token by authorizationId

Sample Request

HTTP

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

{
  "authorizationId": "3d3aca0c-9ad3-4b07-8334-08ec8b1ddc32",
  "displayName": "updated_token",
  "scope": "vso.analytics",
  "validTo": "2020-12-25T23:46:23.319Z",
  "allOrgs": true
}

Sample Response

Status code:: 200

{
  "patToken": {
    "displayName": "updated_token",
    "validTo": "2020-12-25T23:46:23.32Z",
    "scope": "vso.analytics",
    "targetAccounts": null,
    "validFrom": "2020-10-29T17:26:46.72Z",
    "authorizationId": "3d3aca0c-9ad3-4b07-8334-08ec8b1ddc32",
    "token": null
  },
  "patTokenError": "none"
}

정의

Name	Description
PatToken	Azure DevOps 리소스에 액세스하는 데 사용되는 PAT(개인용 액세스 토큰)를 나타냅니다.
PatTokenResult	결과 PAT(개인용 액세스 토큰) 및 작업 중에 발생한 오류(있는 경우) 포함
PatTokenUpdateRequest	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	토큰 만료 날짜

PatTokenResult

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

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

PatTokenUpdateRequest

PAT(개인용 액세스 토큰)를 업데이트하기 위한 요청 매개 변수 캡슐화

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

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

다음을 통해 공유