az iot ops ns asset dataset

Note

Эта ссылка является частью расширения azure-iot-ops для Azure CLI (версия 2.70.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az iot ops ns asset dataset . Подробнее о расширениях.

Управление наборами данных для ресурсов с пространством имен в экземпляре операций Интернета вещей.

Тип соединителя обнаруживается автоматически из существующего ресурса. Для параметров, относящихся к соединителю, используйте конфигурацию --dataset-config (встроенный JSON или файл). Используйте --show-template, чтобы обнаружить поддерживаемую схему конфигурации для типа соединителя ресурса.

Команды

Имя Описание Тип Состояние
az iot ops ns asset dataset add

Добавьте набор данных в ресурс с пространством имен в экземпляре Операций Интернета вещей.

 Extension Preview
az iot ops ns asset dataset export

Экспорт наборов данных в файл.

 Extension Preview
az iot ops ns asset dataset import

Импорт наборов данных из файла.

 Extension Preview
az iot ops ns asset dataset list

Вывод списка наборов данных для ресурса с пространством имен в экземпляре Операций Интернета вещей.

 Extension Preview
az iot ops ns asset dataset remove

Удалите набор данных из ресурса с пространством имен в экземпляре Операций Интернета вещей.

 Extension Preview
az iot ops ns asset dataset show

Отображение сведений о наборе данных для ресурса с пространством имен в экземпляре Операций Интернета вещей.

 Extension Preview
az iot ops ns asset dataset update

Обновите набор данных для ресурса с пространством имен в экземпляре Операций Интернета вещей.

 Extension Preview

az iot ops ns asset dataset add

Предварительный просмотр

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Добавьте набор данных в ресурс с пространством имен в экземпляре Операций Интернета вещей.

Тип соединителя обнаружен из конечной точки устройства ресурса. Конфигурацию для конкретного соединителя (интервал публикации, размер очереди и т. д.) можно предоставить через --dataset-config. Используйте шаблон --show-template для обнаружения поддерживаемой схемы конфигурации. Для соединителей, отличных от OPC UA, в экземпляре должен существовать шаблон соединителя.

az iot ops ns asset dataset add --asset
                                --instance
                                --name
                                --resource-group
                                [--acquire-policy-token]
                                [--change-reference]
                                [--data-source --ds]
                                [--dataset-config --dc]
                                [--replace {false, true}]
                                [--show-template {config, schema}]
                                [--tr --type-ref]

Примеры

Добавление базового набора данных в любой тип ресурса

az iot ops ns asset dataset add --asset myasset --instance myInstance -g myInstanceResourceGroup --name default --data-source "ns=2;s=Temperature"

Отображение шаблона конфигурации набора данных для типа соединителя ресурса

az iot ops ns asset dataset add --asset myasset --instance myInstance -g myInstanceResourceGroup --name default --show-template config

Добавление набора данных с конфигурацией для конкретного соединителя из встроенного JSON

az iot ops ns asset dataset add --asset myasset --instance myInstance -g myInstanceResourceGroup --name default --dataset-config '{"datasetConfiguration": {"publishingInterval": 1000, "samplingInterval": 500}}'

Добавление набора данных с конфигурацией из файла

az iot ops ns asset dataset add --asset myasset --instance myInstance -g myInstanceResourceGroup --name default --dataset-config ./dataset_config.json

Добавление набора данных с назначением MQTT

az iot ops ns asset dataset add --asset myasset --instance myInstance -g myInstanceResourceGroup --name default --dataset-config '{"destinations": [{"target": "Mqtt", "configuration": {"topic": "factory/data", "retain": "Keep", "qos": "Qos1", "ttl": 3600}}]}'

Замена существующего набора данных

az iot ops ns asset dataset add --asset myasset --instance myInstance -g myInstanceResourceGroup --name default --replace

Обязательные параметры

--asset -a

Имя ресурса.

--instance -i

Имя экземпляра Операции Интернета вещей Azure.

--name -n

Имя набора данных.

--resource-group -g

Группа ресурсов экземпляра Операции Интернета вещей Azure.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--data-source --ds

Источник данных для набора данных.

--dataset-config --dc

Встроенная строка JSON или путь к JSON/YAML-файлу (.json, YAML, .yml) с конфигурацией набора данных для конкретного соединителя и (или) назначениями. Допустимые ключи: datasetConfiguration (объект конфигурации для конкретного соединителя) и "назначения" (список целевых объектов). Используйте --show-template, чтобы обнаружить поддерживаемые ключи и схему для типа соединителя ресурса. Не удается объединить с --show-template. Для соединителей, отличных от OPC UA, в экземпляре должен существовать шаблон соединителя.

--replace

Замените набор данных, если другой набор данных уже присутствует с тем же именем.

Свойство Значение
Значение по умолчанию: False
Допустимые значения: false, true
--show-template

Отображение шаблона конфигурации начального набора данных для типа соединителя ресурса и выхода без изменения набора данных. Тип соединителя считывается из существующего ресурса. Конфигурация: поля, отображаемые со значениями по умолчанию (null, если значение по умолчанию отсутствует); выходные данные доступны напрямую как входные данные --dataset-config. схема: каждое поле включает тип, значения по умолчанию и ограничения (min, max, перечисление, шаблон). Черновик-07 $ref указатели (#/definitions/...) разрешаются встроенными в обоих режимах.

Свойство Значение
Допустимые значения: config, schema
--tr --type-ref

Идентификатор определения типа или универсальный код ресурса (URI).

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False

az iot ops ns asset dataset export

Предварительный просмотр

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Экспорт наборов данных в файл.

az iot ops ns asset dataset export --asset
                                   --instance
                                   --resource-group
                                   [--acquire-policy-token]
                                   [--change-reference]
                                   [--format {json, yaml}]
                                   [--od --output-dir]
                                   [--replace {false, true}]

Примеры

Экспорт наборов данных в JSON

az iot ops ns asset dataset export --asset myasset --instance myInstance -g myInstanceResourceGroup

Обязательные параметры

--asset -a

Имя ресурса.

--instance -i

Имя экземпляра Операции Интернета вещей Azure.

--resource-group -g

Группа ресурсов экземпляра Операции Интернета вещей Azure.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--format -f

Экспорт файла (JSON или YAML).

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, yaml
--od --output-dir

Выходной каталог для экспорта.

Свойство Значение
Значение по умолчанию: .
--replace

Замените локальный файл, если он присутствует.

Свойство Значение
Значение по умолчанию: False
Допустимые значения: false, true
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False

az iot ops ns asset dataset import

Предварительный просмотр

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Импорт наборов данных из файла.

az iot ops ns asset dataset import --asset
                                   --if --input-file
                                   --instance
                                   --resource-group
                                   [--acquire-policy-token]
                                   [--change-reference]
                                   [--replace {false, true}]

Примеры

Импорт наборов данных из JSON-файла

az iot ops ns asset dataset import --asset myasset --instance myInstance -g myInstanceResourceGroup --input-file ./datasets.json

Обязательные параметры

--asset -a

Имя ресурса.

--if --input-file

Путь к импорту файла (JSON или YAML).

--instance -i

Имя экземпляра Операции Интернета вещей Azure.

--resource-group -g

Группа ресурсов экземпляра Операции Интернета вещей Azure.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--replace

Замените существующие наборы данных, которые совместно используют имя импортированным набором данных.

Свойство Значение
Значение по умолчанию: False
Допустимые значения: false, true
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False

az iot ops ns asset dataset list

Предварительный просмотр

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Вывод списка наборов данных для ресурса с пространством имен в экземпляре Операций Интернета вещей.

az iot ops ns asset dataset list --asset
                                 --instance
                                 --resource-group

Примеры

Вывод списка всех наборов данных для ресурса

az iot ops ns asset dataset list --asset myasset --instance myInstance -g myInstanceResourceGroup

Обязательные параметры

--asset -a

Имя ресурса.

--instance -i

Имя экземпляра Операции Интернета вещей Azure.

--resource-group -g

Группа ресурсов экземпляра Операции Интернета вещей Azure.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False

az iot ops ns asset dataset remove

Предварительный просмотр

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Удалите набор данных из ресурса с пространством имен в экземпляре Операций Интернета вещей.

az iot ops ns asset dataset remove --asset
                                   --instance
                                   --name
                                   --resource-group
                                   [--acquire-policy-token]
                                   [--change-reference]

Примеры

Удаление набора данных из ресурса

az iot ops ns asset dataset remove --asset myasset --instance myInstance -g myInstanceResourceGroup --name default

Обязательные параметры

--asset -a

Имя ресурса.

--instance -i

Имя экземпляра Операции Интернета вещей Azure.

--name -n

Имя набора данных.

--resource-group -g

Группа ресурсов экземпляра Операции Интернета вещей Azure.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False

az iot ops ns asset dataset show

Предварительный просмотр

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Отображение сведений о наборе данных для ресурса с пространством имен в экземпляре Операций Интернета вещей.

az iot ops ns asset dataset show --asset
                                 --instance
                                 --name
                                 --resource-group

Примеры

Отображение сведений о наборе данных

az iot ops ns asset dataset show --asset myasset --instance myInstance -g myInstanceResourceGroup --name default

Обязательные параметры

--asset -a

Имя ресурса.

--instance -i

Имя экземпляра Операции Интернета вещей Azure.

--name -n

Имя набора данных.

--resource-group -g

Группа ресурсов экземпляра Операции Интернета вещей Azure.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False

az iot ops ns asset dataset update

Предварительный просмотр

Эта команда находится в предварительной версии и находится в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Обновите набор данных для ресурса с пространством имен в экземпляре Операций Интернета вещей.

Тип соединителя обнаружен из конечной точки устройства ресурса. Используйте конфигурацию --dataset-config для предоставления конфигурации для конкретного соединителя. Используйте конфигурацию --show-template, чтобы просмотреть текущие значения набора данных, предварительно заполненные в полной структуре схемы (готовы к изменению и передаче через --dataset-config). Используйте схему --show-template, чтобы просмотреть полную схему соединителя с типами и ограничениями.

az iot ops ns asset dataset update --asset
                                   --instance
                                   --name
                                   --resource-group
                                   [--acquire-policy-token]
                                   [--change-reference]
                                   [--data-source --ds]
                                   [--dataset-config --dc]
                                   [--show-template {config, schema}]
                                   [--tr --type-ref]

Примеры

Отображение текущей конфигурации набора данных, предварительно заполненной существующими значениями (для редактирования перед обновлением)

az iot ops ns asset dataset update --asset myasset --instance myInstance -g myInstanceResourceGroup --name default --show-template config

Отображение схемы конфигурации набора данных с типами и ограничениями

az iot ops ns asset dataset update --asset myasset --instance myInstance -g myInstanceResourceGroup --name default --show-template schema

Обновление конфигурации набора данных из встроенного JSON

az iot ops ns asset dataset update --asset myasset --instance myInstance -g myInstanceResourceGroup --name default --dataset-config '{"datasetConfiguration": {"publishingInterval": 2000}}'

Обновление источника данных набора данных

az iot ops ns asset dataset update --asset myasset --instance myInstance -g myInstanceResourceGroup --name default --data-source "ns=3;s=UpdatedSensor"

Обязательные параметры

--asset -a

Имя ресурса.

--instance -i

Имя экземпляра Операции Интернета вещей Azure.

--name -n

Имя набора данных.

--resource-group -g

Группа ресурсов экземпляра Операции Интернета вещей Azure.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--acquire-policy-token

Автоматическое получение маркера Политика Azure для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--change-reference

Связанный идентификатор ссылки на изменение для этой операции ресурса.

Свойство Значение
Группа параметров: Global Policy Arguments
--data-source --ds

Источник данных для набора данных.

--dataset-config --dc

Встроенная строка JSON или путь к JSON/YAML-файлу (.json, YAML, .yml) с конфигурацией набора данных для конкретного соединителя и (или) назначениями. Допустимые ключи: datasetConfiguration (объект конфигурации для конкретного соединителя) и "назначения" (список целевых объектов). Используйте --show-template, чтобы обнаружить поддерживаемые ключи и схему для типа соединителя ресурса. Не удается объединить с --show-template. Для соединителей, отличных от OPC UA, в экземпляре должен существовать шаблон соединителя.

--show-template

Отображение шаблона конфигурации начального набора данных для типа соединителя ресурса и выхода без изменения набора данных. Тип соединителя считывается из существующего ресурса. Конфигурация: поля, отображаемые со значениями по умолчанию (null, если значение по умолчанию отсутствует); выходные данные доступны напрямую как входные данные --dataset-config. схема: каждое поле включает тип, значения по умолчанию и ограничения (min, max, перечисление, шаблон). Черновик-07 $ref указатели (#/definitions/...) разрешаются встроенными в обоих режимах.

Свойство Значение
Допустимые значения: config, schema
--tr --type-ref

Идентификатор определения типа или универсальный код ресурса (URI).

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Значение по умолчанию: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Значение по умолчанию: False
--output -o

Формат вывода.

Свойство Значение
Значение по умолчанию: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Значение по умолчанию: False