Permissions - Has Permissions

  • Referência
Service:
Security
API Version:
6.0

Avalia se o chamador tem as permissões especificadas no conjunto de tokens de segurança especificado.

GET https://dev.azure.com/{organization}/_apis/permissions/{securityNamespaceId}/{permissions}?api-version=6.0
With optional parameters: 
GET https://dev.azure.com/{organization}/_apis/permissions/{securityNamespaceId}/{permissions}?tokens={tokens}&alwaysAllowAdministrators={alwaysAllowAdministrators}&delimiter={delimiter}&api-version=6.0

Parâmetros de URI

Nome Em Obrigatório Tipo Description
securityNamespaceId
 path True

string

uuid

Identificador de namespace de segurança.
organization
 path

string

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

integer

int32

Permissões a serem avaliadas.
api-version
 query True

string

Versão da API a ser usada. Isso deve ser definido como '6.0' para usar essa versão da api.
alwaysAllowAdministrators
 query

boolean

Se true e se o chamador for um administrador, sempre retorne true.
delimiter
 query

string

Separador de token de segurança opcional. O padrão é ",".
tokens
 query

string

Um ou mais tokens de segurança a serem avaliados.

Respostas

Nome Tipo Description
200 OK

boolean[]

operação bem-sucedida

Segurança

accessToken

Token de acesso pessoal. Use qualquer valor para o nome de usuário e o token como a senha.

Type: basic

Exemplos

A list of tokens
Singular token

A list of tokens

Sample Request

GET https://dev.azure.com/fabrikam/_apis/permissions/5a27515b-ccd7-42c9-84f1-54c998f03866?tokens=token1,token2,token3&alwaysAllowAdministrators=False&api-version=6.0

Sample Response

Status code:
200 
{
  "count": 3,
  "value": [
    false,
    false,
    true
  ]
}

Singular token

Sample Request

GET https://dev.azure.com/fabrikam/_apis/permissions/5a27515b-ccd7-42c9-84f1-54c998f03866?alwaysAllowAdministrators=False&api-version=6.0

Sample Response

Status code:
200