Compartir a través de

Presupuestos de Microsoft.Consumption

  • Artículo

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@2024-08-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'
        ]
      }
      tags: {
        name: 'string'
        operator: 'string'
        values: [
          'string'
        ]
      }
    }
    notifications: {
      {customized property}: {
        contactEmails: [
          'string'
        ]
        contactGroups: [
          'string'
        ]
        contactRoles: [
          'string'
        ]
        enabled: bool
        locale: 'string'
        operator: 'string'
        threshold: int
        thresholdType: 'string'
      }
    }
    timeGrain: 'string'
    timePeriod: {
      endDate: 'string'
      startDate: 'string'
    }
  }
}

Valores de propiedad

BudgetComparisonExpression

Nombre Descripción Valor
nombre Nombre de la columna que se va a usar en comparación. string (obligatorio)
operador Operador que se va a usar para la comparación. 'In' (obligatorio)
valores Matriz de valores que se van a usar para la comparación string[] (obligatorio)

BudgetFilter

Nombre Descripción Valor
y Expresión "AND" lógica. Debe tener al menos 2 elementos. BudgetFilterProperties[]
Dimensiones Tiene una expresión de comparación para una dimensión BudgetComparisonExpression
Etiquetas Tiene expresión de comparación para una etiqueta BudgetComparisonExpression

BudgetFilterProperties

Nombre Descripción Valor
Dimensiones Tiene una expresión de comparación para una dimensión BudgetComparisonExpression
Etiquetas Tiene expresión de comparación para una etiqueta BudgetComparisonExpression

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' (obligatorio)
filtro Se puede usar para filtrar presupuestos por dimensiones o etiquetas especificadas por el usuario. budgetFilter
notificaciones Diccionario de notificaciones asociadas al presupuesto. El presupuesto puede tener hasta cinco notificaciones. BudgetPropertiesNotifications
timeGrain Tiempo cubierto por un presupuesto. El seguimiento de la cantidad se restablecerá en función del intervalo de tiempo. Los clientes de WD solo admiten BillingMonth, BillingQuarter y Billing Annual. 'Anualmente'
'Billing Annual'
'BillingMonth'
'BillingQuarter'
'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 doce 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
endDate 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
startDate Fecha de inicio del presupuesto. string (obligatorio)

Microsoft.Consumption/budgets

Nombre Descripción Valor
eTag 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. BudgetProperties
alcance Use al crear un recurso en un ámbito diferente del ámbito de implementación. Establezca esta propiedad en el nombre simbólico de un recurso para aplicar el recurso de extensión .

Notificación

Nombre Descripción Valor
contactEmails Direcciones de correo electrónico para enviar la notificación presupuestaria a cuando se supera el umbral. Debe tener al menos un correo electrónico de contacto o un grupo de contactos especificado en los ámbitos de suscripción o grupo de recursos. Todos los demás ámbitos deben tener al menos un correo electrónico de contacto especificado. string[] (obligatorio)
contactGroups Grupos de acciones a los que se enviará la notificación de presupuesto cuando se supere el umbral. Debe proporcionarse como identificador de recurso completo de Azure. Solo se admite en ámbitos de suscripción o grupo de recursos. string[]
contactRoles Póngase en contacto con los roles para enviar la notificación presupuestaria a cuando se supere el umbral. string[]
Habilitado La notificación está habilitada o no. bool (obligatorio)
configuración regional Idioma en el que el destinatario recibirá la notificación 'cs-cz'
'da-dk'
'de-de'
'en-gb'
'en-us'
'es-es'
'fr-fr'
'hu-hu'
'it-it'
'ja-jp'
'ko-kr'
'nb-no'
'nl-nl'
'pl-pl'
'pt-br'
'pt-pt'
'ru-ru'
'sv-se'
'tr-tr'
'zh-cn'
'zh-tw'
operador Operador de comparación. 'EqualTo'
'GreaterThan'
'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)
thresholdType El tipo de umbral 'Real'
"Previsión"

Ejemplos de inicio rápido

En los ejemplos de inicio rápido siguientes se implementa 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": "2024-08-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" ]
      },
      "tags": {
        "name": "string",
        "operator": "string",
        "values": [ "string" ]
      }
    },
    "notifications": {
      "{customized property}": {
        "contactEmails": [ "string" ],
        "contactGroups": [ "string" ],
        "contactRoles": [ "string" ],
        "enabled": "bool",
        "locale": "string",
        "operator": "string",
        "threshold": "int",
        "thresholdType": "string"
      }
    },
    "timeGrain": "string",
    "timePeriod": {
      "endDate": "string",
      "startDate": "string"
    }
  }
}

Valores de propiedad

BudgetComparisonExpression

Nombre Descripción Valor
nombre Nombre de la columna que se va a usar en comparación. string (obligatorio)
operador Operador que se va a usar para la comparación. 'In' (obligatorio)
valores Matriz de valores que se van a usar para la comparación string[] (obligatorio)

BudgetFilter

Nombre Descripción Valor
y Expresión "AND" lógica. Debe tener al menos 2 elementos. BudgetFilterProperties[]
Dimensiones Tiene una expresión de comparación para una dimensión BudgetComparisonExpression
Etiquetas Tiene expresión de comparación para una etiqueta BudgetComparisonExpression

BudgetFilterProperties

Nombre Descripción Valor
Dimensiones Tiene una expresión de comparación para una dimensión BudgetComparisonExpression
Etiquetas Tiene expresión de comparación para una etiqueta BudgetComparisonExpression

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' (obligatorio)
filtro Se puede usar para filtrar presupuestos por dimensiones o etiquetas especificadas por el usuario. budgetFilter
notificaciones Diccionario de notificaciones asociadas al presupuesto. El presupuesto puede tener hasta cinco notificaciones. BudgetPropertiesNotifications
timeGrain Tiempo cubierto por un presupuesto. El seguimiento de la cantidad se restablecerá en función del intervalo de tiempo. Los clientes de WD solo admiten BillingMonth, BillingQuarter y Billing Annual. 'Anualmente'
'Billing Annual'
'BillingMonth'
'BillingQuarter'
'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 doce 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
endDate 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
startDate Fecha de inicio del presupuesto. string (obligatorio)

Microsoft.Consumption/budgets

Nombre Descripción Valor
apiVersion La versión de api '2024-08-01'
eTag 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. BudgetProperties
tipo El tipo de recurso "Microsoft.Consumption/budgets"

Notificación

Nombre Descripción Valor
contactEmails Direcciones de correo electrónico para enviar la notificación presupuestaria a cuando se supera el umbral. Debe tener al menos un correo electrónico de contacto o un grupo de contactos especificado en los ámbitos de suscripción o grupo de recursos. Todos los demás ámbitos deben tener al menos un correo electrónico de contacto especificado. string[] (obligatorio)
contactGroups Grupos de acciones a los que se enviará la notificación de presupuesto cuando se supere el umbral. Debe proporcionarse como identificador de recurso completo de Azure. Solo se admite en ámbitos de suscripción o grupo de recursos. string[]
contactRoles Póngase en contacto con los roles para enviar la notificación presupuestaria a cuando se supere el umbral. string[]
Habilitado La notificación está habilitada o no. bool (obligatorio)
configuración regional Idioma en el que el destinatario recibirá la notificación 'cs-cz'
'da-dk'
'de-de'
'en-gb'
'en-us'
'es-es'
'fr-fr'
'hu-hu'
'it-it'
'ja-jp'
'ko-kr'
'nb-no'
'nl-nl'
'pl-pl'
'pt-br'
'pt-pt'
'ru-ru'
'sv-se'
'tr-tr'
'zh-cn'
'zh-tw'
operador Operador de comparación. 'EqualTo'
'GreaterThan'
'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)
thresholdType El tipo de umbral 'Real'
"Previsión"

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Crear un de presupuesto

Implementación en Azure 		Esta plantilla muestra cómo crear un presupuesto en una suscripción.
Crear un presupuesto con filtro

Implementación en Azure 		Esta plantilla muestra cómo crear un presupuesto en una suscripción.
Crear un de presupuesto simple

Implementación en Azure 		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@2024-08-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"
          ]
        }
        tags = {
          name = "string"
          operator = "string"
          values = [
            "string"
          ]
        }
      }
      notifications = {
        {customized property} = {
          contactEmails = [
            "string"
          ]
          contactGroups = [
            "string"
          ]
          contactRoles = [
            "string"
          ]
          enabled = bool
          locale = "string"
          operator = "string"
          threshold = int
          thresholdType = "string"
        }
      }
      timeGrain = "string"
      timePeriod = {
        endDate = "string"
        startDate = "string"
      }
    }
  })
}

Valores de propiedad

BudgetComparisonExpression

Nombre Descripción Valor
nombre Nombre de la columna que se va a usar en comparación. string (obligatorio)
operador Operador que se va a usar para la comparación. 'In' (obligatorio)
valores Matriz de valores que se van a usar para la comparación string[] (obligatorio)

BudgetFilter

Nombre Descripción Valor
y Expresión "AND" lógica. Debe tener al menos 2 elementos. BudgetFilterProperties[]
Dimensiones Tiene una expresión de comparación para una dimensión BudgetComparisonExpression
Etiquetas Tiene expresión de comparación para una etiqueta BudgetComparisonExpression

BudgetFilterProperties

Nombre Descripción Valor
Dimensiones Tiene una expresión de comparación para una dimensión BudgetComparisonExpression
Etiquetas Tiene expresión de comparación para una etiqueta BudgetComparisonExpression

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' (obligatorio)
filtro Se puede usar para filtrar presupuestos por dimensiones o etiquetas especificadas por el usuario. budgetFilter
notificaciones Diccionario de notificaciones asociadas al presupuesto. El presupuesto puede tener hasta cinco notificaciones. BudgetPropertiesNotifications
timeGrain Tiempo cubierto por un presupuesto. El seguimiento de la cantidad se restablecerá en función del intervalo de tiempo. Los clientes de WD solo admiten BillingMonth, BillingQuarter y Billing Annual. 'Anualmente'
'Billing Annual'
'BillingMonth'
'BillingQuarter'
'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 doce 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
endDate 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
startDate Fecha de inicio del presupuesto. string (obligatorio)

Microsoft.Consumption/budgets

Nombre Descripción Valor
eTag 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. BudgetProperties
tipo El tipo de recurso "Microsoft.Consumption/budgets@2024-08-01"

Notificación

Nombre Descripción Valor
contactEmails Direcciones de correo electrónico para enviar la notificación presupuestaria a cuando se supera el umbral. Debe tener al menos un correo electrónico de contacto o un grupo de contactos especificado en los ámbitos de suscripción o grupo de recursos. Todos los demás ámbitos deben tener al menos un correo electrónico de contacto especificado. string[] (obligatorio)
contactGroups Grupos de acciones a los que se enviará la notificación de presupuesto cuando se supere el umbral. Debe proporcionarse como identificador de recurso completo de Azure. Solo se admite en ámbitos de suscripción o grupo de recursos. string[]
contactRoles Póngase en contacto con los roles para enviar la notificación presupuestaria a cuando se supere el umbral. string[]
Habilitado La notificación está habilitada o no. bool (obligatorio)
configuración regional Idioma en el que el destinatario recibirá la notificación 'cs-cz'
'da-dk'
'de-de'
'en-gb'
'en-us'
'es-es'
'fr-fr'
'hu-hu'
'it-it'
'ja-jp'
'ko-kr'
'nb-no'
'nl-nl'
'pl-pl'
'pt-br'
'pt-pt'
'ru-ru'
'sv-se'
'tr-tr'
'zh-cn'
'zh-tw'
operador Operador de comparación. 'EqualTo'
'GreaterThan'
'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)
thresholdType El tipo de umbral 'Real'
"Previsión"