共用方式為


az iot ops asset event

注意

此參考是 Azure CLI 的 azure-iot-ops 擴充功能的一部分(2.53.0 版或更高版本)。 擴充功能會在您第一次執行 az iot ops asset event 命令時自動安裝。 深入了解擴充功能。

管理資產中的事件。

命令

名稱 Description 類型 狀態
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 event add

將事件新增至資產。

az iot ops asset event add --asset
                           --en
                           --resource-group
                           [--name]
                           [--observability-mode]
                           [--qs]
                           [--replace {false, true}]
                           [--sampling-interval]

範例

將事件新增至資產。

az iot ops asset event add --asset myasset -g myresourcegroup --event-notifier eventId --name eventName

使用事件名稱、可檢視模式、自定義佇列大小和自定義取樣間隔,將事件新增至資產。

az iot ops asset event add --asset MyAsset -g MyRG --event-notifier eventId --name eventName --observability-mode log --queue-size 2 --sampling-interval 500

必要參數

--asset -a

資產名稱。

--en --event-notifier

事件通知器。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--name -n

事件名稱。

--observability-mode --om

可檢視模式。 必須是 none 或log。

--qs --queue-size

自定義佇列大小。

--replace

如果已有同名的另一個事件,請取代 事件。

接受的值: false, true
--sampling-interval --si

自定義取樣間隔(以毫秒為單位)。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az iot ops asset event export

匯出資產中的事件。

檔名將會是 {asset_name}_events。{file_type}。

az iot ops asset event export --asset
                              --resource-group
                              [--format {csv, json, yaml}]
                              [--od]
                              [--replace {false, true}]

範例

以 JSON 格式匯出資產中的所有事件。

az iot ops asset event export --asset myasset -g myresourcegroup

以 CSV 格式匯出資產中的所有事件,該輸出目錄中可上傳至數位作業體驗。

az iot ops asset event export --asset myasset -g myresourcegroup --format csv --output-dir myAssetFiles

以 YAML 格式匯出資產中的所有事件。 如果已有檔案,請取代檔案。

az iot ops asset event export --asset myasset -g myresourcegroup --format yaml --replace

必要參數

--asset -a

資產名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--format -f

檔案格式。

接受的值: csv, json, yaml
預設值: json
--od --output-dir

匯出檔案的輸出目錄。

--replace

如果存在,請取代本機檔案。

接受的值: false, true
預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az iot ops asset event import

匯入資產中的事件。

如需檔格式的範例,請參閱 aka.ms/aziotops-assets。

az iot ops asset event import --asset
                              --if
                              --resource-group
                              [--replace {false, true}]

範例

從檔案匯入所有事件。 這些事件會附加至資產的目前事件。 將忽略具有重複名稱的事件。

az iot ops asset event import --asset myasset -g myresourcegroup --input-file myasset_events.yaml

從檔案匯入所有事件。 這些事件會附加資產的目前事件。 具有重複名稱的事件將會取代目前的資產事件。

az iot ops asset event import --asset myasset -g myresourcegroup --input-file myasset_events.csv --replace

必要參數

--asset -a

資產名稱。

--if --input-file

包含事件的檔案檔案路徑。 支援下列檔類型:json、csv、yaml。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

選擇性參數

--replace

將重複的資產事件取代為檔案中的事件。 如果為 false,則會忽略檔案事件。 重複的資產事件將由名稱決定。

接受的值: false, true
預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az iot ops asset event list

列出資產中的事件。

az iot ops asset event list --asset
                            --resource-group

範例

列出資產中的所有事件。

az iot ops asset event list --asset myasset -g myresourcegroup

必要參數

--asset -a

資產名稱。

--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az iot ops asset event remove

拿掉資產中的事件。

az iot ops asset event remove --asset
                              --name
                              --resource-group

範例

透過事件名稱從資產中移除事件。

az iot ops asset event remove --asset myasset -g myresourcegroup --name myevent

必要參數

--asset -a

資產名稱。

--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
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 az account set -s NAME_OR_ID 設定預設訂用帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。