az iot ops dataflow endpoint create
Note
此参考是 Azure CLI(版本 2.67.0 或更高版本)的 azure-iot-ops 扩展的一部分。 该扩展将在首次运行 az iot ops dataflow endpoint create 命令时自动安装。 了解更多关于扩展的信息。
创建或替换数据流终结点资源。
命令
| 名称 | 说明 | 类型 | Status |
|---|---|---|---|
| az iot ops dataflow endpoint create adls |
为 Azure Data Lake Storage Gen2 创建或替换数据流终结点资源。 |
Extension | GA |
| az iot ops dataflow endpoint create adx |
为 Azure 数据资源管理器创建或替换数据流终结点资源。 |
Extension | GA |
| az iot ops dataflow endpoint create custom-kafka |
为自定义 kafka 中转站创建或替换数据流终结点资源。 |
Extension | GA |
| az iot ops dataflow endpoint create custom-mqtt |
为自定义 MQTT 代理创建或替换数据流终结点资源。 |
Extension | GA |
| az iot ops dataflow endpoint create eventgrid |
为 Azure 事件网格创建或替换数据流终结点资源。 |
Extension | GA |
| az iot ops dataflow endpoint create eventhub |
为已启用 kafka 的 Azure 事件中心命名空间创建或替换数据流终结点资源。 |
Extension | GA |
| az iot ops dataflow endpoint create fabric-onelake |
为 Microsoft Fabric OneLake 创建或替换数据流终结点资源。 |
Extension | GA |
| az iot ops dataflow endpoint create fabric-realtime |
创建或替换 Microsoft Fabric Real-Time Intelligence 数据流终结点。 |
Extension | GA |
| az iot ops dataflow endpoint create local-mqtt |
创建或替换 Azure IoT作本地 MQTT 数据流终结点。 |
Extension | GA |
| az iot ops dataflow endpoint create local-storage |
创建或替换本地存储数据流终结点。 |
Extension | GA |
| az iot ops dataflow endpoint create otel |
创建或替换 OpenTelemetry 数据流终结点。 |
Extension | GA |
az iot ops dataflow endpoint create adls
为 Azure Data Lake Storage Gen2 创建或替换数据流终结点资源。
有关 Azure Data Lake Storage Gen2 数据流终结点的详细信息,请参阅 https://aka.ms/adlsv2。
注意:使用用户分配的托管标识身份验证方法时,范围将默认为“https://storage.azure.com/.default'”(如果未指定)。--scope
az iot ops dataflow endpoint create adls --instance
--name
--resource-group
--sa --storage-account
[--aud --audience]
[--auth-type {AccessToken, SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
[--cid --client-id]
[--latency]
[--mc --message-count]
[--scope]
[--secret-name]
[--show-config {false, true}]
[--tenant-id --tid]
示例
使用最小输入创建或替换数据流终结点资源。
az iot ops dataflow endpoint create adls --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --storage-account mystorageaccount
使用用户分配的托管标识身份验证方法创建或替换数据流终结点资源。
az iot ops dataflow endpoint create adls --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --storage-account mystorageaccount --client-id 425cb1e9-1247-4cbc-8cdb-1aac9b429696 --tenant-id bca45660-49a2-4bad-862a-0b9459b4b836 --scope "https://storage.azure.com/.default"
显示用于创建数据流终结点资源的配置。
az iot ops dataflow endpoint create adls --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --storage-account mystorageaccount --latency 70 --message-count 100 --secret-name mysecret --show-config
必需参数
IoT 操作实例名称。
数据流终结点名称。
资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。
Azure Data Lake Storage Gen2 帐户的名称。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
要对其进行身份验证的服务受众。
| 属性 | 值 |
|---|---|
| 参数组: | System Assigned Managed Identity Arguments |
数据流终结点的身份验证类型。 注意:如果未指定,身份验证类型由其他身份验证参数确定。
| 属性 | 值 |
|---|---|
| 接受的值: | AccessToken, SystemAssignedManagedIdentity, UserAssignedManagedIdentity |
用户分配标识的客户端 ID。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
批处理延迟(以毫秒为单位)。 最小值:0,最大值:65535。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | 60 |
批中的最大消息数。 最小值:0,最大值:4294967295。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | 100000 |
资源的资源标识符(应用程序 ID URI)带有 .default 后缀。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
包含 SAS 令牌的 kubernetes 机密的名称。
| 属性 | 值 |
|---|---|
| 参数组: | Access Token Arguments |
显示生成的资源配置,而不是使用它调用 API。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
用户分配标识的租户 ID。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
只显示错误,取消显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az iot ops dataflow endpoint create adx
为 Azure 数据资源管理器创建或替换数据流终结点资源。
有关 Azure 数据资源管理器数据流终结点的详细信息,请参阅 https://aka.ms/aio-adx。
az iot ops dataflow endpoint create adx --database --db
--host
--instance
--name
--resource-group
[--aud --audience]
[--auth-type {SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
[--cid --client-id]
[--latency]
[--mc --message-count]
[--scope]
[--show-config {false, true}]
[--tenant-id --tid]
示例
使用最小输入创建或替换数据流终结点资源。
az iot ops dataflow endpoint create adx --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --database mydatabase --host "https://cluster.region.kusto.windows.net"
使用用户分配的托管标识身份验证方法创建或替换数据流终结点资源。
az iot ops dataflow endpoint create adx --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --database mydatabase --host "https://cluster.region.kusto.windows.net" --client-id 425cb1e9-1247-4cbc-8cdb-1aac9b429696 --tenant-id bca45660-49a2-4bad-862a-0b9459b4b836
显示用于创建数据流终结点资源的配置。
az iot ops dataflow endpoint create adx --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --database mydatabase --host "https://cluster.region.kusto.windows.net" --latency 70 --message-count 100 --audience myaudience --show-config
必需参数
Azure 数据资源管理器数据库的名称。
Azure 数据资源管理器的主机是 Azure 数据资源管理器群集 URI。 以 . 的形式 https://cluster.region.kusto.windows.net。
IoT 操作实例名称。
数据流终结点名称。
资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
要对其进行身份验证的服务受众。
| 属性 | 值 |
|---|---|
| 参数组: | System Assigned Managed Identity Arguments |
数据流终结点的身份验证类型。 注意:如果未指定,身份验证类型由其他身份验证参数确定。
| 属性 | 值 |
|---|---|
| 接受的值: | SystemAssignedManagedIdentity, UserAssignedManagedIdentity |
用户分配标识的客户端 ID。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
批处理延迟(以毫秒为单位)。 最小值:0,最大值:65535。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | 60 |
批中的最大消息数。 最小值:0,最大值:4294967295。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | 100000 |
资源的资源标识符(应用程序 ID URI)带有 .default 后缀。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
显示生成的资源配置,而不是使用它调用 API。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
用户分配标识的租户 ID。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
只显示错误,取消显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az iot ops dataflow endpoint create custom-kafka
为自定义 kafka 中转站创建或替换数据流终结点资源。
有关自定义 kafka 数据流终结点的详细信息,请参阅 https://aka.ms/aio-custom-kafka。
az iot ops dataflow endpoint create custom-kafka --hostname
--instance
--name
--port
--resource-group
[--acks {All, One, Zero}]
[--aud --audience]
[--auth-type {Sasl, SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
[--cea --cloud-event-attribute {CreateOrRemap, Propagate}]
[--cid --client-id]
[--cm --config-map-ref]
[--compression {Gzip, Lz4, None, Snappy}]
[--db --disable-batching {false, true}]
[--dbpc --disable-broker-props-copy {false, true}]
[--disable-tls {false, true}]
[--gid --group-id]
[--latency]
[--max-bytes --mb]
[--mc --message-count]
[--no-auth {false, true}]
[--partition-strategy --ps {Default, Property, Static, Topic}]
[--sasl-type {Plain, ScramSha256, ScramSha512}]
[--scope]
[--secret-name]
[--show-config {false, true}]
[--tenant-id --tid]
示例
使用最小输入创建或替换数据流终结点资源。
az iot ops dataflow endpoint create custom-kafka --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname mykafkabroker --port 9092
使用 SASL 身份验证方法创建或替换数据流终结点资源。
az iot ops dataflow endpoint create custom-kafka --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname mykafkabroker --port 9092 --sasl-type ScramSha256 --secret-name mysecret
创建或替换没有身份验证的数据流终结点资源。
az iot ops dataflow endpoint create custom-kafka --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname mykafkabroker --port 9092 --no-auth
显示用于创建数据流终结点资源的配置。
az iot ops dataflow endpoint create custom-kafka --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname mykafkabroker --port 9092 --disable-batching --latency 70 --max-bytes 200000 --message-count 100 --audience myaudience --config-map-ref myconfigmap --disable-tls --show-config
必需参数
Kafka 中转站主机设置的主机名。
IoT 操作实例名称。
数据流终结点名称。
Kafka 中转站主机设置的端口号。
资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
Kafka 中转站的确认级别,以确保生成者发送的消息已成功写入主题,并在 Kafka 群集中复制。
| 属性 | 值 |
|---|---|
| 默认值: | All |
| 接受的值: | All, One, Zero |
要对其进行身份验证的服务受众。
| 属性 | 值 |
|---|---|
| 参数组: | System Assigned Managed Identity Arguments |
数据流终结点的身份验证类型。 注意:如果未指定,身份验证类型由其他身份验证参数确定。
| 属性 | 值 |
|---|---|
| 接受的值: | Sasl, SystemAssignedManagedIdentity, UserAssignedManagedIdentity |
CloudEvent 设置类型,用于将事件映射到云。 不同的设置需要不同的消息格式。
| 属性 | 值 |
|---|---|
| 参数组: | Cloud Event Arguments |
| 默认值: | Propagate |
| 接受的值: | CreateOrRemap, Propagate |
用户分配标识的客户端 ID。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
Kafka/MQTT 终结点的受信任 CA 证书的配置映射参考。 注意:此 ConfigMap 应包含 PEM 格式的 CA 证书。 ConfigMap 必须与 Kafka/MQTT 数据流资源位于同一命名空间中。
| 属性 | 值 |
|---|---|
| 参数组: | Transport Layer Security (TLS) Arguments |
发送到 Kafka 主题的消息的压缩类型。
| 属性 | 值 |
|---|---|
| 默认值: | None |
| 接受的值: | Gzip, Lz4, None, Snappy |
禁用批处理。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | False |
| 接受的值: | false, true |
禁用 MQTT 代理属性复制到 Kafka 用户标头。
| 属性 | 值 |
|---|---|
| 默认值: | False |
| 接受的值: | false, true |
数据流使用与 Kafka/MQTT 中转站的不安全连接。
| 属性 | 值 |
|---|---|
| 参数组: | Transport Layer Security (TLS) Arguments |
| 默认值: | False |
| 接受的值: | false, true |
数据流用于从 Kafka 主题读取消息的使用者组的 ID。
批处理延迟(以毫秒为单位)。 最小值:0,最大值:65535。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | 5 |
批中的最大字节数。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | 1000000 |
批中的最大消息数。 最小值:0,最大值:4294967295。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | 100000 |
没有终结点的身份验证。
| 属性 | 值 |
|---|---|
| 默认值: | False |
| 接受的值: | false, true |
分区处理策略可控制在将消息发送到 Kafka 主题时如何将其分配给 Kafka 分区。
| 属性 | 值 |
|---|---|
| 默认值: | Default |
| 接受的值: | Default, Property, Static, Topic |
SASL 身份验证的类型。
| 属性 | 值 |
|---|---|
| 参数组: | SASL Authentication Arguments |
| 接受的值: | Plain, ScramSha256, ScramSha512 |
资源的资源标识符(应用程序 ID URI)带有 .default 后缀。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
包含 SASL 令牌的 Kubernetes 机密的名称。
| 属性 | 值 |
|---|---|
| 参数组: | SASL Authentication Arguments |
显示生成的资源配置,而不是使用它调用 API。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
用户分配标识的租户 ID。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
只显示错误,取消显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az iot ops dataflow endpoint create custom-mqtt
为自定义 MQTT 代理创建或替换数据流终结点资源。
有关自定义 MQTT 数据流终结点的详细信息,请参阅 https://aka.ms/aio-custom-mqtt。
az iot ops dataflow endpoint create custom-mqtt --hostname
--instance
--name
--port
--resource-group
[--auth-type {ServiceAccountToken, SystemAssignedManagedIdentity, UserAssignedManagedIdentity, X509Certificate}]
[--cea --cloud-event-attribute {CreateOrRemap, Propagate}]
[--cid --client-id]
[--client-id-prefix]
[--cm --config-map-ref]
[--disable-tls {false, true}]
[--ka --keep-alive]
[--max-inflight-msg --mim]
[--no-auth {false, true}]
[--protocol {Mqtt, WebSockets}]
[--qos]
[--retain {Keep, Never}]
[--sami-aud --sami-audience]
[--sat-aud --sat-audience]
[--scope]
[--secret-name]
[--session-expiry]
[--show-config {false, true}]
[--tenant-id --tid]
示例
使用最小输入创建或替换数据流终结点资源。
az iot ops dataflow endpoint create custom-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname mymqttbroker --port 9092
使用 Kubernetes 服务帐户令牌身份验证方法创建或替换数据流终结点资源。
az iot ops dataflow endpoint create custom-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname mymqttbroker --port 9092 --sat-audience myaudience --secret-name mysecret
创建或替换没有身份验证的数据流终结点资源。
az iot ops dataflow endpoint create custom-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname mymqttbroker --port 9092 --no-auth
显示用于创建数据流终结点资源的配置。
az iot ops dataflow endpoint create custom-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname mymqttbroker --port 9092 --client-id-prefix myclientprefix --keep-alive 100 --max-inflight-msg 60 --protocol WebSockets --qos 1 --retain Never --session-expiry 100 --cloud-event-attribute CreateOrRemap --secret-name mysecret --disable-tls --show-config
必需参数
自定义 MQTT 代理主机设置的主机名。
IoT 操作实例名称。
数据流终结点名称。
自定义 MQTT 代理主机设置的端口号。
资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
数据流终结点的身份验证类型。 注意:如果未指定,身份验证类型由其他身份验证参数确定。
| 属性 | 值 |
|---|---|
| 接受的值: | ServiceAccountToken, SystemAssignedManagedIdentity, UserAssignedManagedIdentity, X509Certificate |
CloudEvent 设置类型,用于将事件映射到云。 不同的设置需要不同的消息格式。
| 属性 | 值 |
|---|---|
| 参数组: | Cloud Event Arguments |
| 默认值: | Propagate |
| 接受的值: | CreateOrRemap, Propagate |
用户分配标识的客户端 ID。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
MQTT 客户端的客户端 ID 前缀。 注意:在 IoT作部署后更改客户端 ID 前缀可能会导致数据丢失。
Kafka/MQTT 终结点的受信任 CA 证书的配置映射参考。 注意:此 ConfigMap 应包含 PEM 格式的 CA 证书。 ConfigMap 必须与 Kafka/MQTT 数据流资源位于同一命名空间中。
| 属性 | 值 |
|---|---|
| 参数组: | Transport Layer Security (TLS) Arguments |
数据流使用与 Kafka/MQTT 中转站的不安全连接。
| 属性 | 值 |
|---|---|
| 参数组: | Transport Layer Security (TLS) Arguments |
| 默认值: | False |
| 接受的值: | false, true |
将 PINGREQ 消息发送到中转站之前,数据流客户端可以处于空闲状态的最长时间(以秒为单位)。 最小值:0。
| 属性 | 值 |
|---|---|
| 默认值: | 60 |
数据流 MQTT 客户端可以拥有的最大飞行消息数。 最小值:0。
| 属性 | 值 |
|---|---|
| 默认值: | 100 |
没有终结点的身份验证。
| 属性 | 值 |
|---|---|
| 默认值: | False |
| 接受的值: | false, true |
用于客户端连接的协议。
| 属性 | 值 |
|---|---|
| 默认值: | Mqtt |
| 接受的值: | Mqtt, WebSockets |
MQTT 消息的服务质量(QoS)级别。 仅支持 0 或 1。
| 属性 | 值 |
|---|---|
| 默认值: | 1 |
保留设置以指定数据流是否应保留 MQTT 消息上的保留标志。 设置此项可确保远程代理是否保留与本地中转站相同的消息。
| 属性 | 值 |
|---|---|
| 默认值: | Keep |
| 接受的值: | Keep, Never |
系统分配的托管标识的受众。
| 属性 | 值 |
|---|---|
| 参数组: | System Assigned Managed Identity Arguments |
Kubernetes 服务帐户令牌(SAT)的受众。
| 属性 | 值 |
|---|---|
| 参数组: | Kubernetes Service Account Token Arguments |
资源的资源标识符(应用程序 ID URI)带有 .default 后缀。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
Kubernetes 机密的名称,其中包含 X509 客户端证书、对应于客户端证书的私钥,以及客户端证书链的中间证书。 注意:证书和私钥必须采用 PEM 格式,且不受密码保护。
| 属性 | 值 |
|---|---|
| 参数组: | X509 Authentication Arguments |
数据流 MQTT 客户端的会话到期间隔(以秒为单位)。 最小值:0。
| 属性 | 值 |
|---|---|
| 默认值: | 3600 |
显示生成的资源配置,而不是使用它调用 API。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
用户分配标识的租户 ID。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
只显示错误,取消显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az iot ops dataflow endpoint create eventgrid
为 Azure 事件网格创建或替换数据流终结点资源。
有关 Azure 事件网格数据流终结点的详细信息,请参阅 https://aka.ms/aio-eventgrid。
az iot ops dataflow endpoint create eventgrid --hostname
--instance
--name
--resource-group
[--aud --audience]
[--auth-type {SystemAssignedManagedIdentity, UserAssignedManagedIdentity, X509Certificate}]
[--cea --cloud-event-attribute {CreateOrRemap, Propagate}]
[--cid --client-id]
[--client-id-prefix]
[--cm --config-map-ref]
[--ka --keep-alive]
[--max-inflight-msg --mim]
[--port]
[--protocol {Mqtt, WebSockets}]
[--qos]
[--retain {Keep, Never}]
[--scope]
[--secret-name]
[--session-expiry]
[--show-config {false, true}]
[--tenant-id --tid]
示例
使用最小输入创建或替换数据流终结点资源。
az iot ops dataflow endpoint create eventgrid --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname "namespace.region-1.ts.eventgrid.azure.net" --port 9092
使用 X509 身份验证方法创建或替换数据流终结点资源。
az iot ops dataflow endpoint create eventgrid --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname "namespace.region-1.ts.eventgrid.azure.net" --port 9092 --secret-name mysecret
显示用于创建数据流终结点资源的配置。
az iot ops dataflow endpoint create eventgrid --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname "namespace.region-1.ts.eventgrid.azure.net" --port 9092 --client-id-prefix myclientprefix --keep-alive 100 --max-inflight-msg 60 --protocol WebSockets --qos 1 --retain Never --session-expiry 100 --cloud-event-attribute CreateOrRemap --secret-name mysecret --config-map-ref myconfigmap --show-config
必需参数
事件网格命名空间的主机名。 可以在“Http 主机名”属性中找到。 以 NAMESPACE.REGION-1.ts.eventgrid.azure.net 的形式。
IoT 操作实例名称。
数据流终结点名称。
资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
要对其进行身份验证的服务受众。
| 属性 | 值 |
|---|---|
| 参数组: | System Assigned Managed Identity Arguments |
数据流终结点的身份验证类型。 注意:如果未指定,身份验证类型由其他身份验证参数确定。
| 属性 | 值 |
|---|---|
| 接受的值: | SystemAssignedManagedIdentity, UserAssignedManagedIdentity, X509Certificate |
CloudEvent 设置类型,用于将事件映射到云。 不同的设置需要不同的消息格式。
| 属性 | 值 |
|---|---|
| 参数组: | Cloud Event Arguments |
| 默认值: | Propagate |
| 接受的值: | CreateOrRemap, Propagate |
用户分配标识的客户端 ID。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
MQTT 客户端的客户端 ID 前缀。 注意:在 IoT作部署后更改客户端 ID 前缀可能会导致数据丢失。
Kafka/MQTT 终结点的受信任 CA 证书的配置映射参考。 注意:此 ConfigMap 应包含 PEM 格式的 CA 证书。 ConfigMap 必须与 Kafka/MQTT 数据流资源位于同一命名空间中。
| 属性 | 值 |
|---|---|
| 参数组: | Transport Layer Security (TLS) Arguments |
将 PINGREQ 消息发送到中转站之前,数据流客户端可以处于空闲状态的最长时间(以秒为单位)。 最小值:0。
| 属性 | 值 |
|---|---|
| 默认值: | 60 |
数据流 MQTT 客户端可以拥有的最大飞行消息数。 最小值:0。
| 属性 | 值 |
|---|---|
| 默认值: | 100 |
事件网格命名空间的端口号。
| 属性 | 值 |
|---|---|
| 默认值: | 8883 |
用于客户端连接的协议。
| 属性 | 值 |
|---|---|
| 默认值: | Mqtt |
| 接受的值: | Mqtt, WebSockets |
MQTT 消息的服务质量(QoS)级别。 仅支持 0 或 1。
| 属性 | 值 |
|---|---|
| 默认值: | 1 |
保留设置以指定数据流是否应保留 MQTT 消息上的保留标志。 设置此项可确保远程代理是否保留与本地中转站相同的消息。
| 属性 | 值 |
|---|---|
| 默认值: | Keep |
| 接受的值: | Keep, Never |
资源的资源标识符(应用程序 ID URI)带有 .default 后缀。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
Kubernetes 机密的名称,其中包含 X509 客户端证书、对应于客户端证书的私钥,以及客户端证书链的中间证书。 注意:证书和私钥必须采用 PEM 格式,且不受密码保护。
| 属性 | 值 |
|---|---|
| 参数组: | X509 Authentication Arguments |
数据流 MQTT 客户端的会话到期间隔(以秒为单位)。 最小值:0。
| 属性 | 值 |
|---|---|
| 默认值: | 3600 |
显示生成的资源配置,而不是使用它调用 API。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
用户分配标识的租户 ID。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
只显示错误,取消显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az iot ops dataflow endpoint create eventhub
为已启用 kafka 的 Azure 事件中心命名空间创建或替换数据流终结点资源。
有关 Azure 事件中心数据流终结点的详细信息,请参阅 https://aka.ms/aio-eventhub。
az iot ops dataflow endpoint create eventhub --ehns --eventhub-namespace
--instance
--name
--resource-group
[--acks {All, One, Zero}]
[--aud --audience]
[--auth-type {Sasl, SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
[--cea --cloud-event-attribute {CreateOrRemap, Propagate}]
[--cid --client-id]
[--cm --config-map-ref]
[--compression {Gzip, Lz4, None, Snappy}]
[--db --disable-batching {false, true}]
[--dbpc --disable-broker-props-copy {false, true}]
[--gid --group-id]
[--latency]
[--max-bytes --mb]
[--mc --message-count]
[--partition-strategy --ps {Default, Property, Static, Topic}]
[--sasl-type {Plain, ScramSha256, ScramSha512}]
[--scope]
[--secret-name]
[--show-config {false, true}]
[--tenant-id --tid]
示例
使用最小输入创建或替换数据流终结点资源。
az iot ops dataflow endpoint create eventhub --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --eventhub-namespace myeventhubnamespace
使用用户分配的托管标识身份验证方法创建或替换数据流终结点资源。
az iot ops dataflow endpoint create eventhub --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --eventhub-namespace myeventhubnamespace --client-id 425cb1e9-1247-4cbc-8cdb-1aac9b429696 --tenant-id bca45660-49a2-4bad-862a-0b9459b4b836 --scope "https://eventhubs.azure.net/.default"
显示用于创建数据流终结点资源的配置。
az iot ops dataflow endpoint create eventhub --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --eventhub-namespace myeventhubnamespace --acks One --compression Gzip --disable-broker-props-copy --group-id mygroupid --partition-strategy Static --max-bytes 200000 --message-count 100 --latency 70 --cloud-event-attribute CreateOrRemap --sasl-type ScramSha256 --secret-name mysecret --config-map-ref myconfigmap --show-config
必需参数
事件中心命名空间的名称。
IoT 操作实例名称。
数据流终结点名称。
资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
Kafka 中转站的确认级别,以确保生成者发送的消息已成功写入主题,并在 Kafka 群集中复制。
| 属性 | 值 |
|---|---|
| 默认值: | All |
| 接受的值: | All, One, Zero |
要对其进行身份验证的服务受众。
| 属性 | 值 |
|---|---|
| 参数组: | System Assigned Managed Identity Arguments |
数据流终结点的身份验证类型。 注意:如果未指定,身份验证类型由其他身份验证参数确定。
| 属性 | 值 |
|---|---|
| 接受的值: | Sasl, SystemAssignedManagedIdentity, UserAssignedManagedIdentity |
CloudEvent 设置类型,用于将事件映射到云。 不同的设置需要不同的消息格式。
| 属性 | 值 |
|---|---|
| 参数组: | Cloud Event Arguments |
| 默认值: | Propagate |
| 接受的值: | CreateOrRemap, Propagate |
用户分配标识的客户端 ID。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
Kafka/MQTT 终结点的受信任 CA 证书的配置映射参考。 注意:此 ConfigMap 应包含 PEM 格式的 CA 证书。 ConfigMap 必须与 Kafka/MQTT 数据流资源位于同一命名空间中。
| 属性 | 值 |
|---|---|
| 参数组: | Transport Layer Security (TLS) Arguments |
发送到 Kafka 主题的消息的压缩类型。
| 属性 | 值 |
|---|---|
| 默认值: | None |
| 接受的值: | Gzip, Lz4, None, Snappy |
禁用批处理。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | False |
| 接受的值: | false, true |
禁用 MQTT 代理属性复制到 Kafka 用户标头。
| 属性 | 值 |
|---|---|
| 默认值: | False |
| 接受的值: | false, true |
数据流用于从 Kafka 主题读取消息的使用者组的 ID。
批处理延迟(以毫秒为单位)。 最小值:0,最大值:65535。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | 5 |
批中的最大字节数。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | 1000000 |
批中的最大消息数。 最小值:0,最大值:4294967295。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | 100000 |
分区处理策略可控制在将消息发送到 Kafka 主题时如何将其分配给 Kafka 分区。
| 属性 | 值 |
|---|---|
| 默认值: | Default |
| 接受的值: | Default, Property, Static, Topic |
SASL 身份验证的类型。
| 属性 | 值 |
|---|---|
| 参数组: | SASL Authentication Arguments |
| 接受的值: | Plain, ScramSha256, ScramSha512 |
资源的资源标识符(应用程序 ID URI)带有 .default 后缀。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
包含事件中心连接字符串的 kubernetes 机密的名称。 注意:机密必须与 Kafka 数据流终结点位于同一命名空间中。 机密必须同时拥有用户名和密码作为密钥值对。 有关机密格式的详细信息,请参阅命令说明中的链接。
| 属性 | 值 |
|---|---|
| 参数组: | SASL Authentication Arguments |
显示生成的资源配置,而不是使用它调用 API。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
用户分配标识的租户 ID。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
只显示错误,取消显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az iot ops dataflow endpoint create fabric-onelake
为 Microsoft Fabric OneLake 创建或替换数据流终结点资源。
有关 Microsoft Fabric OneLake 数据流终结点的详细信息,请参阅 https://aka.ms/fabric-onelake。
az iot ops dataflow endpoint create fabric-onelake --instance
--lakehouse
--name
--path-type --pt {Files, Tables}
--resource-group
--workspace
[--aud --audience]
[--auth-type {SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
[--cid --client-id]
[--latency]
[--mc --message-count]
[--scope]
[--show-config {false, true}]
[--tenant-id --tid]
示例
使用最小输入创建或替换数据流终结点资源。
az iot ops dataflow endpoint create fabric-onelake --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --lakehouse mylakehouse --workspace myworkspace --path-type Files
使用用户分配的托管标识身份验证方法创建或替换数据流终结点资源。
az iot ops dataflow endpoint create fabric-onelake --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --lakehouse mylakehouse --workspace myworkspace --path-type Files --client-id 425cb1e9-1247-4cbc-8cdb-1aac9b429696 --tenant-id bca45660-49a2-4bad-862a-0b9459b4b836
显示用于创建数据流终结点资源的配置。
az iot ops dataflow endpoint create fabric-onelake --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --lakehouse mylakehouse --workspace myworkspace --path-type Files --latency 70 --message-count 100 --audience myaudience --show-config
必需参数
IoT 操作实例名称。
提供的工作区下Microsoft Fabric lakehouse 名称。
数据流终结点名称。
OneLake 中使用的路径类型。
| 属性 | 值 |
|---|---|
| 接受的值: | Files, Tables |
资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。
Microsoft Fabric 工作区名称。 注意:不支持默认的“我的工作区”。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
要对其进行身份验证的服务受众。
| 属性 | 值 |
|---|---|
| 参数组: | System Assigned Managed Identity Arguments |
数据流终结点的身份验证类型。 注意:如果未指定,身份验证类型由其他身份验证参数确定。
| 属性 | 值 |
|---|---|
| 接受的值: | SystemAssignedManagedIdentity, UserAssignedManagedIdentity |
用户分配标识的客户端 ID。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
批处理延迟(以毫秒为单位)。 最小值:0,最大值:65535。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | 60 |
批中的最大消息数。 最小值:0,最大值:4294967295。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | 100000 |
资源的资源标识符(应用程序 ID URI)带有 .default 后缀。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
显示生成的资源配置,而不是使用它调用 API。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
用户分配标识的租户 ID。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
只显示错误,取消显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az iot ops dataflow endpoint create fabric-realtime
创建或替换 Microsoft Fabric Real-Time Intelligence 数据流终结点。
有关 Microsoft Fabric Real-Time Intelligence 数据流终结点的详细信息,请参阅 https://aka.ms/aio-fabric-real-time。
az iot ops dataflow endpoint create fabric-realtime --host
--instance
--name
--resource-group
[--acks {All, One, Zero}]
[--aud --audience]
[--auth-type {Sasl, SystemAssignedManagedIdentity, UserAssignedManagedIdentity}]
[--cea --cloud-event-attribute {CreateOrRemap, Propagate}]
[--cid --client-id]
[--cm --config-map-ref]
[--compression {Gzip, Lz4, None, Snappy}]
[--db --disable-batching {false, true}]
[--dbpc --disable-broker-props-copy {false, true}]
[--disable-tls {false, true}]
[--gid --group-id]
[--latency]
[--max-bytes --mb]
[--mc --message-count]
[--partition-strategy --ps {Default, Property, Static, Topic}]
[--sasl-type {Plain, ScramSha256, ScramSha512}]
[--scope]
[--secret-name]
[--show-config {false, true}]
[--tenant-id --tid]
示例
使用最小输入创建或替换数据流终结点资源。
az iot ops dataflow endpoint create fabric-realtime --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --host "fabricrealtime.servicebus.windows.net:9093"
使用 SASL 身份验证方法创建或替换数据流终结点资源。
az iot ops dataflow endpoint create fabric-realtime --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --host "fabricrealtime.servicebus.windows.net:9093" --sasl-type ScramSha256 --secret-name mysecret
显示用于创建数据流终结点资源的配置。
az iot ops dataflow endpoint create fabric-realtime --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --host "fabricrealtime.servicebus.windows.net:9093" --acks One --compression Gzip --group-id mygroupid --partition-strategy Static --max-bytes 200000 --cloud-event-attribute CreateOrRemap --disable-tls --show-config
必需参数
Fabric 实时主机是“Bootstrap 服务器”值。 可以在事件流目标 -- “SAS 密钥身份验证”部分找到。 以 *.servicebus.windows.net:9093 的形式。
IoT 操作实例名称。
数据流终结点名称。
资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
Kafka 中转站的确认级别,以确保生成者发送的消息已成功写入主题,并在 Kafka 群集中复制。
| 属性 | 值 |
|---|---|
| 默认值: | All |
| 接受的值: | All, One, Zero |
要对其进行身份验证的服务受众。
| 属性 | 值 |
|---|---|
| 参数组: | System Assigned Managed Identity Arguments |
数据流终结点的身份验证类型。 注意:如果未指定,身份验证类型由其他身份验证参数确定。
| 属性 | 值 |
|---|---|
| 接受的值: | Sasl, SystemAssignedManagedIdentity, UserAssignedManagedIdentity |
CloudEvent 设置类型,用于将事件映射到云。 不同的设置需要不同的消息格式。
| 属性 | 值 |
|---|---|
| 参数组: | Cloud Event Arguments |
| 默认值: | Propagate |
| 接受的值: | CreateOrRemap, Propagate |
用户分配标识的客户端 ID。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
Kafka/MQTT 终结点的受信任 CA 证书的配置映射参考。 注意:此 ConfigMap 应包含 PEM 格式的 CA 证书。 ConfigMap 必须与 Kafka/MQTT 数据流资源位于同一命名空间中。
| 属性 | 值 |
|---|---|
| 参数组: | Transport Layer Security (TLS) Arguments |
发送到 Kafka 主题的消息的压缩类型。
| 属性 | 值 |
|---|---|
| 默认值: | None |
| 接受的值: | Gzip, Lz4, None, Snappy |
禁用批处理。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | False |
| 接受的值: | false, true |
禁用 MQTT 代理属性复制到 Kafka 用户标头。
| 属性 | 值 |
|---|---|
| 默认值: | False |
| 接受的值: | false, true |
数据流使用与 Kafka/MQTT 中转站的不安全连接。
| 属性 | 值 |
|---|---|
| 参数组: | Transport Layer Security (TLS) Arguments |
| 默认值: | False |
| 接受的值: | false, true |
数据流用于从 Kafka 主题读取消息的使用者组的 ID。
批处理延迟(以毫秒为单位)。 最小值:0,最大值:65535。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | 5 |
批中的最大字节数。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | 1000000 |
批中的最大消息数。 最小值:0,最大值:4294967295。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | 100000 |
分区处理策略可控制在将消息发送到 Kafka 主题时如何将其分配给 Kafka 分区。
| 属性 | 值 |
|---|---|
| 默认值: | Default |
| 接受的值: | Default, Property, Static, Topic |
SASL 身份验证的类型。
| 属性 | 值 |
|---|---|
| 参数组: | SASL Authentication Arguments |
| 接受的值: | Plain, ScramSha256, ScramSha512 |
资源的资源标识符(应用程序 ID URI)带有 .default 后缀。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
包含连接字符串-主键值的 kubernetes 机密的名称。 可以在事件流目标 -- “SAS 密钥身份验证”部分找到。 注意:机密必须与 Kafka 数据流终结点位于同一命名空间中。 有关机密格式的详细信息,请参阅命令说明中的链接。
| 属性 | 值 |
|---|---|
| 参数组: | SASL Authentication Arguments |
显示生成的资源配置,而不是使用它调用 API。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
用户分配标识的租户 ID。
| 属性 | 值 |
|---|---|
| 参数组: | User Assigned Managed Identity Arguments |
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
只显示错误,取消显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az iot ops dataflow endpoint create local-mqtt
创建或替换 Azure IoT作本地 MQTT 数据流终结点。
有关 Azure IoT作本地 MQTT 数据流终结点的详细信息,请参阅 https://aka.ms/local-mqtt-broker。
az iot ops dataflow endpoint create local-mqtt --hostname
--instance
--name
--port
--resource-group
[--aud --audience]
[--auth-type {ServiceAccountToken, X509Certificate}]
[--cea --cloud-event-attribute {CreateOrRemap, Propagate}]
[--client-id-prefix]
[--cm --config-map-ref]
[--disable-tls {false, true}]
[--ka --keep-alive]
[--max-inflight-msg --mim]
[--no-auth {false, true}]
[--protocol {Mqtt, WebSockets}]
[--qos]
[--retain {Keep, Never}]
[--secret-name]
[--session-expiry]
[--show-config {false, true}]
示例
使用最小输入创建或替换数据流终结点资源。
az iot ops dataflow endpoint create local-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname aio-broker --port 1883
使用 X509 身份验证方法创建或替换数据流终结点资源。
az iot ops dataflow endpoint create local-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname aio-broker --port 1883 --secret-name mysecret
创建或替换没有身份验证的数据流终结点资源。
az iot ops dataflow endpoint create local-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname aio-broker --port 1883 --no-auth
显示用于创建数据流终结点资源的配置。
az iot ops dataflow endpoint create local-mqtt --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname aio-broker --port 1883 --client-id-prefix myclientprefix --keep-alive 100 --max-inflight-msg 70 --protocol WebSockets --qos 0 --retain Never --show-config
必需参数
本地 MQTT 代理的主机名。
IoT 操作实例名称。
数据流终结点名称。
本地 MQTT 代理的端口号。
资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
Kubernetes 服务帐户令牌(SAT)的受众。
| 属性 | 值 |
|---|---|
| 参数组: | Kubernetes Service Account Token Arguments |
数据流终结点的身份验证类型。 注意:如果未指定,身份验证类型由其他身份验证参数确定。
| 属性 | 值 |
|---|---|
| 接受的值: | ServiceAccountToken, X509Certificate |
CloudEvent 设置类型,用于将事件映射到云。 不同的设置需要不同的消息格式。
| 属性 | 值 |
|---|---|
| 参数组: | Cloud Event Arguments |
| 默认值: | Propagate |
| 接受的值: | CreateOrRemap, Propagate |
MQTT 客户端的客户端 ID 前缀。 注意:在 IoT作部署后更改客户端 ID 前缀可能会导致数据丢失。
Kafka/MQTT 终结点的受信任 CA 证书的配置映射参考。 注意:此 ConfigMap 应包含 PEM 格式的 CA 证书。 ConfigMap 必须与 Kafka/MQTT 数据流资源位于同一命名空间中。
| 属性 | 值 |
|---|---|
| 参数组: | Transport Layer Security (TLS) Arguments |
| 默认值: | azure-iot-operations-aio-ca-trust-bundle |
数据流使用与 Kafka/MQTT 中转站的不安全连接。
| 属性 | 值 |
|---|---|
| 参数组: | Transport Layer Security (TLS) Arguments |
| 默认值: | False |
| 接受的值: | false, true |
将 PINGREQ 消息发送到中转站之前,数据流客户端可以处于空闲状态的最长时间(以秒为单位)。 最小值:0。
| 属性 | 值 |
|---|---|
| 默认值: | 60 |
数据流 MQTT 客户端可以拥有的最大飞行消息数。 最小值:0。
| 属性 | 值 |
|---|---|
| 默认值: | 100 |
没有终结点的身份验证。
| 属性 | 值 |
|---|---|
| 默认值: | False |
| 接受的值: | false, true |
用于客户端连接的协议。
| 属性 | 值 |
|---|---|
| 默认值: | Mqtt |
| 接受的值: | Mqtt, WebSockets |
MQTT 消息的服务质量(QoS)级别。 仅支持 0 或 1。
| 属性 | 值 |
|---|---|
| 默认值: | 1 |
保留设置以指定数据流是否应保留 MQTT 消息上的保留标志。 设置此项可确保远程代理是否保留与本地中转站相同的消息。
| 属性 | 值 |
|---|---|
| 默认值: | Keep |
| 接受的值: | Keep, Never |
Kubernetes 机密的名称,其中包含 X509 客户端证书、对应于客户端证书的私钥,以及客户端证书链的中间证书。 注意:证书和私钥必须采用 PEM 格式,且不受密码保护。
| 属性 | 值 |
|---|---|
| 参数组: | X509 Authentication Arguments |
数据流 MQTT 客户端的会话到期间隔(以秒为单位)。 最小值:0。
| 属性 | 值 |
|---|---|
| 默认值: | 3600 |
显示生成的资源配置,而不是使用它调用 API。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
只显示错误,取消显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az iot ops dataflow endpoint create local-storage
创建或替换本地存储数据流终结点。
有关本地存储数据流终结点的详细信息,请参阅 https://aka.ms/local-storage-endpoint。
az iot ops dataflow endpoint create local-storage --instance
--name
--pvc-ref
--resource-group
[--show-config {false, true}]
示例
使用最小输入创建或替换数据流终结点资源。
az iot ops dataflow endpoint create local-storage --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --pvc-ref mypvc
显示用于创建数据流终结点资源的配置。
az iot ops dataflow endpoint create local-storage --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --pvc-ref mypvc --show-config
必需参数
IoT 操作实例名称。
数据流终结点名称。
要用于本地存储的 PersistentVolumeClaim (PVC) 的名称。 注意:PVC 必须与数据流终结点位于同一命名空间中。
资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
显示生成的资源配置,而不是使用它调用 API。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
只显示错误,取消显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
az iot ops dataflow endpoint create otel
创建或替换 OpenTelemetry 数据流终结点。
有关 OpenTelemetry 数据流终结点的详细信息,请参阅 https://aka.ms/opentelemetry-endpoint。
az iot ops dataflow endpoint create otel --hostname
--instance
--name
--port
--resource-group
[--aud --audience]
[--auth-type {ServiceAccountToken, X509Certificate}]
[--cm --config-map-ref]
[--disable-tls {false, true}]
[--latency]
[--mc --message-count]
[--no-auth {false, true}]
[--secret-name]
[--show-config {false, true}]
示例
使用最小输入创建或替换数据流终结点资源。
az iot ops dataflow endpoint create otel --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --name myendpoint --hostname https://otel-collector.monitoring.svc.cluster.local --port 4317 --no-auth
显示用于创建数据流终结点资源的配置。
az iot ops dataflow endpoint create otel --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname https://otel-collector.monitoring.svc.cluster.local --port 4317 --no-auth --show-config
使用 X509 身份验证方法创建或替换数据流终结点资源。
az iot ops dataflow endpoint create otel --name myendpoint --instance mycluster-ops-instance --resource-group myresourcegroup --hostname https://otel-collector.monitoring.svc.cluster.local --port 4317 --secret-name mysecret
必需参数
打开的遥测设置的主机名。
IoT 操作实例名称。
数据流终结点名称。
打开的遥测设置的端口号。
资源组的名称。 可以使用 az configure --defaults group=<name>配置默认组。
可选参数
以下参数是可选的,但根据上下文,命令可能需要一个或多个参数才能成功执行。
要对其进行身份验证的服务受众。
| 属性 | 值 |
|---|---|
| 参数组: | System Assigned Managed Identity Arguments |
数据流终结点的身份验证类型。 注意:如果未指定,身份验证类型由其他身份验证参数确定。
| 属性 | 值 |
|---|---|
| 接受的值: | ServiceAccountToken, X509Certificate |
Kafka/MQTT 终结点的受信任 CA 证书的配置映射参考。 注意:此 ConfigMap 应包含 PEM 格式的 CA 证书。 ConfigMap 必须与 Kafka/MQTT 数据流资源位于同一命名空间中。
| 属性 | 值 |
|---|---|
| 参数组: | Transport Layer Security (TLS) Arguments |
数据流使用与 Kafka/MQTT 中转站的不安全连接。
| 属性 | 值 |
|---|---|
| 参数组: | Transport Layer Security (TLS) Arguments |
| 默认值: | False |
| 接受的值: | false, true |
批处理延迟(以毫秒为单位)。 最小值:0,最大值:65535。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | 60 |
批中的最大消息数。 最小值:0,最大值:4294967295。
| 属性 | 值 |
|---|---|
| 参数组: | Batching Configuration Arguments |
| 默认值: | 100000 |
没有终结点的身份验证。
| 属性 | 值 |
|---|---|
| 默认值: | False |
| 接受的值: | false, true |
Kubernetes 机密的名称,其中包含 X509 客户端证书、对应于客户端证书的私钥,以及客户端证书链的中间证书。 注意:证书和私钥必须采用 PEM 格式,且不受密码保护。
| 属性 | 值 |
|---|---|
| 参数组: | X509 Authentication Arguments |
显示生成的资源配置,而不是使用它调用 API。
| 属性 | 值 |
|---|---|
| 接受的值: | false, true |
全局参数
提高日志记录详细程度以显示所有调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |
显示此帮助消息并退出。
只显示错误,取消显示警告。
| 属性 | 值 |
|---|---|
| 默认值: | False |
输出格式。
| 属性 | 值 |
|---|---|
| 默认值: | json |
| 接受的值: | json, jsonc, none, table, tsv, yaml, yamlc |
JMESPath 查询字符串。 有关更多信息和示例,请参阅 http://jmespath.org/。
订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。
增加日志记录详细程度。 使用 --debug 获取完整的调试日志。
| 属性 | 值 |
|---|---|
| 默认值: | False |