Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
Definição de recursos do bíceps
O tipo de recurso de orçamentos pode ser implantado com operações que visam:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato do recurso
Para criar um recurso Microsoft.Consumption/budgets, adicione o seguinte Bicep ao seu modelo.
resource symbolicname 'Microsoft.Consumption/budgets@2018-10-01' = {
scope: resourceSymbolicName or scope
eTag: 'string'
name: 'string'
properties: {
amount: int
category: 'string'
filters: {
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
}
}
timeGrain: 'string'
timePeriod: {
endDate: 'string'
startDate: 'string'
}
}
}
Valores de propriedade
Microsoft.Consumo/orçamentos
| Designação | 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. | cadeia (de caracteres) |
| Designação | O nome do recurso | string (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 . |
BudgetProperties
| Designação | Descrição | Valor |
|---|---|---|
| Montante | O valor total do custo a acompanhar com o orçamento | int (obrigatório) |
| categoria | A categoria do orçamento, se o orçamento controla 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. | BudgetPropertiesNotifications |
| timeGrain | O tempo coberto por um orçamento. O rastreamento do valor será redefinido com base no grão de tempo. | 'Anualmente' 'Mensal' «Trimestral» (obrigatório) |
| tempoPeríodo | 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 futuro 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. | BudgetTimePeriod (obrigatório) |
BudgetPropertiesNotifications
| Designação | Descrição | Valor |
|---|
BudgetTimePeriod
| Designação | Descrição | Valor |
|---|---|---|
| Data de fim | A data final do orçamento. Se não for fornecido, o padrão será de 10 anos a partir da data de início. | cadeia (de caracteres) |
| data de início | A data de início do orçamento. | string (obrigatório) |
Filtros
| Designação | Descrição | Valor |
|---|---|---|
| medidores | A lista de filtros em medidores (GUID), obrigatória para orçamentos da categoria de uso. | cadeia de caracteres 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 apenas no nível de assinatura. | string[] |
| Recursos | A lista de filtros em recursos. | string[] |
| Etiquetas | O dicionário de filtros em tags. | FiltrosTags |
FiltrosTags
| Designação | Descrição | Valor |
|---|
Notificação
| Designação | Descrição | Valor |
|---|---|---|
| contatoE-mails | Endereços de e-mail para enviar a notificação de orçamento quando o limite for excedido. | string[] (obrigatório) |
| contatoGrupos | Grupos de ação para enviar a notificação de orçamento quando o limite for excedido. | string[] |
| contatoFunções | Funções de contato para enviar a notificação de orçamento quando o limite for excedido. | string[] |
| ativado | A notificação está habilitada ou não. | bool (obrigatório) |
| operador | O operador de comparação. | 'Igual' 'MaiorQue' 'GreaterThanOrEqualTo' (obrigatório) |
| limiar | Valor limite associado a uma notificação. A notificação é enviada quando o custo excede o limite. É sempre percentual e tem que estar entre 0 e 1000. | int (obrigatório) |
Exemplos de uso
Módulos verificados do Azure
Os seguintes de Módulos Verificados do Azure podem ser usados para implantar esse tipo de recurso.
| Módulo | Descrição |
|---|---|
| Orçamento de Consumo | Módulo de recursos AVM para orçamento de consumo |
Exemplos de início rápido do Azure
Os seguintes modelos início rápido do Azure contêm exemplos de Bicep para implantar esse tipo de recurso.
| Arquivo Bicep | Descrição |
|---|---|
| Criar um orçamento | Este modelo mostra como criar um orçamento sob uma assinatura. |
| Criar um orçamento com de filtro | Este modelo mostra como criar um orçamento sob uma assinatura. |
| Criar um orçamento simples | Este modelo mostra como criar um orçamento sob uma assinatura. |
Definição de recurso de modelo ARM
O tipo de recurso de orçamentos pode ser implantado com operações que visam:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato do recurso
Para criar um recurso Microsoft.Consumption/budgets, adicione o seguinte JSON ao seu modelo.
{
"type": "Microsoft.Consumption/budgets",
"apiVersion": "2018-10-01",
"name": "string",
"eTag": "string",
"properties": {
"amount": "int",
"category": "string",
"filters": {
"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"
}
},
"timeGrain": "string",
"timePeriod": {
"endDate": "string",
"startDate": "string"
}
}
}
Valores de propriedade
Microsoft.Consumo/orçamentos
| Designação | Descrição | Valor |
|---|---|---|
| Versão da API | A versão api | '2018-10-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. | cadeia (de caracteres) |
| Designação | O nome do recurso | string (obrigatório) |
| propriedades | As propriedades do orçamento. | BudgetProperties |
| tipo | O tipo de recurso | 'Microsoft.Consumo/orçamentos' |
BudgetProperties
| Designação | Descrição | Valor |
|---|---|---|
| Montante | O valor total do custo a acompanhar com o orçamento | int (obrigatório) |
| categoria | A categoria do orçamento, se o orçamento controla 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. | BudgetPropertiesNotifications |
| timeGrain | O tempo coberto por um orçamento. O rastreamento do valor será redefinido com base no grão de tempo. | 'Anualmente' 'Mensal' «Trimestral» (obrigatório) |
| tempoPeríodo | 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 futuro 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. | BudgetTimePeriod (obrigatório) |
BudgetPropertiesNotifications
| Designação | Descrição | Valor |
|---|
BudgetTimePeriod
| Designação | Descrição | Valor |
|---|---|---|
| Data de fim | A data final do orçamento. Se não for fornecido, o padrão será de 10 anos a partir da data de início. | cadeia (de caracteres) |
| data de início | A data de início do orçamento. | string (obrigatório) |
Filtros
| Designação | Descrição | Valor |
|---|---|---|
| medidores | A lista de filtros em medidores (GUID), obrigatória para orçamentos da categoria de uso. | cadeia de caracteres 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 apenas no nível de assinatura. | string[] |
| Recursos | A lista de filtros em recursos. | string[] |
| Etiquetas | O dicionário de filtros em tags. | FiltrosTags |
FiltrosTags
| Designação | Descrição | Valor |
|---|
Notificação
| Designação | Descrição | Valor |
|---|---|---|
| contatoE-mails | Endereços de e-mail para enviar a notificação de orçamento quando o limite for excedido. | string[] (obrigatório) |
| contatoGrupos | Grupos de ação para enviar a notificação de orçamento quando o limite for excedido. | string[] |
| contatoFunções | Funções de contato para enviar a notificação de orçamento quando o limite for excedido. | string[] |
| ativado | A notificação está habilitada ou não. | bool (obrigatório) |
| operador | O operador de comparação. | 'Igual' 'MaiorQue' 'GreaterThanOrEqualTo' (obrigatório) |
| limiar | Valor limite associado a uma notificação. A notificação é enviada quando o custo excede o limite. É sempre percentual e tem que estar entre 0 e 1000. | int (obrigatório) |
Exemplos de uso
Modelos de início rápido do Azure
Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.
| Modelo | Descrição |
|---|---|
|
Criar um orçamento |
Este modelo mostra como criar um orçamento sob uma assinatura. |
|
Criar um orçamento com de filtro |
Este modelo mostra como criar um orçamento sob uma assinatura. |
|
Criar um orçamento simples |
Este modelo mostra como criar um orçamento sob uma assinatura. |
Definição de recursos Terraform (provedor AzAPI)
O tipo de recurso de orçamentos pode ser implantado com operações que visam:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.
Formato do recurso
Para criar um recurso Microsoft.Consumption/budgets, adicione o seguinte Terraform ao seu modelo.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Consumption/budgets@2018-10-01"
name = "string"
parent_id = "string"
body = {
eTag = "string"
properties = {
amount = int
category = "string"
filters = {
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
}
}
timeGrain = "string"
timePeriod = {
endDate = "string"
startDate = "string"
}
}
}
}
Valores de propriedade
Microsoft.Consumo/orçamentos
| Designação | 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. | cadeia (de caracteres) |
| Designação | O nome do recurso | string (obrigatório) |
| parent_id | A ID do recurso ao qual aplicar esse recurso de extensão. | string (obrigatório) |
| propriedades | As propriedades do orçamento. | BudgetProperties |
| tipo | O tipo de recurso | "Microsoft.Consumption/budgets@2018-10-01" |
BudgetProperties
| Designação | Descrição | Valor |
|---|---|---|
| Montante | O valor total do custo a acompanhar com o orçamento | int (obrigatório) |
| categoria | A categoria do orçamento, se o orçamento controla 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. | BudgetPropertiesNotifications |
| timeGrain | O tempo coberto por um orçamento. O rastreamento do valor será redefinido com base no grão de tempo. | 'Anualmente' 'Mensal' «Trimestral» (obrigatório) |
| tempoPeríodo | 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 futuro 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. | BudgetTimePeriod (obrigatório) |
BudgetPropertiesNotifications
| Designação | Descrição | Valor |
|---|
BudgetTimePeriod
| Designação | Descrição | Valor |
|---|---|---|
| Data de fim | A data final do orçamento. Se não for fornecido, o padrão será de 10 anos a partir da data de início. | cadeia (de caracteres) |
| data de início | A data de início do orçamento. | string (obrigatório) |
Filtros
| Designação | Descrição | Valor |
|---|---|---|
| medidores | A lista de filtros em medidores (GUID), obrigatória para orçamentos da categoria de uso. | cadeia de caracteres 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 apenas no nível de assinatura. | string[] |
| Recursos | A lista de filtros em recursos. | string[] |
| Etiquetas | O dicionário de filtros em tags. | FiltrosTags |
FiltrosTags
| Designação | Descrição | Valor |
|---|
Notificação
| Designação | Descrição | Valor |
|---|---|---|
| contatoE-mails | Endereços de e-mail para enviar a notificação de orçamento quando o limite for excedido. | string[] (obrigatório) |
| contatoGrupos | Grupos de ação para enviar a notificação de orçamento quando o limite for excedido. | string[] |
| contatoFunções | Funções de contato para enviar a notificação de orçamento quando o limite for excedido. | string[] |
| ativado | A notificação está habilitada ou não. | bool (obrigatório) |
| operador | O operador de comparação. | 'Igual' 'MaiorQue' 'GreaterThanOrEqualTo' (obrigatório) |
| limiar | Valor limite associado a uma notificação. A notificação é enviada quando o custo excede o limite. É sempre percentual e tem que estar entre 0 e 1000. | int (obrigatório) |
Exemplos de uso
Amostras Terraform
Um exemplo básico de implantação do Orçamento de Consumo.
terraform {
required_providers {
azapi = {
source = "Azure/azapi"
}
}
}
provider "azapi" {
skip_provider_registration = false
}
variable "resource_name" {
type = string
default = "acctest0001"
}
variable "location" {
type = string
default = "westus"
}
resource "azapi_resource" "resourceGroup" {
type = "Microsoft.Resources/resourceGroups@2020-06-01"
name = var.resource_name
location = var.location
}
resource "azapi_resource" "budget" {
type = "Microsoft.Consumption/budgets@2019-10-01"
parent_id = azapi_resource.resourceGroup.id
name = var.resource_name
body = {
properties = {
amount = 1000
category = "Cost"
filter = {
tags = {
name = "foo"
operator = "In"
values = ["bar"]
}
}
notifications = {
"Actual_EqualTo_90.000000_Percent" = {
contactEmails = ["foo@example.com", "bar@example.com"]
contactGroups = []
contactRoles = []
enabled = true
operator = "EqualTo"
threshold = 90
thresholdType = "Actual"
}
}
timeGrain = "Monthly"
timePeriod = {
startDate = "2025-08-01T00:00:00Z"
}
}
}
}