Partilhar via

az consumption budget

  • Pré-visualizar
  • Referência

O grupo de comando 'consumo' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Gerencie orçamentos para uma assinatura do Azure.

Comandos

Name Description Tipo Estado
az consumption budget create

Crie um orçamento para uma assinatura do Azure.

 Principal Pré-visualizar
az consumption budget create-with-rg

Criar operação para criar ou atualizar um orçamento. A operação de atualização requer que o eTag mais recente seja definido na solicitação obrigatoriamente. Você pode obter o eTag mais recente executando uma operação get. Criar operação não requer eTag.

 Principal Pré-visualizar
az consumption budget delete

Exclua um orçamento para uma assinatura do Azure.

 Principal Pré-visualizar
az consumption budget delete-with-rg

Excluir operação para excluir um orçamento.

 Principal Pré-visualizar
az consumption budget list

Listar orçamentos para uma assinatura do Azure.

 Principal Pré-visualizar
az consumption budget show

Mostrar orçamento para uma assinatura do Azure.

 Principal Pré-visualizar
az consumption budget show-with-rg

Obtenha o orçamento para um grupo de recursos sob uma assinatura por nome de orçamento.

 Principal Pré-visualizar
az consumption budget update

Operação de atualização para criar ou atualizar um orçamento. A operação de atualização requer que o eTag mais recente seja definido na solicitação obrigatoriamente. Você pode obter o eTag mais recente executando uma operação get. Criar operação não requer eTag.

 Principal Pré-visualizar
az consumption budget update-with-rg

Operação de atualização para criar ou atualizar um orçamento. A operação de atualização requer que o eTag mais recente seja definido na solicitação obrigatoriamente. Você pode obter o eTag mais recente executando uma operação get. Criar operação não requer eTag.

 Principal Pré-visualizar

az consumption budget create

Editar
Pré-visualizar

O grupo de comando 'consumo' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Crie um orçamento para uma assinatura do 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]

Parâmetros Obrigatórios

--amount

Valor de um orçamento.

--budget-name

Nome de um orçamento.

--category

A categoria do orçamento pode ser custo ou uso.

valores aceites: cost, usage
--end-date -e

Data de fim (AAAA-MM-DD em UTC) do período de tempo de um orçamento.

--start-date -s

Data de início (AAAA-MM-DD em UTC) do período de tempo de um orçamento.

--time-grain

O tempo do orçamento pode ser mensal, trimestral ou anual.

valores aceites: annually, monthly, quarterly

Parâmetros Opcionais

--meter-filter

Lista separada por espaço de medidores para filtrar. Obrigatório se a categoria for uso.

--resource-filter

Lista separada por espaço de instâncias de recursos para filtrar.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--resource-group-filter

Lista separada por espaço de grupos de recursos para filtrar.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az consumption budget create-with-rg

Editar
Pré-visualizar

O grupo de comando 'consumo' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Criar operação para criar ou atualizar um orçamento. A operação de atualização requer que o eTag mais recente seja definido na solicitação obrigatoriamente. Você pode obter o eTag mais recente executando uma operação get. Criar operação não requer 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]

Parâmetros Opcionais

--amount

O valor total do custo a acompanhar com o orçamento.

--budget-name --name -n

Nome do orçamento.

--category

A categoria do orçamento, se o orçamento controla o custo ou o uso.

valores aceites: Cost, Usage
--e-tag

ETag do recurso. Para lidar com o cenário de atualização simultânea, esse campo será usado para determinar se o usuário está atualizando a versão mais recente ou não.

--filters

Pode ser usado para filtrar orçamentos por grupo de recursos, recurso ou medidor. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--notifications

Dicionário de notificações associadas ao orçamento. O orçamento pode ter até cinco notificações. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--time-grain

O tempo coberto por um orçamento. O rastreamento do valor será redefinido com base no grão de tempo.

valores aceites: Annually, Monthly, Quarterly
--time-period

Tem data de início e fim do orçamento. A data de início deve ser a primeira do mês e deve ser inferior à data de fim. A data de início do orçamento deve ser em ou após 1º de junho de 2017. A data de início futura não deve ser superior a três meses. A data de início anterior deve ser selecionada dentro do período de tempo. Não há restrições quanto à data de término. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az consumption budget delete

Editar
Pré-visualizar

O grupo de comando 'consumo' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Exclua um orçamento para uma assinatura do Azure.

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

Exemplos

Exclua um orçamento para uma assinatura do Azure. (gerado automaticamente)

az consumption budget delete --budget-name MyBudget

Parâmetros Obrigatórios

--budget-name

Nome de um orçamento.

Parâmetros Opcionais

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az consumption budget delete-with-rg

Editar
Pré-visualizar

O grupo de comando 'consumo' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Excluir operação para excluir um orçamento.

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

Parâmetros Opcionais

--budget-name --name -n

Nome do orçamento.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az consumption budget list

Editar
Pré-visualizar

O grupo de comando 'consumo' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Listar orçamentos para uma assinatura do Azure.

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

Parâmetros Opcionais

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token no --next-token argumento de um comando subsequente.

--next-token

Token para especificar por onde começar a paginar. Este é o valor do token de uma resposta truncada anteriormente.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az consumption budget show

Editar
Pré-visualizar

O grupo de comando 'consumo' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Mostrar orçamento para uma assinatura do Azure.

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

Exemplos

Mostrar orçamento para uma assinatura do Azure. (gerado automaticamente)

az consumption budget show --budget-name MyBudget

Parâmetros Obrigatórios

--budget-name

Nome de um orçamento.

Parâmetros Opcionais

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az consumption budget show-with-rg

Editar
Pré-visualizar

O grupo de comando 'consumo' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Obtenha o orçamento para um grupo de recursos sob uma assinatura por nome de orçamento.

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

Parâmetros Opcionais

--budget-name --name -n

Nome do orçamento.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az consumption budget update

Editar
Pré-visualizar

O grupo de comando 'consumo' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Operação de atualização para criar ou atualizar um orçamento. A operação de atualização requer que o eTag mais recente seja definido na solicitação obrigatoriamente. Você pode obter o eTag mais recente executando uma operação get. Criar operação não requer 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]

Parâmetros Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string ou JSON string>.

--amount

O valor total do custo a acompanhar com o orçamento.

--budget-name --name -n

Nome do orçamento.

--category

A categoria do orçamento, se o orçamento controla o custo ou o uso.

valores aceites: Cost, Usage
--e-tag

ETag do recurso. Para lidar com o cenário de atualização simultânea, esse campo será usado para determinar se o usuário está atualizando a versão mais recente ou não.

--filters

Pode ser usado para filtrar orçamentos por grupo de recursos, recurso ou medidor. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--force-string

Ao usar 'set' ou 'add', preserve literais de string em vez de tentar converter para JSON.

valores aceites: 0, 1, f, false, n, no, t, true, y, yes
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--notifications

Dicionário de notificações associadas ao orçamento. O orçamento pode ter até cinco notificações. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list OR --remove propertyToRemove.

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--time-grain

O tempo coberto por um orçamento. O rastreamento do valor será redefinido com base no grão de tempo.

valores aceites: Annually, Monthly, Quarterly
--time-period

Tem data de início e fim do orçamento. A data de início deve ser a primeira do mês e deve ser inferior à data de fim. A data de início do orçamento deve ser em ou após 1º de junho de 2017. A data de início futura não deve ser superior a três meses. A data de início anterior deve ser selecionada dentro do período de tempo. Não há restrições quanto à data de término. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az consumption budget update-with-rg

Editar
Pré-visualizar

O grupo de comando 'consumo' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Operação de atualização para criar ou atualizar um orçamento. A operação de atualização requer que o eTag mais recente seja definido na solicitação obrigatoriamente. Você pode obter o eTag mais recente executando uma operação get. Criar operação não requer 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]

Parâmetros Opcionais

--amount

O valor total do custo a acompanhar com o orçamento.

--budget-name --name -n

Nome do orçamento.

--category

A categoria do orçamento, se o orçamento controla o custo ou o uso.

valores aceites: Cost, Usage
--e-tag

ETag do recurso. Para lidar com o cenário de atualização simultânea, esse campo será usado para determinar se o usuário está atualizando a versão mais recente ou não.

--filters

Pode ser usado para filtrar orçamentos por grupo de recursos, recurso ou medidor. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--notifications

Dicionário de notificações associadas ao orçamento. O orçamento pode ter até cinco notificações. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--time-grain

O tempo coberto por um orçamento. O rastreamento do valor será redefinido com base no grão de tempo.

valores aceites: Annually, Monthly, Quarterly
--time-period

Tem data de início e fim do orçamento. A data de início deve ser a primeira do mês e deve ser inferior à data de fim. A data de início do orçamento deve ser em ou após 1º de junho de 2017. A data de início futura não deve ser superior a três meses. A data de início anterior deve ser selecionada dentro do período de tempo. Não há restrições quanto à data de término. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.