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

POST /v2/sg-sg-rules

Этот метод отображает список Security Group to Security Group правил, в соответствии с указанным списком Security Groups.

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

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

  • sgFrom[] - Список, содержащий названия Security Group(s).
  • sgTo[] - Список, содержащий названия Security Group(s).
названиеобязательностьтип данныхЗначение по умолчанию
sgFrom[]нетObject[][]
sgTo[]нетObject[][]

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

curl '127.0.0.1:9007/v2/sg-sg-rules' \
--header 'Content-Type: application/json' \
--data '{
"sgFrom": [
"sg-1"
],
"sgTo": [
"sg-2"
]
}'

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

  • rules[] - Структура, содержащая описание создаваемых правил.
  • rules[].sgFrom - Имя Security Group откуда уходит трафик (Egress)
  • rules[].sgTo - Имя Security Group куда приходит трафик (Ingress)
  • rules[].logs - Включить/отключить логирование.
  • rules[].trace - Включить/отключить трассировку.
  • rules[].ports - Блок описывающий набор пар портов (source-destination).
  • rules[].ports[].d - Набор открытых портов получателя
  • rules[].ports[].s - Набор открытых портов отправителя.
  • rules[].transport - Протокол L3/L4 уровня модели OSI.
  • rules[].action - Действие для пакетов в сформированных правил в цепочке.
  • rules[].priority - Структура, содержащая описание порядка применения правил в цепочке.
  • rules[].priority.some - Поле, определяющее порядок применения правил в цепочке.
названиетип данных
rules[]Object[]
rules[].sgFromString
rules[].sgToString
rules[].logsBoolean
rules[].portsObject[]
rules[].ports.dString
rules[].ports.sString
rules[].transportString
rules[].actionString
rules[].priorityObject
rules[].priority.someInteger

Пример ответа

{
"rules": [{
"sgFrom": "sg-example",
"sgTo": "sg-example-2",
"logs": "true",
"transport": "TCP",
"ports": [{
"d": "5000",
"s": ""
}],
"action": "ACCEPT",
"priority": {
"some": -200
}
}]
}

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

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

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