Partager via


Budgets Microsoft.Consumption

Définition de ressource Bicep

Le type de ressource budgets est une ressource d’extension, ce qui signifie que vous pouvez l’appliquer à une autre ressource.

Utilisez la scope propriété sur cette ressource pour définir l’étendue de cette ressource. Consultez Définir l’étendue des ressources d’extension dans Bicep.

Les étendues de déploiement valides pour la ressource budgets sont les suivantes :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Consumption/budgets, ajoutez le Bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Consumption/budgets@2021-10-01' = {
  name: 'string'
  scope: resourceSymbolicName
  eTag: 'string'
  properties: {
    amount: int
    category: 'Cost'
    filter: {
      and: [
        {
          dimensions: {
            name: 'string'
            operator: 'In'
            values: [
              'string'
            ]
          }
          tags: {
            name: 'string'
            operator: 'In'
            values: [
              'string'
            ]
          }
        }
      ]
      dimensions: {
        name: 'string'
        operator: 'In'
        values: [
          'string'
        ]
      }
      tags: {
        name: 'string'
        operator: 'In'
        values: [
          'string'
        ]
      }
    }
    notifications: {}
    timeGrain: 'string'
    timePeriod: {
      endDate: 'string'
      startDate: 'string'
    }
  }
}

Valeurs de propriétés

budgets

Nom Description Valeur
name Nom de la ressource chaîne (obligatoire)

Limite de caractères : 1-63

Caractères valides :
Caractères alphanumériques, traits d’union et traits de soulignement.
scope Utilisez lors de la création d’une ressource d’extension dans une étendue différente de l’étendue du déploiement. Ressource cible

Pour Bicep, définissez cette propriété sur le nom symbolique de la ressource pour appliquer la ressource d’extension.
eTag eTag de la ressource. Pour gérer le scénario de mise à jour simultanée, ce champ sera utilisé pour déterminer si l’utilisateur met à jour la dernière version ou non. string
properties Propriétés du budget. BudgetPropriétés

BudgetPropriétés

Nom Description Valeur
Montant Montant total du coût à suivre avec le budget int (obligatoire)
catégorie Catégorie du budget, si le budget suit le coût ou l’utilisation. 'Cost' (obligatoire)
filter Peut être utilisé pour filtrer les budgets par dimensions et/ou balises spécifiées par l’utilisateur. BudgetFilter
Notifications Dictionnaire des notifications associées au budget. Budget peut comporter jusqu’à cinq notifications. object
timeGrain Temps couvert par un budget. Le suivi de la quantité sera réinitialisé en fonction du grain de temps. BillingMonth, BillingQuarter et BillingAnnual sont uniquement pris en charge par les clients WD « Annuel »
'BillingAnnual'
'BillingMonth'
'BillingQuarter'
'Mensuel'
'Trimestriel' (obligatoire)
timePeriod A les dates de début et de fin du budget. La date de début doit être le premier du mois et doit être inférieure à la date de fin. La date de début du budget doit être le 1er juin 2017 ou après cette date. La date de début future ne devrait pas dépasser douze mois. La date de début passée doit être sélectionnée dans la période timegrain. Il n’existe aucune restriction sur la date de fin. BudgetTimePeriod (obligatoire)

BudgetFilter

Nom Description Valeur
et Expression logique « AND ». Doit avoir au moins 2 éléments. BudgetFilterProperties[]
dimensions A l’expression de comparaison pour une dimension BudgetComparisonExpression
tags A l’expression de comparaison pour une balise object

BudgetFilterProperties

Nom Description Valeur
dimensions A l’expression de comparaison pour une dimension BudgetComparisonExpression
tags A l’expression de comparaison pour une balise object

BudgetComparisonExpression

Nom Description Valeur
name Nom de la colonne à utiliser en comparaison. chaîne (obligatoire)
operator Opérateur à utiliser pour la comparaison. 'In' (obligatoire)
values Tableau de valeurs à utiliser pour la comparaison string[] (obligatoire)

BudgetTimePeriod

Nom Description Valeur
endDate Date de fin du budget. S’il n’est pas fourni, nous avons par défaut la valeur 10 ans à compter de la date de début. string
startDate Date de début du budget. chaîne (obligatoire)

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Créer un budget

Déployer sur Azure
Ce modèle montre comment créer un budget dans le cadre d’un abonnement.
Créer un budget avec filtre

Déployer sur Azure
Ce modèle montre comment créer un budget dans le cadre d’un abonnement.
Créer un budget simple

Déployer sur Azure
Ce modèle montre comment créer un budget dans le cadre d’un abonnement.

Définition de ressources de modèle ARM

Le type de ressource budgets est une ressource d’extension, ce qui signifie que vous pouvez l’appliquer à une autre ressource.

Utilisez la scope propriété sur cette ressource pour définir l’étendue de cette ressource. Consultez Définir l’étendue des ressources d’extension dans les modèles ARM.

Les étendues de déploiement valides pour la ressource budgets sont les suivantes :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Consumption/budgets, ajoutez le json suivant à votre modèle.

{
  "type": "Microsoft.Consumption/budgets",
  "apiVersion": "2021-10-01",
  "name": "string",
  "scope": "string",
  "eTag": "string",
  "properties": {
    "amount": "int",
    "category": "Cost",
    "filter": {
      "and": [
        {
          "dimensions": {
            "name": "string",
            "operator": "In",
            "values": [ "string" ]
          },
          "tags": {
            "name": "string",
            "operator": "In",
            "values": [ "string" ]
          }
        }
      ],
      "dimensions": {
        "name": "string",
        "operator": "In",
        "values": [ "string" ]
      },
      "tags": {
        "name": "string",
        "operator": "In",
        "values": [ "string" ]
      }
    },
    "notifications": {},
    "timeGrain": "string",
    "timePeriod": {
      "endDate": "string",
      "startDate": "string"
    }
  }
}

Valeurs de propriétés

budgets

Nom Description Valeur
type Type de ressource « Microsoft.Consumption/budgets »
apiVersion Version de l’API de ressource '2021-10-01'
name Nom de la ressource chaîne (obligatoire)

Limite de caractères : 1-63

Caractères valides :
Caractères alphanumériques, traits d’union et traits de soulignement.
scope Utilisez lors de la création d’une ressource d’extension dans une étendue différente de l’étendue du déploiement. Ressource cible

Pour JSON, définissez la valeur sur le nom complet de la ressource à laquelle appliquer la ressource d’extension .
eTag eTag de la ressource. Pour gérer le scénario de mise à jour simultanée, ce champ sera utilisé pour déterminer si l’utilisateur met à jour la dernière version ou non. string
properties Propriétés du budget. BudgetPropriétés

BudgetPropriétés

Nom Description Valeur
Montant Montant total du coût à suivre avec le budget int (obligatoire)
catégorie Catégorie du budget, si le budget suit le coût ou l’utilisation. 'Cost' (obligatoire)
filter Peut être utilisé pour filtrer les budgets par dimensions et/ou balises spécifiées par l’utilisateur. BudgetFilter
Notifications Dictionnaire des notifications associées au budget. Budget peut comporter jusqu’à cinq notifications. object
timeGrain Temps couvert par un budget. Le suivi de la quantité sera réinitialisé en fonction du grain de temps. BillingMonth, BillingQuarter et BillingAnnual sont uniquement pris en charge par les clients WD « Annuel »
'BillingAnnual'
'BillingMonth'
'BillingQuarter'
'Mensuel'
'Trimestriel' (obligatoire)
timePeriod A les dates de début et de fin du budget. La date de début doit être le premier du mois et doit être inférieure à la date de fin. La date de début du budget doit être le 1er juin 2017 ou après cette date. La date de début future ne devrait pas dépasser douze mois. La date de début passée doit être sélectionnée dans la période timegrain. Il n’existe aucune restriction sur la date de fin. BudgetTimePeriod (obligatoire)

BudgetFilter

Nom Description Valeur
et Expression logique « AND ». Doit avoir au moins 2 éléments. BudgetFilterProperties[]
dimensions A l’expression de comparaison pour une dimension BudgetComparisonExpression
tags A l’expression de comparaison pour une balise object

BudgetFilterProperties

Nom Description Valeur
dimensions A l’expression de comparaison pour une dimension BudgetComparisonExpression
tags A l’expression de comparaison pour une balise object

BudgetComparisonExpression

Nom Description Valeur
name Nom de la colonne à utiliser en comparaison. chaîne (obligatoire)
operator Opérateur à utiliser pour la comparaison. 'In' (obligatoire)
values Tableau de valeurs à utiliser pour la comparaison string[] (obligatoire)

BudgetTimePeriod

Nom Description Valeur
endDate Date de fin du budget. S’il n’est pas fourni, nous avons par défaut la valeur 10 ans à compter de la date de début. string
startDate Date de début du budget. chaîne (obligatoire)

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Créer un budget

Déployer sur Azure
Ce modèle montre comment créer un budget dans le cadre d’un abonnement.
Créer un budget avec filtre

Déployer sur Azure
Ce modèle montre comment créer un budget dans le cadre d’un abonnement.
Créer un budget simple

Déployer sur Azure
Ce modèle montre comment créer un budget dans le cadre d’un abonnement.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource budgets est une ressource d’extension, ce qui signifie que vous pouvez l’appliquer à une autre ressource.

Utilisez la parent_id propriété sur cette ressource pour définir l’étendue de cette ressource.

Les étendues de déploiement valides pour la ressource budgets sont les suivantes :

  • Groupes de ressources
  • Abonnements

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Consumption/budgets, ajoutez le Terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Consumption/budgets@2021-10-01"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      amount = int
      category = "Cost"
      filter = {
        and = [
          {
            dimensions = {
              name = "string"
              operator = "In"
              values = [
                "string"
              ]
            }
            tags = {
              name = "string"
              operator = "In"
              values = [
                "string"
              ]
            }
          }
        ]
        dimensions = {
          name = "string"
          operator = "In"
          values = [
            "string"
          ]
        }
        tags = {
          name = "string"
          operator = "In"
          values = [
            "string"
          ]
        }
      }
      notifications = {}
      timeGrain = "string"
      timePeriod = {
        endDate = "string"
        startDate = "string"
      }
    }
    eTag = "string"
  })
}

Valeurs de propriétés

budgets

Nom Description Valeur
type Type de ressource « Microsoft.Consumption/budgets@2021-10-01 »
name Nom de la ressource string (obligatoire)

Limite de caractères : 1-63

Caractères valides :
Caractères alphanumériques, traits d’union et traits de soulignement.
parent_id ID de la ressource à laquelle appliquer cette ressource d’extension. string (obligatoire)
eTag eTag de la ressource. Pour gérer le scénario de mise à jour simultanée, ce champ est utilisé pour déterminer si l’utilisateur met à jour la dernière version ou non. string
properties Propriétés du budget. BudgetProperties

BudgetProperties

Nom Description Valeur
Montant Montant total des coûts à suivre avec le budget int (obligatoire)
catégorie Catégorie du budget, si le budget suit le coût ou l’utilisation. « Coût » (obligatoire)
filter Peut être utilisé pour filtrer les budgets par dimensions et/ou balises spécifiées par l’utilisateur. BudgetFilter
Notifications Dictionnaire de notifications associées au budget. Budget peut contenir jusqu’à cinq notifications. object
timeGrain Temps couvert par un budget. Le suivi de la quantité est réinitialisé en fonction du grain de temps. BillingMonth, BillingQuarter et BillingAnnual sont uniquement pris en charge par les clients WD « Annuellement »
« BillingAnnual »
« BillingMonth »
« BillingQuarter »
« Mensuel »
« Trimestriel » (obligatoire)
timePeriod A les dates de début et de fin du budget. La date de début doit être le premier du mois et doit être inférieure à la date de fin. La date de début du budget doit être le 1er juin 2017 ou après cette date. La date de début future ne doit pas dépasser douze mois. La date de début passée doit être sélectionnée dans la période timegrain. Il n’existe aucune restriction à la date de fin. BudgetTimePeriod (obligatoire)

BudgetFilter

Nom Description Valeur
et Expression logique « AND ». Doit avoir au moins 2 éléments. BudgetFilterProperties[]
dimensions A une expression de comparaison pour une dimension BudgetComparisonExpression
tags A une expression de comparaison pour une balise object

BudgetFilterProperties

Nom Description Valeur
dimensions A une expression de comparaison pour une dimension BudgetComparisonExpression
tags A une expression de comparaison pour une balise object

BudgetComparisonExpression

Nom Description Valeur
name Nom de la colonne à utiliser en comparaison. string (obligatoire)
operator Opérateur à utiliser pour la comparaison. « In » (obligatoire)
values Tableau de valeurs à utiliser pour la comparaison string[] (obligatoire)

BudgetTimePeriod

Nom Description Valeur
endDate Date de fin du budget. S’il n’est pas fourni, cette valeur par défaut est de 10 ans à compter de la date de début. string
startDate Date de début du budget. string (obligatoire)