Partager via


Token Revocations - Revoke Authorizations

Révoque les autorisations OAuth répertoriées.

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

Paramètres URI

Nom Dans Obligatoire Type Description
api-version
query True

string

Version de l’API à utiliser. Cette valeur doit être définie sur « 5.0-preview.1 » pour utiliser cette version de l’API.

hostId
query True

string

uuid

ID d’hôte à afficher sur la page de notification pour gérer les jetons.

isPublic
query

boolean

Définissez sur false pour les jetons PAT et true pour les jetons SSH.

Corps de la demande

Nom Type Description
audience

string[]

Liste d’audiences (comptes cibles) pour limiter les révocations à

authorizationIds

string[]

Liste de l’ID d’autorisation de l’autorisation OAuth à révoquer.

Réponses

Nom Type Description
204 No Content

Les autorisations ont été supprimées avec succès.

400 Bad Request

L’entrée n’est pas valide, par exemple si elle ne contient pas d’ID d’autorisation et/ou d’id d’hôte.

401 Unauthorized

Si l’appelant n’est pas autorisé à administrer des jetons

Sécurité

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

Nom Description
vso.tokenadministration Accorde la possibilité de gérer (afficher et révoquer) les jetons existants aux administrateurs organization

Définitions

TokenAdministrationRevocation

Nom Type Description
audience

string[]

Liste d’audiences (comptes cibles) pour limiter les révocations à

authorizationIds

string[]

Liste de l’ID d’autorisation de l’autorisation OAuth à révoquer.