[ aws . greengrassv2 ]
resolve-component-candidates
Описание
Возвращает список компонентов, удовлетворяющих требованиям по компоненту, версии и платформе развертывания. Устройства Greengrass core вызывают эту операцию при получении развертывания, чтобы определить компоненты для установки.
Эта операция идентифицирует компоненты, которые удовлетворяют всем требованиям зависимостей для развертывания. Если требования конфликтуют, эта операция возвращает ошибку, и развертывание завершается неудачно. Например, это происходит, если компонент A требует версии >2.0.0, а компонент B требует версии <2.0.0 зависимости компонента.
При указании кандидатов на разрешение компонентов IoT Greengrass сравнивает каждый компонент из устройства core с компонентом в облаке Amazon Web Services. Если хеши не совпадают, IoT Greengrass указывает использовать версию из облака Amazon Web Services.
Предупреждение
Для использования этой операции необходимо использовать конечную точку API плоскости данных и аутентифицироваться с помощью сертификата устройства IoT. Дополнительную информацию см. в разделах конечные точки и квоты IoT Greengrass.См. также: Документацию API AWS
Синтаксис
resolve-component-candidates
[--platform <value>]
[--component-candidates <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]
Параметры
--platform (структура)
Платформа для разрешения совместимых компонентов.
name -> (строка)
Напоминающее имя платформы. Это имя помогает идентифицировать платформу.
Если этот параметр опущен, IoT Greengrass создает напоминающее имя из os и architecture платформы.
attributes -> (карта)
Словарь атрибутов для платформы. Программное обеспечение IoT Greengrass Core по умолчанию определяет os и architecture. Дополнительные атрибуты платформы для устройства core можно указать при развертывании компонента ядра Greengrass. Дополнительную информацию см. в разделе компонент ядра Greengrass в руководстве разработчика IoT Greengrass V2.
key -> (строка)
value -> (строка)
Краткий синтаксис:
name=string,attributes={KeyName1=string,KeyName2=string}
Синтаксис JSON:
{
"name": "string",
"attributes": {"string": "string"
...}
}
--component-candidates (список)
Список компонентов для разрешения.
(структура)
Содержит информацию о компоненте, являющемся кандидатом для развертывания на устройстве Greengrass core.
componentName -> (строка)
componentVersion -> (строка)
versionRequirements -> (карта)
Требования к версии зависимостей компонента. Устройства Greengrass core получают требования к версии из рецептов компонентов.
IoT Greengrass V2 использует семантические ограничения версий. Дополнительную информацию см. в разделе Семантическое версионирование.
key -> (строка)
value -> (строка)
Краткий синтаксис:
componentName=string,componentVersion=string,versionRequirements={KeyName1=string,KeyName2=string} ...
Синтаксис JSON:
[
{
"componentName": "string",
"componentVersion": "string",
"versionRequirements": {"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
- text
- таблица
- 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.
Вывод
resolvedComponentVersions -> (список)
Список компонентов, удовлетворяющих требованиям, указанным в запросе. Этот список включает рецепт каждого компонента, который можно использовать для установки компонента.
(структура)
Содержит информацию о версии компонента, совместимой с работой на устройстве Greengrass core.
arn -> (строка)
componentName -> (строка)
componentVersion -> (строка)
recipe -> (двоичные данные)
vendorGuidance -> (строка)
Состояние рекомендаций поставщика для версии компонента. Это состояние указывает, есть ли у версии компонента проблемы, которые следует учитывать перед развертыванием. Состояние рекомендаций поставщика может быть:
-
ACTIVE– Эта версия компонента доступна и рекомендуется к использованию. -
DISCONTINUED– Эта версия компонента была прекращена его издателем. Вы можете развернуть эту версию компонента, но мы рекомендуем использовать другую версию этого компонента. -
DELETED– Эта версия компонента была удалена его издателем, поэтому вы не можете ее развернуть. Если у вас есть существующие развертывания, которые указывают на эту версию компонента, эти развертывания завершатся неудачно.
message -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.
|
|