Поделиться через

az iot ops asset

  • Ссылка

Примечание.

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

Управление ресурсами.

Дополнительные сведения об управлении ресурсами см. в aka.ms/asset-overview.

Команды

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

Создайте ресурс.

 Расширение ГА
az iot ops asset dataset

Управление наборами данных в ресурсе.

 Расширение ГА
az iot ops asset dataset list

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

 Расширение ГА
az iot ops asset dataset point

Управление точками данных в наборе данных ресурса.

 Расширение ГА
az iot ops asset dataset point add

Добавьте точку данных в набор данных ресурса.

 Расширение ГА
az iot ops asset dataset point export

Экспорт точек данных в наборе данных ресурса.

 Расширение ГА
az iot ops asset dataset point import

Импорт точек данных в набор данных ресурса.

 Расширение ГА
az iot ops asset dataset point list

Вывод списка точек данных в наборе данных ресурса.

 Расширение ГА
az iot ops asset dataset point remove

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

 Расширение ГА
az iot ops asset dataset show

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

 Расширение ГА
az iot ops asset delete

Удаление ресурса.

 Расширение ГА
az iot ops asset endpoint

Управление профилями конечных точек активов.

 Расширение ГА
az iot ops asset endpoint create

Создание профилей конечных точек ресурса.

 Расширение ГА
az iot ops asset endpoint create custom

Создайте профиль конечной точки ресурса для пользовательского соединителя.

 Расширение Устаревшие
az iot ops asset endpoint create onvif

Создайте профиль конечной точки ресурса для соединителя Onvif.

 Расширение Устаревшие
az iot ops asset endpoint create opcua

Создайте профиль конечной точки ресурса для соединителя OPCUA.

 Расширение ГА
az iot ops asset endpoint delete

Удаление профиля конечной точки ресурса.

 Расширение ГА
az iot ops asset endpoint query

Запросите граф ресурсов для профилей конечных точек ресурса.

 Расширение ГА
az iot ops asset endpoint show

Отображение профиля конечной точки ресурса.

 Расширение ГА
az iot ops asset endpoint update

Обновите профиль конечной точки ресурса.

 Расширение ГА
az iot ops asset event

Управление событиями в ресурсе.

 Расширение ГА
az iot ops asset event add

Добавление события в ресурс.

 Расширение ГА
az iot ops asset event export

Экспорт событий в ресурсе.

 Расширение ГА
az iot ops asset event import

Импорт событий в ресурсе.

 Расширение ГА
az iot ops asset event list

Вывод списка событий в ресурсе.

 Расширение ГА
az iot ops asset event remove

Удаление события в ресурсе.

 Расширение ГА
az iot ops asset query

Запрос графа ресурсов для ресурсов.

 Расширение ГА
az iot ops asset show

Отображение ресурса.

 Расширение ГА
az iot ops asset update

Обновление ресурса.

 Расширение ГА

az iot ops asset create

Создайте ресурс.

Примеры форматов файлов см. в aka.ms/aziotops-assets.

az iot ops asset create --endpoint-profile
                        --instance
                        --name
                        --resource-group
                        [--attr]
                        [--dataset-publish-int]
                        [--dataset-queue-size]
                        [--dataset-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--eai]
                        [--ef]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--event]
                        [--hardware-revision]
                        [--ig]
                        [--instance-subscription]
                        [--location]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]
                        [--topic-path]
                        [--topic-retain {Keep, Never}]

Примеры

Создайте ресурс с помощью заданного экземпляра в той же группе ресурсов.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance

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

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --instance-resource-group myinstanceresourcegroup

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

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --event-file /path/to/myasset_events.csv --disable

Создайте ресурс с заданными предварительно заполненными значениями.

az iot ops asset create --name myasset -g myresourcegroup --endpoint-profile myassetendpoint --instance myinstance --event event_notifier=EventNotifier1 name=myEvent1 observability_mode=log sampling_interval=10 queue_size=2 --event event_notifier=EventNotifier2 name=myEvent2 --dataset-publish-int 1250 --dataset-queue-size 2 --dataset-sample-int 30 --event-publish-int 750 --event-queue-size 3 --event-sample-int 50 --description 'Description for a test asset.' --documentation-uri www.contoso.com --external-asset-id 000-000-1234 --hardware-revision 10.0 --product-code XXX100 --software-revision 0.1 --manufacturer Contoso --manufacturer-uri constoso.com --model AssetModel --serial-number 000-000-ABC10 --custom-attribute work_location=factory

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

--endpoint-profile --ep

Имя профиля конечной точки ресурса.

--instance

Имя экземпляра для связывания созданного ресурса с.

--name -n

Имя ресурса.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

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

--attr --custom-attribute

Пары key=value, разделенные пробелами, соответствующие дополнительным пользовательским атрибутам для ресурса. Этот параметр можно использовать несколько раз.

--dataset-publish-int --dpi

Интервал публикации по умолчанию для наборов данных.

Default value: 1000
--dataset-queue-size --dqs

Размер очереди по умолчанию для наборов данных.

Default value: 1
--dataset-sample-int --dsi

Интервал выборки по умолчанию (в миллисекундах) для наборов данных.

Default value: 500
--description -d

Описание.

--disable

Отключите ресурс.

Допустимые значения: false, true
Default value: False
--display-name --dn

Отображаемое имя.

--documentation-uri --du

URI документации.

--eai --external-asset-id

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

--ef --event-file

Путь к файлу, содержаму события. Поддерживаются следующие типы файлов: json, csv, yaml.

--epi --event-publish-int

Интервал публикации по умолчанию для событий.

Default value: 1000
--eqs --event-queue-size

Размер очереди по умолчанию для событий.

Default value: 1
--esi --event-sample-int

Интервал выборки по умолчанию (в миллисекундах) для событий.

Default value: 500
--event

Пары key=value, разделенные пробелами, соответствующие свойствам создаваемого события. Поддерживаются следующие ключевые значения: event_notifier (обязательно), name (обязательно), observability_mode (нет или журнал), sampling_interval (int), queue_size (int). --event можно использовать 1 или более раз. Ознакомьтесь с примерами справки по полному использованию параметров.

--hardware-revision --hr

Редакция оборудования.

--ig --instance-resource-group

Группа ресурсов экземпляра. Если это не указано, будет использоваться группа ресурсов.

--instance-subscription --is
Не рекомендуется

Аргумент "instance_subscription" устарел и будет удален в будущем выпуске.

Идентификатор подписки экземпляра. Если это не указано, будет использоваться идентификатор подписки ресурса.

--location -l

Location. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--manufacturer

Изготовитель.

--manufacturer-uri --mu

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

--model

Модель.

--pc --product-code

Код продукта.

--serial-number --sn

Серийный номер.

--software-revision --sr

Редакция программного обеспечения.

--tags

Теги ресурсов ресурса. Контейнер свойств в парах "ключ-значение" со следующим форматом: a=b=b=d.

--topic-path --tp

Путь к разделу по умолчанию.

--topic-retain --tr

Политика хранения раздела по умолчанию.

Допустимые значения: Keep, Never
Глобальные параметры
--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az iot ops asset delete

Удаление ресурса.

az iot ops asset delete --name
                        --resource-group

Примеры

Удаление ресурса.

az iot ops asset delete --name myasset -g myresourcegroup

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

--name -n

Имя ресурса.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az iot ops asset query

Запрос графа ресурсов для ресурсов.

az iot ops asset query [--cq]
                       [--description]
                       [--disabled {false, true}]
                       [--display-name]
                       [--documentation-uri]
                       [--eai]
                       [--endpoint-profile]
                       [--hardware-revision]
                       [--ig]
                       [--instance]
                       [--location]
                       [--manufacturer]
                       [--manufacturer-uri]
                       [--model]
                       [--name]
                       [--pc]
                       [--resource-group]
                       [--serial-number]
                       [--software-revision]
                       [--topic-path]
                       [--topic-retain {Keep, Never}]

Примеры

Запрос ресурсов, отключенных в данной группе ресурсов.

az iot ops asset query -g myresourcegroup --disabled

Запрос ресурсов с заданной моделью, производителем и серийным номером.

az iot ops asset query --model model1 --manufacturer contoso --serial-number 000-000-ABC10

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

--cq --custom-query

Настраиваемый запрос для использования. Все остальные аргументы запроса будут игнорироваться.

--description -d

Описание.

--disabled

Состояние ресурса.

Допустимые значения: false, true
--display-name --dn

Отображаемое имя.

--documentation-uri --du

URI документации.

--eai --external-asset-id

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

--endpoint-profile --ep

Имя профиля конечной точки ресурса.

--hardware-revision --hr

Редакция оборудования.

--ig --instance-resource-group

Группа ресурсов экземпляра. Если это не указано, будет использоваться группа ресурсов.

--instance

Имя экземпляра для связывания созданного ресурса с.

--location -l

Location. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--manufacturer

Изготовитель.

--manufacturer-uri --mu

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

--model

Модель.

--name -n

Имя ресурса.

--pc --product-code

Код продукта.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--serial-number --sn

Серийный номер.

--software-revision --sr

Редакция программного обеспечения.

--topic-path --tp

Путь к разделу по умолчанию.

--topic-retain --tr

Политика хранения раздела по умолчанию.

Допустимые значения: Keep, Never
Глобальные параметры
--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az iot ops asset show

Отображение ресурса.

az iot ops asset show --name
                      --resource-group

Примеры

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

az iot ops asset show --name myasset -g myresourcegroup

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

--name -n

Имя ресурса.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

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

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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

az iot ops asset update

Обновление ресурса.

Чтобы обновить наборы данных и события, используйте группы az iot ops asset dataset команд и az iot ops asset event соответственно.

az iot ops asset update --name
                        --resource-group
                        [--attr]
                        [--dataset-publish-int]
                        [--dataset-queue-size]
                        [--dataset-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--hardware-revision]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]
                        [--topic-path]
                        [--topic-retain {Keep, Never}]

Примеры

Обновите набор данных ресурса и значения по умолчанию.

az iot ops asset update --name myasset -g myresourcegroup --dataset-publish-int 1250 --dataset-queue-size 2 --dataset-sample-int 30 --event-publish-int 750 --event-queue-size 3 --event-sample-int 50

Обновите описание ресурса, uri документации, редакцию оборудования, код продукта и редакцию программного обеспечения.

az iot ops asset update --name myasset -g myresourcegroup --description "Updated test asset description." --documentation-uri www.contoso.com --hardware-revision 11.0 --product-code XXX102 --software-revision 0.2

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

az iot ops asset update --name myasset -g myresourcegroup --manufacturer Contoso --manufacturer-uri constoso2.com --model NewAssetModel --serial-number 000-000-ABC11 --custom-attribute work_location=new_factory --custom-attribute secondary_work_location=factory

Отключите ресурс и удалите настраиваемый атрибут с именем "work_site".

az iot ops asset update --name myasset -g myresourcegroup --disable --custom-attribute work_site=""

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

--name -n

Имя ресурса.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

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

--attr --custom-attribute

Пары key=value, разделенные пробелами, соответствующие дополнительным пользовательским атрибутам для ресурса. Этот параметр можно использовать несколько раз. Чтобы удалить настраиваемый атрибут, задайте для атрибута значение "".

--dataset-publish-int --dpi

Интервал публикации по умолчанию для наборов данных.

--dataset-queue-size --dqs

Размер очереди по умолчанию для наборов данных.

--dataset-sample-int --dsi

Интервал выборки по умолчанию (в миллисекундах) для наборов данных.

--description -d

Описание.

--disable

Отключите ресурс.

Допустимые значения: false, true
--display-name --dn

Отображаемое имя.

--documentation-uri --du

URI документации.

--epi --event-publish-int

Интервал публикации по умолчанию для событий.

--eqs --event-queue-size

Размер очереди по умолчанию для событий.

--esi --event-sample-int

Интервал выборки по умолчанию (в миллисекундах) для событий.

--hardware-revision --hr

Редакция оборудования.

--manufacturer

Изготовитель.

--manufacturer-uri --mu

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

--model

Модель.

--pc --product-code

Код продукта.

--serial-number --sn

Серийный номер.

--software-revision --sr

Редакция программного обеспечения.

--tags

Теги ресурсов ресурса. Контейнер свойств в парах "ключ-значение" со следующим форматом: a=b=b=d.

--topic-path --tp

Путь к разделу по умолчанию.

--topic-retain --tr

Политика хранения раздела по умолчанию.

Допустимые значения: Keep, Never
Глобальные параметры
--debug

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

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

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

--output -o

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

Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

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

--verbose

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