Spec-Zone.ru › AWS CLI v2

[ 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 (строка)

Amazon Resource Name (ARN) каталога сигналов для ассоциации с кампанией.

--target-arn (строка)

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

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

  • OFF
  • SEND_ACTIVE_DTCS

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

Определяет, сохранять ли собранные данные после потери транспортным средством связи с облаком. После восстановления соединения данные автоматически передаются в Amazon Web Services IoT FleetWise. Если вы хотите сохранить собранные данные при потере связи транспортным средством с облаком, используйте TO_DISK . Если не указано, используется OFF.

По умолчанию: OFF

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

  • OFF
  • TO_DISK

--compression (строка)

Определяет, следует ли сжимать сигналы перед передачей данных в Amazon Web Services IoT FleetWise. Если вы не хотите сжимать сигналы, используйте OFF . Если не указано, используется SNAPPY.

По умолчанию: SNAPPY

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

  • OFF
  • SNAPPY

--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 -> (строка)

Идентификатор ресурса Amazon (ARN) ведра Amazon S3.

dataFormat -> (строка)

Укажите формат, в котором файлы сохраняются в ведре Amazon S3. Вы можете сохранять файлы в формате Apache Parquet или JSON.

  • Parquet — хранение данных в формате столбцового хранения. Parquet оптимален для быстрого извлечения данных и может снизить затраты. Этот параметр выбран по умолчанию.
  • JSON — хранение данных в стандартном текстовом формате JSON.

storageCompressionFormat -> (строка)

По умолчанию хранящиеся данные сжимаются как файл .gzip. Сжатые файлы имеют меньший размер, что может оптимизировать стоимость хранения данных.

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 -> (строка)

Идентификатор ресурса Amazon (ARN) таблицы Amazon Timestream.

executionRoleArn -> (строка)

Идентификатор ресурса Amazon (ARN) роли выполнения задачи, которая предоставляет Amazon Web Services IoT FleetWise разрешение на доставку данных в таблицу Amazon Timestream.

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

MQTT-тема, на которую кампания Amazon Web Services IoT FleetWise маршрутизирует данные.

Предупреждение

Доступ к определенным функциям Amazon Web Services IoT FleetWise в настоящее время ограничен. Для получения дополнительной информации см. Доступность регионов и функций Amazon Web Services в руководстве разработчика Amazon Web Services IoT FleetWise.

mqttTopicArn -> (строка)

ARN MQTT-темы.

executionRoleArn -> (строка)

ARN роли, которая предоставляет Amazon Web Services IoT FleetWise разрешение на доступ и обработку сообщений, отправленных на MQTT-тему.

Сокращенная синтаксическая запись:

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)

ARN созданной кампании.

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

Spec-Zone.ru

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