list-finding-aggregations

Описание

Отображает агрегированные данные о находках для вашей среды на основе определенных критериев.

См. также: Документацию API AWS

list-finding-aggregations — это постраничная операция. Для получения всего набора результатов может потребоваться несколько вызовов API. Вы можете отключить постраничный вывод, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе на постраничный запрос аргумент --query должен извлечь данные из результатов следующих выражений запроса: responses

Синтаксис

  list-finding-aggregations
[--account-ids <value>]
[--aggregation-request <value>]
--aggregation-type <value>
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--account-ids (список)

Идентификаторы учетных записей Amazon Web Services, для которых требуется получить агрегированные данные о находках.

(структура)

Объект, описывающий подробности фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение, по которому необходимо произвести фильтрацию.

Сокращённый синтаксис:

comparison=string,value=string ...

Синтаксис JSON:

[
  {
    "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
    "value": "string"
  }
  ...
]

--aggregation-request (структура помеченного объединения)

Подробности запроса агрегации, используемого для фильтрации результатов агрегации.

Примечание

Это структура помеченного объединения. Только один из следующих ключей верхнего уровня может быть установлен: accountAggregation, amiAggregation, awsEcrContainerAggregation, ec2InstanceAggregation, findingTypeAggregation, imageLayerAggregation, lambdaFunctionAggregation, lambdaLayerAggregation, packageAggregation, repositoryAggregation, titleAggregation.

accountAggregation -> (структура)

Объект, содержащий сведения о запросе агрегации на основе идентификаторов учетных записей Amazon Web Services.

findingType -> (строка)

Тип обнаружения.

resourceType -> (строка)

Тип ресурса.

sortBy -> (строка)

Значение для сортировки.

sortOrder -> (строка)

Порядок сортировки (по возрастанию или убыванию).

amiAggregation -> (структура)

Объект, содержащий сведения о запросе агрегации на основе Amazon Machine Images (AMI).

amis -> (список)

Идентификаторы AMI, для которых требуется агрегировать результаты обнаружения.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

sortBy -> (строка)

Значение для сортировки результатов.

sortOrder -> (строка)

Порядок сортировки результатов.

awsEcrContainerAggregation -> (структура)

Объект, содержащий сведения о запросе агрегации на основе контейнерных изображений Amazon ECR.

architectures -> (список)

Архитектура контейнеров.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

imageShas -> (список)

Значения SHA изображений.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

imageTags -> (список)

Теги изображений.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

inUseCount -> (список)

Количество задач Amazon ECS или контейнеров Amazon EKS, где изображение Amazon ECR используется.

(структура)

Объект, описывающий детали числового фильтра.

lowerInclusive -> (двойное)

Наименьшее число, включаемое в фильтр.

upperInclusive -> (двойное)

Наибольшее число, включаемое в фильтр.

lastInUseAt -> (список)

Последний момент использования изображения Amazon ECR в задаче Amazon ECS или контейнере Amazon EKS.

(структура)

Содержит данные о временном интервале, используемом для фильтрации результатов.

endInclusive -> (отметка времени)

Отметка времени, представляющая конец временного периода, на котором выполняется фильтрация.

startInclusive -> (отметка времени)

Отметка времени, представляющая начало временного периода, на котором выполняется фильтрация.

repositories -> (список)

Контейнерные хранилища.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

resourceIds -> (список)

Идентификаторы ресурсов контейнера.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

sortBy -> (строка)

Значение для сортировки.

sortOrder -> (строка)

Порядок сортировки (по возрастанию или убыванию).

ec2InstanceAggregation -> (структура)

Объект, содержащий сведения о запросе агрегации на основе экземпляров Amazon EC2.

amis -> (список)

Идентификаторы AMI, связанные с экземплярами Amazon EC2, для которых требуется агрегировать результаты обнаружения.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

instanceIds -> (список)

Идентификаторы экземпляров Amazon EC2, для которых требуется агрегировать результаты обнаружения.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

instanceTags -> (список)

Теги экземпляров Amazon EC2, для которых требуется агрегировать результаты обнаружения.

(структура)

Объект, описывающий детали фильтра карты.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

key -> (строка)

Ключ тега, используемый в фильтре.

value -> (строка)

Значение тега, используемое в фильтре.

operatingSystems -> (список)

Типы операционных систем для агрегации результатов обнаружения. Значения должны быть заглавными и разделены подчеркиванием, например, ORACLE_LINUX_7 и ALPINE_LINUX_3_8.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

sortBy -> (строка)

Значение для сортировки результатов.

sortOrder -> (строка)

Порядок сортировки результатов.

findingTypeAggregation -> (структура)

Объект, содержащий сведения о запросе агрегации на основе типов обнаружения.

findingType -> (строка)

Тип обнаружения для агрегации.

resourceType -> (строка)

Тип ресурса для агрегации.

sortBy -> (строка)

Значение для сортировки результатов.

sortOrder -> (строка)

Порядок сортировки результатов.

imageLayerAggregation -> (структура)

Объект, содержащий сведения о запросе агрегации на основе слоёв контейнерного изображения.

layerHashes -> (список)

Хэши, связанные со слоями.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

repositories -> (список)

Хранилище, связанное с контейнерным изображением, содержащим слои.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

resourceIds -> (список)

Идентификатор слоя контейнерного изображения.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

sortBy -> (строка)

Значение для сортировки результатов.

sortOrder -> (строка)

Порядок сортировки результатов.

lambdaFunctionAggregation -> (структура)

Возвращает объект с результатами агрегации по функциям Amazon Web Services Lambda.

functionNames -> (список)

Имена функций Amazon Web Services Lambda, которые нужно включить в результаты агрегации.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

functionTags -> (список)

Теги, которые нужно включить в результаты агрегации.

(структура)

Объект, описывающий детали фильтра карты.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

key -> (строка)

Ключ тега, используемый в фильтре.

value -> (строка)

Значение тега, используемое в фильтре.

resourceIds -> (список)

Идентификаторы ресурсов, которые нужно включить в результаты агрегации.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

runtimes -> (список)

Возвращает результаты агрегации по средам выполнения функций Amazon Web Services Lambda.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

sortBy -> (строка)

Уровень критичности результата для сортировки.

sortOrder -> (строка)

Порядок сортировки результатов.

lambdaLayerAggregation -> (структура)

Возвращает объект с результатами агрегации по слоям Amazon Web Services Lambda.

functionNames -> (список)

Имена функций Amazon Web Services Lambda, связанных со слоями.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

layerArns -> (список)

Amazon Resource Name (ARN) слоя функции Amazon Web Services Lambda.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

resourceIds -> (список)

Идентификаторы ресурсов слоёв функций Amazon Web Services Lambda.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

sortBy -> (строка)

Уровень критичности результата для сортировки.

sortOrder -> (строка)

Порядок сортировки результатов.

packageAggregation -> (структура)

Объект, содержащий подробности запроса агрегирования на основе типа пакета операционной системы.

packageNames -> (список)

Названия пакетов для агрегирования данных.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

sortBy -> (строка)

Значение для сортировки результатов.

sortOrder -> (строка)

Порядок сортировки результатов.

repositoryAggregation -> (структура)

Объект, содержащий подробности запроса агрегирования на основе репозиториев Amazon ECR.

repositories -> (список)

Названия репозиториев для агрегирования данных.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

sortBy -> (строка)

Значение для сортировки результатов.

sortOrder -> (строка)

Порядок сортировки результатов.

titleAggregation -> (структура)

Объект, содержащий подробности запроса агрегирования на основе заголовка обнаружения.

findingType -> (строка)

Тип обнаружения для агрегирования.

resourceType -> (строка)

Тип ресурса для агрегирования.

sortBy -> (строка)

Значение для сортировки результатов.

sortOrder -> (строка)

Порядок сортировки результатов.

titles -> (список)

Заголовки обнаружений для агрегирования.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

vulnerabilityIds -> (список)

Идентификаторы уязвимостей обнаружений.

(структура)

Объект, описывающий детали фильтра строки.

comparison -> (строка)

Оператор, используемый при сравнении значений в фильтре.

value -> (строка)

Значение для фильтрации.

Синтаксис JSON:

{
  "accountAggregation": {
    "findingType": "NETWORK_REACHABILITY"|"PACKAGE_VULNERABILITY"|"CODE_VULNERABILITY",
    "resourceType": "AWS_EC2_INSTANCE"|"AWS_ECR_CONTAINER_IMAGE"|"AWS_LAMBDA_FUNCTION",
    "sortBy": "CRITICAL"|"HIGH"|"ALL",
    "sortOrder": "ASC"|"DESC"
  },
  "amiAggregation": {
    "amis": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "sortBy": "CRITICAL"|"HIGH"|"ALL"|"AFFECTED_INSTANCES",
    "sortOrder": "ASC"|"DESC"
  },
  "awsEcrContainerAggregation": {
    "architectures": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "imageShas": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "imageTags": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "inUseCount": [
      {
        "lowerInclusive": double,
        "upperInclusive": double
      }
      ...
    ],
    "lastInUseAt": [
      {
        "endInclusive": timestamp,
        "startInclusive": timestamp
      }
      ...
    ],
    "repositories": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "resourceIds": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "sortBy": "CRITICAL"|"HIGH"|"ALL",
    "sortOrder": "ASC"|"DESC"
  },
  "ec2InstanceAggregation": {
    "amis": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "instanceIds": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "instanceTags": [
      {
        "comparison": "EQUALS",
        "key": "string",
        "value": "string"
      }
      ...
    ],
    "operatingSystems": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "sortBy": "NETWORK_FINDINGS"|"CRITICAL"|"HIGH"|"ALL",
    "sortOrder": "ASC"|"DESC"
  },
  "findingTypeAggregation": {
    "findingType": "NETWORK_REACHABILITY"|"PACKAGE_VULNERABILITY"|"CODE_VULNERABILITY",
    "resourceType": "AWS_EC2_INSTANCE"|"AWS_ECR_CONTAINER_IMAGE"|"AWS_LAMBDA_FUNCTION",
    "sortBy": "CRITICAL"|"HIGH"|"ALL",
    "sortOrder": "ASC"|"DESC"
  },
  "imageLayerAggregation": {
    "layerHashes": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "repositories": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "resourceIds": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "sortBy": "CRITICAL"|"HIGH"|"ALL",
    "sortOrder": "ASC"|"DESC"
  },
  "lambdaFunctionAggregation": {
    "functionNames": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "functionTags": [
      {
        "comparison": "EQUALS",
        "key": "string",
        "value": "string"
      }
      ...
    ],
    "resourceIds": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "runtimes": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "sortBy": "CRITICAL"|"HIGH"|"ALL",
    "sortOrder": "ASC"|"DESC"
  },
  "lambdaLayerAggregation": {
    "functionNames": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "layerArns": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "resourceIds": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "sortBy": "CRITICAL"|"HIGH"|"ALL",
    "sortOrder": "ASC"|"DESC"
  },
  "packageAggregation": {
    "packageNames": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "sortBy": "CRITICAL"|"HIGH"|"ALL",
    "sortOrder": "ASC"|"DESC"
  },
  "repositoryAggregation": {
    "repositories": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "sortBy": "CRITICAL"|"HIGH"|"ALL"|"AFFECTED_IMAGES",
    "sortOrder": "ASC"|"DESC"
  },
  "titleAggregation": {
    "findingType": "NETWORK_REACHABILITY"|"PACKAGE_VULNERABILITY"|"CODE_VULNERABILITY",
    "resourceType": "AWS_EC2_INSTANCE"|"AWS_ECR_CONTAINER_IMAGE"|"AWS_LAMBDA_FUNCTION",
    "sortBy": "CRITICAL"|"HIGH"|"ALL",
    "sortOrder": "ASC"|"DESC",
    "titles": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ],
    "vulnerabilityIds": [
      {
        "comparison": "EQUALS"|"PREFIX"|"NOT_EQUALS",
        "value": "string"
      }
      ...
    ]
  }
}

--aggregation-type (строка)

Тип запроса агрегирования.

Возможные значения:

FINDING_TYPE
PACKAGE
TITLE
REPOSITORY
AMI
AWS_EC2_INSTANCE
AWS_ECR_CONTAINER
IMAGE_LAYER
ACCOUNT
AWS_LAMBDA_FUNCTION
LAMBDA_LAYER

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной JSON-строки. JSON-строка соответствует формату, указанному в --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределят значения, полученные из JSON. Передача произвольных двоичных значений с помощью значения из JSON невозможна, поскольку строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.

--starting-token (строка)

Токен для указания точки начала постраничного отображения. Это NextToken из ранее усеченного ответа.

Примеры использования см. в разделе Постраничное отображение в Руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-сервиса.

Примеры использования см. в разделе Постраничное отображение в Руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов больше, чем указанное значение, в выводе команды предоставляется NextToken. Для возобновления постраничного отображения предоставьте значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе Постраничное отображение в Руководстве пользователя AWS Command Line Interface.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса к API. Если предоставлено без значения или со значением input, выводит пример JSON ввода, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, выведет пример YAML ввода, который можно использовать с --cli-input-yaml. При предоставлении значения output проверяет входные данные команды и возвращает пример JSON вывода для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантии обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (логическое значение)

Включить отладку логов.

--endpoint-url (строка)

Переопределить URL по умолчанию команды указанным URL.

--no-verify-ssl (логическое значение)

По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI проверит SSL-сертификаты. Этот параметр переопределяет поведение по умолчанию по проверке SSL-сертификатов.

--no-paginate (логическое значение)

Отключить автоматическое постраничное отображение. Если автоматическое постраничное отображение отключено, AWS CLI сделает только один вызов для первой страницы результатов.

--output (строка)

Стиль форматирования для вывода команды.

json
текст
таблица
yaml
yaml-поток

--query (строка)

Запрос JMESPath для использования в фильтрации данных ответа.

--profile (строка)

Использовать определенный профиль из вашего файла учетных данных.

--region (строка)

Регион для использования. Переопределяет настройки конфигурации/среды.

--version (строка)

Показать версию этого инструмента.

--color (строка)

Включить/отключить цветной вывод.

вкл
выкл
авто

--no-sign-request (логическое значение)

Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.

--ca-bundle (строка)

Файл сертификатов CA для использования при проверке SSL-сертификатов. Переопределяет настройки конфигурации/среды.

--cli-read-timeout (целое число)

Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (целое число)

Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (строка)

Стиль форматирования, используемый для двоичных блоков. Формат по умолчанию - base64. Формат base64 ожидает, что двоичные блоки будут предоставлены в виде base64-кодированной строки. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, соответствующего двоичному блоку, fileb:// всегда будет обрабатываться как двоичное и использовать содержимое файла напрямую независимо от параметра cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

base64
raw-in-base64-out

--no-cli-pager (логическое значение)

Отключить постраничное отображение CLI для вывода.

--cli-auto-prompt (логическое значение)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (логическое значение)

Отключить автоматическое запроса параметров ввода CLI.

Output

aggregationType -> (string)

The type of aggregation to perform.

nextToken -> (string)

A token to use for paginating results that are returned in the response. Set the value of this parameter to null for the first request to a list action. For subsequent calls, use the NextToken value returned from the previous request to continue listing results after the first page.

responses -> (list)

Objects that contain the results of an aggregation operation.

(tagged union structure)

A structure that contains details about the results of an aggregation type.

Note

This is a Tagged Union structure. Only one of the following top level keys can be set: accountAggregation, amiAggregation, awsEcrContainerAggregation, ec2InstanceAggregation, findingTypeAggregation, imageLayerAggregation, lambdaFunctionAggregation, lambdaLayerAggregation, packageAggregation, repositoryAggregation, titleAggregation.

accountAggregation -> (structure)

An object that contains details about an aggregation response based on Amazon Web Services account IDs.

accountId -> (string)

The Amazon Web Services account ID.

exploitAvailableCount -> (long)

The number of findings that have an exploit available.

fixAvailableCount -> (long)

Details about the number of fixes.

severityCounts -> (structure)

The number of findings by severity.

all -> (long)

The total count of findings from all severities.

critical -> (long)

The total count of critical severity findings.

high -> (long)

The total count of high severity findings.

medium -> (long)

The total count of medium severity findings.

amiAggregation -> (structure)

An object that contains details about an aggregation response based on Amazon Machine Images (AMIs).

accountId -> (string)

The Amazon Web Services account ID for the AMI.

affectedInstances -> (long)

The IDs of Amazon EC2 instances using this AMI.

ami -> (string)

The ID of the AMI that findings were aggregated for.

severityCounts -> (structure)

An object that contains the count of matched findings per severity.

all -> (long)

The total count of findings from all severities.

critical -> (long)

The total count of critical severity findings.

high -> (long)

The total count of high severity findings.

medium -> (long)

The total count of medium severity findings.

awsEcrContainerAggregation -> (structure)

An object that contains details about an aggregation response based on Amazon ECR container images.

accountId -> (string)

The Amazon Web Services account ID of the account that owns the container.

architecture -> (string)

The architecture of the container.

imageSha -> (string)

The SHA value of the container image.

imageTags -> (list)

The container image stags.

(string)

inUseCount -> (long)

The number of Amazon ECS tasks or Amazon EKS pods where the Amazon ECR container image is in use.

lastInUseAt -> (timestamp)

The last time an Amazon ECR image was used in an Amazon ECS task or Amazon EKS pod.

repository -> (string)

The container repository.

resourceId -> (string)

The resource ID of the container.

severityCounts -> (structure)

The number of finding by severity.

all -> (long)

The total count of findings from all severities.

critical -> (long)

The total count of critical severity findings.

high -> (long)

The total count of high severity findings.

medium -> (long)

The total count of medium severity findings.

ec2InstanceAggregation -> (structure)

An object that contains details about an aggregation response based on Amazon EC2 instances.

accountId -> (string)

The Amazon Web Services account for the Amazon EC2 instance.

ami -> (string)

The Amazon Machine Image (AMI) of the Amazon EC2 instance.

instanceId -> (string)

The Amazon EC2 instance ID.

instanceTags -> (map)

The tags attached to the instance.

key -> (string)

value -> (string)

networkFindings -> (long)

The number of network findings for the Amazon EC2 instance.

operatingSystem -> (string)

The operating system of the Amazon EC2 instance.

severityCounts -> (structure)

An object that contains the count of matched findings per severity.

all -> (long)

The total count of findings from all severities.

critical -> (long)

The total count of critical severity findings.

high -> (long)

The total count of high severity findings.

medium -> (long)

The total count of medium severity findings.

findingTypeAggregation -> (structure)

An object that contains details about an aggregation response based on finding types.

accountId -> (string)

The ID of the Amazon Web Services account associated with the findings.

exploitAvailableCount -> (long)

The number of findings that have an exploit available.

fixAvailableCount -> (long)

Details about the number of fixes.

severityCounts -> (structure)

The value to sort results by.

all -> (long)

The total count of findings from all severities.

critical -> (long)

The total count of critical severity findings.

high -> (long)

The total count of high severity findings.

medium -> (long)

The total count of medium severity findings.

imageLayerAggregation -> (structure)

An object that contains details about an aggregation response based on container image layers.

accountId -> (string)

The ID of the Amazon Web Services account that owns the container image hosting the layer image.

layerHash -> (string)

The layer hash.

repository -> (string)

The repository the layer resides in.

resourceId -> (string)

The resource ID of the container image layer.

severityCounts -> (structure)

An object that represents the count of matched findings per severity.

all -> (long)

The total count of findings from all severities.

critical -> (long)

The total count of critical severity findings.

high -> (long)

The total count of high severity findings.

medium -> (long)

The total count of medium severity findings.

lambdaFunctionAggregation -> (structure)

An aggregation of findings by Amazon Web Services Lambda function.

accountId -> (string)

The ID of the Amazon Web Services account that owns the Amazon Web Services Lambda function.

functionName -> (string)

The Amazon Web Services Lambda function names included in the aggregation results.

lambdaTags -> (map)

The tags included in the aggregation results.

key -> (string)

value -> (string)

lastModifiedAt -> (timestamp)

The date that the Amazon Web Services Lambda function included in the aggregation results was last changed.

resourceId -> (string)

The resource IDs included in the aggregation results.

runtime -> (string)

The runtimes included in the aggregation results.

severityCounts -> (structure)

An object that contains the counts of aggregated finding per severity.

all -> (long)

The total count of findings from all severities.

critical -> (long)

The total count of critical severity findings.

high -> (long)

The total count of high severity findings.

medium -> (long)

The total count of medium severity findings.

lambdaLayerAggregation -> (structure)

An aggregation of findings by Amazon Web Services Lambda layer.

accountId -> (string)

The account ID of the Amazon Web Services Lambda function layer.

functionName -> (string)

The names of the Amazon Web Services Lambda functions associated with the layers.

layerArn -> (string)

The Amazon Resource Name (ARN) of the Amazon Web Services Lambda function layer.

resourceId -> (string)

The Resource ID of the Amazon Web Services Lambda function layer.

severityCounts -> (structure)

An object that contains the counts of aggregated finding per severity.

all -> (long)

The total count of findings from all severities.

critical -> (long)

The total count of critical severity findings.

high -> (long)

The total count of high severity findings.

medium -> (long)

The total count of medium severity findings.

packageAggregation -> (structure)

An object that contains details about an aggregation response based on operating system package type.

accountId -> (string)

The ID of the Amazon Web Services account associated with the findings.

packageName -> (string)

The name of the operating system package.

severityCounts -> (structure)

An object that contains the count of matched findings per severity.

all -> (long)

The total count of findings from all severities.

critical -> (long)

The total count of critical severity findings.

high -> (long)

The total count of high severity findings.

medium -> (long)

The total count of medium severity findings.

repositoryAggregation -> (structure)

An object that contains details about an aggregation response based on Amazon ECR repositories.

accountId -> (string)

The ID of the Amazon Web Services account associated with the findings.

affectedImages -> (long)

The number of container images impacted by the findings.

repository -> (string)

The name of the repository associated with the findings.

severityCounts -> (structure)

An object that represent the count of matched findings per severity.

all -> (long)

The total count of findings from all severities.

critical -> (long)

The total count of critical severity findings.

high -> (long)

The total count of high severity findings.

medium -> (long)

The total count of medium severity findings.

titleAggregation -> (structure)

Объект, содержащий подробности о результатах агрегации по названию поиска.

accountId -> (строка)

Идентификатор учетной записи Amazon Web Services, связанной с результатами поиска.

severityCounts -> (структура)

Объект, представляющий количество совпавших результатов поиска по степени важности.

all -> (целое число)

Общее количество результатов поиска со всех степеней важности.

critical -> (целое число)

Общее количество результатов поиска с высокой степенью важности.

high -> (целое число)

Общее количество результатов поиска со средней степенью важности.

medium -> (целое число)

Общее количество результатов поиска с низкой степенью важности.

title -> (строка)

Название, по которому были агрегированы результаты поиска.

vulnerabilityId -> (строка)

Идентификатор уязвимости результата поиска.

END_OF_DOCUMENT_MARKER