Spec-Zone.ru › AWS CLI v2

[ aws . iotwireless ]

создание-беспроводного-устройства

Описание

Обеспечивает беспроводное устройство.

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

Синтаксис

  create-wireless-device
--type <value>
[--name <value>]
[--description <value>]
--destination-name <value>
[--client-request-token <value>]
[--tags <value>]
[--positioning <value>]
[--sidewalk <value>]
[--lorawan <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]

Параметры

--type (строка)

Тип беспроводного устройства.

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

  • Sidewalk
  • LoRaWAN

--name (строка)

Имя нового ресурса.

--description (строка)

Описание нового ресурса.

--destination-name (строка)

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

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

Каждый ресурс должен иметь уникальный маркер запроса клиента. Маркер клиента используется для реализации идемпотентности. Он гарантирует, что запрос выполнится не более одного раза. Если вы повторите запрос с тем же маркером и теми же параметрами, запрос будет выполнен успешно. Однако, если вы попытаетесь создать новый ресурс с использованием того же маркера, но с другими параметрами, произойдёт конфликт HTTP 409. Если вы опустите это значение, AWS SDK автоматически сгенерирует уникальный маркер клиента. Дополнительную информацию об идемпотентности см. в разделе Обеспечение идемпотентности в запросах API Amazon EC2.

--tags (список)

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

(структура)

Простой ярлык, состоящий из пары ключ-значение, определённой клиентом

Ключ -> (строка)

Значение ключа тега.

Значение -> (строка)

Значение тега.

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

Key=string,Value=string ...

Синтаксис JSON:

[
  {
    "Key": "string",
    "Value": "string"
  }
  ...
]

--positioning (строка)

Значения FPort для функций GNSS, потока и ClockSync позиционной информации.

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

  • Enabled
  • Disabled

--sidewalk (структура)

Информация о конфигурации устройства, которую нужно использовать для создания устройства Sidewalk.

DeviceProfileId -> (строка)

Идентификатор профиля устройства Sidewalk.

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

DeviceProfileId=string

Синтаксис JSON:

{
  "DeviceProfileId": "string"
}

--lorawan (структура)

Информация о конфигурации устройства, которую нужно использовать для создания беспроводного устройства.

DevEui -> (строка)

Значение DevEUI.

DeviceProfileId -> (строка)

Идентификатор профиля устройства для нового беспроводного устройства.

ServiceProfileId -> (строка)

Идентификатор профиля службы.

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

Объект устройства OTAA для v1.1 для API создания

AppKey -> (строка)

Значение AppKey.

NwkKey -> (строка)

Значение NwkKey.

JoinEui -> (строка)

Значение JoinEUI.

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

Объект устройства OTAA для API создания для v1.0.x

AppKey -> (строка)

Значение AppKey.

AppEui -> (строка)

Значение AppEUI. Вы указываете это значение при использовании LoRaWAN версии v1.0.2 или v1.0.3.

JoinEui -> (строка)

Значение JoinEUI. Вы указываете это значение вместо AppEUI при использовании LoRaWAN версии v1.0.4.

GenAppKey -> (строка)

Значение GenAppKey.

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

Объект устройства ABP для API создания для v1.1

DevAddr -> (строка)

Значение DevAddr.

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

Ключи сессии для ABP v1.1

FNwkSIntKey -> (строка)

Значение FNwkSIntKey.

SNwkSIntKey -> (строка)

Значение SNwkSIntKey.

NwkSEncKey -> (строка)

Значение NwkSEncKey.

AppSKey -> (строка)

Значение AppSKey.

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

Начальное значение FCnt.

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

Объект LoRaWAN для API создания

DevAddr -> (строка)

Значение DevAddr.

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

Ключи сессии для ABP v1.0.x

NwkSKey -> (строка)

Значение NwkSKey.

AppSKey -> (строка)

Значение AppSKey.

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

Начальное значение FCnt.

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

Список назначенных FPort для использования различных пакетов приложений LoRaWAN

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

Значение Fport.

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

Значение Fport.

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

Значение Fport.

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

Значения FPort для функций GNSS, потока и ClockSync позиционной информации.

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

Значение Fport.

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

Значение Fport.

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

Значение Fport.

Applications -> (список)

Дополнительная информация об приложении LoRaWAN, которая может использоваться для геолокации.

(структура)

Конфигурация приложения LoRaWAN, которая может использоваться для выполнения геолокации.

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

Значение Fport.

Тип -> (строка)

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

DestinationName -> (строка)

Имя назначения данных местоположения, которое описывает правило AWS IoT, обрабатывающее данные местоположения устройства для использования в AWS IoT Core для LoRaWAN.

Синтаксис JSON:

{
  "DevEui": "string",
  "DeviceProfileId": "string",
  "ServiceProfileId": "string",
  "OtaaV1_1": {
    "AppKey": "string",
    "NwkKey": "string",
    "JoinEui": "string"
  },
  "OtaaV1_0_x": {
    "AppKey": "string",
    "AppEui": "string",
    "JoinEui": "string",
    "GenAppKey": "string"
  },
  "AbpV1_1": {
    "DevAddr": "string",
    "SessionKeys": {
      "FNwkSIntKey": "string",
      "SNwkSIntKey": "string",
      "NwkSEncKey": "string",
      "AppSKey": "string"
    },
    "FCntStart": integer
  },
  "AbpV1_0_x": {
    "DevAddr": "string",
    "SessionKeys": {
      "NwkSKey": "string",
      "AppSKey": "string"
    },
    "FCntStart": integer
  },
  "FPorts": {
    "Fuota": integer,
    "Multicast": integer,
    "ClockSync": integer,
    "Positioning": {
      "ClockSync": integer,
      "Stream": integer,
      "Gnss": integer
    },
    "Applications": [
      {
        "FPort": integer,
        "Type": "SemtechGeolocation",
        "DestinationName": "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.

Для создания беспроводного устройства IoT

Следующий create-wireless-device пример создаёт беспроводной ресурс типа LoRaWAN.

aws iotwireless create-wireless-device \
    --cli-input-json file://input.json

Содержание input.json:

{
    "Description": "My LoRaWAN wireless device"
    "DestinationName": "IoTWirelessDestination"
    "LoRaWAN": {
        "DeviceProfileId": "ab0c23d3-b001-45ef-6a01-2bc3de4f5333",
        "ServiceProfileId": "fe98dc76-cd12-001e-2d34-5550432da100",
        "OtaaV1_1": {
            "AppKey": "3f4ca100e2fc675ea123f4eb12c4a012",
            "JoinEui": "b4c231a359bc2e3d",
            "NwkKey": "01c3f004a2d6efffe32c4eda14bcd2b4"
        },
        "DevEui": "ac12efc654d23fc2"
    },
    "Name": "SampleIoTWirelessThing"
    "Type": LoRaWAN
}

Вывод:

{
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:WirelessDevice/1ffd32c8-8130-4194-96df-622f072a315f",
    "Id": "1ffd32c8-8130-4194-96df-622f072a315f"
}

Дополнительную информацию см. в разделе Подключение устройств и шлюзов к AWS IoT Core для LoRaWAN в Руководстве разработчика AWS IoT.

Вывод

Arn -> (строка)

Amazon Resource Name нового ресурса.

Id -> (строка)

Идентификатор нового беспроводного устройства.

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

Spec-Zone.ru

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