Compartilhar via

az consumption budget

  • Versão Prévia
  • Referência

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

Gerenciar orçamentos para uma assinatura do Azure.

Comandos

Nome Description Tipo Status
az consumption budget create

Crie um orçamento para uma assinatura do Azure.

 Núcleo Versão Prévia
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. A operação de criação não requer eTag.

 Núcleo Versão Prévia
az consumption budget delete

Exclua um orçamento para uma assinatura do Azure.

 Núcleo Versão Prévia
az consumption budget delete-with-rg

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

 Núcleo Versão Prévia
az consumption budget list

Listar orçamentos para uma assinatura do Azure.

 Núcleo Versão Prévia
az consumption budget show

Mostrar orçamento para uma assinatura do Azure.

 Núcleo Versão Prévia
az consumption budget show-with-rg

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

 Núcleo Versão Prévia
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. A operação de criação não requer eTag.

 Núcleo Versão Prévia
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. A operação de criação não requer eTag.

 Núcleo Versão Prévia

az consumption budget create

Editar
Versão Prévia

O grupo de comando 'consumo' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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 Exigidos

--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 aceitos: cost, usage
--end-date -e

Data de término (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 cronograma do orçamento pode ser mensal, trimestral ou anual.

valores aceitos: annually, monthly, quarterly

Parâmetros Opcionais

--meter-filter

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

--resource-filter

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

--resource-group -g

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 Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az consumption budget create-with-rg

Editar
Versão Prévia

O grupo de comando 'consumo' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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. A operação de criaçã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 ser acompanhado 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 aceitos: Cost, Usage
--e-tag

ETag do recurso. Para manipular 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. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--ids

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

--notifications

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

--resource-group -g

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--time-grain

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

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

Tem data de início e término do orçamento. A data de início deve ser a primeira do mês e deve ser menor que a data de término. 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 passada deve ser selecionada dentro do período de tempo. Não há restrições quanto à data de término. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az consumption budget delete

Editar
Versão Prévia

O grupo de comando 'consumo' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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 Exigidos

--budget-name

Nome de um orçamento.

Parâmetros Opcionais

--resource-group -g

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az consumption budget delete-with-rg

Editar
Versão Prévia

O grupo de comando 'consumo' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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

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

--resource-group -g

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az consumption budget list

Editar
Versão Prévia

O grupo de comando 'consumo' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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 onde iniciar a paginação. Esse é o valor de token de uma resposta truncada anteriormente.

--resource-group -g

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az consumption budget show

Editar
Versão Prévia

O grupo de comando 'consumo' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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 Exigidos

--budget-name

Nome de um orçamento.

Parâmetros Opcionais

--resource-group -g

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az consumption budget show-with-rg

Editar
Versão Prévia

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

Obtenha o orçamento de um grupo de recursos em 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

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

--resource-group -g

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az consumption budget update

Editar
Versão Prévia

O grupo de comando 'consumo' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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. A operação de criaçã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 valores de chave. Exemplo: --add property.listProperty <key=value, string ou cadeia de caracteres> JSON.

--amount

O valor total do custo a ser acompanhado 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 aceitos: Cost, Usage
--e-tag

ETag do recurso. Para manipular 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. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--force-string

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

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

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

--notifications

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

--remove

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

--set

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--time-grain

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

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

Tem data de início e término do orçamento. A data de início deve ser a primeira do mês e deve ser menor que a data de término. 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 passada deve ser selecionada dentro do período de tempo. Não há restrições quanto à data de término. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az consumption budget update-with-rg

Editar
Versão Prévia

O grupo de comando 'consumo' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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. A operação de criaçã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 ser acompanhado 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 aceitos: Cost, Usage
--e-tag

ETag do recurso. Para manipular 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. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

--ids

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

--notifications

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

--resource-group -g

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--time-grain

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

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

Tem data de início e término do orçamento. A data de início deve ser a primeira do mês e deve ser menor que a data de término. 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 passada deve ser selecionada dentro do período de tempo. Não há restrições quanto à data de término. Suporte taquigráfico-sintaxe, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.