az providerhub custom-rollout

  • 參考

注意

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

使用 providerhub 管理自定義推出。

命令

名稱 Description 類型 狀態
az providerhub custom-rollout create

建立首度發行詳細數據。

 副檔名 GA
az providerhub custom-rollout delete

刪除自訂推出資源。 自定義首度發行必須處於終端機狀態。

 副檔名 GA
az providerhub custom-rollout list

列出指定提供者的自定義推出清單。

 副檔名 GA
az providerhub custom-rollout show

取得自訂推出詳細數據。

 副檔名 GA
az providerhub custom-rollout stop

如果進行中，會停止或取消自定義推出。

 副檔名 GA
az providerhub custom-rollout update

更新推出詳細數據。

 副檔名 GA
az providerhub custom-rollout wait

將 CLI 置於等候狀態，直到符合條件為止。

 副檔名 GA

az providerhub custom-rollout create

建立首度發行詳細數據。

az providerhub custom-rollout create --name
                                     --provider-namespace
                                     [--auto-provision-config]
                                     [--canary]
                                     [--manifest-checkin-spec]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--provider-registration]
                                     [--refresh-sub-reg {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--release-scopes]
                                     [--resource-type-registrations]
                                     [--skip-release-scope-validation {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--status]

範例

custom-rollout create

az providerhub custom-rollout create --provider-namespace "{providerNamespace}" --rollout-name "{customRolloutName}" --canary region="EastUS2EUAP" region="centraluseuap"

必要參數

--name --rollout-name -n

首度發行名稱。

--provider-namespace

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

選擇性參數

--auto-provision-config

支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--canary

要套用指令清單的 Canary 區域。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--manifest-checkin-spec --manifest-checkin-specification

指令清單簽入規格。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--no-wait

請勿等候長時間執行的作業完成。

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

支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--refresh-sub-reg --refresh-subscription-registration

判斷是否應該重新整理訂用帳戶註冊。

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

支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--resource-type-registrations --rt-regs

資源類型註冊。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--skip-release-scope-validation --skip-validation

判斷是否應該略過發行範圍驗證。

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

支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

全域參數
--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 custom-rollout delete

刪除自訂推出資源。 自定義首度發行必須處於終端機狀態。

az providerhub custom-rollout delete [--ids]
                                     [--name]
                                     [--provider-namespace]
                                     [--subscription]
                                     [--yes]

範例

custom-rollout delete

az providerhub custom-rollout delete --provider-namespace "{providerNamespace}" --rollout-name "{customRolloutName}"

選擇性參數

--ids

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

--name --rollout-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 custom-rollout list

列出指定提供者的自定義推出清單。

az providerhub custom-rollout list --provider-namespace
                                   [--max-items]
                                   [--next-token]

範例

custom-rollout list

az providerhub custom-rollout 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 custom-rollout show

取得自訂推出詳細數據。

az providerhub custom-rollout show [--ids]
                                   [--name]
                                   [--provider-namespace]
                                   [--subscription]

範例

custom-rollout show

az providerhub custom-rollout show --provider-namespace "{providerNamespace}" --rollout-name "{customRolloutName}"

選擇性參數

--ids

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

--name --rollout-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 custom-rollout stop

如果進行中，會停止或取消自定義推出。

az providerhub custom-rollout stop [--ids]
                                   [--provider-namespace]
                                   [--rollout-name]
                                   [--subscription]

範例

custom-rollout stop

az providerhub custom-rollout stop --provider-namespace "{providerNamespace}" --rollout-name "{customRolloutName}"

選擇性參數

--ids

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

--provider-namespace

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

--rollout-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 providerhub custom-rollout update

更新推出詳細數據。

az providerhub custom-rollout update [--add]
                                     [--auto-provision-config]
                                     [--canary]
                                     [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--ids]
                                     [--manifest-checkin-spec]
                                     [--name]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--provider-namespace]
                                     [--provider-registration]
                                     [--refresh-sub-reg {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--release-scopes]
                                     [--remove]
                                     [--resource-type-registrations]
                                     [--set]
                                     [--skip-release-scope-validation {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--status]
                                     [--subscription]

範例

custom-rollout update

az providerhub custom-rollout update --provider-namespace "{providerNamespace}" --rollout-name "{customRolloutName}" --canary region="EastUS2EUAP" region="centraluseuap"

選擇性參數

--add

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

--auto-provision-config

支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--canary

要套用指令清單的 Canary 區域。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--force-string

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

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

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

--manifest-checkin-spec --manifest-checkin-specification

指令清單簽入規格。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--name --rollout-name -n

首度發行名稱。

--no-wait

請勿等候長時間執行的作業完成。

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

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

--provider-registration

支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--refresh-sub-reg --refresh-subscription-registration

判斷是否應該重新整理訂用帳戶註冊。

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

支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--remove

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

--resource-type-registrations --rt-regs

資源類型註冊。 支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--set

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

--skip-release-scope-validation --skip-validation

判斷是否應該略過發行範圍驗證。

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

支援速記語法、json-file 和 yaml-file。 請嘗試 “？？” 以顯示更多。

--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 custom-rollout wait

將 CLI 置於等候狀態，直到符合條件為止。

az providerhub custom-rollout wait [--created]
                                   [--custom]
                                   [--deleted]
                                   [--exists]
                                   [--ids]
                                   [--interval]
                                   [--name]
                                   [--provider-namespace]
                                   [--subscription]
                                   [--timeout]
                                   [--updated]

選擇性參數

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False
--custom

等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到刪除為止。

預設值: False
--exists

等候資源存在。

預設值: False
--ids

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

--interval

輪詢間隔以秒為單位。

預設值: 30
--name --rollout-name -n

首度發行名稱。

--provider-namespace

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

--subscription

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

--timeout

以秒為單位的等候上限。

預設值: 3600
--updated

等到 provisioningState 更新為 'Succeeded'。

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