Share via


Token Revocations - Revoke Authorizations

Revoca le autorizzazioni OAuth elencate.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
api-version
query True

string

Versione dell'API da usare. Deve essere impostato su '5.0-preview.1' per usare questa versione dell'API.

hostId
query True

string

uuid

ID host da visualizzare nella pagina di notifica per gestire i token.

isPublic
query

boolean

Impostare su false per i token PAT e true per i token SSH.

Corpo della richiesta

Nome Tipo Descrizione
audience

string[]

Elenco di destinatari (account di destinazione) per limitare le revoche a

authorizationIds

string[]

Elenco di ID autorizzazione dell'autorizzazione OAuth da revocare.

Risposte

Nome Tipo Descrizione
204 No Content

Le autorizzazioni sono state eliminate correttamente.

400 Bad Request

L'input non è valido, ad esempio non contiene un ID autorizzazione e/o l'ID host.

401 Unauthorized

Se il chiamante non dispone dell'autorizzazione per l'amministrazione dei token

Sicurezza

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

Nome Descrizione
vso.tokenadministration Concede la possibilità di gestire (visualizzare e revocare) i token esistenti agli amministratori dell'organizzazione

Definizioni

TokenAdministrationRevocation

Nome Tipo Descrizione
audience

string[]

Elenco di destinatari (account di destinazione) per limitare le revoche a

authorizationIds

string[]

Elenco di ID autorizzazione dell'autorizzazione OAuth da revocare.