Revocations - Revoke Authorizations

参考

服务:: Token Admin

API 版本:: 7.1

撤销列出的 OAuth 授权。

POST https://vssps.dev.azure.com/{organization}/_apis/tokenadmin/revocations?api-version=7.1

具有可选参数:

POST https://vssps.dev.azure.com/{organization}/_apis/tokenadmin/revocations?isPublic={isPublic}&api-version=7.1

URI 参数

名称	在	必需	类型	说明
organization	path	True	string	Azure DevOps 组织的名称。
api-version	query	True	string	要使用的 API 版本。这应设置为“7.1”才能使用此版本的 API。
isPublic	query		boolean	对于 PAT 令牌设置为 false，SSH 令牌设置为 true。

请求正文

名称	类型	说明
body	TokenAdminRevocation[]	包含 OAuth 授权的授权 ID 的对象列表，例如应吊销的用户 PAT 检索的会话令牌。

响应

名称	类型	说明
204 No Content		已成功删除授权。
400 Bad Request		输入无效，例如不包含授权 ID。
401 Unauthorized		如果调用方无权管理令牌

安全性

oauth2

类型: oauth2
流向: accessCode
授权 URL: https://app.vssps.visualstudio.com/oauth2/authorize&response_type=Assertion
令牌 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

作用域

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

示例

示例请求

HTTP

POST https://vssps.dev.azure.com/fabrikam/_apis/tokenadmin/revocations?api-version=7.1

[
  {
    "authorizationId": "532c7fe6-74f8-408b-8051-4abb73dca491"
  },
  {
    "authorizationId": "ce6a72ed-051f-41cd-8d7b-5a67c46748eb"
  },
  {
    "authorizationId": "a681129e-46f1-4013-9c46-7dc7e3cab3c8"
  },
  {
    "authorizationId": "7b7a7c65-8a52-4f90-a637-f76f1ea91510"
  },
  {
    "authorizationId": "952858d3-7084-4635-964e-3c2a57645185"
  },
  {
    "authorizationId": "c2e0abd5-85a8-40b0-a179-88e98538ec7c"
  },
  {
    "authorizationId": "e1bd9361-1120-4227-a258-da80545884b9"
  }
]

示例响应

状态代码:: 204

定义

TokenAdminRevocation

Object

撤销特定委派授权的请求。

名称	类型	说明
authorizationId	string (uuid)	要撤销的 OAuth 授权的授权 ID。

通过