你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

az iot ops ns asset sse

注释

此参考是 Azure CLI(版本 2.67.0 或更高版本)的 azure-iot-ops 扩展的一部分。 该扩展将在首次运行 az iot ops ns asset sse 命令时自动安装。 了解更多关于扩展的信息。

命令组“iot ops ns”处于预览状态,正在开发中。 参考和支持级别:https://aka.ms/CLI_refstatus

管理指向 SSE(Server-Sent 事件)设备终结点的命名空间资产。

命令

名称 说明 类型 Status
az iot ops ns asset sse create

在 IoT作实例中创建 SSE 命名空间资产。

Extension Preview
az iot ops ns asset sse dataset

管理 SSE 命名空间资产的数据集。

Extension Preview
az iot ops ns asset sse dataset add

将数据集添加到 IoT作实例中的 SSE 命名空间资产。

Extension Preview
az iot ops ns asset sse dataset list

列出 IoT作实例中 SSE 命名空间资产的数据集。

Extension Preview
az iot ops ns asset sse dataset remove

从 IoT作实例中的 SSE 命名空间资产中删除数据集。

Extension Preview
az iot ops ns asset sse dataset show

显示 IoT作实例中 SSE 命名空间资产的数据集的详细信息。

Extension Preview
az iot ops ns asset sse dataset update

更新 IoT作实例中 SSE 命名空间资产的数据集。

Extension Preview
az iot ops ns asset sse event

在设备注册表命名空间中管理 SSE 事件组的各个事件。

Extension Preview
az iot ops ns asset sse event-group

管理 SSE 命名空间资产的事件组。

Extension Preview
az iot ops ns asset sse event-group add

将事件组添加到 IoT作实例中的 SSE 命名空间资产。

Extension Preview
az iot ops ns asset sse event-group list

列出 IoT作实例中 SSE 命名空间资产的事件组。

Extension Preview
az iot ops ns asset sse event-group remove

从 IoT作实例中的 SSE 命名空间资产中删除事件组。

Extension Preview
az iot ops ns asset sse event-group show

显示 IoT作实例中 SSE 命名空间资产的事件组的详细信息。

Extension Preview
az iot ops ns asset sse event-group update

更新 IoT作实例中 SSE 命名空间资产的事件组。

Extension Preview
az iot ops ns asset sse event add

将事件添加到设备注册表命名空间中的 SSE 资产事件组。

Extension Preview
az iot ops ns asset sse event list

列出设备注册表命名空间中 SSE 资产事件组的事件。

Extension Preview
az iot ops ns asset sse event remove

从设备注册表命名空间中的 SSE 资产事件组中删除事件。

Extension Preview
az iot ops ns asset sse update

更新 IoT作实例中的 SSE 命名空间资产。

Extension Preview

az iot ops ns asset sse create

预览

命令组“iot ops ns”处于预览状态,正在开发中。 参考和支持级别:https://aka.ms/CLI_refstatus

在 IoT作实例中创建 SSE 命名空间资产。

设备终结点的类型必须为 Microsoft.SSEHttp。

az iot ops ns asset sse create --device
                               --endpoint --ep
                               --instance
                               --name
                               --resource-group
                               [--asset-type-ref --type-ref]
                               [--attr --attribute]
                               [--dataset-dest --dsd]
                               [--description]
                               [--disable {false, true}]
                               [--display-name --dn]
                               [--doc-uri --documentation-uri]
                               [--eid --external-asset-id]
                               [--evd --event-dest]
                               [--hardware-revision --hw-rev]
                               [--manufacturer]
                               [--manufacturer-uri --mfr-uri]
                               [--model]
                               [--pc --product-code]
                               [--serial-number --sn]
                               [--software-revision --sw-rev]
                               [--tags]

示例

创建基本 SSE 资产

az iot ops ns asset sse create --name mysseAsset --instance myInstance -g myInstanceResourceGroup --device myssedevice --endpoint mySSEEndpoint

使用数据集目标创建 SSE 资产

az iot ops ns asset sse create --name mysseAsset --instance myInstance -g myInstanceResourceGroup --device myssedevice --endpoint mySSEEndpoint --dataset-dest topic="factory/sse/events" retain=Never qos=Qos1 ttl=3600

使用事件目标创建 SSE 资产

az iot ops ns asset sse create --name mysseAsset --instance myInstance -g myInstanceResourceGroup --device myssedevice --endpoint mySSEEndpoint --event-dest topic="factory/sse/alerts" retain=Keep qos=Qos1 ttl=7200

创建包含数据集和事件目标的 SSE 资产

az iot ops ns asset sse create --name mysseAsset --instance myInstance -g myInstanceResourceGroup --device myssedevice --endpoint mySSEEndpoint --dataset-dest topic="factory/sse/data" retain=Never qos=Qos1 ttl=3600 --event-dest topic="factory/sse/events" retain=Keep qos=Qos1 ttl=7200

使用 BrokerStateStore 目标创建 SSE 资产

az iot ops ns asset sse create --name mysseAsset --instance myInstance -g myInstanceResourceGroup --device myssedevice --endpoint mySSEEndpoint --dataset-dest key="sse-data-cache" --event-dest topic="factory/sse/events" retain=Keep qos=Qos1 ttl=7200

使用其他元数据创建 SSE 资产

az iot ops ns asset sse create --name mysseAsset --instance myInstance -g myInstanceResourceGroup --device myssedevice --endpoint mySSEEndpoint --description "Real-time event stream from IoT sensors" --display-name "Facility Event Monitor" --model "EventStream-5000" --manufacturer "StreamCorp" --serial-number "ES-67890" --documentation-uri "https://example.com/docs/sse-api"

使用自定义属性创建 SSE 资产

az iot ops ns asset sse create --name mysseAsset --instance myInstance -g myInstanceResourceGroup --device myssedevice --endpoint mySSEEndpoint --attribute location=warehouse --attribute stream-type=events --attribute format=json

必需参数

--device -d

设备名称。

--endpoint --ep

设备终结点名称。

--instance -i

Azure IoT作实例的名称。

--name -n

资产的名称。

--resource-group -g

Azure IoT作实例的资源组。

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--asset-type-ref --type-ref

资产类型引用的空间分隔列表。

属性
参数组: Additional Info Arguments
--attr --attribute

自定义资产属性的空间分隔键=值对。

属性
参数组: Additional Info Arguments
--dataset-dest --dsd

表示数据集目标的键=值对。 允许的参数包括: key BrokerStateStore 或 topicretainqos以及 ttl MQTT。 允许的 retain 值为 KeepNever 允许的 qos 值为 Qos0Qos1

--description

资产的说明。

属性
参数组: Additional Info Arguments
--disable

禁用资产。

属性
参数组: Additional Info Arguments
接受的值: false, true
--display-name --dn

资产的显示名称。

属性
参数组: Additional Info Arguments
--doc-uri --documentation-uri

资产的文档 URI。

属性
参数组: Additional Info Arguments
--eid --external-asset-id

外部资产 ID。

属性
参数组: Additional Info Arguments
--evd --event-dest

表示事件目标的键=值对。 允许的参数包括: topicretainqosMQTT 和 ttl MQTT。 允许的 retain 值为 KeepNever 允许的 qos 值为 Qos0Qos1

--hardware-revision --hw-rev

硬件修订信息。

属性
参数组: Additional Info Arguments
--manufacturer

制造商名称。

属性
参数组: Additional Info Arguments
--manufacturer-uri --mfr-uri

制造商 URI。

属性
参数组: Additional Info Arguments
--model

模型名称或数字。

属性
参数组: Additional Info Arguments
--pc --product-code

产品代码。

属性
参数组: Additional Info Arguments
--serial-number --sn

序列号。

属性
参数组: Additional Info Arguments
--software-revision --sw-rev

软件修订信息。

属性
参数组: Additional Info Arguments
--tags

空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

属性
默认值: False
--output -o

输出格式。

属性
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性
默认值: False

az iot ops ns asset sse update

预览

命令组“iot ops ns”处于预览状态,正在开发中。 参考和支持级别:https://aka.ms/CLI_refstatus

更新 IoT作实例中的 SSE 命名空间资产。

az iot ops ns asset sse update --instance
                               --name
                               --resource-group
                               [--asset-type-ref --type-ref]
                               [--attr --attribute]
                               [--dataset-dest --dsd]
                               [--description]
                               [--disable {false, true}]
                               [--display-name --dn]
                               [--doc-uri --documentation-uri]
                               [--eid --external-asset-id]
                               [--evd --event-dest]
                               [--hardware-revision --hw-rev]
                               [--manufacturer]
                               [--manufacturer-uri --mfr-uri]
                               [--model]
                               [--pc --product-code]
                               [--serial-number --sn]
                               [--software-revision --sw-rev]
                               [--tags]

示例

更新 SSE 资产数据集目标

az iot ops ns asset sse update --name mysseAsset --instance myInstance -g myInstanceResourceGroup --dataset-dest topic="updated/sse/data" retain=Keep qos=Qos1 ttl=7200

更新 SSE 资产事件目标

az iot ops ns asset sse update --name mysseAsset --instance myInstance -g myInstanceResourceGroup --event-dest topic="updated/sse/alerts" retain=Never qos=Qos0 ttl=3600

更新 SSE 资产元数据

az iot ops ns asset sse update --name mysseAsset --instance myInstance -g myInstanceResourceGroup --description "Updated real-time event stream" --display-name "Updated Event Monitor"

更新 SSE 资产属性

az iot ops ns asset sse update --name mysseAsset --instance myInstance -g myInstanceResourceGroup --attribute location=factory --attribute priority=high

禁用 SSE 资产

az iot ops ns asset sse update --name mysseAsset --instance myInstance -g myInstanceResourceGroup --disable

必需参数

--instance -i

Azure IoT作实例的名称。

--name -n

资产的名称。

--resource-group -g

Azure IoT作实例的资源组。

可选参数

以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。

--asset-type-ref --type-ref

资产类型引用的空间分隔列表。

属性
参数组: Additional Info Arguments
--attr --attribute

自定义资产属性的空间分隔键=值对。

属性
参数组: Additional Info Arguments
--dataset-dest --dsd

表示数据集目标的键=值对。 允许的参数包括: key BrokerStateStore 或 topicretainqos以及 ttl MQTT。 允许的 retain 值为 KeepNever 允许的 qos 值为 Qos0Qos1

--description

资产的说明。

属性
参数组: Additional Info Arguments
--disable

禁用资产。

属性
参数组: Additional Info Arguments
接受的值: false, true
--display-name --dn

资产的显示名称。

属性
参数组: Additional Info Arguments
--doc-uri --documentation-uri

资产的文档 URI。

属性
参数组: Additional Info Arguments
--eid --external-asset-id

外部资产 ID。

属性
参数组: Additional Info Arguments
--evd --event-dest

表示事件目标的键=值对。 允许的参数包括: topicretainqosMQTT 和 ttl MQTT。 允许的 retain 值为 KeepNever 允许的 qos 值为 Qos0Qos1

--hardware-revision --hw-rev

硬件修订信息。

属性
参数组: Additional Info Arguments
--manufacturer

制造商名称。

属性
参数组: Additional Info Arguments
--manufacturer-uri --mfr-uri

制造商 URI。

属性
参数组: Additional Info Arguments
--model

模型名称或数字。

属性
参数组: Additional Info Arguments
--pc --product-code

产品代码。

属性
参数组: Additional Info Arguments
--serial-number --sn

序列号。

属性
参数组: Additional Info Arguments
--software-revision --sw-rev

软件修订信息。

属性
参数组: Additional Info Arguments
--tags

空格分隔标记:key[=value] [key[=value] ...]。使用“”清除现有标记。

全局参数
--debug

提高日志记录详细程度以显示所有调试日志。

属性
默认值: False
--help -h

显示此帮助消息并退出。

--only-show-errors

只显示错误,取消显示警告。

属性
默认值: False
--output -o

输出格式。

属性
默认值: json
接受的值: json, jsonc, none, table, tsv, yaml, yamlc
--query

JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--verbose

增加日志记录详细程度。 使用 --debug 获取完整的调试日志。

属性
默认值: False