Spec-Zone.ru › AWS CLI v2

[ aws . inspector ]

describe-assessment-runs

Описание

Описывает запущенные оценки, указанные по ARNs этих оценок.

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

Синтаксис

  describe-assessment-runs
--assessment-run-arns <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]

Параметры

--assessment-run-arns (список)

ARN, определяющий запущенную оценку, которую нужно описать.

(строка)

Синтаксис:

"string" "string" ...

--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.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Подробнее см. руководство по началу работы в руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной среды. См. использование кавычек со строками в руководстве пользователя AWS CLI.

Для описания запущенных оценок

Следующая команда describe-assessment-run описывает запущенную оценку с ARN arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE:

aws inspector describe-assessment-runs --assessment-run-arns arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE

Вывод:

{
        "assessmentRuns": [
          {
                "arn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw/run/0-MKkpXXPE",
                "assessmentTemplateArn": "arn:aws:inspector:us-west-2:123456789012:target/0-0kFIPusq/template/0-4r1V2mAw",
                "completedAt": 1458680301.4,
                "createdAt": 1458680170.035,
                "dataCollected": true,
                "durationInSeconds": 3600,
                "name": "Run 1 for ExampleAssessmentTemplate",
                "notifications": [],
                "rulesPackageArns": [
                  "arn:aws:inspector:us-west-2:758058086616:rulespackage/0-X1KXtawP"
                ],
                "startedAt": 1458680170.161,
                "state": "COMPLETED",
                "stateChangedAt": 1458680301.4,
                "stateChanges": [
                  {
                        "state": "CREATED",
                        "stateChangedAt": 1458680170.035
                  },
                  {
                        "state": "START_DATA_COLLECTION_PENDING",
                        "stateChangedAt": 1458680170.065
                  },
                  {
                        "state": "START_DATA_COLLECTION_IN_PROGRESS",
                        "stateChangedAt": 1458680170.096
                  },
                  {
                        "state": "COLLECTING_DATA",
                        "stateChangedAt": 1458680170.161
                  },
                  {
                        "state": "STOP_DATA_COLLECTION_PENDING",
                        "stateChangedAt": 1458680239.883
                  },
                  {
                        "state": "DATA_COLLECTED",
                        "stateChangedAt": 1458680299.847
                  },
                  {
                        "state": "EVALUATING_RULES",
                        "stateChangedAt": 1458680300.099
                  },
                  {
                        "state": "COMPLETED",
                        "stateChangedAt": 1458680301.4
                  }
                ],
                "userAttributesForFindings": []
          }
        ],
        "failedItems": {}
}

Дополнительную информацию можно найти в руководстве Amazon Inspector по шаблонам оценок Amazon Inspector и запускам оценок.

Вывод

assessmentRuns -> (список)

Информация о запущенной оценке.

(структура)

Снимок запущенной оценки Amazon Inspector, содержащий результаты оценки.

Используется в качестве элемента ответа в действии DescribeAssessmentRuns.

arn -> (строка)

ARN запущенной оценки.

name -> (строка)

Автоматически сгенерированное имя для запущенной оценки.

assessmentTemplateArn -> (строка)

ARN шаблона оценки, связанного с запущенной оценкой.

state -> (строка)

Состояние запущенной оценки.

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

Продолжительность запущенной оценки.

rulesPackageArns -> (список)

Наборы правил, выбранные для запущенной оценки.

(строка)

userAttributesForFindings -> (список)

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

(структура)

Этот тип данных используется в качестве параметра запроса в действиях AddAttributesToFindings и CreateAssessmentTemplate.

key -> (строка)

Ключ атрибута.

value -> (строка)

Значение, назначенное ключу атрибута.

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

Время вызова StartAssessmentRun.

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

Время вызова StartAssessmentRun.

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

Время завершения запущенной оценки, которое соответствует завершению или ошибке оценки наборов правил.

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

Последнее время изменения состояния запущенной оценки.

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

Логическое значение (true или false), указывающее, завершен ли процесс сбора данных с агентов.

stateChanges -> (список)

Список изменений состояния запущенной оценки.

(структура)

Используется как один из элементов типа данных AssessmentRun.

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

Последнее время изменения состояния запущенной оценки.

state -> (строка)

Состояние запущенной оценки.

notifications -> (список)

Список уведомлений для подписок на события. Уведомление об определенной созданной находке добавляется в этот список только один раз.

(структура)

Используется как один из элементов типа данных AssessmentRun.

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

Дата уведомления.

event -> (строка)

Событие, для которого отправляется уведомление.

message -> (строка)

Сообщение, включенное в уведомление.

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

Логическое значение, указывающее, представляет ли уведомление ошибку.

snsTopicArn -> (строка)

Тема SNS, в которую отправляется уведомление SNS.

snsPublishStatusCode -> (строка)

Код состояния уведомления SNS.

findingCounts -> (карта)

Предоставляет общее количество созданных находок по степени критичности.

key -> (строка)

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

failedItems -> (карта)

Подробности запущенной оценки, которые невозможно описать. Для каждого проблемного элемента предоставляется код ошибки.

key -> (строка)

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

Включает детали проблемных элементов.

failureCode -> (строка)

Код состояния проблемного элемента.

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

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

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API