Token Revocations - Revoke Authorizations

Service:

Token Administration

API Version:

5.0-preview.1

撤銷列出的 OAuth 授權。

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

With optional parameters:

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

URI 參數

名稱	位於	必要	類型	Description
api-version	query	True	string	要使用的 API 版本。 這應該設定為 '5.0-preview.1'，以使用此版本的 API。
hostId	query	True	string uuid	要顯示在通知頁面上以管理權杖的主機識別碼。
isPublic	query		boolean	針對 PAT 權杖設定為 false，SSH 權杖為 true。

要求本文

名稱	類型	Description
audience	string[]	目標帳戶 (目標帳戶清單，) 限制撤銷
authorizationIds	string[]	要撤銷之 OAuth 授權的授權識別碼清單。

回應

名稱	類型	Description
204 No Content		已成功刪除授權。
400 Bad Request		輸入無效，例如不包含授權識別碼和/或主機識別碼。
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

名稱	Description
vso.tokenadministration	授與管理 (檢視和撤銷) 現有權杖的能力給組織系統管理員

定義

TokenAdministrationRevocation

名稱	類型	Description
audience	string[]	目標帳戶 (目標帳戶清單，) 限制撤銷
authorizationIds	string[]	要撤銷之 OAuth 授權的授權識別碼清單。