az eventgrid system-topic

注意

此命令群組具有 Azure CLI 和至少一個擴充功能中定義的命令。 安裝每個擴充功能以受益於其擴充功能。 深入了解擴充功能。

管理系統主題。

命令

名稱	Description	類型	狀態
az eventgrid system-topic create	建立系統主題。	核心	GA
az eventgrid system-topic create (eventgrid 擴充功能)	建立系統主題。	副檔名	預覽版
az eventgrid system-topic delete	刪除系統主題。	核心	GA
az eventgrid system-topic delete (eventgrid 擴充功能)	刪除系統主題。	副檔名	預覽版
az eventgrid system-topic event-subscription	管理系統主題的事件訂閱。	核心和擴充功能	GA
az eventgrid system-topic event-subscription create	建立系統主題的新事件訂用帳戶。	核心	GA
az eventgrid system-topic event-subscription create (eventgrid 擴充功能)	建立系統主題的新事件訂用帳戶。	副檔名	預覽版
az eventgrid system-topic event-subscription delete	刪除系統主題的事件訂閱。	核心	GA
az eventgrid system-topic event-subscription delete (eventgrid 擴充功能)	刪除系統主題的事件訂閱。	副檔名	預覽版
az eventgrid system-topic event-subscription list	列出特定系統主題的事件訂閱。	核心	GA
az eventgrid system-topic event-subscription list (eventgrid 擴充功能)	列出特定系統主題的事件訂閱。	副檔名	預覽版
az eventgrid system-topic event-subscription show	取得系統主題的事件訂閱詳細數據。	核心	GA
az eventgrid system-topic event-subscription show (eventgrid 擴充功能)	取得系統主題的事件訂閱詳細數據。	副檔名	預覽版
az eventgrid system-topic event-subscription update	更新系統主題的事件訂閱。	核心	GA
az eventgrid system-topic event-subscription update (eventgrid 擴充功能)	更新系統主題的事件訂閱。	副檔名	預覽版
az eventgrid system-topic list	列出可用的系統主題。	核心	GA
az eventgrid system-topic list (eventgrid 擴充功能)	列出可用的系統主題。	副檔名	預覽版
az eventgrid system-topic show	取得系統主題的詳細數據。	核心	GA
az eventgrid system-topic show (eventgrid 擴充功能)	取得系統主題的詳細數據。	副檔名	預覽版
az eventgrid system-topic update	更新系統主題。	核心	GA
az eventgrid system-topic update (eventgrid 擴充功能)	更新系統主題。	副檔名	預覽版

az eventgrid system-topic create

建立系統主題。

az eventgrid system-topic create --name
                                 --resource-group
                                 --source
                                 --topic-type
                                 [--identity {noidentity, systemassigned}]
                                 [--location]
                                 [--mi-system-assigned]
                                 [--mi-user-assigned]
                                 [--tags]

範例

建立記憶體帳戶來源的新系統主題。

az eventgrid system-topic create -g rg1 --name systemtopic1 --location westus2 --topic-type microsoft.storage.storageaccounts --source /subscriptions/1b3b4501-23b9-4790-c31b-ddbd88d72123/resourceGroups/rg2/providers/Microsoft.Storage/storageAccounts/stgaccountname

使用 systemassigned 身分識別建立新的系統主題

az eventgrid system-topic create -g rg1 --name systemtopic1 --location westus2 --topic-type microsoft.storage.storageaccounts --source /subscriptions/1b3b4501-23b9-4790-c31b-ddbd88d72123/resourceGroups/rg2/providers/Microsoft.Storage/storageAccounts/stgaccountname --identity systemassigned

必要參數

--name -n

系統主題的名稱。

--resource-group -g

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

--source

主題的 ARM 標識符，例如 /subscriptions/{SubId}/resourceGroups/{RgName}/providers/Microsoft。儲存體/storageAccounts/{AccountName}。

--topic-type

主題類型的名稱。

選擇性參數

--identity

預覽 已被取代

自變數 'identity' 已被取代，未來版本將會移除。

資源的受控識別類型。 未來將會被 --mi-system-assigned-identity 取代。

接受的值: noidentity, systemassigned

--location -l

位置。 來自的值： az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。

--mi-system-assigned

此參數的存在表示將使用 SystemAssigned 受控識別。

--mi-user-assigned

預覽

當 identityType 是使用者或混合時，新增使用者指派的身分識別。 此屬性適用於所有目的地類型，但 儲存體 Queue 除外。 您可以使用多個 --mi-user-assigned 自變數來指定多個屬性。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

全域參數

--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 eventgrid system-topic create (eventgrid 擴充功能)

預覽

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

建立系統主題。

az eventgrid system-topic create --location
                                 --name
                                 --resource-group
                                 --source
                                 --topic-type
                                 [--tags]

範例

建立記憶體帳戶來源的新系統主題。

az eventgrid system-topic create -g rg1 --name systemtopic1 --location westus2 --topic-type microsoft.storage.storageaccounts --source /subscriptions/1b3b4501-23b9-4790-c31b-ddbd88d72123/resourceGroups/rg2/providers/Microsoft.Storage/storageAccounts/stgaccountname

必要參數

--location -l

位置。 來自的值： az account list-locations。 您可以使用 az configure --defaults location=<location> 設定預設位置。

--name -n

系統主題的名稱。

--resource-group -g

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

--source

主題的 ARM 標識符，例如 /subscriptions/{SubId}/resourceGroups/{RgName}/providers/Microsoft。儲存體/storageAccounts/{AccountName}。

--topic-type

主題類型的名稱。

選擇性參數

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

全域參數

--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 eventgrid system-topic delete

刪除系統主題。

az eventgrid system-topic delete [--ids]
                                 [--name]
                                 [--resource-group]
                                 [--subscription]
                                 [--yes]

範例

刪除特定的系統主題。

az eventgrid system-topic delete -g rg1 --name systemtopic1

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

系統主題的名稱。

--resource-group -g

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

--subscription

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

--yes -y

不提示確認。

預設值: 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 eventgrid system-topic delete (eventgrid 擴充功能)

預覽

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

刪除系統主題。

az eventgrid system-topic delete [--ids]
                                 [--name]
                                 [--resource-group]
                                 [--subscription]

範例

刪除特定的系統主題。

az eventgrid system-topic delete -g rg1 --name systemtopic1

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

系統主題的名稱。

--resource-group -g

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

--subscription

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

全域參數

--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 eventgrid system-topic list

列出可用的系統主題。

az eventgrid system-topic list [--odata-query]
                               [--resource-group]

範例

列出目前 Azure 訂用帳戶中的所有系統主題。

az eventgrid system-topic list

列出資源群組中的所有系統主題。

az eventgrid system-topic list -g rg1

列出資源群組中名稱包含模式 「XYZ」 的所有系統主題

az eventgrid system-topic list -g rg1 --odata-query "Contains(name, 'XYZ')"

列出資源群組中的所有系統主題，但名稱為 「name1」 的系統主題除外

az eventgrid system-topic list -g rg1 --odata-query "NOT (name eq 'name1')"

選擇性參數

--odata-query

用於篩選清單結果的 OData 查詢。 [名稱] 屬性目前只允許篩選。 支持的作業包括：CONTAINS、eq （等於）、ne （不等於）、AND、OR 和 NOT。

--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 eventgrid system-topic list (eventgrid 擴充功能)

預覽

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

列出可用的系統主題。

az eventgrid system-topic list [--odata-query]
                               [--resource-group]

範例

列出目前 Azure 訂用帳戶中的所有系統主題。

az eventgrid system-topic list

列出資源群組中的所有系統主題。

az eventgrid system-topic list -g rg1

列出資源群組中名稱包含模式 「XYZ」 的所有系統主題

az eventgrid system-topic list -g rg1 --odata-query "Contains(name, 'XYZ')"

列出資源群組中的所有系統主題，但名稱為 「name1」 的系統主題除外

az eventgrid system-topic list -g rg1 --odata-query "NOT (name eq 'name1')"

選擇性參數

--odata-query

用來使用 OData 語法篩選結果的查詢。

--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 eventgrid system-topic show

取得系統主題的詳細數據。

az eventgrid system-topic show [--ids]
                               [--name]
                               [--resource-group]
                               [--subscription]

範例

顯示系統主題的詳細數據。

az eventgrid system-topic show -g rg1 -n systemtopic1

根據資源識別碼顯示系統主題的詳細數據。

az eventgrid system-topic show --ids /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/systemtopics/systemtopic1

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

系統主題的名稱。

--resource-group -g

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

--subscription

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

全域參數

--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 eventgrid system-topic show (eventgrid 擴充功能)

預覽

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

取得系統主題的詳細數據。

az eventgrid system-topic show [--ids]
                               [--name]
                               [--resource-group]
                               [--subscription]

範例

顯示系統主題的詳細數據。

az eventgrid system-topic show -g rg1 -n systemtopic1

根據資源識別碼顯示系統主題的詳細數據。

az eventgrid system-topic show --ids /subscriptions/{SubID}/resourceGroups/{RG}/providers/Microsoft.EventGrid/systemtopics/systemtopic1

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

系統主題的名稱。

--resource-group -g

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

--subscription

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

全域參數

--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 eventgrid system-topic update

更新系統主題。

az eventgrid system-topic update [--identity {noidentity, systemassigned}]
                                 [--ids]
                                 [--mi-system-assigned]
                                 [--mi-user-assigned]
                                 [--name]
                                 [--resource-group]
                                 [--subscription]
                                 [--tags]

範例

更新現有系統主題的屬性。

az eventgrid system-topic update -g rg1 --name systemtopic1 --tags Dept=IT

更新現有系統主題的身分識別。

az eventgrid system-topic update -g rg1 --name systemtopic1 --identity systemassigned

選擇性參數

--identity

預覽 已被取代

自變數 'identity' 已被取代，未來版本將會移除。

資源的受控識別類型。 未來將會被 --mi-system-assigned-identity 取代。

接受的值: noidentity, systemassigned

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--mi-system-assigned

此參數的存在表示將使用 SystemAssigned 受控識別。

--mi-user-assigned

預覽

當 identityType 是使用者或混合時，新增使用者指派的身分識別。 此屬性適用於所有目的地類型，但 儲存體 Queue 除外。 您可以使用多個 --mi-user-assigned 自變數來指定多個屬性。

--name -n

系統主題的名稱。

--resource-group -g

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

--subscription

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

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

全域參數

--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 eventgrid system-topic update (eventgrid 擴充功能)

預覽

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

更新系統主題。

az eventgrid system-topic update [--ids]
                                 [--name]
                                 [--resource-group]
                                 [--subscription]
                                 [--tags]

範例

更新現有系統主題的屬性。

az eventgrid system-topic update -g rg1 --name systemtopic1 --tags Dept=IT

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。

--name -n

系統主題的名稱。

--resource-group -g

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

--subscription

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

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「清除現有的標記」。

全域參數

--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 來取得完整偵錯記錄。