共用方式為

az providerhub notification-registration

  • 參考

注意

此參考是 Azure CLI 的 providerhub 延伸模組的一部分（2.57.0 版或更高版本）。 擴充功能會在您第一次執行 az providerhub notification-registration 命令時自動安裝。 深入了解擴充功能。

使用 providerhub 管理通知註冊。

命令

名稱 Description 類型 狀態
az providerhub notification-registration create

建立通知註冊。

 副檔名 GA
az providerhub notification-registration delete

刪除通知註冊。

 副檔名 GA
az providerhub notification-registration list

列出指定提供者的通知註冊清單。

 副檔名 GA
az providerhub notification-registration show

取得通知註冊詳細數據。

 副檔名 GA
az providerhub notification-registration update

更新通知註冊。

 副檔名 GA

az providerhub notification-registration create

建立通知註冊。

az providerhub notification-registration create --name
                                                --provider-namespace
                                                [--included-events]
                                                [--message-scope {NotSpecified, RegisteredSubscriptions}]
                                                [--notification-endpoints]
                                                [--notification-mode {EventHub, NotSpecified, WebHook}]

範例

notification-registration create

az providerhub notification-registration create --name "{notificationRegistration}" --included-events "*/write" "Microsoft.Contoso/employees/delete" --message-scope "RegisteredSubscriptions" --notification-endpoints [{notification-destination:/subscriptions/ac6bcfb5-3dc1-491f-95a6-646b89bf3e88/resourceGroups/mgmtexp-eastus/providers/Microsoft.EventHub/namespaces/unitedstates-mgmtexpint/eventhubs/armlinkednotifications,locations:[EastUS]}] --notification-mode "EventHub" --provider-namespace "{providerNamespace}"

必要參數

--name --notification-registration-name -n

通知註冊。

--provider-namespace

在 ProviderHub 內裝載的資源提供者名稱。

選擇性參數

--included-events

這些是 RP 應傳送訊息的事件。 訊息格式為 {RP Namespace}/{ResourceType}/{action}。 可用的動作包括：寫入、刪除和移動/動作。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--message-scope

限制傳送至 RP 的訊息。 默認值為 RegisteredSubscriptions。 可用的值為 Global （Azure 中的所有訊息） 和 RegisteredSubscriptions （只有由 RP 註冊的訂用帳戶中的訊息）。

接受的值: NotSpecified, RegisteredSubscriptions
--notification-endpoints

這些是通知訊息的位置。 通知會傳送至事件資源位置的區域（例如，美國東部的 VM 會將訊息傳送至美國東部的指定端點）。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--notification-mode

決定通知如何傳送至 RP。 這兩種可用的模式為 EventHub 和 Webhook。

接受的值: EventHub, NotSpecified, WebHook
全域參數
--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 providerhub notification-registration delete

刪除通知註冊。

az providerhub notification-registration delete [--ids]
                                                [--name]
                                                [--provider-namespace]
                                                [--subscription]
                                                [--yes]

範例

notification-registration delete

az providerhub notification-registration delete -y --name "{notificationRegistration}" --provider-namespace "{providerNamespace}"

選擇性參數

--ids

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

--name --notification-registration-name -n

通知註冊。

--provider-namespace

在 ProviderHub 內裝載的資源提供者名稱。

--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 providerhub notification-registration list

列出指定提供者的通知註冊清單。

az providerhub notification-registration list --provider-namespace
                                              [--max-items]
                                              [--next-token]

範例

notification-registration list

az providerhub notification-registration list --provider-namespace "{providerNamespace}"

必要參數

--provider-namespace

在 ProviderHub 內裝載的資源提供者名稱。

選擇性參數

--max-items

命令輸出中要傳回的項目總數。 如果可用的專案總數超過指定的值，則會在命令的輸出中提供令牌。 若要繼續分頁，請在後續命令的自變數中 --next-token 提供令牌值。

--next-token

標記，指定要開始分頁的位置。 這是先前截斷回應中的令牌值。

全域參數
--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 providerhub notification-registration show

取得通知註冊詳細數據。

az providerhub notification-registration show [--ids]
                                              [--name]
                                              [--provider-namespace]
                                              [--subscription]

範例

notification-registration show

az providerhub notification-registration show --name "{notificationRegistration}" --provider-namespace "{providerNamespace}"

選擇性參數

--ids

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

--name --notification-registration-name -n

通知註冊。

--provider-namespace

在 ProviderHub 內裝載的資源提供者名稱。

--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 providerhub notification-registration update

更新通知註冊。

az providerhub notification-registration update [--add]
                                                [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                                [--ids]
                                                [--included-events]
                                                [--message-scope {NotSpecified, RegisteredSubscriptions}]
                                                [--name]
                                                [--notification-endpoints]
                                                [--notification-mode {EventHub, NotSpecified, WebHook}]
                                                [--provider-namespace]
                                                [--remove]
                                                [--set]
                                                [--subscription]

範例

notification-registration update

az providerhub notification-registration update --name "{notificationRegistration}" --included-events "*/write" "Microsoft.Contoso/employees/delete" --message-scope "RegisteredSubscriptions" --notification-endpoints [{notification-destination:/subscriptions/ac6bcfb5-3dc1-491f-95a6-646b89bf3e88/resourceGroups/mgmtexp-eastus/providers/Microsoft.EventHub/namespaces/unitedstates-mgmtexpint/eventhubs/armlinkednotifications,locations:[EastUS]}] --notification-mode "EventHub" --provider-namespace "{providerNamespace}"

選擇性參數

--add

藉由指定路徑和索引鍵值組，將物件加入物件清單。 範例：--add property.listProperty <key=value、string 或 JSON 字串>。

--force-string

使用 'set' 或 'add' 時，請保留字串常值，而不是嘗試轉換成 JSON。

接受的值: 0, 1, f, false, n, no, t, true, y, yes
--ids

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

--included-events

這些是 RP 應傳送訊息的事件。 訊息格式為 {RP Namespace}/{ResourceType}/{action}。 可用的動作包括：寫入、刪除和移動/動作。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--message-scope

限制傳送至 RP 的訊息。 默認值為 RegisteredSubscriptions。 可用的值為 Global （Azure 中的所有訊息） 和 RegisteredSubscriptions （只有由 RP 註冊的訂用帳戶中的訊息）。

接受的值: NotSpecified, RegisteredSubscriptions
--name --notification-registration-name -n

通知註冊。

--notification-endpoints

這些是通知訊息的位置。 通知會傳送至事件資源位置的區域（例如，美國東部的 VM 會將訊息傳送至美國東部的指定端點）。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--notification-mode

決定通知如何傳送至 RP。 這兩種可用的模式為 EventHub 和 Webhook。

接受的值: EventHub, NotSpecified, WebHook
--provider-namespace

在 ProviderHub 內裝載的資源提供者名稱。

--remove

從清單中移除屬性或專案。 範例：--remove property.list OR --remove 屬性ToRemove。

--set

指定要設定的屬性路徑和值，以更新物件。 範例：--set property1.property2=。

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