получить-статистику-использования
Описание
Отображает статистику использования Amazon GuardDuty за последние 30 дней для указанного идентификатора детектора. Для недавно включённых детекторов или источников данных стоимость будет включать только использование за последние 30 дней. Это может отличаться от метрик стоимости в консоли, которые прогнозируют использование за 30 дней, чтобы предоставить оценочную месячную стоимость. Дополнительную информацию см. в разделе Понимание, как рассчитывается стоимость использования .
См. также: Документация API AWS
Синтаксис
get-usage-statistics
--detector-id <value>
--usage-statistic-type <value>
--usage-criteria <value>
[--unit <value>]
[--max-results <value>]
[--next-token <value>]
[--cli-input-json | --cli-input-yaml]
[--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]
Параметры
--detector-id (строка)
Идентификатор детектора, определяющий службу GuardDuty, для которой требуется получить статистику использования.
Чтобы найти detectorId в текущем регионе, перейдите на страницу «Настройки» в консоли GuardDuty или выполните API ListDetectors.
--usage-statistic-type (строка)
Тип статистики использования, который необходимо получить.
Возможные значения:
SUM_BY_ACCOUNTSUM_BY_DATA_SOURCESUM_BY_RESOURCETOP_RESOURCESSUM_BY_FEATURESTOP_ACCOUNTS_BY_FEATURE
--usage-criteria (структура)
Представляет критерии, используемые для запроса данных об использовании.
AccountIds -> (список)
Идентификаторы учётных записей для агрегирования статистики использования.
(строка)
DataSources -> (список)
Источники данных для агрегирования статистики использования.
(строка)
Resources -> (список)
Ресурсы для агрегирования статистики использования. Принимает только точные имена ресурсов.
(строка)
Features -> (список)
Функции для агрегирования статистики использования.
(строка)
Сокращённый синтаксис:
AccountIds=string,string,DataSources=string,string,Resources=string,string,Features=string,string
Синтаксис JSON:
{
"AccountIds": ["string", ...],
"DataSources": ["FLOW_LOGS"|"CLOUD_TRAIL"|"DNS_LOGS"|"S3_LOGS"|"KUBERNETES_AUDIT_LOGS"|"EC2_MALWARE_SCAN", ...],
"Resources": ["string", ...],
"Features": ["FLOW_LOGS"|"CLOUD_TRAIL"|"DNS_LOGS"|"S3_DATA_EVENTS"|"EKS_AUDIT_LOGS"|"EBS_MALWARE_PROTECTION"|"RDS_LOGIN_EVENTS"|"LAMBDA_NETWORK_LOGS"|"EKS_RUNTIME_MONITORING"|"FARGATE_RUNTIME_MONITORING"|"EC2_RUNTIME_MONITORING"|"RDS_DBI_PROTECTION_PROVISIONED"|"RDS_DBI_PROTECTION_SERVERLESS", ...]
}
--unit (строка)
--max-results (целое число)
--next-token (строка)
--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON следует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределяют значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.
--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.
Вывод
UsageStatistics -> (структура)
Объект статистики использования. Если был предоставлен UsageStatisticType, объекты, представляющие другие типы, будут null.
SumByAccount -> (список)
Сумма статистики использования, организованная по идентификатору учётной записи.
(структура)
Содержит информацию о сумме использования, основанной на идентификаторах учётных записей.
AccountId -> (строка)
Total -> (структура)
Представляет сумму использования для идентификатора учётной записи.
Amount -> (строка)
Unit -> (строка)
TopAccountsByFeature -> (список)
Отображает 50 самых крупных учётных записей по функциям, которые произвели наибольшее использование GuardDuty, в порядке от наиболее к наименее дорогостоящим.
В настоящее время эта функция не поддерживает RDS_LOGIN_EVENTS .
(структура)
Информация о статистике использования, рассчитанная по самым крупным учётным записям по функции.
Feature -> (строка)
Функции, по которым можно генерировать статистику использования.
RDS_LOGIN_EVENTS в настоящее время не поддерживается с topAccountsByFeature .Accounts -> (список)
Учётные записи, которые внесли вклад в общую стоимость использования.
(структура)
Содержит информацию о сумме использования, основанную на 50 самых крупных идентификаторах учётных записей.
AccountId -> (строка)
Total -> (структура)
Содержит общее использование с соответствующей единицей валюты для этого значения.
Amount -> (строка)
Unit -> (строка)
SumByDataSource -> (список)
Сумма статистики использования, организованная по источникам данных.
(структура)
Содержит информацию о результате использования на основе типа источника данных.
DataSource -> (строка)
Total -> (структура)
Представляет сумму использования для указанного источника данных.
Amount -> (строка)
Unit -> (строка)
SumByResource -> (список)
Сумма статистики использования, организованная по ресурсам.
(структура)
Содержит информацию о сумме использования на основе ресурса Amazon Web Services.
Resource -> (строка)
Total -> (структура)
Представляет общую сумму использования для указанного типа ресурса.
Amount -> (строка)
Unit -> (строка)
TopResources -> (список)
Отображает 50 самых крупных ресурсов, которые породили наибольшее использование GuardDuty, в порядке от наиболее к наименее дорогостоящим.
(структура)
Содержит информацию о сумме использования на основе ресурса Amazon Web Services.
Resource -> (строка)
Total -> (структура)
Представляет общую сумму использования для указанного типа ресурса.
Amount -> (строка)
Unit -> (строка)
SumByFeature -> (список)
Сумма статистики использования, организованная по функциям.
(структура)
Содержит информацию о результате общей суммы использования на основе функции.
Feature -> (строка)
Total -> (структура)
Содержит общее использование с соответствующей единицей валюты для этого значения.
Amount -> (строка)
Unit -> (строка)
NextToken -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.