Compartilhar via


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

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@2019-05-01' = {
  scope: resourceSymbolicName or scope
  eTag: 'string'
  name: 'string'
  properties: {
    amount: int
    category: 'string'
    filter: {
      meters: [
        'string'
      ]
      resourceGroups: [
        'string'
      ]
      resources: [
        'string'
      ]
      tags: {
        {customized property}: [
          '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

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'
'Uso' (obrigatório)
filtro Pode ser usado para filtrar orçamentos por dimensões especificadas pelo usuário e/ou marcas. Filtrar
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. '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 três 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)

Filtro

Nome Descrição Valor
Metros A lista de filtros em medidores (GUID), obrigatória para orçamentos da categoria de uso. corda

Restrições:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[]
resourceGroups A lista de filtros em grupos de recursos, permitida somente no nível da assinatura. string[]
Recursos A lista de filtros nos recursos. string[]
Tags O dicionário de filtros em marcas. FilterTags

FilterTags

Nome Descrição Valor

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": "2019-05-01",
  "name": "string",
  "eTag": "string",
  "properties": {
    "amount": "int",
    "category": "string",
    "filter": {
      "meters": [ "string" ],
      "resourceGroups": [ "string" ],
      "resources": [ "string" ],
      "tags": {
        "{customized property}": [ "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

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'
'Uso' (obrigatório)
filtro Pode ser usado para filtrar orçamentos por dimensões especificadas pelo usuário e/ou marcas. Filtrar
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. '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 três 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)

Filtro

Nome Descrição Valor
Metros A lista de filtros em medidores (GUID), obrigatória para orçamentos da categoria de uso. corda

Restrições:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[]
resourceGroups A lista de filtros em grupos de recursos, permitida somente no nível da assinatura. string[]
Recursos A lista de filtros nos recursos. string[]
Tags O dicionário de filtros em marcas. FilterTags

FilterTags

Nome Descrição Valor

Microsoft.Consumption/budgets

Nome Descrição Valor
apiVersion A versão da API '2019-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@2019-05-01"
  name = "string"
  parent_id = "string"
  eTag = "string"
  body = jsonencode({
    properties = {
      amount = int
      category = "string"
      filter = {
        meters = [
          "string"
        ]
        resourceGroups = [
          "string"
        ]
        resources = [
          "string"
        ]
        tags = {
          {customized property} = [
            "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

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'
'Uso' (obrigatório)
filtro Pode ser usado para filtrar orçamentos por dimensões especificadas pelo usuário e/ou marcas. Filtrar
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. '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 três 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)

Filtro

Nome Descrição Valor
Metros A lista de filtros em medidores (GUID), obrigatória para orçamentos da categoria de uso. corda

Restrições:
Comprimento mínimo = 36
Comprimento máximo = 36
Padrão = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[]
resourceGroups A lista de filtros em grupos de recursos, permitida somente no nível da assinatura. string[]
Recursos A lista de filtros nos recursos. string[]
Tags O dicionário de filtros em marcas. FilterTags

FilterTags

Nome Descrição Valor

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@2019-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'