Spec-Zone.ru › AWS CLI v2

[ aws . configservice ]

start-resource-evaluation

Описание

Выполняет оперативное оценивание указанного ресурса, чтобы определить, соответствуют ли его данные настроенным правилам Config. Также можно использовать для оценки. Config рекомендует использовать контекст оценки. Он выполняет выполнение по данным о ресурсе со всеми правилами Config в вашей учетной записи, которые соответствуют указанному проактивному режиму и типу ресурса.

Примечание

Убедитесь, что настроенная роль cloudformation:DescribeType для проверки схемы типа ресурса.

Вы можете найти схему типа ресурса в «Общедоступные расширения Amazon Web Services» в реестре CloudFormation или с помощью следующей команды CLI: aws cloudformation describe-type --type-name "AWS::S3::Bucket" --type RESOURCE .

Дополнительную информацию см. в руководстве пользователя CloudFormation в разделах «Управление расширениями через реестр CloudFormation» и «Справочник по типам ресурсов и свойств ресурсов Amazon Web Services».

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

Синтаксис

  start-resource-evaluation
--resource-details <value>
[--evaluation-context <value>]
--evaluation-mode <value>
[--evaluation-timeout <value>]
[--client-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]

Параметры

--resource-details (структура)

Возвращает объект ResourceDetails.

ResourceId -> (строка)

Уникальный идентификатор ресурса для оценки.

ResourceType -> (строка)

Тип оцениваемого ресурса.

ResourceConfiguration -> (строка)

Определение ресурса для оценки в соответствии со схемой типа конфигурации ресурса.

ResourceConfigurationSchemaType -> (строка)

Тип схемы конфигурации ресурса.

Примечание

Вы можете найти схему типа ресурса или CFN_RESOURCE_SCHEMA в «Общедоступные расширения Amazon Web Services» в реестре CloudFormation или с помощью следующей команды CLI: aws cloudformation describe-type --type-name "AWS::S3::Bucket" --type RESOURCE .

Дополнительную информацию см. в руководстве пользователя CloudFormation в разделах «Управление расширениями через реестр CloudFormation» и «Справочник по типам ресурсов и свойств ресурсов Amazon Web Services».

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

ResourceId=string,ResourceType=string,ResourceConfiguration=string,ResourceConfigurationSchemaType=string

Синтаксис JSON:

{
  "ResourceId": "string",
  "ResourceType": "string",
  "ResourceConfiguration": "string",
  "ResourceConfigurationSchemaType": "CFN_RESOURCE_SCHEMA"
}

--evaluation-context (структура)

Возвращает объект EvaluationContext.

EvaluationContextIdentifier -> (строка)

Уникальный идентификатор EvaluationContextIdentifier для EvaluationContext.

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

EvaluationContextIdentifier=string

Синтаксис JSON:

{
  "EvaluationContextIdentifier": "string"
}

--evaluation-mode (строка)

Режим оценки. Допустимые значения для этого API — DETECTIVE и PROACTIVE.

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

  • DETECTIVE
  • PROACTIVE

--evaluation-timeout (целое число)

Таймаут для оценки. По умолчанию 900 секунд. Вы не можете указать число больше 3600. Если вы укажете 0, Config использует значение по умолчанию.

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

Маркер клиента — уникальная, регистрозависимая строка длиной до 64 ASCII-символов. Чтобы сделать идемпотентный запрос API с помощью одного из этих действий, укажите маркер клиента в запросе.

Примечание

Не используйте один и тот же маркер клиента для других запросов API. Если вы повторите запрос, который успешно завершился с тем же маркером клиента и теми же параметрами, повторное выполнение завершится успешно без каких-либо дополнительных действий. Если вы повторите успешный запрос с тем же маркером клиента, но один или несколько параметров отличаются, кроме региона или зоны доступности, повторное выполнение завершится ошибкой IdempotentParameterMismatch.

--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
  • text
  • table
  • yaml
  • yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • on
  • off
  • auto

--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-auto-prompt (булево)

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

--no-cli-auto-prompt (булево)

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

Вывод

ResourceEvaluationId -> (строка)

Уникальный ResourceEvaluationId, связанный с одним выполнением.

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

Spec-Zone.ru

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