Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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@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'
}
}
}
Valeurs de la propriété
Microsoft.Consommation/budgets
| Nom | Descriptif | 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. | BudgetPropriétés |
| 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 . |
BudgetComparisonExpression
| Nom | Descriptif | Valeur |
|---|---|---|
| nom | Nom de la colonne à utiliser en comparaison. | chaîne (obligatoire) |
| opérateur | Opérateur à utiliser pour la comparaison. | 'In' (obligatoire) |
| Valeurs | Tableau de valeurs à utiliser pour la comparaison | string[] (obligatoire) |
BudgetFilter
| Nom | Descriptif | Valeur |
|---|---|---|
| et | Expression logique « AND ». Doit avoir au moins 2 éléments. | BudgetFilterProperties[] |
| taille | A une expression de comparaison pour une dimension | BudgetComparisonExpression |
| étiquettes | A une expression de comparaison pour une balise | BudgetComparisonExpression |
BudgetFilterProperties
| Nom | Descriptif | Valeur |
|---|---|---|
| taille | A une expression de comparaison pour une dimension | BudgetComparisonExpression |
| étiquettes | A une expression de comparaison pour une balise | BudgetComparisonExpression |
BudgetPropriétés
| Nom | Descriptif | 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' (obligatoire) |
| filtre | 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. Le budget peut avoir jusqu’à cinq notifications. | BudgetPropriétésNotifications |
| timeGrain | Temps couvert par un budget. Le suivi de la quantité sera réinitialisé en fonction du grain de temps. BillingMonth, BillingQuarter et BillingAnnual ne sont pris en charge que par les clients WD | « Annuellement » 'FacturationAnnuelle' 'MoisFacturation' 'BillingQuarter' 'Mensuel' 'Quarterly' (obligatoire) |
| tempsPériode | 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 douze 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) |
BudgetPropriétésNotifications
| Nom | Descriptif | Valeur |
|---|
BudgetTimePeriod
| Nom | Descriptif | Valeur |
|---|---|---|
| date de fin | 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 |
| date de début | Date de début du budget. | chaîne (obligatoire) |
Notification
| Nom | Descriptif | Valeur |
|---|---|---|
| contactE-mails | Adresses e-mail à laquelle envoyer la notification budgétaire lorsque le seuil est dépassé. Doit avoir au moins un e-mail de contact ou un groupe de contacts spécifié dans les étendues Abonnement ou Groupe de ressources. Toutes les autres étendues doivent avoir au moins un e-mail de contact spécifié. | string[] (obligatoire) |
| contactGroupes | Groupes d’actions auxquels envoyer la notification budgétaire lorsque le seuil est dépassé. Doit être fourni en tant qu’ID de ressource Azure complet. Uniquement pris en charge dans les étendues d’abonnement ou de groupe de ressources. | chaîne de caractères[] |
| contactRôles | Contactez les rôles pour envoyer la notification budgétaire au moment où le seuil est dépassé. | chaîne de caractères[] |
| Activé | La notification est activée ou non. | bool (obligatoire) |
| paramètres régionaux | Langue dans laquelle le destinataire recevra la notification | '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' |
| opérateur | Opérateur de comparaison. | 'ÉgalÀ' « Plus grand que » '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) |
| thresholdType | Type de seuil | 'Réel' 'Prévu' |
Exemples d’utilisation
Modules vérifiés Azure
Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.
| Module | Descriptif |
|---|---|
| budget de consommation | Module de ressources AVM pour le budget de consommation |
Exemples de démarrage rapide Azure
Les modèles de démarrage rapide Azure suivants contiennent des exemples Bicep pour le déploiement de ce type de ressource.
| Fichier Bicep | Descriptif |
|---|---|
| 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": "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"
}
}
}
Valeurs de la propriété
Microsoft.Consommation/budgets
| Nom | Descriptif | Valeur |
|---|---|---|
| apiVersion | Version de l’API | '2024-08-01' |
| 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. | BudgetPropriétés |
| type | Type de ressource | 'Microsoft.Consommation/budgets' |
BudgetComparisonExpression
| Nom | Descriptif | Valeur |
|---|---|---|
| nom | Nom de la colonne à utiliser en comparaison. | chaîne (obligatoire) |
| opérateur | Opérateur à utiliser pour la comparaison. | 'In' (obligatoire) |
| Valeurs | Tableau de valeurs à utiliser pour la comparaison | string[] (obligatoire) |
BudgetFilter
| Nom | Descriptif | Valeur |
|---|---|---|
| et | Expression logique « AND ». Doit avoir au moins 2 éléments. | BudgetFilterProperties[] |
| taille | A une expression de comparaison pour une dimension | BudgetComparisonExpression |
| étiquettes | A une expression de comparaison pour une balise | BudgetComparisonExpression |
BudgetFilterProperties
| Nom | Descriptif | Valeur |
|---|---|---|
| taille | A une expression de comparaison pour une dimension | BudgetComparisonExpression |
| étiquettes | A une expression de comparaison pour une balise | BudgetComparisonExpression |
BudgetPropriétés
| Nom | Descriptif | 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' (obligatoire) |
| filtre | 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. Le budget peut avoir jusqu’à cinq notifications. | BudgetPropriétésNotifications |
| timeGrain | Temps couvert par un budget. Le suivi de la quantité sera réinitialisé en fonction du grain de temps. BillingMonth, BillingQuarter et BillingAnnual ne sont pris en charge que par les clients WD | « Annuellement » 'FacturationAnnuelle' 'MoisFacturation' 'BillingQuarter' 'Mensuel' 'Quarterly' (obligatoire) |
| tempsPériode | 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 douze 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) |
BudgetPropriétésNotifications
| Nom | Descriptif | Valeur |
|---|
BudgetTimePeriod
| Nom | Descriptif | Valeur |
|---|---|---|
| date de fin | 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 |
| date de début | Date de début du budget. | chaîne (obligatoire) |
Notification
| Nom | Descriptif | Valeur |
|---|---|---|
| contactE-mails | Adresses e-mail à laquelle envoyer la notification budgétaire lorsque le seuil est dépassé. Doit avoir au moins un e-mail de contact ou un groupe de contacts spécifié dans les étendues Abonnement ou Groupe de ressources. Toutes les autres étendues doivent avoir au moins un e-mail de contact spécifié. | string[] (obligatoire) |
| contactGroupes | Groupes d’actions auxquels envoyer la notification budgétaire lorsque le seuil est dépassé. Doit être fourni en tant qu’ID de ressource Azure complet. Uniquement pris en charge dans les étendues d’abonnement ou de groupe de ressources. | chaîne de caractères[] |
| contactRôles | Contactez les rôles pour envoyer la notification budgétaire au moment où le seuil est dépassé. | chaîne de caractères[] |
| Activé | La notification est activée ou non. | bool (obligatoire) |
| paramètres régionaux | Langue dans laquelle le destinataire recevra la notification | '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' |
| opérateur | Opérateur de comparaison. | 'ÉgalÀ' « Plus grand que » '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) |
| thresholdType | Type de seuil | 'Réel' 'Prévu' |
Exemples d’utilisation
Modèles de démarrage rapide Microsoft Azure
Les modèles de démarrage rapide Azure suivants déployer ce type de ressource.
| Modèle | Descriptif |
|---|---|
|
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 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@2024-08-01"
name = "string"
parent_id = "string"
body = {
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"
}
}
}
}
Valeurs de la propriété
Microsoft.Consommation/budgets
| Nom | Descriptif | 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. | BudgetPropriétés |
| type | Type de ressource | « Microsoft.Consumption/budgets@2024-08-01 » |
BudgetComparisonExpression
| Nom | Descriptif | Valeur |
|---|---|---|
| nom | Nom de la colonne à utiliser en comparaison. | chaîne (obligatoire) |
| opérateur | Opérateur à utiliser pour la comparaison. | 'In' (obligatoire) |
| Valeurs | Tableau de valeurs à utiliser pour la comparaison | string[] (obligatoire) |
BudgetFilter
| Nom | Descriptif | Valeur |
|---|---|---|
| et | Expression logique « AND ». Doit avoir au moins 2 éléments. | BudgetFilterProperties[] |
| taille | A une expression de comparaison pour une dimension | BudgetComparisonExpression |
| étiquettes | A une expression de comparaison pour une balise | BudgetComparisonExpression |
BudgetFilterProperties
| Nom | Descriptif | Valeur |
|---|---|---|
| taille | A une expression de comparaison pour une dimension | BudgetComparisonExpression |
| étiquettes | A une expression de comparaison pour une balise | BudgetComparisonExpression |
BudgetPropriétés
| Nom | Descriptif | 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' (obligatoire) |
| filtre | 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. Le budget peut avoir jusqu’à cinq notifications. | BudgetPropriétésNotifications |
| timeGrain | Temps couvert par un budget. Le suivi de la quantité sera réinitialisé en fonction du grain de temps. BillingMonth, BillingQuarter et BillingAnnual ne sont pris en charge que par les clients WD | « Annuellement » 'FacturationAnnuelle' 'MoisFacturation' 'BillingQuarter' 'Mensuel' 'Quarterly' (obligatoire) |
| tempsPériode | 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 douze 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) |
BudgetPropriétésNotifications
| Nom | Descriptif | Valeur |
|---|
BudgetTimePeriod
| Nom | Descriptif | Valeur |
|---|---|---|
| date de fin | 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 |
| date de début | Date de début du budget. | chaîne (obligatoire) |
Notification
| Nom | Descriptif | Valeur |
|---|---|---|
| contactE-mails | Adresses e-mail à laquelle envoyer la notification budgétaire lorsque le seuil est dépassé. Doit avoir au moins un e-mail de contact ou un groupe de contacts spécifié dans les étendues Abonnement ou Groupe de ressources. Toutes les autres étendues doivent avoir au moins un e-mail de contact spécifié. | string[] (obligatoire) |
| contactGroupes | Groupes d’actions auxquels envoyer la notification budgétaire lorsque le seuil est dépassé. Doit être fourni en tant qu’ID de ressource Azure complet. Uniquement pris en charge dans les étendues d’abonnement ou de groupe de ressources. | chaîne de caractères[] |
| contactRôles | Contactez les rôles pour envoyer la notification budgétaire au moment où le seuil est dépassé. | chaîne de caractères[] |
| Activé | La notification est activée ou non. | bool (obligatoire) |
| paramètres régionaux | Langue dans laquelle le destinataire recevra la notification | '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' |
| opérateur | Opérateur de comparaison. | 'ÉgalÀ' « Plus grand que » '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) |
| thresholdType | Type de seuil | 'Réel' 'Prévu' |
Exemples d’utilisation
Échantillons Terraform
Un exemple de base de déploiement du budget de consommation.
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"
}
}
}
}