Token Revocations - Revoke Authorizations

撤销列出的 OAuth 授权。

POST https://dev.azure.com/_apis/tokenadministration/tokenrevocations?hostId={hostId}&api-version=5.0-preview.1
POST https://dev.azure.com/_apis/tokenadministration/tokenrevocations?hostId={hostId}&isPublic={isPublic}&api-version=5.0-preview.1

URI 参数

名称 必需 类型 说明
api-version
query True

string

要使用的 API 版本。 应将其设置为“5.0-preview.1”才能使用此版本的 API。

hostId
query True

string

uuid

要显示在通知页上以管理令牌的主机 ID。

isPublic
query

boolean

将 PAT 令牌设置为 false,将 SSH 令牌设置为 true。

请求正文

名称 类型 说明
audience

string[]

) 将吊销限制为的目标帐户 (受众列表

authorizationIds

string[]

要撤销的 OAuth 授权的授权 ID 列表。

响应

名称 类型 说明
204 No Content

已成功删除授权。

400 Bad Request

输入无效,例如不包含授权 ID 和/或主机 ID。

401 Unauthorized

如果调用方无权管理令牌

安全性

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

名称 说明
vso.tokenadministration 向组织管理员授予管理 (查看和撤销) 现有令牌的能力

定义

TokenAdministrationRevocation

名称 类型 说明
audience

string[]

) 将吊销限制为的目标帐户 (受众列表

authorizationIds

string[]

要撤销的 OAuth 授权的授权 ID 列表。