Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Definición de recursos de Bicep
El tipo de recurso de presupuestos se puede implementar con operaciones destinadas a:
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.Consumption/budgets, agregue el siguiente bicep a la plantilla.
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 propiedad
Microsoft.Consumo/presupuestos
BudgetProperties
| Nombre | Descripción | Valor |
|---|---|---|
| importe | Importe total del costo para realizar el seguimiento con el presupuesto. | int (obligatorio) |
| categoría | Categoría del presupuesto, tanto si el presupuesto realiza un seguimiento del costo como del uso. | 'Costo' 'Uso' (obligatorio) |
| filtros | Puede usarse para filtrar los presupuestos por grupo de recursos, recurso o medidor. | filtros de |
| notificaciones | Diccionario de notificaciones asociadas al presupuesto. El presupuesto puede tener hasta cinco notificaciones. | |
| timeGrain | Tiempo cubierto por un presupuesto. El seguimiento de la cantidad se restablecerá en función del intervalo de tiempo. | 'Anualmente' 'Mensual' 'Trimestral' (obligatorio) |
| timePeriod | Tiene la fecha de inicio y finalización del presupuesto. La fecha de inicio debe ser la primera del mes y debe ser menor que la fecha de finalización. La fecha de inicio del presupuesto debe ser el 1 o después del 1 de junio de 2017. La fecha de inicio futura no debe ser superior a tres meses. La fecha de inicio anterior debe seleccionarse dentro del período de tiempo. No hay restricciones en la fecha de finalización. | budgetTimePeriod (obligatorio) |
BudgetPropertiesNotifications
| Nombre | Descripción | Valor |
|---|
BudgetTimePeriod
| Nombre | Descripción | Valor |
|---|---|---|
| fecha de finalización | Fecha de finalización del presupuesto. Si no se proporciona, el valor predeterminado es de 10 años a partir de la fecha de inicio. | cuerda |
| Fecha de inicio | Fecha de inicio del presupuesto. | string (obligatorio) |
Filtros
| Nombre | Descripción | Valor |
|---|---|---|
| Metros | La lista de filtros en medidores (GUID), obligatorio para los presupuestos de la categoría de uso. | cuerda Restricciones: Longitud mínima = 36 Longitud máxima = 36 Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[] |
| resourceGroups | La lista de filtros de los grupos de recursos, permitidos solo en el nivel de suscripción. | cadena[] |
| Recursos | Lista de filtros en los recursos. | cadena[] |
| Etiquetas | Diccionario de filtros en etiquetas. | FiltersTags de |
FiltrosEtiquetas
| Nombre | Descripción | Valor |
|---|
Notificación
| Nombre | Descripción | Valor |
|---|---|---|
| contactoCorreos electrónicos | Direcciones de correo electrónico para enviar la notificación presupuestaria a cuando se supera el umbral. | string[] (obligatorio) |
| contactGroups | Grupos de acciones a los que se enviará la notificación de presupuesto cuando se supere el umbral. | cadena[] |
| contactRoles | Póngase en contacto con los roles para enviar la notificación presupuestaria a cuando se supere el umbral. | cadena[] |
| Habilitado | La notificación está habilitada o no. | bool (obligatorio) |
| operador | Operador de comparación. | 'Igual a' 'Más grande que' 'GreaterThanOrEqualTo' (obligatorio) |
| umbral | Valor de umbral asociado a una notificación. La notificación se envía cuando el costo supera el umbral. Siempre es porcentaje y tiene que estar entre 0 y 1000. | int (obligatorio) |
Ejemplos de uso
Módulos comprobados de Azure
Los siguientes módulos comprobados de Azure se pueden usar para implementar este tipo de recurso.
| Módulo | Descripción |
|---|---|
| presupuesto de consumo | Módulo de recursos de AVM para el presupuesto de consumo |
Ejemplos de inicio rápido de Azure
Los siguientes plantillas de inicio rápido de Azure contienen ejemplos de Bicep para implementar este tipo de recurso.
| Archivo de Bicep | Descripción |
|---|---|
| Crear un de presupuesto | Esta plantilla muestra cómo crear un presupuesto en una suscripción. |
| Crear un presupuesto con filtro | Esta plantilla muestra cómo crear un presupuesto en una suscripción. |
| Crear un de presupuesto simple | Esta plantilla muestra cómo crear un presupuesto en una suscripción. |
Definición de recursos de plantilla de ARM
El tipo de recurso de presupuestos se puede implementar con operaciones destinadas a:
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.Consumption/budgets, agregue el siguiente JSON a la plantilla.
{
"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 propiedad
Microsoft.Consumo/presupuestos
| Nombre | Descripción | Valor |
|---|---|---|
| apiVersion | La versión de api | '2018-10-01' |
| Etiqueta electrónica | eTag del recurso. Para controlar el escenario de actualización simultánea, este campo se usará para determinar si el usuario está actualizando la versión más reciente o no. | cuerda |
| nombre | El nombre del recurso | string (obligatorio) |
| Propiedades | Propiedades del presupuesto. | |
| tipo | El tipo de recurso | "Microsoft.Consumption/budgets" |
BudgetProperties
| Nombre | Descripción | Valor |
|---|---|---|
| importe | Importe total del costo para realizar el seguimiento con el presupuesto. | int (obligatorio) |
| categoría | Categoría del presupuesto, tanto si el presupuesto realiza un seguimiento del costo como del uso. | 'Costo' 'Uso' (obligatorio) |
| filtros | Puede usarse para filtrar los presupuestos por grupo de recursos, recurso o medidor. | filtros de |
| notificaciones | Diccionario de notificaciones asociadas al presupuesto. El presupuesto puede tener hasta cinco notificaciones. | |
| timeGrain | Tiempo cubierto por un presupuesto. El seguimiento de la cantidad se restablecerá en función del intervalo de tiempo. | 'Anualmente' 'Mensual' 'Trimestral' (obligatorio) |
| timePeriod | Tiene la fecha de inicio y finalización del presupuesto. La fecha de inicio debe ser la primera del mes y debe ser menor que la fecha de finalización. La fecha de inicio del presupuesto debe ser el 1 o después del 1 de junio de 2017. La fecha de inicio futura no debe ser superior a tres meses. La fecha de inicio anterior debe seleccionarse dentro del período de tiempo. No hay restricciones en la fecha de finalización. | budgetTimePeriod (obligatorio) |
BudgetPropertiesNotifications
| Nombre | Descripción | Valor |
|---|
BudgetTimePeriod
| Nombre | Descripción | Valor |
|---|---|---|
| fecha de finalización | Fecha de finalización del presupuesto. Si no se proporciona, el valor predeterminado es de 10 años a partir de la fecha de inicio. | cuerda |
| Fecha de inicio | Fecha de inicio del presupuesto. | string (obligatorio) |
Filtros
| Nombre | Descripción | Valor |
|---|---|---|
| Metros | La lista de filtros en medidores (GUID), obligatorio para los presupuestos de la categoría de uso. | cuerda Restricciones: Longitud mínima = 36 Longitud máxima = 36 Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[] |
| resourceGroups | La lista de filtros de los grupos de recursos, permitidos solo en el nivel de suscripción. | cadena[] |
| Recursos | Lista de filtros en los recursos. | cadena[] |
| Etiquetas | Diccionario de filtros en etiquetas. | FiltersTags de |
FiltrosEtiquetas
| Nombre | Descripción | Valor |
|---|
Notificación
| Nombre | Descripción | Valor |
|---|---|---|
| contactoCorreos electrónicos | Direcciones de correo electrónico para enviar la notificación presupuestaria a cuando se supera el umbral. | string[] (obligatorio) |
| contactGroups | Grupos de acciones a los que se enviará la notificación de presupuesto cuando se supere el umbral. | cadena[] |
| contactRoles | Póngase en contacto con los roles para enviar la notificación presupuestaria a cuando se supere el umbral. | cadena[] |
| Habilitado | La notificación está habilitada o no. | bool (obligatorio) |
| operador | Operador de comparación. | 'Igual a' 'Más grande que' 'GreaterThanOrEqualTo' (obligatorio) |
| umbral | Valor de umbral asociado a una notificación. La notificación se envía cuando el costo supera el umbral. Siempre es porcentaje y tiene que estar entre 0 y 1000. | int (obligatorio) |
Ejemplos de uso
Plantillas de inicio rápido de Azure
Los siguientes plantillas de inicio rápido de Azure implementar este tipo de recurso.
| Plantilla | Descripción |
|---|---|
|
Crear un de presupuesto |
Esta plantilla muestra cómo crear un presupuesto en una suscripción. |
|
Crear un presupuesto con filtro |
Esta plantilla muestra cómo crear un presupuesto en una suscripción. |
|
Crear un de presupuesto simple |
Esta plantilla muestra cómo crear un presupuesto en una suscripción. |
Definición de recursos de Terraform (proveedor AzAPI)
El tipo de recurso de presupuestos se puede implementar con operaciones destinadas a:
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.
Formato de recurso
Para crear un recurso Microsoft.Consumption/budgets, agregue el siguiente Terraform a la plantilla.
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 propiedad
Microsoft.Consumo/presupuestos
| Nombre | Descripción | Valor |
|---|---|---|
| Etiqueta electrónica | eTag del recurso. Para controlar el escenario de actualización simultánea, este campo se usará para determinar si el usuario está actualizando la versión más reciente o no. | cuerda |
| nombre | El nombre del recurso | string (obligatorio) |
| parent_id | Identificador del recurso al que se va a aplicar este recurso de extensión. | string (obligatorio) |
| Propiedades | Propiedades del presupuesto. | |
| tipo | El tipo de recurso | "Microsoft.Consumption/budgets@2018-10-01" |
BudgetProperties
| Nombre | Descripción | Valor |
|---|---|---|
| importe | Importe total del costo para realizar el seguimiento con el presupuesto. | int (obligatorio) |
| categoría | Categoría del presupuesto, tanto si el presupuesto realiza un seguimiento del costo como del uso. | 'Costo' 'Uso' (obligatorio) |
| filtros | Puede usarse para filtrar los presupuestos por grupo de recursos, recurso o medidor. | filtros de |
| notificaciones | Diccionario de notificaciones asociadas al presupuesto. El presupuesto puede tener hasta cinco notificaciones. | |
| timeGrain | Tiempo cubierto por un presupuesto. El seguimiento de la cantidad se restablecerá en función del intervalo de tiempo. | 'Anualmente' 'Mensual' 'Trimestral' (obligatorio) |
| timePeriod | Tiene la fecha de inicio y finalización del presupuesto. La fecha de inicio debe ser la primera del mes y debe ser menor que la fecha de finalización. La fecha de inicio del presupuesto debe ser el 1 o después del 1 de junio de 2017. La fecha de inicio futura no debe ser superior a tres meses. La fecha de inicio anterior debe seleccionarse dentro del período de tiempo. No hay restricciones en la fecha de finalización. | budgetTimePeriod (obligatorio) |
BudgetPropertiesNotifications
| Nombre | Descripción | Valor |
|---|
BudgetTimePeriod
| Nombre | Descripción | Valor |
|---|---|---|
| fecha de finalización | Fecha de finalización del presupuesto. Si no se proporciona, el valor predeterminado es de 10 años a partir de la fecha de inicio. | cuerda |
| Fecha de inicio | Fecha de inicio del presupuesto. | string (obligatorio) |
Filtros
| Nombre | Descripción | Valor |
|---|---|---|
| Metros | La lista de filtros en medidores (GUID), obligatorio para los presupuestos de la categoría de uso. | cuerda Restricciones: Longitud mínima = 36 Longitud máxima = 36 Patrón = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[] |
| resourceGroups | La lista de filtros de los grupos de recursos, permitidos solo en el nivel de suscripción. | cadena[] |
| Recursos | Lista de filtros en los recursos. | cadena[] |
| Etiquetas | Diccionario de filtros en etiquetas. | FiltersTags de |
FiltrosEtiquetas
| Nombre | Descripción | Valor |
|---|
Notificación
| Nombre | Descripción | Valor |
|---|---|---|
| contactoCorreos electrónicos | Direcciones de correo electrónico para enviar la notificación presupuestaria a cuando se supera el umbral. | string[] (obligatorio) |
| contactGroups | Grupos de acciones a los que se enviará la notificación de presupuesto cuando se supere el umbral. | cadena[] |
| contactRoles | Póngase en contacto con los roles para enviar la notificación presupuestaria a cuando se supere el umbral. | cadena[] |
| Habilitado | La notificación está habilitada o no. | bool (obligatorio) |
| operador | Operador de comparación. | 'Igual a' 'Más grande que' 'GreaterThanOrEqualTo' (obligatorio) |
| umbral | Valor de umbral asociado a una notificación. La notificación se envía cuando el costo supera el umbral. Siempre es porcentaje y tiene que estar entre 0 y 1000. | int (obligatorio) |
Ejemplos de uso
Ejemplos de Terraform
Un ejemplo básico de implementación del presupuesto 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"
}
}
}
}