Permissions - Remove Permission

  • Ссылка
Service:
Security
API Version:
6.0

Удаляет указанные разрешения на маркер безопасности для пользователя или группы.

DELETE https://dev.azure.com/{organization}/_apis/permissions/{securityNamespaceId}/{permissions}?descriptor={descriptor}&api-version=6.0
With optional parameters: 
DELETE https://dev.azure.com/{organization}/_apis/permissions/{securityNamespaceId}/{permissions}?descriptor={descriptor}&token={token}&api-version=6.0

Параметры URI

Имя В Обязательно Тип Описание
securityNamespaceId
 path True

string

uuid

Идентификатор пространства имен безопасности.
organization
 path

string

Название организации Azure DevOps.
permissions
 path

integer

int32

Разрешения для удаления.
api-version
 query True

string

Используемая версия API. Для использования этой версии API необходимо задать значение "6.0".
descriptor
 query True

string

Дескриптор удостоверения пользователя, для который требуется удалить разрешения.
token
 query

string

Маркер безопасности для удаления разрешений.

Ответы

Имя Тип Описание
200 OK

AccessControlEntry

успешная операция

Безопасность

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

Имя Описание
vso.security_manage Предоставляет возможность чтения, записи и управления разрешениями безопасности.

Примеры

Sample Request

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=6.0

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
}

Определения

Имя Описание
AccessControlEntry

Класс для инкапсулирования разрешенных и запрещенных разрешений для заданного дескриптора IdentityDescriptor.
AceExtendedInformation

Содержит унаследованные и действующие сведения о разрешениях для заданного AccessControlEntry.
IdentityDescriptor

Дескриптор удостоверения — это оболочка для типа удостоверения (ИД Безопасности Windows, Passport) вместе с уникальным идентификатором, таким как SID или PUID.

AccessControlEntry

Класс для инкапсулирования разрешенных и запрещенных разрешений для заданного дескриптора IdentityDescriptor.

Имя Тип Описание
allow

integer

Набор битов разрешений, представляющих действия, которые может выполнять связанный дескриптор.
deny

integer

Набор битов разрешений, представляющих действия, которые связанный дескриптор не может выполнять.
descriptor

IdentityDescriptor

Дескриптор для пользователя, к которому применяется AccessControlEntry.
extendedInfo

AceExtendedInformation

Это значение, если задано, сообщает наследуемые и действующие сведения для связанного дескриптора. Это значение задается только для AccessControlEntries, возвращаемого вызовом QueryAccessControlList(s), если его параметру includeExtendedInfo присвоено значение true.

AceExtendedInformation

Содержит унаследованные и действующие сведения о разрешениях для заданного AccessControlEntry.

Имя Тип Описание
effectiveAllow

integer

Это сочетание всех явных и унаследованных разрешений для этого удостоверения для этого маркера. Это разрешения, используемые при определении того, имеет ли данный пользователь разрешение на выполнение действия.
effectiveDeny

integer

Это сочетание всех явных и унаследованных разрешений для этого удостоверения для этого маркера. Это разрешения, используемые при определении того, имеет ли данный пользователь разрешение на выполнение действия.
inheritedAllow

integer

Это разрешения, которые наследуются для этого удостоверения на этом маркере. Если маркер не наследует разрешения, это будет 0. Обратите внимание, что все разрешения, явно заданные для этого маркера для этого удостоверения, или любые группы, в состав которых входит это удостоверение, здесь не включаются.
inheritedDeny

integer

Это разрешения, которые наследуются для этого удостоверения на этом маркере. Если маркер не наследует разрешения, это будет 0. Обратите внимание, что все разрешения, явно заданные для этого маркера для этого удостоверения, или любые группы, в состав которых входит это удостоверение, здесь не включаются.

IdentityDescriptor

Дескриптор удостоверения — это оболочка для типа удостоверения (ИД Безопасности Windows, Passport) вместе с уникальным идентификатором, таким как SID или PUID.

Имя Тип Описание
identifier

string

Уникальный идентификатор для этого удостоверения, не превышающий 256 символов, который будет сохранен.
identityType

string

Тип дескриптора (например, Windows, Passport и т. д.).