Permissions - Remove Permission

Ссылка

Service:: Security

API Version:: 7.1-preview.2

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

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

Параметры URI

Имя	В	Обязательно	Тип	Описание
securityNamespaceId	path	True	string uuid	Идентификатор пространства имен безопасности.
organization	path		string	Название организации Azure DevOps.
permissions	path		integer int32	Разрешения для удаления.
api-version	query	True	string	Используемая версия API. Для использования этой версии API необходимо задать значение 7.1-preview.2.
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

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
}

Определения

Имя	Описание
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 и т. д.).

Поделиться через