[ aws . iotfleetwise ]
создание-кампании
Описание
Создаёт оркестрацию правил сбора данных. Программное обеспечение агента Amazon Web Services IoT FleetWise Edge, работающее в транспортных средствах, использует кампании для определения того, как собирать и передавать данные в облако. Вы создаёте кампании в облаке. После утверждения кампаний вами или вашей командой, Amazon Web Services IoT FleetWise автоматически развертывает их на транспортных средствах.
Для получения дополнительной информации см. Сбор и передача данных с помощью кампаний в руководстве разработчика Amazon Web Services IoT FleetWise.
Предупреждение
Доступ к некоторым функциям Amazon Web Services IoT FleetWise в настоящее время ограничен. Для получения дополнительной информации см. Доступность регионов и функций Amazon Web Services в руководстве разработчика Amazon Web Services IoT FleetWise.См. также: Документация API AWS
Синтаксис
create-campaign
--name <value>
[--description <value>]
--signal-catalog-arn <value>
--target-arn <value>
[--start-time <value>]
[--expiry-time <value>]
[--post-trigger-collection-duration <value>]
[--diagnostics-mode <value>]
[--spooling-mode <value>]
[--compression <value>]
[--priority <value>]
[--signals-to-collect <value>]
--collection-scheme <value>
[--data-extra-dimensions <value>]
[--tags <value>]
[--data-destination-configs <value>]
[--data-partitions <value>]
[--signals-to-fetch <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]
Параметры
--name (строка)
--description (строка)
--signal-catalog-arn (строка)
--target-arn (строка)
--start-time (метка времени)
Время в миллисекундах для доставки кампании после её утверждения. Если не указано, используется 0.
По умолчанию: 0
--expiry-time (метка времени)
Время истечения срока действия кампании, в секундах с эпохи (1 января 1970 года в полночь по UTC). Сбор данных транспортного средства не производится после истечения срока действия кампании.
По умолчанию: 253402214400 (31 декабря 9999 года, 00:00:00 по UTC)
--post-trigger-collection-duration (целое число)
Сколько времени (в миллисекундах) необходимо для сбора необработанных данных после того, как событие-триггер инициирует сбор. Если не указано, используется 0.
По умолчанию: 0
--diagnostics-mode (строка)
Вариант для отправки диагностических кодов неисправности транспортного средства в Amazon Web Services IoT FleetWise. Если вы хотите отправить диагностические коды неисправности, используйте SEND_ACTIVE_DTCS . Если не указано, используется OFF.
По умолчанию: OFF
Возможные значения:
OFFSEND_ACTIVE_DTCS
--spooling-mode (строка)
Определяет, сохранять ли собранные данные после потери транспортным средством связи с облаком. После восстановления соединения данные автоматически передаются в Amazon Web Services IoT FleetWise. Если вы хотите сохранить собранные данные при потере связи транспортным средством с облаком, используйте TO_DISK . Если не указано, используется OFF.
По умолчанию: OFF
Возможные значения:
OFFTO_DISK
--compression (строка)
Определяет, следует ли сжимать сигналы перед передачей данных в Amazon Web Services IoT FleetWise. Если вы не хотите сжимать сигналы, используйте OFF . Если не указано, используется SNAPPY.
По умолчанию: SNAPPY
Возможные значения:
OFFSNAPPY
--priority (целое число)
Число, указывающее приоритет одной кампании над другой для определённого транспортного средства или флота. Кампания с наименьшим значением развертывается на транспортных средствах перед другими кампаниями. Если не указано, используется 0.
По умолчанию: 0
--signals-to-collect (список)
Список информации о сигналах для сбора.
Примечание
Если вы загружаете сигнал в качестве условия в разделе данных для кампании, эти же сигналы должны быть включены вsignalsToCollect .(структура)
Информация о сигнале.
name -> (строка)
maxSampleCount -> (целое число)
minimumSamplingIntervalMs -> (целое число)
Минимальный интервал времени (в миллисекундах) между двумя событиями-триггерами для сбора данных.
Примечание
Если сигнал часто меняется, вы можете захотеть собирать данные с меньшей скоростью.dataPartitionId -> (строка)
Идентификатор раздела данных, с которым связан этот сигнал.
Идентификатор должен совпадать с одним из идентификаторов, указанных в dataPartitions . Это достигается либо указанием конкретного идентификатора раздела данных, либо использованием default для установленного по умолчанию раздела. Вы можете установить раздел по умолчанию в типе данных DataPartition.
Примечание
Если вы загружаете сигнал в качестве условия для раздела данных кампании, тот же сигнал должен быть включён вsignalsToCollect .Предупреждение
Доступ к некоторым функциям Amazon Web Services IoT FleetWise в настоящее время ограничен. Для получения дополнительной информации см. Доступность регионов и функций Amazon Web Services в руководстве разработчика Amazon Web Services IoT FleetWise.Упрощённый синтаксис:
name=string,maxSampleCount=long,minimumSamplingIntervalMs=long,dataPartitionId=string ...
Синтаксис JSON:
[
{
"name": "string",
"maxSampleCount": long,
"minimumSamplingIntervalMs": long,
"dataPartitionId": "string"
}
...
]
--collection-scheme (структура помеченного союза)
Схема сбора данных, связанная с кампанией. Вы можете указать схему, которая собирает данные на основе времени или события.
Примечание
Это структура помеченного союза. Только один из следующих ключей верхнего уровня может быть задан:timeBasedCollectionScheme, conditionBasedCollectionScheme.timeBasedCollectionScheme -> (структура)
Информация о схеме сбора, использующей временной период для определения частоты сбора данных.
periodMs -> (целое число)
60000, программное обеспечение агента Edge собирает данные один раз в минуту.conditionBasedCollectionScheme -> (структура)
Информация о схеме сбора, которая использует простое логическое выражение для распознавания данных, которые необходимо собрать.
expression -> (строка)
$variable.`Vehicle.OutsideAirTemperature` >= 105.0 .minimumTriggerIntervalMs -> (целое число)
Минимальная продолжительность времени между двумя событиями-триггерами для сбора данных, в миллисекундах.
Примечание
Если сигнал часто меняется, вы можете захотеть собирать данные с меньшей скоростью.triggerMode -> (строка)
ALWAYS ). Указать (RISING_EDGE ), или указать только тогда, когда условие впервые оценивается как ложное. Например, срабатывание по "AirbagDeployed"; Пользователей не интересует срабатывание, когда подушка безопасности уже сработала; их интересует только изменение со «не развернута» => «развернута».conditionLanguageVersion -> (целое число)
Упрощённый синтаксис:
timeBasedCollectionScheme={periodMs=long},conditionBasedCollectionScheme={expression=string,minimumTriggerIntervalMs=long,triggerMode=string,conditionLanguageVersion=integer}
Синтаксис JSON:
{
"timeBasedCollectionScheme": {
"periodMs": long
},
"conditionBasedCollectionScheme": {
"expression": "string",
"minimumTriggerIntervalMs": long,
"triggerMode": "ALWAYS"|"RISING_EDGE",
"conditionLanguageVersion": integer
}
}
--data-extra-dimensions (список)
Список атрибутов транспортных средств, которые необходимо связать с кампанией.
Обогатите данные указанными атрибутами транспортного средства. Например, добавьте make и model в кампанию, и Amazon Web Services IoT FleetWise свяжет данные с этими атрибутами как измерениями в Amazon Timestream. Затем вы можете запросить данные по make и model.
По умолчанию: пустой массив
(строка)
Синтаксис:
"string" "string" ...
--tags (список)
Метаданные, которые могут быть использованы для управления кампанией.
(структура)
Набор пар ключ/значение, используемых для управления ресурсом.
Key -> (строка)
Value -> (строка)
Упрощённый синтаксис:
Key=string,Value=string ...
Синтаксис JSON:
[
{
"Key": "string",
"Value": "string"
}
...
]
--data-destination-configs (список)
Место назначения, куда кампания отправляет данные. Вы можете отправлять данные на MQTT-тему или сохранять их в Amazon S3 или Amazon Timestream.
MQTT — это протокол обмена сообщениями публикации/подписки, используемый Amazon Web Services IoT для связи с вашими устройствами.
Amazon S3 оптимизирует стоимость хранения данных и предоставляет дополнительные механизмы использования данных транспортного средства, такие как хранилища данных, централизованное хранилище данных, конвейеры обработки данных и аналитика. Amazon Web Services IoT FleetWise поддерживает доставку файлов с гарантией «по крайней мере один раз» в S3. Данные вашего транспортного средства хранятся на нескольких серверах Amazon Web Services IoT FleetWise для обеспечения резервирования и высокой доступности.
Вы можете использовать Amazon Timestream для доступа к данным временных рядов и анализа, а также для запроса данных транспортного средства, чтобы вы могли идентифицировать тенденции и закономерности.
(структура помеченных объединений)
Место назначения, куда кампания отправляет данные. Вы можете отправлять данные на MQTT-тему или сохранять их в Amazon S3 или Amazon Timestream.
Примечание
Это структура помеченных объединений. Только один из следующих ключей верхнего уровня может быть задан:s3Config, timestreamConfig, mqttTopicConfig.s3Config -> (структура)
Ведро Amazon S3, куда кампания Amazon Web Services IoT FleetWise отправляет данные.
bucketArn -> (строка)
dataFormat -> (строка)
Укажите формат, в котором файлы сохраняются в ведре Amazon S3. Вы можете сохранять файлы в формате Apache Parquet или JSON.
- Parquet — хранение данных в формате столбцового хранения. Parquet оптимален для быстрого извлечения данных и может снизить затраты. Этот параметр выбран по умолчанию.
- JSON — хранение данных в стандартном текстовом формате JSON.
storageCompressionFormat -> (строка)
prefix -> (строка)
Введите префикс ведра S3. Префикс — это строка символов после имени ведра и перед именем объекта. Вы можете использовать префикс для организации данных, хранящихся в ведрах Amazon S3. Для получения дополнительной информации см. Организацию объектов с помощью префиксов в руководстве пользователя Amazon Simple Storage Service.
По умолчанию Amazon Web Services IoT FleetWise устанавливает префикс processed-data/year=YY/month=MM/date=DD/hour=HH/ (в UTC) для данных, которые он предоставляет в Amazon S3. Вы можете ввести префикс, чтобы добавить его к этому префиксу по умолчанию. Например, если вы введете префикс vehicles, префикс будет vehicles/processed-data/year=YY/month=MM/date=DD/hour=HH/.
timestreamConfig -> (структура)
Таблица Amazon Timestream, куда кампания отправляет данные.
timestreamTableArn -> (строка)
executionRoleArn -> (строка)
mqttTopicConfig -> (структура)
MQTT-тема, на которую кампания Amazon Web Services IoT FleetWise маршрутизирует данные.
Предупреждение
Доступ к определенным функциям Amazon Web Services IoT FleetWise в настоящее время ограничен. Для получения дополнительной информации см. Доступность регионов и функций Amazon Web Services в руководстве разработчика Amazon Web Services IoT FleetWise.mqttTopicArn -> (строка)
executionRoleArn -> (строка)
Сокращенная синтаксическая запись:
s3Config={bucketArn=string,dataFormat=string,storageCompressionFormat=string,prefix=string},timestreamConfig={timestreamTableArn=string,executionRoleArn=string},mqttTopicConfig={mqttTopicArn=string,executionRoleArn=string} ...
Синтаксис JSON:
[
{
"s3Config": {
"bucketArn": "string",
"dataFormat": "JSON"|"PARQUET",
"storageCompressionFormat": "NONE"|"GZIP",
"prefix": "string"
},
"timestreamConfig": {
"timestreamTableArn": "string",
"executionRoleArn": "string"
},
"mqttTopicConfig": {
"mqttTopicArn": "string",
"executionRoleArn": "string"
}
}
...
]
--data-partitions (список)
Разделы данных, связанные с сигналами, собранными с транспортного средства.
(структура)
Настройка параметров хранения и загрузки данных сигнала. Эти параметры можно задавать только при режиме накопления кампании TO_DISK.
Предупреждение
Доступ к определенным функциям Amazon Web Services IoT FleetWise в настоящее время ограничен. Для получения дополнительной информации см. Доступность регионов и функций Amazon Web Services в руководстве разработчика Amazon Web Services IoT FleetWise.id -> (строка)
default в качестве идентификатора.storageOptions -> (структура)
Параметры хранения для раздела данных.
maximumSize -> (структура)
Максимальный размер хранилища данных, хранящихся в разделе данных.
Примечание
Более новые данные перезаписывают более старые данные, когда раздел достигает максимального размера.unit -> (строка)
value -> (целое число)
storageLocation -> (строка)
minimumTimeToLive -> (структура)
Срок хранения данных в этом разделе на диске.
- После истечения установленного срока данные могут быть удалены, но это не гарантируется.
- До истечения срока данные в этом разделе могут быть удалены, если раздел достигнет своего максимального размера.
- Более новые данные перезаписывают более старые данные, когда раздел достигает максимального размера.
unit -> (строка)
value -> (целое число)
uploadOptions -> (структура)
Параметры загрузки для раздела данных.
expression -> (строка)
$variable.`Vehicle.OutsideAirTemperature` >= 105.0.conditionLanguageVersion -> (целое число)
Сокращенная синтаксическая запись:
id=string,storageOptions={maximumSize={unit=string,value=integer},storageLocation=string,minimumTimeToLive={unit=string,value=integer}},uploadOptions={expression=string,conditionLanguageVersion=integer} ...
Синтаксис JSON:
[
{
"id": "string",
"storageOptions": {
"maximumSize": {
"unit": "MB"|"GB"|"TB",
"value": integer
},
"storageLocation": "string",
"minimumTimeToLive": {
"unit": "HOURS"|"DAYS"|"WEEKS",
"value": integer
}
},
"uploadOptions": {
"expression": "string",
"conditionLanguageVersion": integer
}
}
...
]
--signals-to-fetch (список)
Список информации о сигналах для извлечения.
(структура)
Информация о сигнале, подлежащем извлечению.
Предупреждение
Доступ к определенным функциям Amazon Web Services IoT FleetWise в настоящее время ограничен. Для получения дополнительной информации см. Доступность регионов и функций Amazon Web Services в руководстве разработчика Amazon Web Services IoT FleetWise.fullyQualifiedName -> (строка)
signalFetchConfig -> (структура помеченных объединений)
Настройка операции извлечения сигнала.
Примечание
Это структура помеченных объединений. Только один из следующих ключей верхнего уровня может быть задан:timeBased, conditionBased.timeBased -> (структура)
Настройка операции извлечения сигнала на основе времени.
executionFrequencyMs -> (длинное целое число)
conditionBased -> (структура)
Настройка операции извлечения сигнала на основе условий.
conditionExpression -> (строка)
triggerMode -> (строка)
conditionLanguageVersion -> (целое число)
actions -> (список)
Действия, выполняемые при извлечении сигнала.
(строка)
Сокращенная синтаксическая запись:
fullyQualifiedName=string,signalFetchConfig={timeBased={executionFrequencyMs=long},conditionBased={conditionExpression=string,triggerMode=string}},conditionLanguageVersion=integer,actions=string,string ...
Синтаксис JSON:
[
{
"fullyQualifiedName": "string",
"signalFetchConfig": {
"timeBased": {
"executionFrequencyMs": long
},
"conditionBased": {
"conditionExpression": "string",
"triggerMode": "ALWAYS"|"RISING_EDGE"
}
},
"conditionLanguageVersion": integer,
"actions": ["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 (boolean)
Включить отладку логирования.
--endpoint-url (string)
Заменить адрес по умолчанию команды на указанный адрес.
--no-verify-ssl (boolean)
По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (boolean)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (string)
Стиль форматирования вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (string)
Запрос JMESPath для фильтрации данных ответа.
--profile (string)
Использовать определённый профиль из файла учетных данных.
--region (string)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (string)
Отобразить версию этого инструмента.
--color (string)
Включить/выключить цветной вывод.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент указан.
--ca-bundle (string)
Файл с корневым сертификатом для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться блокирующим образом и без таймаута. Значение по умолчанию - 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение установлено в 0, подключение сокета будет выполняться блокирующим образом и без таймаута. Значение по умолчанию - 60 секунд.
--cli-binary-format (string)
Стиль форматирования, используемый для бинарных блоков. Формат по умолчанию - 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 (boolean)
Отключить вывод страницы CLI.
--cli-auto-prompt (boolean)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запроса параметров ввода CLI.
Вывод
name -> (string)
arn -> (string)
© Copyright 2025, Amazon Web Services. Created using Sphinx.