Compartilhar via


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

Definição de recurso do Bicep

O tipo de recurso budgets é um recurso de extensão, o que significa que você pode aplicá-lo a outro recurso.

Use a scope propriedade nesse recurso para definir o escopo desse recurso. Consulte Definir escopo em recursos de extensão no Bicep.

Os escopos de implantação válidos para o recurso de orçamentos são:

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

Formato de recurso

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

resource symbolicname 'Microsoft.Consumption/budgets@2019-05-01-preview' = {
  name: 'string'
  scope: resourceSymbolicName
  eTag: 'string'
  properties: {
    amount: int
    category: 'string'
    filters: {
      meters: [
        'string'
      ]
      resourceGroups: [
        'string'
      ]
      resources: [
        'string'
      ]
      tags: {}
    }
    notifications: {}
    timeGrain: 'string'
    timePeriod: {
      endDate: 'string'
      startDate: 'string'
    }
  }
}

Valores de propriedade

budgets

Nome Descrição Valor
name O nome do recurso cadeia de caracteres (obrigatório)

Limite de caracteres: 1 a 63

Caracteres válidos:
Caracteres alfanuméricos, hifens e sublinhados.
scope Use ao criar um recurso de extensão em um escopo diferente do escopo de implantação. Recurso de destino

Para o Bicep, defina essa propriedade como o nome simbólico do recurso para aplicar o recurso de extensão.
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. string
properties As propriedades do orçamento. BudgetProperties

BudgetProperties

Nome Descrição Valor
quantidade O valor total do custo a ser acompanhado com o orçamento int (obrigatório)
category A categoria do orçamento, independentemente de o orçamento rastrear o custo ou o uso. 'Custo'
'Usage' (obrigatório)
filtros Pode ser usado para filtrar orçamentos por grupo de recursos, recurso ou medidor. Filtros
Notificações Dicionário de notificações associadas ao orçamento. O orçamento pode ter até cinco notificações. objeto
timeGrain O tempo coberto por um orçamento. O acompanhamento da quantidade será redefinido com base na granularidade de tempo. 'Anualmente'
'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 timegrain. Não há restrições na data de término. BudgetTimePeriod (obrigatório)

Filtros

Nome Descrição Valor
Metros A lista de filtros em medidores (GUID), obrigatória para orçamentos da categoria de uso. string[]
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[]
marcas O dicionário de filtros em marcas. objeto

BudgetTimePeriod

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

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 orçamento simples

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

Definição de recurso de modelo do ARM

O tipo de recurso budgets é um recurso de extensão, o que significa que você pode aplicá-lo a outro recurso.

Use a scope propriedade nesse recurso para definir o escopo desse recurso. Consulte Definir escopo em recursos de extensão em modelos do ARM.

Os escopos de implantação válidos para o recurso de orçamentos são:

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

Formato de recurso

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

{
  "type": "Microsoft.Consumption/budgets",
  "apiVersion": "2019-05-01-preview",
  "name": "string",
  "scope": "string",
  "eTag": "string",
  "properties": {
    "amount": "int",
    "category": "string",
    "filters": {
      "meters": [ "string" ],
      "resourceGroups": [ "string" ],
      "resources": [ "string" ],
      "tags": {}
    },
    "notifications": {},
    "timeGrain": "string",
    "timePeriod": {
      "endDate": "string",
      "startDate": "string"
    }
  }
}

Valores de propriedade

budgets

Nome Descrição Valor
tipo O tipo de recurso 'Microsoft.Consumption/budgets'
apiVersion A versão da API do recurso '2019-05-01-preview'
name O nome do recurso cadeia de caracteres (obrigatório)

Limite de caracteres: 1-63

Caracteres válidos:
Caracteres alfanuméricos, hifens e sublinhados.
scope Use ao criar um recurso de extensão em um escopo diferente do escopo de implantação. Recurso de destino

Para JSON, defina o valor como o nome completo do recurso ao qual aplicar o recurso de extensão .
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. string
properties As propriedades do orçamento. BudgetProperties

BudgetProperties

Nome Descrição Valor
quantidade O valor total do custo a ser acompanhado com o orçamento int (obrigatório)
category A categoria do orçamento, independentemente de o orçamento controlar o custo ou o uso. 'Custo'
'Uso' (obrigatório)
filtros Pode ser usado para filtrar orçamentos por grupo de recursos, recurso ou medidor. Filtros
Notificações Dicionário de notificações associadas ao orçamento. O orçamento pode ter até cinco notificações. objeto
timeGrain O tempo coberto por um orçamento. O acompanhamento do valor será redefinido com base na granularidade de tempo. 'Anualmente'
'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 tempo. Não há restrições na data de término. BudgetTimePeriod (obrigatório)

Filtros

Nome Descrição Valor
Metros A lista de filtros em medidores (GUID), obrigatória para orçamentos da categoria de uso. string[]
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[]
marcas O dicionário de filtros em marcas. objeto

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. string
startDate A data de início do orçamento. cadeia de caracteres (obrigatório)

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 orçamento simples

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

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

O tipo de recurso budgets é um recurso de extensão, o que significa que você pode aplicá-lo a outro recurso.

Use a parent_id propriedade nesse recurso para definir o escopo desse recurso.

Os escopos de implantação válidos para o recurso de orçamentos são:

  • Grupos de recursos
  • Assinaturas

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

Formato de recurso

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

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Consumption/budgets@2019-05-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      amount = int
      category = "string"
      filters = {
        meters = [
          "string"
        ]
        resourceGroups = [
          "string"
        ]
        resources = [
          "string"
        ]
        tags = {}
      }
      notifications = {}
      timeGrain = "string"
      timePeriod = {
        endDate = "string"
        startDate = "string"
      }
    }
    eTag = "string"
  })
}

Valores de propriedade

budgets

Nome Descrição Valor
tipo O tipo de recurso "Microsoft.Consumption/budgets@2019-05-01-preview"
name O nome do recurso cadeia de caracteres (obrigatório)

Limite de caracteres: 1 a 63

Caracteres válidos:
Caracteres alfanuméricos, hifens e sublinhados.
parent_id A ID do recurso ao qual aplicar esse recurso de extensão. cadeia de caracteres (obrigatório)
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. string
properties As propriedades do orçamento. BudgetProperties

BudgetProperties

Nome Descrição Valor
quantidade O valor total do custo a ser acompanhado com o orçamento int (obrigatório)
category A categoria do orçamento, independentemente de o orçamento rastrear o custo ou o uso. "Custo"
"Uso" (obrigatório)
filtros Pode ser usado para filtrar orçamentos por grupo de recursos, recurso ou medidor. Filtros
Notificações Dicionário de notificações associadas ao orçamento. O orçamento pode ter até cinco notificações. objeto
timeGrain O tempo coberto por um orçamento. O acompanhamento da quantidade será redefinido com base na granularidade de tempo. "Anualmente"
"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 timegrain. Não há restrições na data de término. BudgetTimePeriod (obrigatório)

Filtros

Nome Descrição Valor
Metros A lista de filtros em medidores (GUID), obrigatória para orçamentos da categoria de uso. string[]
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[]
marcas O dicionário de filtros em marcas. objeto

BudgetTimePeriod

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