DescribeSecurityGroups
In this article:
DescribeSecurityGroups#
Description#
Запрос на получение списка всех существующих фильтров групп безопасности (Security group) и их описаний. Возможно применение одного или нескольких фильтров.
Request Parameters#
Filter.N — Параметры фильтрации.
Тип: Список объектов Filter
Необходимо: Нет
GroupId.N — Идентификаторы групп безопасности.
Тип: Array of strings
Необходимо: Нет
GroupName.N — Имена групп безопасности.
Тип: Array of strings
Необходимо: Нет
Supported Filters#
description — Описание группы безопасности.
group-id — Идентификатор группы безопасности.
group-name — Имя группы безопасности.
ip-permission.cidr — IPv4 CIDR сети, которой разрешён доступ в группу безопасности.
ip-permission.from-port — Начало диапазона портов для TCP и UDP или сообщений для ICMP.
ip-permission.group-id — Идентификатор группы безопасности, для которой разрешён доступ.
ip-permission.protocol — Имя или номер IP-протокола (подробнее Protocol Numbers).
ip-permission.to-port — Конец диапазона портов для TCP и UDP или сообщений для ICMP.
owner-id — Идентификатор проекта.
tag-key — Ключ тега. Такой фильтр позволяет получить ресурсы с указанным ключом и любым значением.
tag:<tag-key> — Пара ключ/значение тега. Ключ тега передаётся в названии фильтра, значение тега — в значении фильтра.
vpc-id — Идентификатор VPC, в котором создана группа безопасности.
Response Elements#
requestId — Идентификатор запроса.
Тип: String
securityGroupInfo — Информация о группах безопасности.
Тип: Список объектов SecurityGroup
Examples#
c2-ec2 DescribeSecurityGroups Filter.1.Name ip-permission.from-port Filter.1.Value.1 555 Filter.1.Value.2 666
c2-ec2 DescribeSecurityGroups Filter.1.Name ip-permission.protocol Filter.1.Value.1 tcp
c2-ec2 DescribeSecurityGroups Filter.1.Name ip-permission.protocol Filter.1.Value.1 17
c2-ec2 DescribeSecurityGroups Filter.1.Name owner-id Filter.1.Value.1 <project_name>
c2-ec2 DescribeSecurityGroups Filter.1.Name tag:<tag-key> Filter.1.Value <tag-value>
c2-ec2 DescribeSecurityGroups Filter.1.Name tag-key Filter.1.Value <tag-key>