共用方式為


az iot ops schema registry

注意

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

命令群組 'iot ops schema' 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

架構登錄管理。

架構登錄是用於管理架構的集中式存放庫。 架構登錄可在邊緣和雲端中啟用架構產生和擷取。 它藉由為架構定義提供單一事實來源,以確保系統之間的一致性和相容性。

命令

名稱 Description 類型 狀態
az iot ops schema registry create

建立架構登錄。

副檔名 預覽​​
az iot ops schema registry delete

刪除目標架構登錄。

副檔名 預覽​​
az iot ops schema registry list

列出資源群組或訂用帳戶中的架構登錄。

副檔名 預覽​​
az iot ops schema registry show

顯示架構登錄的詳細數據。

副檔名 預覽​​

az iot ops schema registry create

預覽

命令群組 'iot ops schema' 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

建立架構登錄。

此作業將會建立已啟用系統受控識別的架構登錄。

然後,它會根據記憶體帳戶容器範圍,將內建的「記憶體 Blob 數據參與者」角色指派給系統身分識別。 如有必要,您可以透過 --custom-role-id 提供自定義角色來改用。

如果指定的記憶體帳戶容器不存在,則會使用預設設定來建立。

如果未註冊,此作業也會註冊 Microsoft.DeviceRegistry 資源提供者。

az iot ops schema registry create --name
                                  --registry-namespace
                                  --resource-group
                                  --sa-resource-id
                                  [--custom-role-id]
                                  [--desc]
                                  [--display-name]
                                  [--location]
                                  [--sa-container]
                                  [--tags]

範例

使用最小輸入建立名為 『myregistry』 的架構登錄。

az iot ops schema registry create -n myregistry -g myresourcegroup --registry-namespace myschemas --sa-resource-id $STORAGE_ACCOUNT_RESOURCE_ID

在 westus2 區域中建立名為 『myregistry』 且具有額外自定義功能的架構登錄。

az iot ops schema registry create -n myregistry -g myresourcegroup --registry-namespace myschemas --sa-resource-id $STORAGE_ACCOUNT_RESOURCE_ID --sa-container myschemacontainer -l westus2 --desc 'Contoso factory X1 schemas' --display-name 'Contoso X1' --tags env=prod

必要參數

--name -n

架構登錄名稱。

--registry-namespace --rn

架構登錄命名空間。 可唯一識別租使用者內的架構登錄。

--resource-group -g

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

--sa-resource-id

要與架構登錄搭配使用的記憶體帳戶資源標識碼。

選擇性參數

--custom-role-id

完整角色定義標識符的格式如下:/subscriptions/{subscriptionId}/providers/Microsoft.Authorization/roleDefinitions/{roleId}。

--desc

架構登錄的描述。

--display-name

架構登錄的顯示名稱。

--location -l

要建立架構登錄的區域。 如果未提供任何位置,則會使用資源群組位置。

--sa-container

將儲存架構的記憶體帳戶容器名稱。

預設值: schemas
--tags

架構登錄標記。 索引鍵/值組中的屬性包,格式如下:a=b c=d。 使用 --tags “” 移除所有標籤。

全域參數
--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 schema registry delete

預覽

命令群組 'iot ops schema' 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

刪除目標架構登錄。

az iot ops schema registry delete --name
                                  [--resource-group]
                                  [--yes {false, true}]

範例

刪除架構登錄 『myregistry』。

az iot ops schema registry delete -n myregistry -g myresourcegroup

必要參數

--name -n

架構登錄名稱。

選擇性參數

--resource-group -g

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

--yes -y

在沒有提示的情況下確認 [y]es。 適用於 CI 和自動化案例。

接受的值: false, true
全域參數
--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 schema registry list

預覽

命令群組 'iot ops schema' 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

列出資源群組或訂用帳戶中的架構登錄。

az iot ops schema registry list [--resource-group]

範例

列出資源群組 『myresourcegroup』 中的架構註冊。

az iot ops schema registry list -g myresourcegroup

列出特定標籤上預設訂用帳戶篩選中的架構註冊。

az iot ops schema registry list --query "[?tags.env == 'prod']"

選擇性參數

--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 schema registry show

預覽

命令群組 'iot ops schema' 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

顯示架構登錄的詳細數據。

az iot ops schema registry show --name
                                --resource-group

範例

顯示目標架構登錄 『myregistry』 的詳細數據。

az iot ops schema registry show --name myregistry -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
預設值: json
--query

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

--subscription

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

--verbose

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