Permissions - Remove Permission

Riferimento

Service:: Security

API Version:: 7.1-preview.2

Rimuove le autorizzazioni specificate per un token di sicurezza per un utente o un gruppo.

DELETE https://dev.azure.com/{organization}/_apis/permissions/{securityNamespaceId}/{permissions}?descriptor={descriptor}&api-version=7.1-preview.2

With optional parameters:

DELETE https://dev.azure.com/{organization}/_apis/permissions/{securityNamespaceId}/{permissions}?descriptor={descriptor}&token={token}&api-version=7.1-preview.2

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
securityNamespaceId	path	True	string uuid	Identificatore dello spazio dei nomi di sicurezza.
organization	path		string	Nome dell'organizzazione di Azure DevOps.
permissions	path		integer int32	Autorizzazioni da rimuovere.
api-version	query	True	string	Versione dell'API da usare. Deve essere impostato su '7.1-preview.2' per usare questa versione dell'API.
descriptor	query	True	string	Descrittore di identità dell'utente per cui rimuovere le autorizzazioni.
token	query		string	Token di sicurezza per cui rimuovere le autorizzazioni.

Risposte

Nome	Tipo	Descrizione
200 OK	AccessControlEntry	operazione riuscita

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.security_manage	Concede la possibilità di leggere, scrivere e gestire le autorizzazioni di sicurezza.

Esempio

Sample Request

HTTP

DELETE https://dev.azure.com/fabrikam/_apis/permissions/5a27515b-ccd7-42c9-84f1-54c998f03866?descriptor=Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1&token=token1&api-version=7.1-preview.2

Sample Response

Status code:: 200

{
  "descriptor": "Microsoft.TeamFoundation.Identity;S-1-9-1551374245-1204400969-2402986413-2179408616-0-0-0-0-1",
  "allow": 1,
  "deny": 0
}

Definizioni

Nome	Descrizione
AccessControlEntry	Classe per incapsulare le autorizzazioni consentite e negate per un determinato IdentityDescriptor.
AceExtendedInformation	Contiene le informazioni sulle autorizzazioni ereditate ed effettive per un oggetto AccessControlEntry specificato.
IdentityDescriptor	Un descrittore di identità è un wrapper per il tipo di identità (SID di Windows, Passport) insieme a un identificatore univoco, ad esempio il SID o PUID.

AccessControlEntry

Classe per incapsulare le autorizzazioni consentite e negate per un determinato IdentityDescriptor.

Nome	Tipo	Descrizione
allow	integer	Set di bit di autorizzazione che rappresentano le azioni che il descrittore associato può eseguire.
deny	integer	Set di bit di autorizzazione che rappresentano le azioni che il descrittore associato non è autorizzato a eseguire.
descriptor	IdentityDescriptor	Il descrittore per l'utente a cui si applica AccessControlEntry.
extendedInfo	AceExtendedInformation	Questo valore, se impostato, segnala le informazioni ereditate ed effettive per il descrittore associato. Questo valore viene impostato solo su AccessControlEntries restituito dalla chiamata queryAccessControlList(s) quando il parametro includeExtendedInfo è impostato su true.

AceExtendedInformation

Contiene le informazioni sulle autorizzazioni ereditate ed effettive per un oggetto AccessControlEntry specificato.

Nome	Tipo	Descrizione
effectiveAllow	integer	Questa è la combinazione di tutte le autorizzazioni esplicite e ereditate per questa identità su questo token. Queste sono le autorizzazioni usate per determinare se un determinato utente dispone dell'autorizzazione per eseguire un'azione.
effectiveDeny	integer	Questa è la combinazione di tutte le autorizzazioni esplicite e ereditate per questa identità su questo token. Queste sono le autorizzazioni usate per determinare se un determinato utente dispone dell'autorizzazione per eseguire un'azione.
inheritedAllow	integer	Queste sono le autorizzazioni ereditate per questa identità in questo token. Se il token non eredita le autorizzazioni, sarà 0. Si noti che tutte le autorizzazioni impostate in modo esplicito su questo token per questa identità o i gruppi di cui fa parte questa identità non sono inclusi qui.
inheritedDeny	integer	Queste sono le autorizzazioni ereditate per questa identità in questo token. Se il token non eredita le autorizzazioni, sarà 0. Si noti che tutte le autorizzazioni impostate in modo esplicito su questo token per questa identità o i gruppi di cui fa parte questa identità non sono inclusi qui.

IdentityDescriptor

Un descrittore di identità è un wrapper per il tipo di identità (SID di Windows, Passport) insieme a un identificatore univoco, ad esempio il SID o PUID.

Nome	Tipo	Descrizione
identifier	string	Identificatore univoco per questa identità, non superiore a 256 caratteri, che verranno salvati in modo permanente.
identityType	string	Tipo di descrittore (ad esempio, Windows, Passport e così via).

Condividi tramite