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

az iot ops asset

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

Примечание.

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

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

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

Команды

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

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

 Расширение Предварительный просмотр
az iot ops asset data-point

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

 Расширение Предварительный просмотр
az iot ops asset data-point add

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

 Расширение Предварительный просмотр
az iot ops asset data-point export

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

 Расширение Предварительный просмотр
az iot ops asset data-point import

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

 Расширение Предварительный просмотр
az iot ops asset data-point list

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

 Расширение Предварительный просмотр
az iot ops asset data-point remove

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

 Расширение Предварительный просмотр
az iot ops asset delete

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

 Расширение Предварительный просмотр
az iot ops asset endpoint

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

 Расширение Предварительный просмотр
az iot ops asset endpoint certificate

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

 Расширение Предварительный просмотр
az iot ops asset endpoint certificate add

Добавьте собственный сертификат в конечную точку ресурса.

 Расширение Предварительный просмотр
az iot ops asset endpoint certificate list

Вывод списка принадлежащих сертификатов в конечной точке ресурса.

 Расширение Предварительный просмотр
az iot ops asset endpoint certificate remove

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

 Расширение Предварительный просмотр
az iot ops asset endpoint create

Создайте конечную точку ресурса.

 Расширение Предварительный просмотр
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

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

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

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

Необходимо указать пользовательское расположение или имя кластера. Эта команда проверяет наличие связанного пользовательского расположения и кластера и гарантирует правильность настройки с расширением microsoft.deviceregistry.assets.

Во время создания ресурса необходимо определить по крайней мере одну точку данных или событие. Примеры форматов файлов см. в aka.ms/aziotops-assets.

az iot ops asset create --endpoint
                        --name
                        --resource-group
                        [--asset-type]
                        [--attr]
                        [--cg]
                        [--cl]
                        [--clg]
                        [--cls]
                        [--cluster]
                        [--cluster-subscription]
                        [--data]
                        [--data-file]
                        [--data-publish-int]
                        [--data-queue-size]
                        [--data-sample-int]
                        [--description]
                        [--disable {false, true}]
                        [--display-name]
                        [--documentation-uri]
                        [--eai]
                        [--ef]
                        [--epi]
                        [--eqs]
                        [--esi]
                        [--event]
                        [--hardware-revision]
                        [--location]
                        [--manufacturer]
                        [--manufacturer-uri]
                        [--model]
                        [--pc]
                        [--serial-number]
                        [--software-revision]
                        [--tags]

Примеры

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

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --data data_source={data_source}

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

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --custom-location-resource-group {custom_location_resource_group} --endpoint {endpoint} --data data_source={data_source}

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

az iot ops asset create --name {asset_name} -g {resource_group} --cluster {cluster} --cluster-resource-group {cluster_resource_group} --endpoint {endpoint} --event event_notifier={event_notifier}

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

az iot ops asset create --name {asset_name} -g {resource_group} --cluster {cluster} --custom-location {custom_location} --endpoint {endpoint} --event event_notifier={event_notifier}

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

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --data-publish-int {data_point_publishing_interval} --data-queue-size {data_point_queue_size} --data-sample-int {data_point_sampling_interval} --event-publish-int {event_publishing_interval} --event-queue-size {event_queue_size} --event-sample-int {event_sampling_interval} --event event_notifier={event_notifier}

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

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --custom-attribute {attribute_key}={attribute_value} --custom-attribute {attribute_key}={attribute_value}

Создайте ресурс с пользовательским типом ресурса, описанием, uri документации, идентификатором внешнего ресурса, редакцией оборудования, кодом продукта и редакцией программного обеспечения.

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --asset-type {asset_type} --description {description} --documentation-uri {documentation_uri} --external-asset-id {external_asset_id} --hardware-revision {hardware_revision} --product-code {product_code} --software-revision {software_revision} --data data_source={data_source}

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

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --event capability_id={capability_id} event_notifier={event_notifier} name={name} observability_mode={observability_mode} sampling_interval={sampling_interval} queue_size={queue_size} --event event_notifier={event_notifier} --manufacturer {manufacturer} --manufacturer-uri {manufacturer_uri} --model {model} --serial-number {serial_number}

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

az iot ops asset create --name {asset_name} -g {resource_group} --custom-location {custom_location} --endpoint {endpoint} --disable --data capability_id={capability_id} data_source={data_source} name={name} observability_mode={observability_mode} sampling_interval={sampling_interval} queue_size={queue_size} --data data_source={data_source}

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

az iot ops asset create --name MyAsset -g MyRg --custom-location MyLocation --endpoint exampleEndpoint --data-file /path/to/myasset_datapoints.json --event-file /path/to/myasset_events.csv

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

az iot ops asset create --name MyAsset -g MyRg --custom-location MyLocation --endpoint exampleEndpoint --data capability_id=myTagId data_source=NodeID1 name=myTagName1 observability_mode=counter sampling_interval=10 queue_size=2 --data data_source=NodeID2 --data-publish-int 1000 --data-queue-size 1 --data-sample-int 30 --asset-type customAsset --description 'Description for a test asset.' --documentation-uri www.help.com --external-asset-id 000-000-0000 --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

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

--name -n

Имя ресурса.

--resource-group -g

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

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

--asset-type --at

Тип ресурса.

--attr --custom-attribute

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

--cg --cluster-resource-group

Группа ресурсов для кластера.

--cl --custom-location

Настраиваемое расположение, используемое для связывания ресурса с кластером.

--clg --custom-location-resource-group

Группа ресурсов для пользовательского расположения.

--cls --custom-location-subscription

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

--cluster -c

Кластер для связывания ресурса с.

--cluster-subscription --cs

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

--data

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

--data-file --df

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

--data-publish-int --dpi

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

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

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

Default value: 1
--data-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

Путь к файлу, содержаму события. Поддерживаются следующие типы файлов: csv, json, portal-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, разделенные пробелами, соответствующие свойствам создаваемого события. Поддерживаются следующие ключевые значения: capability_id, event_notifier (обязательно), nameobservability_mode (нет или журнал), sampling_interval (int), (int). queue_size --event можно использовать 1 или более раз. Ознакомьтесь с примерами справки по полному использованию параметров.

--hardware-revision --hr

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

--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.

Глобальные параметры
--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

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

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

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

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

Примеры

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

az iot ops asset delete --name {asset_name} -g {resource_group}

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

--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

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

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

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

az iot ops asset query [--asset-type]
                       [--cl]
                       [--description]
                       [--disabled {false, true}]
                       [--display-name]
                       [--documentation-uri]
                       [--eai]
                       [--endpoint]
                       [--hardware-revision]
                       [--location]
                       [--manufacturer]
                       [--manufacturer-uri]
                       [--model]
                       [--pc]
                       [--resource-group]
                       [--serial-number]
                       [--software-revision]

Примеры

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

az iot ops asset query -g {resource_group} --disabled

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

az iot ops asset query --model {model} --manufacturer {manufacturer} --serial-number {serial_number}

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

--asset-type --at

Тип ресурса.

--cl --custom-location

Настраиваемое расположение, используемое для связывания ресурса с кластером.

--description -d

Описание.

--disabled

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

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

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

--documentation-uri --du

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

--eai --external-asset-id

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

--endpoint

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

--hardware-revision --hr

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

--location -l

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

--manufacturer

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

--manufacturer-uri --mu

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

--model

Модель.

--pc --product-code

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

--resource-group -g

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

--serial-number --sn

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

--software-revision --sr

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

Глобальные параметры
--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

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

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

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

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

Примеры

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

az iot ops asset show --name {asset_name} -g {resource_group}

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

--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

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

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

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

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

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

Примеры

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

az iot ops asset update --name {asset_name} -g {resource_group} --data-publish-int {data_point_publishing_interval} --data-queue-size {data_point_queue_size} --data-sample-int {data_point_sampling_interval} --event-publish-int {event_publishing_interval} --event-queue-size {event_queue_size} --event-sample-int {event_sampling_interval}

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

az iot ops asset update --name {asset_name} -g {resource_group} --asset-type {asset_type} --description {description} --documentation-uri {documentation_uri} --external-asset-id {external_asset_id} --hardware-revision {hardware_revision} --product-code {product_code} --software-revision {software_revision}

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

az iot ops asset update --name {asset_name} -g {resource_group} --manufacturer {manufacturer} --manufacturer-uri {manufacturer_uri} --model {model} --serial-number {serial_number} --custom-attribute {attribute_key}={attribute_value}

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

az iot ops asset update --name {asset_name} -g {resource_group} --disable --custom-attribute work_site=""

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

--name -n

Имя ресурса.

--resource-group -g

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

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

--asset-type --at

Тип ресурса.

--attr --custom-attribute

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

--data-publish-int --dpi

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

--data-queue-size --dqs

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

--data-sample-int --dsi

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

--description -d

Описание.

--disable

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

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

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

--documentation-uri --du

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

--eai --external-asset-id

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

--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.

Глобальные параметры
--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.