Share via

Service Principals - Delete

  • Referenz
Service:
Graph
API Version:
7.1-preview.1

Deaktiviert einen Dienstprinzipal.

Der Dienstprinzipal ist weiterhin sichtbar, aber die Mitgliedschaftsüberprüfungen für den Dienstprinzipal geben false zurück.

DELETE https://vssps.dev.azure.com/{organization}/_apis/graph/serviceprincipals/{servicePrincipalDescriptor}?api-version=7.1-preview.1

URI-Parameter

Name In Erforderlich Typ Beschreibung
organization
 path True

string

Der Name der Azure DevOps-Organisation.
servicePrincipalDescriptor
 path True

string

Der Deskriptor des zu löschenden Dienstprinzipals.
api-version
 query True

string

Version der zu verwendenden API. Dies sollte auf "7.1-preview.1" festgelegt werden, um diese Version der API zu verwenden.

Antworten

Name Typ Beschreibung
200 OK

Erfolgreicher Vorgang

Sicherheit

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

Name Beschreibung
vso.graph_manage Ermöglicht das Lesen von Benutzer-, Gruppen-, Bereichs- und Gruppenmitgliedschaftsinformationen sowie das Hinzufügen von Benutzern, Gruppen und zum Verwalten von Gruppenmitgliedschaften

Beispiele

Sample Request

DELETE https://vssps.dev.azure.com/{organization}/_apis/graph/serviceprincipals/aadsp.NTkzZjY3MTYtNjI3Yy03Y2NiLTgzM2UtNzdhN2Y5Y2E0MjJm?api-version=7.1-preview.1

Sample Response

Status code:
204