Перейти к основному содержимому

Sgroup to Sgroup (ICMP)

Данный тип правил управляет обменом данными между различными группами безопасности. Он автоматически создает два правила на хостах: одно для исходящего трафика от инициирующей стороны и другое для входящего трафика от группы безопасности, к которой предоставлен доступ.

Более подробную документацию по API можно посмотреть здесь.
Более подробно по организации БД можно посмотреть здесь .

Входные параметры​

  • sgSgIcmpRules.rules[] - Структура, содержащая описание создаваемых правил.
  • sgSgIcmpRules.rules[].sgFrom - Имя Security Group откуда уходит трафик (Egress)
  • sgSgIcmpRules.rules[].sgTo - Имя Security Group куда приходит трафик (Ingress)
  • sgSgIcmpRules.rules[].logs - Включить/отключить логирование.
  • sgSgIcmpRules.rules[].trace - Включить/отключить трассировку.
  • sgSgIcmpRules.rules[].ICMP - Структура, содержащая описание создаваемых правил типа ICMP.
  • sgSgIcmpRules.rules[].ICMP.IPv - Версия IP для ICMP (IPv4 или IPv6).
  • sgSgIcmpRules.rules[].ICMP.Types - Список, определяющий допустимые типы ICMP запросов.
  • sgSgIcmpRules.rules[].action - Действие для пакетов в сформированных правил в цепочке.
  • sgSgIcmpRules.rules[].priority - Структура, содержащая описание порядка применения правил в цепочке.
  • syncOp - Поле определяющее действие с данными из запроса.
названиеобязательностьтип данныхзначение по умолчанию
sgSgIcmpRules.rules[]даObject[]
sgSgIcmpRules.rules[].sgFromдаString
sgSgIcmpRules.rules[].sgToдаString
sgSgIcmpRules.rules[].logsнетBooleanfalse
sgSgIcmpRules.rules[].traceнетBooleanfalse
sgSgIcmpRules.rules[].ICMPдаObject
sgSgIcmpRules.rules[].ICMP.IPvдаEnum("IPv4", "IPv6")
sgSgIcmpRules.rules[].ICMP.TypesнетInteger[][]
sgSgIcmpRules.rules[].actionдаEnum("ACCEPT", "DROP")
sgSgIcmpRules.rules[].priorityнетObject
sgSgIcmpRules.rules[].priority.someнетInteger
syncOpдаEnum("Delete", "Upsert", "FullSync")

Ограничения

  • sgSgIcmpRules.rules[].sgFrom:

    • Длина значения не должна превышать 256 символов.
    • Значение должно начинаться и заканчиваться символами без пробелов.
    • Возможно указать только существующий Security Group.

  • sgSgIcmpRules.rules[].sgTo:

    • Длина значения не должна превышать 256 символов.
    • Значение должно начинаться и заканчиваться символами без пробелов.
    • Возможно указать только существующий Security Group.

  • sgSgIcmpRules.rules.ICMP.types[]:

    • Значения должны быть числами в диапазоне от 0 до 255.
    • Повторения значений в списке не допускаются.
    • Пустой массив разрешает все types
    • Принимает значения (число) в виде string || integer

  • sgSgIcmpRules.rules[].priority.some:

    • Значения должны находиться в интервале от -32768 до 32767
    • Принимает значения (число) в виде string || integer

Пример использования​

curl '127.0.0.1:9007/v2/sync' \
--header 'Content-Type: application/json' \
--data '{
  "sgSgIcmpRules": {
      "rules":[
          {
              "ICMP": {
                  "IPv": "IPv4",
                  "Types": [0, 8]
              },
              "sgFrom": "sg-0",
              "sgTo": "sg-1",
              "logs": true,
              "trace": true,
              "action": "DROP",
              "priority": {
                    "some": 500
                }
          }
      ]
  },
  "syncOp": "Upsert" 
}'

Выходные параметры

названиетип данныхописание
-Objectв случае успеха возвращается пустое тело

Возможные ошибки API

Пользователь указал некорректные значения агрументов
  • HTTP code: 400
  • gRPC code: INVALID_ARGUMENT
  • gRPC number: 3
Не найден метод
  • HTTP code: 404
  • gRPC code: NOT_FOUND
  • gRPC number: 5
Ошибка в указанных данных
  • HTTP code: 500
  • gRPC code: INTERNAL
  • gRPC number: 13

Диаграмма последовательности