Budgets Microsoft.Consommation 2018-08-31
Définition de ressource Bicep
Le type de ressource budgets peut être déployé avec des opérations qui ciblent :
- d’abonnement - Voir commandes de déploiement d’abonnement* groupes de ressources - Voir commandes de déploiement de groupes de ressources
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@2018-08-31' = {
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 |
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 :
- d’abonnement - Voir commandes de déploiement d’abonnement* groupes de ressources - Voir commandes de déploiement de groupes de ressources
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": "2018-08-31",
"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 | '2018-08-31' |
| 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
|
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 :
- les groupes de ressources* abonnement
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@2018-08-31"
name = "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) |
| Propriétés | Propriétés du budget. | BudgetProperties |
| type | Type de ressource | « Microsoft.Consumption/budgets@2018-08-31 » |
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) |