Compartilhar via

Orçamentos do Microsoft.Consumption 2021-05-01

  • Artigo

Definição de recurso do Bicep

O tipo de recurso de orçamentos pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Consumption/budgets, adicione o Bicep a seguir ao seu modelo.

resource symbolicname 'Microsoft.Consumption/budgets@2021-05-01' = {
  scope: resourceSymbolicName or scope
  eTag: 'string'
  name: 'string'
  properties: {
    amount: int
    category: 'string'
    filter: {
      and: [
        {
          dimensions: {
            name: 'string'
            operator: 'string'
            values: [
              'string'
            ]
          }
          tags: {
            name: 'string'
            operator: 'string'
            values: [
              'string'
            ]
          }
        }
      ]
      dimensions: {
        name: 'string'
        operator: 'string'
        values: [
          'string'
        ]
      }
      not: {
        dimensions: {
          name: 'string'
          operator: 'string'
          values: [
            'string'
          ]
        }
        tags: {
          name: 'string'
          operator: 'string'
          values: [
            'string'
          ]
        }
      }
      tags: {
        name: 'string'
        operator: 'string'
        values: [
          'string'
        ]
      }
    }
    notifications: {
      {customized property}: {
        contactEmails: [
          'string'
        ]
        contactGroups: [
          'string'
        ]
        contactRoles: [
          'string'
        ]
        enabled: bool
        operator: 'string'
        threshold: int
        thresholdType: 'string'
      }
    }
    timeGrain: 'string'
    timePeriod: {
      endDate: 'string'
      startDate: 'string'
    }
  }
}

Valores de propriedade

BudgetComparisonExpression

Nome Descrição Valor
nome O nome da coluna a ser usada em comparação. cadeia de caracteres (obrigatório)
operador O operador a ser usado para comparação. 'In' (obrigatório)
Valores Matriz de valores a serem usados para comparação string[] (obrigatório)

BudgetFilter

Nome Descrição Valor
e A expressão lógica "AND". Deve ter pelo menos 2 itens. BudgetFilterProperties[]
Dimensões Tem expressão de comparação para uma dimensão BudgetComparisonExpression
não A expressão lógica "NOT". budgetFilterProperties
Tags Tem expressão de comparação para uma marca BudgetComparisonExpression

BudgetFilterProperties

Nome Descrição Valor
Dimensões Tem expressão de comparação para uma dimensão BudgetComparisonExpression
Tags Tem expressão de comparação para uma marca BudgetComparisonExpression

BudgetProperties

Nome Descrição Valor
quantidade O valor total do custo a ser acompanhado com o orçamento int (obrigatório)
categoria A categoria do orçamento, independentemente de o orçamento controlar o custo ou o uso. 'Custo' (obrigatório)
filtro Pode ser usado para filtrar orçamentos por dimensões especificadas pelo usuário e/ou marcas. BudgetFilter
Notificações Dicionário de notificações associadas ao orçamento. O orçamento pode ter até cinco notificações. BudgetPropertiesNotifications
timeGrain O tempo coberto por um orçamento. O acompanhamento da quantidade será redefinido com base na granulação de tempo. BillingMonth, BillingQuarter e BillingAnnual só têm suporte para clientes do WD 'Anualmente'
'BillingAnnual'
'BillingMonth'
'BillingQuarter'
'Mensal'
'Trimestral' (obrigatório)
timePeriod Tem a 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 doze meses. A data de início anterior deve ser selecionada dentro do período de temporais. Não há restrições na data de término. BudgetTimePeriod (obrigatório)

BudgetPropertiesNotifications

Nome Descrição Valor

BudgetTimePeriod

Nome Descrição Valor
endDate A data de término do orçamento. Se não for fornecido, o padrão será de 10 anos a partir da data de início. corda
startDate A data de início do orçamento. cadeia de caracteres (obrigatório)

Microsoft.Consumption/budgets

Nome Descrição Valor
eTag 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. corda
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades As propriedades do orçamento. BudgetProperties
âmbito Use ao criar um recurso em um escopo diferente do escopo de implantação. Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .

Notificação

Nome Descrição Valor
contactEmails Endereços de email para o qual enviar a notificação de orçamento quando o limite for excedido. Deve ter pelo menos um email de contato ou grupo de contatos especificado nos escopos de Assinatura ou Grupo de Recursos. Todos os outros escopos devem ter pelo menos um email de contato especificado. string[] (obrigatório)
contactGroups Grupos de ações para enviar a notificação de orçamento para quando o limite for excedido. Deve ser fornecido como uma ID de recurso do Azure totalmente qualificada. Só há suporte em escopos de Assinatura ou Grupo de Recursos. string[]
contactRoles Contate as funções para enviar a notificação de orçamento para quando o limite for excedido. string[]
Habilitado A notificação está habilitada ou não. bool (obrigatório)
operador O operador de comparação. 'EqualTo'
'GreaterThan'
'GreaterThanOrEqualTo' (obrigatório)
limiar Valor de limite associado a uma notificação. A notificação é enviada quando o custo excede o limite. É sempre por cento e tem que estar entre 0 e 1000. int (obrigatório)
thresholdType O tipo de limite 'Real'

Exemplos de início rápido

Os exemplos de início rápido a seguir implantam esse tipo de recurso.

Arquivo Bicep Descrição
criar um orçamento Este modelo mostra como criar um orçamento em uma assinatura.
criar um orçamento com filtro Este modelo mostra como criar um orçamento em uma assinatura.
criar um de orçamento simples Este modelo mostra como criar um orçamento em uma assinatura.

Definição de recurso de modelo do ARM

O tipo de recurso de orçamentos pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Consumption/budgets, adicione o JSON a seguir ao seu modelo.

{
  "type": "Microsoft.Consumption/budgets",
  "apiVersion": "2021-05-01",
  "name": "string",
  "eTag": "string",
  "properties": {
    "amount": "int",
    "category": "string",
    "filter": {
      "and": [
        {
          "dimensions": {
            "name": "string",
            "operator": "string",
            "values": [ "string" ]
          },
          "tags": {
            "name": "string",
            "operator": "string",
            "values": [ "string" ]
          }
        }
      ],
      "dimensions": {
        "name": "string",
        "operator": "string",
        "values": [ "string" ]
      },
      "not": {
        "dimensions": {
          "name": "string",
          "operator": "string",
          "values": [ "string" ]
        },
        "tags": {
          "name": "string",
          "operator": "string",
          "values": [ "string" ]
        }
      },
      "tags": {
        "name": "string",
        "operator": "string",
        "values": [ "string" ]
      }
    },
    "notifications": {
      "{customized property}": {
        "contactEmails": [ "string" ],
        "contactGroups": [ "string" ],
        "contactRoles": [ "string" ],
        "enabled": "bool",
        "operator": "string",
        "threshold": "int",
        "thresholdType": "string"
      }
    },
    "timeGrain": "string",
    "timePeriod": {
      "endDate": "string",
      "startDate": "string"
    }
  }
}

Valores de propriedade

BudgetComparisonExpression

Nome Descrição Valor
nome O nome da coluna a ser usada em comparação. cadeia de caracteres (obrigatório)
operador O operador a ser usado para comparação. 'In' (obrigatório)
Valores Matriz de valores a serem usados para comparação string[] (obrigatório)

BudgetFilter

Nome Descrição Valor
e A expressão lógica "AND". Deve ter pelo menos 2 itens. BudgetFilterProperties[]
Dimensões Tem expressão de comparação para uma dimensão BudgetComparisonExpression
não A expressão lógica "NOT". budgetFilterProperties
Tags Tem expressão de comparação para uma marca BudgetComparisonExpression

BudgetFilterProperties

Nome Descrição Valor
Dimensões Tem expressão de comparação para uma dimensão BudgetComparisonExpression
Tags Tem expressão de comparação para uma marca BudgetComparisonExpression

BudgetProperties

Nome Descrição Valor
quantidade O valor total do custo a ser acompanhado com o orçamento int (obrigatório)
categoria A categoria do orçamento, independentemente de o orçamento controlar o custo ou o uso. 'Custo' (obrigatório)
filtro Pode ser usado para filtrar orçamentos por dimensões especificadas pelo usuário e/ou marcas. BudgetFilter
Notificações Dicionário de notificações associadas ao orçamento. O orçamento pode ter até cinco notificações. BudgetPropertiesNotifications
timeGrain O tempo coberto por um orçamento. O acompanhamento da quantidade será redefinido com base na granulação de tempo. BillingMonth, BillingQuarter e BillingAnnual só têm suporte para clientes do WD 'Anualmente'
'BillingAnnual'
'BillingMonth'
'BillingQuarter'
'Mensal'
'Trimestral' (obrigatório)
timePeriod Tem a 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 doze meses. A data de início anterior deve ser selecionada dentro do período de temporais. Não há restrições na data de término. BudgetTimePeriod (obrigatório)

BudgetPropertiesNotifications

Nome Descrição Valor

BudgetTimePeriod

Nome Descrição Valor
endDate A data de término do orçamento. Se não for fornecido, o padrão será de 10 anos a partir da data de início. corda
startDate A data de início do orçamento. cadeia de caracteres (obrigatório)

Microsoft.Consumption/budgets

Nome Descrição Valor
apiVersion A versão da API '2021-05-01'
eTag 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. corda
nome O nome do recurso cadeia de caracteres (obrigatório)
Propriedades As propriedades do orçamento. BudgetProperties
tipo O tipo de recurso 'Microsoft.Consumption/budgets'

Notificação

Nome Descrição Valor
contactEmails Endereços de email para o qual enviar a notificação de orçamento quando o limite for excedido. Deve ter pelo menos um email de contato ou grupo de contatos especificado nos escopos de Assinatura ou Grupo de Recursos. Todos os outros escopos devem ter pelo menos um email de contato especificado. string[] (obrigatório)
contactGroups Grupos de ações para enviar a notificação de orçamento para quando o limite for excedido. Deve ser fornecido como uma ID de recurso do Azure totalmente qualificada. Só há suporte em escopos de Assinatura ou Grupo de Recursos. string[]
contactRoles Contate as funções para enviar a notificação de orçamento para quando o limite for excedido. string[]
Habilitado A notificação está habilitada ou não. bool (obrigatório)
operador O operador de comparação. 'EqualTo'
'GreaterThan'
'GreaterThanOrEqualTo' (obrigatório)
limiar Valor de limite associado a uma notificação. A notificação é enviada quando o custo excede o limite. É sempre por cento e tem que estar entre 0 e 1000. int (obrigatório)
thresholdType O tipo de limite 'Real'

Modelos de início rápido

Os modelos de início rápido a seguir implantam esse tipo de recurso.

Modelo Descrição
criar um orçamento

Implantar no Azure 		Este modelo mostra como criar um orçamento em uma assinatura.
criar um orçamento com filtro

Implantar no Azure 		Este modelo mostra como criar um orçamento em uma assinatura.
criar um de orçamento simples

Implantar no Azure 		Este modelo mostra como criar um orçamento em uma assinatura.

Definição de recurso do Terraform (provedor de AzAPI)

O tipo de recurso de orçamentos pode ser implantado com operações direcionadas:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.

Formato de recurso

Para criar um recurso Microsoft.Consumption/budgets, adicione o Terraform a seguir ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Consumption/budgets@2021-05-01"
  name = "string"
  parent_id = "string"
  eTag = "string"
  body = jsonencode({
    properties = {
      amount = int
      category = "string"
      filter = {
        and = [
          {
            dimensions = {
              name = "string"
              operator = "string"
              values = [
                "string"
              ]
            }
            tags = {
              name = "string"
              operator = "string"
              values = [
                "string"
              ]
            }
          }
        ]
        dimensions = {
          name = "string"
          operator = "string"
          values = [
            "string"
          ]
        }
        not = {
          dimensions = {
            name = "string"
            operator = "string"
            values = [
              "string"
            ]
          }
          tags = {
            name = "string"
            operator = "string"
            values = [
              "string"
            ]
          }
        }
        tags = {
          name = "string"
          operator = "string"
          values = [
            "string"
          ]
        }
      }
      notifications = {
        {customized property} = {
          contactEmails = [
            "string"
          ]
          contactGroups = [
            "string"
          ]
          contactRoles = [
            "string"
          ]
          enabled = bool
          operator = "string"
          threshold = int
          thresholdType = "string"
        }
      }
      timeGrain = "string"
      timePeriod = {
        endDate = "string"
        startDate = "string"
      }
    }
  })
}

Valores de propriedade

BudgetComparisonExpression

Nome Descrição Valor
nome O nome da coluna a ser usada em comparação. cadeia de caracteres (obrigatório)
operador O operador a ser usado para comparação. 'In' (obrigatório)
Valores Matriz de valores a serem usados para comparação string[] (obrigatório)

BudgetFilter

Nome Descrição Valor
e A expressão lógica "AND". Deve ter pelo menos 2 itens. BudgetFilterProperties[]
Dimensões Tem expressão de comparação para uma dimensão BudgetComparisonExpression
não A expressão lógica "NOT". budgetFilterProperties
Tags Tem expressão de comparação para uma marca BudgetComparisonExpression

BudgetFilterProperties

Nome Descrição Valor
Dimensões Tem expressão de comparação para uma dimensão BudgetComparisonExpression
Tags Tem expressão de comparação para uma marca BudgetComparisonExpression

BudgetProperties

Nome Descrição Valor
quantidade O valor total do custo a ser acompanhado com o orçamento int (obrigatório)
categoria A categoria do orçamento, independentemente de o orçamento controlar o custo ou o uso. 'Custo' (obrigatório)
filtro Pode ser usado para filtrar orçamentos por dimensões especificadas pelo usuário e/ou marcas. BudgetFilter
Notificações Dicionário de notificações associadas ao orçamento. O orçamento pode ter até cinco notificações. BudgetPropertiesNotifications
timeGrain O tempo coberto por um orçamento. O acompanhamento da quantidade será redefinido com base na granulação de tempo. BillingMonth, BillingQuarter e BillingAnnual só têm suporte para clientes do WD 'Anualmente'
'BillingAnnual'
'BillingMonth'
'BillingQuarter'
'Mensal'
'Trimestral' (obrigatório)
timePeriod Tem a 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 doze meses. A data de início anterior deve ser selecionada dentro do período de temporais. Não há restrições na data de término. BudgetTimePeriod (obrigatório)

BudgetPropertiesNotifications

Nome Descrição Valor

BudgetTimePeriod

Nome Descrição Valor
endDate A data de término do orçamento. Se não for fornecido, o padrão será de 10 anos a partir da data de início. corda
startDate A data de início do orçamento. cadeia de caracteres (obrigatório)

Microsoft.Consumption/budgets

Nome Descrição Valor
eTag 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. corda
nome O nome do recurso cadeia de caracteres (obrigatório)
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. cadeia de caracteres (obrigatório)
Propriedades As propriedades do orçamento. BudgetProperties
tipo O tipo de recurso "Microsoft.Consumption/budgets@2021-05-01"

Notificação

Nome Descrição Valor
contactEmails Endereços de email para o qual enviar a notificação de orçamento quando o limite for excedido. Deve ter pelo menos um email de contato ou grupo de contatos especificado nos escopos de Assinatura ou Grupo de Recursos. Todos os outros escopos devem ter pelo menos um email de contato especificado. string[] (obrigatório)
contactGroups Grupos de ações para enviar a notificação de orçamento para quando o limite for excedido. Deve ser fornecido como uma ID de recurso do Azure totalmente qualificada. Só há suporte em escopos de Assinatura ou Grupo de Recursos. string[]
contactRoles Contate as funções para enviar a notificação de orçamento para quando o limite for excedido. string[]
Habilitado A notificação está habilitada ou não. bool (obrigatório)
operador O operador de comparação. 'EqualTo'
'GreaterThan'
'GreaterThanOrEqualTo' (obrigatório)
limiar Valor de limite associado a uma notificação. A notificação é enviada quando o custo excede o limite. É sempre por cento e tem que estar entre 0 e 1000. int (obrigatório)
thresholdType O tipo de limite 'Real'