Personal Access Tokens - List
특정 사용자에 대한 PAT(개인용 액세스 토큰)의 모든 세션 토큰 세부 정보 목록입니다.
GET https://vssps.dev.azure.com/{organization}/_apis/tokenadmin/personalaccesstokens/{subjectDescriptor}?api-version=7.1-preview.1
GET https://vssps.dev.azure.com/{organization}/_apis/tokenadmin/personalaccesstokens/{subjectDescriptor}?pageSize={pageSize}&continuationToken={continuationToken}&isPublic={isPublic}&api-version=7.1-preview.1
URI 매개 변수
Name | In(다음 안에) | 필수 | 형식 | Description |
---|---|---|---|---|
organization
|
path | True |
string |
Azure DevOps 조직의 이름입니다. |
subject
|
path | True |
string |
대상 사용자의 설명자입니다. |
api-version
|
query | True |
string |
사용할 API의 버전입니다. 이 버전의 api를 사용하려면 '7.1-preview.1'로 설정해야 합니다. |
continuation
|
query |
string |
이전 페이지가 종료된 직후에 다음 데이터 페이지를 다시 시작할 수 있는 불투명 데이터 Blob입니다. 남은 데이터가 더 있는지 알 수 있는 유일한 방법은 연속 토큰이 있는 것입니다. |
|
is
|
query |
boolean |
PAT 토큰의 경우 false로 설정하고 SSH 토큰의 경우 true로 설정합니다. |
|
page
|
query |
integer int32 |
각 페이지에서 반환할 최대 결과 수입니다. |
응답
Name | 형식 | Description |
---|---|---|
200 OK |
사용자의 PAT에 해당하는 모든 세션 토큰 개체를 포함하는 배열입니다. |
|
400 Bad Request |
잘못된 주체 설명자, 페이지 크기 또는 연속 토큰을 포함하는 등 입력이 잘못되었습니다. |
|
401 Unauthorized |
호출자에게 토큰을 관리하기 위한 권한이 없는 경우 |
|
404 Not Found |
지정된 주체 설명자를 가진 사용자를 찾을 수 없는 경우 |
보안
oauth2
Type:
oauth2
Flow:
accessCode
Authorization URL:
https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
Token URL:
https://app.vssps.visualstudio.com/oauth2/token?client_assertion_type=urn:ietf:params:oauth:client-assertion-type:jwt-bearer&grant_type=urn:ietf:params:oauth:grant-type:jwt-bearer
Scopes
Name | Description |
---|---|
vso.tokenadministration | organization 관리자에게 기존 토큰을 관리(보기 및 해지)하는 기능을 부여합니다. |
예제
Sample Request
GET https://vssps.dev.azure.com/fabrikam/_apis/tokenadmin/personalaccesstokens/{subjectDescriptor}?pageSize=20&api-version=7.1-preview.1
Sample Response
{
"value": [
{
"clientId": "00000000-0000-0000-0000-000000000000",
"accessId": "00000000-0000-0000-0000-000000000000",
"authorizationId": "952858d3-7084-4635-964e-3c2a57645185",
"hostAuthorizationId": "00000000-0000-0000-0000-000000000000",
"userId": "bb5bb6c8-ef0a-400f-8987-92b3674d2043",
"validFrom": "2018-07-19T00:00:00",
"validTo": "2018-07-19T00:00:00",
"displayName": null,
"scope": "app_token",
"targetAccounts": null,
"token": null,
"alternateToken": null,
"isValid": true,
"isPublic": false,
"publicData": null,
"source": null
},
{
"clientId": "00000000-0000-0000-0000-000000000000",
"accessId": "00000000-0000-0000-0000-000000000000",
"authorizationId": "c2e0abd5-85a8-40b0-a179-88e98538ec7c",
"hostAuthorizationId": "00000000-0000-0000-0000-000000000000",
"userId": "bb5bb6c8-ef0a-400f-8987-92b3674d2043",
"validFrom": "2018-07-19T00:00:00",
"validTo": "2018-07-19T00:00:00",
"displayName": null,
"scope": "vso.dashboards vso.taskgroups_manage",
"targetAccounts": null,
"token": null,
"alternateToken": null,
"isValid": true,
"isPublic": false,
"publicData": null,
"source": null
},
{
"clientId": "00000000-0000-0000-0000-000000000000",
"accessId": "00000000-0000-0000-0000-000000000000",
"authorizationId": "e1bd9361-1120-4227-a258-da80545884b9",
"hostAuthorizationId": "00000000-0000-0000-0000-000000000000",
"userId": "bb5bb6c8-ef0a-400f-8987-92b3674d2043",
"validFrom": "2018-07-19T00:00:00",
"validTo": "2018-07-19T00:00:00",
"displayName": null,
"scope": "vso.graph_manage vso.identity_manage",
"targetAccounts": null,
"token": null,
"alternateToken": null,
"isValid": true,
"isPublic": false,
"publicData": null,
"source": null
}
],
"continuationToken": null
}
정의
Name | Description |
---|---|
Session |
Azure DevOps 리소스에 액세스하는 데 사용되는 세션 토큰을 나타냅니다. |
Token |
세션 토큰의 페이지를 매긴 목록입니다. 세션 토큰은 개인용 액세스 토큰(PAT) 및 기타 OAuth 권한 부여와 같은 OAuth 자격 증명에 해당합니다. |
SessionToken
Azure DevOps 리소스에 액세스하는 데 사용되는 세션 토큰을 나타냅니다.
Name | 형식 | Description |
---|---|---|
accessId |
string |
|
alternateToken |
string |
이 값은 사용자가 압축 토큰을 요청할 때 채워집니다. 대체 토큰 값은 자체 설명 토큰입니다. |
authorizationId |
string |
|
claims |
object |
|
clientId |
string |
|
displayName |
string |
|
hostAuthorizationId |
string |
|
isPublic |
boolean |
|
isValid |
boolean |
|
publicData |
string |
|
scope |
string |
|
source |
string |
|
targetAccounts |
string[] |
|
token |
string |
이는 계산되며 쿼리 가져오기에서 반환되지 않습니다. |
userId |
string |
|
validFrom |
string |
|
validTo |
string |
TokenAdminPagedSessionTokens
세션 토큰의 페이지를 매긴 목록입니다. 세션 토큰은 개인용 액세스 토큰(PAT) 및 기타 OAuth 권한 부여와 같은 OAuth 자격 증명에 해당합니다.
Name | 형식 | Description |
---|---|---|
continuationToken |
string |
세션 토큰의 다음 페이지를 검색하는 데 사용할 수 있는 연속 토큰이거나 |
value |
현재 페이지의 모든 세션 토큰 목록입니다. |