Share via

Service Principals - Delete

  • Referência
Service:
Graph
API Version:
7.1-preview.1

Desabilita uma entidade de serviço.

A entidade de serviço ainda estará visível, mas as verificações de associação para a entidade de serviço retornarão false.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
organization
 path True

string

O nome da organização do Azure DevOps.
servicePrincipalDescriptor
 path True

string

O descritor da entidade de serviço a ser excluída.
api-version
 query True

string

Versão da API a ser usada. Isso deve ser definido como '7.1-preview.1' para usar essa versão da API.

Respostas

Nome Tipo Description
200 OK

operação bem-sucedida

Segurança

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 Description
vso.graph_manage Concede a capacidade de ler informações de associação de usuário, grupo, escopo e grupo e adicionar usuários, grupos e gerenciar associações de grupo

Exemplos

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