Partager via


Budgets Microsoft.Consumption 2019-04-01-preview

Définition de ressource Bicep

Le type de ressource budgets peut être déployé avec des opérations qui ciblent :

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

Format de ressource

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

resource symbolicname 'Microsoft.Consumption/budgets@2019-04-01-preview' = {
  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'
    }
  }
}

Valeurs de propriété

BudgetProperties

Nom Description Valeur
quantité Montant total du coût à suivre avec le budget int (obligatoire)
catégorie Catégorie du budget, que le budget effectue le suivi du coût ou de l’utilisation. 'Coût'
'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. Le budget peut avoir jusqu’à cinq notifications. BudgetPropertiesNotifications
timeGrain Temps couvert par un budget. Le suivi de la quantité sera réinitialisé en fonction du grain de temps. « Annuellement »
'Mensuel'
'Quarterly' (obligatoire)
timePeriod A la date de début et de fin du budget. La date de début doit être la première 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 le 1er juin 2017. 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 au cours de la période de temps. Il n’existe aucune restriction à la date de fin. BudgetTimePeriod (obligatoire)

BudgetPropertiesNotifications

Nom Description Valeur

BudgetTimePeriod

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

Filtres

Nom Description Valeur
Mètres Liste des filtres sur les compteurs (GUID), obligatoire pour les budgets de catégorie d’utilisation. corde

Contraintes:
Longueur minimale = 36
Longueur maximale = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[]
resourceGroups Liste des filtres sur les groupes de ressources, autorisés uniquement au niveau de l’abonnement. string[]
ressources Liste des filtres sur les ressources. string[]
étiquettes Dictionnaire de filtres sur les balises. FiltersTags

FiltersTags

Nom Description Valeur

Microsoft.Consumption/budgets

Nom Description Valeur
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. corde
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés du budget. BudgetProperties
portée Utilisez-la lors de la création d’une ressource dans une étendue différente de l’étendue de déploiement. Définissez cette propriété sur le nom symbolique d’une ressource pour appliquer la ressource d’extension .

Notification

Nom Description Valeur
contactEmails Adresses e-mail à laquelle envoyer la notification budgétaire lorsque le seuil est dépassé. string[] (obligatoire)
contactGroups Groupes d’actions auxquels envoyer la notification budgétaire lorsque le seuil est dépassé. string[]
contactRoles Contactez les rôles pour envoyer la notification budgétaire au moment où le seuil est dépassé. string[]
Activé La notification est activée ou non. bool (obligatoire)
opérateur Opérateur de comparaison. 'EqualTo'
'GreaterThan'
'GreaterThanOrEqualTo' (obligatoire)
seuil Valeur de seuil associée à une notification. La notification est envoyée lorsque le coût a dépassé le seuil. Il est toujours pourcentage et doit être compris entre 0 et 1000. int (obligatoire)

Exemples de démarrage rapide

Les exemples de démarrage rapide suivants déploient ce type de ressource.

Fichier Bicep Description
créer un budgétaire Ce modèle montre comment créer un budget sous un abonnement.
Créer un budget avec de filtre Ce modèle montre comment créer un budget sous un abonnement.
créer un budget simple Ce modèle montre comment créer un budget sous un abonnement.

Définition de ressource de modèle ARM

Le type de ressource budgets peut être déployé avec des opérations qui ciblent :

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

Format de ressource

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

{
  "type": "Microsoft.Consumption/budgets",
  "apiVersion": "2019-04-01-preview",
  "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"
    }
  }
}

Valeurs de propriété

BudgetProperties

Nom Description Valeur
quantité Montant total du coût à suivre avec le budget int (obligatoire)
catégorie Catégorie du budget, que le budget effectue le suivi du coût ou de l’utilisation. 'Coût'
'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. Le budget peut avoir jusqu’à cinq notifications. BudgetPropertiesNotifications
timeGrain Temps couvert par un budget. Le suivi de la quantité sera réinitialisé en fonction du grain de temps. « Annuellement »
'Mensuel'
'Quarterly' (obligatoire)
timePeriod A la date de début et de fin du budget. La date de début doit être la première 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 le 1er juin 2017. 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 au cours de la période de temps. Il n’existe aucune restriction à la date de fin. BudgetTimePeriod (obligatoire)

BudgetPropertiesNotifications

Nom Description Valeur

BudgetTimePeriod

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

Filtres

Nom Description Valeur
Mètres Liste des filtres sur les compteurs (GUID), obligatoire pour les budgets de catégorie d’utilisation. corde

Contraintes:
Longueur minimale = 36
Longueur maximale = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[]
resourceGroups Liste des filtres sur les groupes de ressources, autorisés uniquement au niveau de l’abonnement. string[]
ressources Liste des filtres sur les ressources. string[]
étiquettes Dictionnaire de filtres sur les balises. FiltersTags

FiltersTags

Nom Description Valeur

Microsoft.Consumption/budgets

Nom Description Valeur
apiVersion Version de l’API '2019-04-01-preview'
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. corde
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés du budget. BudgetProperties
type Type de ressource 'Microsoft.Consumption/budgets'

Notification

Nom Description Valeur
contactEmails Adresses e-mail à laquelle envoyer la notification budgétaire lorsque le seuil est dépassé. string[] (obligatoire)
contactGroups Groupes d’actions auxquels envoyer la notification budgétaire lorsque le seuil est dépassé. string[]
contactRoles Contactez les rôles pour envoyer la notification budgétaire au moment où le seuil est dépassé. string[]
Activé La notification est activée ou non. bool (obligatoire)
opérateur Opérateur de comparaison. 'EqualTo'
'GreaterThan'
'GreaterThanOrEqualTo' (obligatoire)
seuil Valeur de seuil associée à une notification. La notification est envoyée lorsque le coût a dépassé le seuil. Il est toujours pourcentage et doit être compris entre 0 et 1000. int (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 budgétaire

Déployer sur Azure
Ce modèle montre comment créer un budget sous un abonnement.
Créer un budget avec de 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 ressource Terraform (fournisseur AzAPI)

Le type de ressource budgets peut être déployé avec des opérations qui ciblent :

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

Format de ressource

Pour créer une ressource Microsoft.Consumption/budgets, ajoutez la terraform suivante à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Consumption/budgets@2019-04-01-preview"
  name = "string"
  parent_id = "string"
  eTag = "string"
  body = jsonencode({
    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"
      }
    }
  })
}

Valeurs de propriété

BudgetProperties

Nom Description Valeur
quantité Montant total du coût à suivre avec le budget int (obligatoire)
catégorie Catégorie du budget, que le budget effectue le suivi du coût ou de l’utilisation. 'Coût'
'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. Le budget peut avoir jusqu’à cinq notifications. BudgetPropertiesNotifications
timeGrain Temps couvert par un budget. Le suivi de la quantité sera réinitialisé en fonction du grain de temps. « Annuellement »
'Mensuel'
'Quarterly' (obligatoire)
timePeriod A la date de début et de fin du budget. La date de début doit être la première 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 le 1er juin 2017. 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 au cours de la période de temps. Il n’existe aucune restriction à la date de fin. BudgetTimePeriod (obligatoire)

BudgetPropertiesNotifications

Nom Description Valeur

BudgetTimePeriod

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

Filtres

Nom Description Valeur
Mètres Liste des filtres sur les compteurs (GUID), obligatoire pour les budgets de catégorie d’utilisation. corde

Contraintes:
Longueur minimale = 36
Longueur maximale = 36
Pattern = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$[]
resourceGroups Liste des filtres sur les groupes de ressources, autorisés uniquement au niveau de l’abonnement. string[]
ressources Liste des filtres sur les ressources. string[]
étiquettes Dictionnaire de filtres sur les balises. FiltersTags

FiltersTags

Nom Description Valeur

Microsoft.Consumption/budgets

Nom Description Valeur
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. corde
nom Nom de la ressource chaîne (obligatoire)
parent_id ID de la ressource à laquelle appliquer cette ressource d’extension. chaîne (obligatoire)
Propriétés Propriétés du budget. BudgetProperties
type Type de ressource « Microsoft.Consumption/budgets@2019-04-01-preview »

Notification

Nom Description Valeur
contactEmails Adresses e-mail à laquelle envoyer la notification budgétaire lorsque le seuil est dépassé. string[] (obligatoire)
contactGroups Groupes d’actions auxquels envoyer la notification budgétaire lorsque le seuil est dépassé. string[]
contactRoles Contactez les rôles pour envoyer la notification budgétaire au moment où le seuil est dépassé. string[]
Activé La notification est activée ou non. bool (obligatoire)
opérateur Opérateur de comparaison. 'EqualTo'
'GreaterThan'
'GreaterThanOrEqualTo' (obligatoire)
seuil Valeur de seuil associée à une notification. La notification est envoyée lorsque le coût a dépassé le seuil. Il est toujours pourcentage et doit être compris entre 0 et 1000. int (obligatoire)