Partager via


Budgets Microsoft.Consommation 2019-06-01

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@2019-06-01' = {
  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'
    }
  }
}

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. 'Coût'
'Utilisation' (obligatoire)
filtres Peut être utilisé pour filtrer les budgets par groupe de ressources, ressource ou compteur. Filtres
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. « 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 trois 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)

Filtres

Nom Description Valeur
Mètres Liste des filtres sur les compteurs (GUID), obligatoire pour les budgets de catégorie d’utilisation. string[]
resourceGroups Liste des filtres sur les groupes de ressources, autorisés au niveau de l’abonnement uniquement. string[]
les ressources Liste des filtres sur les ressources. string[]
tags Dictionnaire de filtres sur les balises. object

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)

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 sous un abonnement.
Créer un budget avec un filtre

Déployer sur Azure
Ce modèle montre comment créer un budget sous un abonnement.
Créer un budget simple

Déployer sur Azure
Ce modèle montre comment créer un budget sous 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 d’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": "2019-06-01",
  "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"
    }
  }
}

Valeurs de propriétés

budgets

Nom Description Valeur
type Type de ressource 'Microsoft.Consumption/budgets'
apiVersion Version de l’API de ressource '2019-06-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.
scope Utilisez lors de la création d’une ressource d’extension dans une étendue différente de l’étendue de 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 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. 'Cost'
'Utilisation' (obligatoire)
filtres Peut être utilisé pour filtrer les budgets par groupe de ressources, ressource ou compteur. Filtres
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. « Annuellement »
'BillingAnnual'
'BillingMonth'
'BillingQuarter'
'Monthly'
'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 trois 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)

Filtres

Nom Description Valeur
Mètres Liste des filtres sur les compteurs (GUID), obligatoire pour les budgets de catégorie d’utilisation. string[]
resourceGroups Liste des filtres sur les groupes de ressources, autorisés au niveau de l’abonnement uniquement. string[]
les ressources Liste des filtres sur les ressources. string[]
tags Dictionnaire des filtres sur les balises. object

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@2019-06-01"
  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"
  })
}

Valeurs de propriétés

budgets

Nom Description Valeur
type Type de ressource « Microsoft.Consumption/budgets@2019-06-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.
parent_id ID de la ressource à laquelle appliquer cette ressource d’extension. chaîne (obligatoire)
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. « Coût »
« Utilisation » (obligatoire)
filtres Peut être utilisé pour filtrer les budgets par groupe de ressources, ressource ou compteur. Filtres
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. « 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 devrait pas dépasser trois 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)

Filtres

Nom Description Valeur
Mètres Liste des filtres sur les compteurs (GUID), obligatoire pour les budgets de catégorie d’utilisation. string[]
resourceGroups Liste des filtres sur les groupes de ressources, autorisés au niveau de l’abonnement uniquement. string[]
les ressources Liste des filtres sur les ressources. string[]
tags Dictionnaire des filtres sur les balises. object

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)