Управление списками

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

1. Посмотрите описание команды:

   yc smartwebsecurity match-list match-list create --help
   

2. Создайте пользовательский список. Укажите тип элементов в параметре --item-type:

   • ip — IP-адреса, диапазоны адресов или префиксы CIDR:

     yc smartwebsecurity match-list match-list create <идентификатор_каталога> \
       --name <имя_списка> \
       --list-type custom \
       --item-type ip \
       --items '[{value="192.0.2.1",description="Описание IP-адреса"}]'
     

   • asn — номера автономных систем:

     yc smartwebsecurity match-list match-list create <идентификатор_каталога> \
       --name <имя_списка> \
       --list-type custom \
       --item-type asn \
       --items '[{value="AS64512",description="Описание номера ASN"}]'
     

   • reg-exp — регулярные выражения:

     yc smartwebsecurity match-list match-list create <идентификатор_каталога> \
       --name <имя_списка> \
       --list-type custom \
       --item-type reg-exp \
       --items '[{value="User-Agent:\\s*",description="Описание регулярного выражения"}]'
     

   • str — текстовые строки:

     yc smartwebsecurity match-list match-list create <идентификатор_каталога> \
       --name <имя_списка> \
       --list-type custom \
       --item-type str \
       --items '[{value="fev4ct8l9infabcd1234",description="Описание строкового значения"}]'
     

   Где:

   • <идентификатор_каталога> — идентификатор каталога, в котором будет создан список.
   • --name — имя списка.
   • --list-type — тип списка, укажите значение custom (пользовательский список). Значение managed используется для предустановленных списков.
   • --item-type — тип элементов списка: ip, asn, str, reg-exp. У предустановленных списков могут быть типы ip, bot-name, bot-category.
   • --items — элементы списка в shorthand-синтаксисе. Строковые значения указывайте в двойных кавычках.

3. Чтобы не создавать файл запроса вручную, сформируйте и отредактируйте его шаблон.

   Для JSON-файла выполните команду:

   yc smartwebsecurity match-list match-list create --example-json > request.json
   

   Для YAML-файла выполните команду:

   yc smartwebsecurity match-list match-list create --example-yaml > request.yaml
   

   Отредактируйте созданный файл и передайте его в команде создания списка:

   yc smartwebsecurity match-list match-list create \
     --request-file request.yaml
   

Воспользуйтесь методом REST API create для ресурса MatchList или вызовом gRPC API MatchListService/Create.

1. Посмотрите описание команды:

   yc smartwebsecurity match-list match-list get --help
   

2. Сохраните список в файл:

   yc smartwebsecurity match-list match-list get \
     --list-id <идентификатор_списка> \
     --format json > list.json
   

   Файл list.json содержит JSON-представление ресурса с метаданными и элементами списка. Без > list.json команда выводит результат в терминал.

Воспользуйтесь методом REST API get для ресурса MatchList или вызовом gRPC API MatchListService/Get.

Метод возвращает ресурс с метаданными и элементами списка. Ответ REST API можно сохранить в JSON-файл.

1. Посмотрите описание команды:

   yc smartwebsecurity match-list match-list update --help
   

2. Измените параметры списка:

   yc smartwebsecurity match-list match-list update \
     --list-id <идентификатор_списка> \
     --name <имя_списка> \
     --description <описание_списка>
   

   Где:

   • --list-id — идентификатор списка.
   • --name — имя списка.
   • (Опционально) --description — описание списка.

Воспользуйтесь методом REST API update для ресурса MatchList или вызовом gRPC API MatchListService/Update.

Передайте новые значения полей name, description или labels. Чтобы сохранить остальные поля, перечислите изменяемые поля в маске обновления: updateMask для REST API или update_mask для gRPC API.

1. Посмотрите описание команды:

   yc smartwebsecurity match-list match-list update --help
   

2. Измените значения списка:

   Важно

   Команда полностью заменяет содержимое списка: прежние элементы, не указанные в --items, будут удалены. Перед обновлением скачайте текущий список в формате JSON, отредактируйте массив items и передайте его в параметре --items.

   yc smartwebsecurity match-list match-list update \
     --list-id <идентификатор_списка> \
     --items '[{"value":"192.0.2.1","description":"Описание IP-адреса"}]'
   

   Где:

   • --list-id — идентификатор списка.
   • --items — полный список значений в формате JSON, которым будет заменен существующий список.

Воспользуйтесь методом REST API update для ресурса MatchList или вызовом gRPC API MatchListService/Update.

Передайте полный массив элементов в поле items. Чтобы изменить только содержимое списка, укажите items в маске обновления: updateMask для REST API или update_mask для gRPC API.

1. Посмотрите описание команды:

   yc smartwebsecurity match-list match-list delete --help
   

2. Удалите список:

   yc smartwebsecurity match-list match-list delete --list-id <идентификатор_списка>
   

Воспользуйтесь вызовом gRPC API MatchListService/Delete.