az consumption budget

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

管理 Azure 訂用帳戶的預算。

命令

名稱	Description	類型	狀態
az consumption budget create	建立 Azure 訂用帳戶的預算。	核心	預覽版
az consumption budget create-with-rg	建立作業以建立或更新預算。 更新作業需要強制在要求中設定最新的 eTag。 您可以藉由執行取得作業來取得最新的 eTag。 建立作業不需要 eTag。	核心	預覽版
az consumption budget delete	刪除 Azure 訂用帳戶的預算。	核心	預覽版
az consumption budget delete-with-rg	刪除作業以刪除預算。	核心	預覽版
az consumption budget list	列出 Azure 訂用帳戶的預算。	核心	預覽版
az consumption budget show	顯示 Azure 訂用帳戶的預算。	核心	預覽版
az consumption budget show-with-rg	依預算名稱取得訂用帳戶下資源群組的預算。	核心	預覽版
az consumption budget update	更新作業以建立或更新預算。 更新作業需要強制在要求中設定最新的 eTag。 您可以藉由執行取得作業來取得最新的 eTag。 建立作業不需要 eTag。	核心	預覽版
az consumption budget update-with-rg	更新作業以建立或更新預算。 更新作業需要強制在要求中設定最新的 eTag。 您可以藉由執行取得作業來取得最新的 eTag。 建立作業不需要 eTag。	核心	預覽版

az consumption budget create

預覽

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

建立 Azure 訂用帳戶的預算。

az consumption budget create --amount
                             --budget-name
                             --category {cost, usage}
                             --end-date
                             --start-date
                             --time-grain {annually, monthly, quarterly}
                             [--meter-filter]
                             [--resource-filter]
                             [--resource-group]
                             [--resource-group-filter]

必要參數

--amount

預算金額。

--budget-name

預算的名稱。

--category

預算的類別可以是成本或使用量。

接受的值: cost, usage

--end-date -e

預算時段的結束日期（UTC 的 YYYY-MM-DD）。

--start-date -s

預算時間週期的開始日期（UTC 為 YYYY-MM-DD）。

--time-grain

預算的時間粒紋可以是每月、每季或每年。

接受的值: annually, monthly, quarterly

選擇性參數

--meter-filter

要篩選的計量以空格分隔的清單。 如果類別是使用量，則為必要專案。

--resource-filter

要篩選之資源實例的空間分隔清單。

--resource-group -g

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

--resource-group-filter

要篩選的資源群組空間分隔清單。

全域參數

--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 consumption budget create-with-rg

預覽

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

建立作業以建立或更新預算。 更新作業需要強制在要求中設定最新的 eTag。 您可以藉由執行取得作業來取得最新的 eTag。 建立作業不需要 eTag。

az consumption budget create-with-rg [--amount]
                                     [--budget-name]
                                     [--category {Cost, Usage}]
                                     [--e-tag]
                                     [--filters]
                                     [--ids]
                                     [--notifications]
                                     [--resource-group]
                                     [--subscription]
                                     [--time-grain {Annually, Monthly, Quarterly}]
                                     [--time-period]

選擇性參數

--amount

要與預算一起追蹤的成本總計。

--budget-name --name -n

預算名稱。

--category

預算的類別，無論是預算追蹤成本還是使用量。

接受的值: Cost, Usage

--e-tag

資源的 ETag。 若要處理並行更新案例，此欄位將用來判斷使用者是否要更新最新版本。

--filters

可用來依資源群組、資源或計量來篩選預算。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。

--ids

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

--notifications

與預算相關聯的通知字典。 預算最多可以有五個通知。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。

--resource-group -g

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

--subscription

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

--time-grain

預算涵蓋的時間。 追蹤數量將會根據時間粒紋重設。

接受的值: Annually, Monthly, Quarterly

--time-period

具有預算的開始和結束日期。 開始日期必須是月份的第一個，而且應該小於結束日期。 預算開始日期必須是 2017 年 6 月 1 日或之後。 未來的開始日期不應超過三個月。 應該在時間根期間內選取過去的開始日期。 結束日期沒有任何限制。 支援速記語法、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 consumption budget delete

預覽

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

刪除 Azure 訂用帳戶的預算。

az consumption budget delete --budget-name
                             [--resource-group]

範例

刪除 Azure 訂用帳戶的預算。 （自動產生）

az consumption budget delete --budget-name MyBudget

必要參數

--budget-name

預算的名稱。

選擇性參數

--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 consumption budget delete-with-rg

預覽

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

刪除作業以刪除預算。

az consumption budget delete-with-rg [--budget-name]
                                     [--ids]
                                     [--resource-group]
                                     [--subscription]

選擇性參數

--budget-name --name -n

預算名稱。

--ids

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

--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 consumption budget list

預覽

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

列出 Azure 訂用帳戶的預算。

az consumption budget list [--max-items]
                           [--next-token]
                           [--resource-group]

選擇性參數

--max-items

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

--next-token

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

--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 consumption budget show

預覽

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

顯示 Azure 訂用帳戶的預算。

az consumption budget show --budget-name
                           [--resource-group]

範例

顯示 Azure 訂用帳戶的預算。 （自動產生）

az consumption budget show --budget-name MyBudget

必要參數

--budget-name

預算的名稱。

選擇性參數

--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 consumption budget show-with-rg

預覽

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

依預算名稱取得訂用帳戶下資源群組的預算。

az consumption budget show-with-rg [--budget-name]
                                   [--ids]
                                   [--resource-group]
                                   [--subscription]

選擇性參數

--budget-name --name -n

預算名稱。

--ids

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

--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 consumption budget update

預覽

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

更新作業以建立或更新預算。 更新作業需要強制在要求中設定最新的 eTag。 您可以藉由執行取得作業來取得最新的 eTag。 建立作業不需要 eTag。

az consumption budget update [--add]
                             [--amount]
                             [--budget-name]
                             [--category {Cost, Usage}]
                             [--e-tag]
                             [--filters]
                             [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                             [--ids]
                             [--notifications]
                             [--remove]
                             [--set]
                             [--subscription]
                             [--time-grain {Annually, Monthly, Quarterly}]
                             [--time-period]

選擇性參數

--add

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

--amount

要與預算一起追蹤的成本總計。

--budget-name --name -n

預算名稱。

--category

預算的類別，無論是預算追蹤成本還是使用量。

接受的值: Cost, Usage

--e-tag

資源的 ETag。 若要處理並行更新案例，此欄位將用來判斷使用者是否要更新最新版本。

--filters

可用來依資源群組、資源或計量來篩選預算。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。

--force-string

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

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

--ids

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

--notifications

與預算相關聯的通知字典。 預算最多可以有五個通知。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。

--remove

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

--set

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

--subscription

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

--time-grain

預算涵蓋的時間。 追蹤數量將會根據時間粒紋重設。

接受的值: Annually, Monthly, Quarterly

--time-period

具有預算的開始和結束日期。 開始日期必須是月份的第一個，而且應該小於結束日期。 預算開始日期必須是 2017 年 6 月 1 日或之後。 未來的開始日期不應超過三個月。 應該在時間根期間內選取過去的開始日期。 結束日期沒有任何限制。 支援速記語法、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 consumption budget update-with-rg

預覽

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

更新作業以建立或更新預算。 更新作業需要強制在要求中設定最新的 eTag。 您可以藉由執行取得作業來取得最新的 eTag。 建立作業不需要 eTag。

az consumption budget update-with-rg [--amount]
                                     [--budget-name]
                                     [--category {Cost, Usage}]
                                     [--e-tag]
                                     [--filters]
                                     [--ids]
                                     [--notifications]
                                     [--resource-group]
                                     [--subscription]
                                     [--time-grain {Annually, Monthly, Quarterly}]
                                     [--time-period]

選擇性參數

--amount

要與預算一起追蹤的成本總計。

--budget-name --name -n

預算名稱。

--category

預算的類別，無論是預算追蹤成本還是使用量。

接受的值: Cost, Usage

--e-tag

資源的 ETag。 若要處理並行更新案例，此欄位將用來判斷使用者是否要更新最新版本。

--filters

可用來依資源群組、資源或計量來篩選預算。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。

--ids

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

--notifications

與預算相關聯的通知字典。 預算最多可以有五個通知。 支援速記語法、json-file 和 yaml-file。 請嘗試 「？？」 以顯示更多。

--resource-group -g

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

--subscription

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

--time-grain

預算涵蓋的時間。 追蹤數量將會根據時間粒紋重設。

接受的值: Annually, Monthly, Quarterly

--time-period

具有預算的開始和結束日期。 開始日期必須是月份的第一個，而且應該小於結束日期。 預算開始日期必須是 2017 年 6 月 1 日或之後。 未來的開始日期不應超過三個月。 應該在時間根期間內選取過去的開始日期。 結束日期沒有任何限制。 支援速記語法、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 來取得完整偵錯記錄。