다음을 통해 공유


Pats - List

이 organization 만든 PAT(개인용 액세스 토큰)의 페이징된 목록을 가져옵니다. API에 대한 후속 호출에서는 동일한 필터링 옵션을 제공해야 합니다.

GET https://vssps.dev.azure.com/{organization}/_apis/tokens/pats?api-version=7.1-preview.1
GET https://vssps.dev.azure.com/{organization}/_apis/tokens/pats?displayFilterOption={displayFilterOption}&sortByOption={sortByOption}&isSortAscending={isSortAscending}&continuationToken={continuationToken}&$top={$top}&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'로 설정해야 합니다.

$top
query

integer

int32

(선택 사항) 반환할 토큰 수, 100개 제한

continuationToken
query

string

(선택 사항) 토큰 반환을 시작할 위치

displayFilterOption
query

DisplayFilterOptions

(선택 사항) PAT(개인용 액세스 토큰)의 상태 참조합니다.

isSortAscending
query

boolean

(선택 사항) 오름차순 또는 내림차순

sortByOption
query

SortByOptions

(선택 사항) 정렬 기준 필드

응답

Name 형식 Description
200 OK

PagedPatTokens

성공적인 작업

보안

accessToken

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

Type: basic

예제

List personal access tokens

Sample Request

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

Sample Response

{
  "continuationToken": "",
  "patTokens": [
    {
      "displayName": "all_access_token",
      "validTo": "2020-11-23T04:04:38.5233333Z",
      "scope": "app_token",
      "targetAccounts": null,
      "validFrom": "2020-10-24T03:04:57.52Z",
      "authorizationId": "4c60c9ed-a378-4883-af16-d655ca025b11",
      "token": null
    },
    {
      "displayName": "work_token",
      "validTo": "2020-11-23T04:03:55.8033333Z",
      "scope": "vso.work_full",
      "targetAccounts": [
        "38aaa865-2c70-4bf7-a308-0c6539c38c1a"
      ],
      "validFrom": "2020-10-24T03:04:19.1466667Z",
      "authorizationId": "eabb38b2-48ef-440b-959b-b9e6cb37a64e",
      "token": null
    },
    {
      "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": null
    },
    {
      "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
    }
  ]
}

정의

Name Description
DisplayFilterOptions

(선택 사항) PAT(개인용 액세스 토큰)의 상태 참조합니다.

PagedPatTokens

List 메서드에서 반환됩니다. 에는 다음 결과 페이지를 가져오기 위한 개인용 액세스 토큰(PAT) 및 연속 토큰 목록이 포함되어 있습니다.

PatToken

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

SortByOptions

(선택 사항) 정렬 기준 필드

DisplayFilterOptions

(선택 사항) PAT(개인용 액세스 토큰)의 상태 참조합니다.

Name 형식 Description
active

string

토큰이 활성 상태입니다(예: 해지되지 않았으며 만료되지 않음).

all

string

모든 토큰을 포함합니다.

expired

string

토큰이 만료되었으며 새 만료 날짜로 업데이트되지 않는 한 더 이상 사용할 수 없습니다.

revoked

string

토큰이 해지되었으며 더 이상 사용할 수 없습니다.

PagedPatTokens

List 메서드에서 반환됩니다. 에는 다음 결과 페이지를 가져오기 위한 개인용 액세스 토큰(PAT) 및 연속 토큰 목록이 포함되어 있습니다.

Name 형식 Description
continuationToken

string

연속 API 호출에서 결과의 다음 페이지에 액세스하여 PAT(개인용 액세스 토큰)를 나열하는 데 사용됩니다.

patTokens

PatToken[]

개인용 액세스 토큰 목록(PAT)

PatToken

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

Name 형식 Description
authorizationId

string

고유 GUID 식별자

displayName

string

토큰 이름

scope

string

Azure DevOps 리소스에 액세스하기 위한 토큰 범위

targetAccounts

string[]

토큰이 유효한 조직입니다. 토큰이 사용자의 모든 액세스 가능한 조직에 적용되는 경우 null

token

string

만들 때 생성된 고유 토큰 문자열

validFrom

string

토큰 생성 날짜

validTo

string

토큰 만료 날짜

SortByOptions

(선택 사항) 정렬 기준 필드

Name 형식 Description
displayDate

string

표시 날짜별 정렬

displayName

string

표시 이름별로 정렬

status

string

정렬 기준 상태