Budgets Microsoft.Consumption 2018-03-31
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 :
- Abonnements - Voir les commandes de déploiement d’abonnement
- Groupes de ressources - Voir commandes de déploiement de groupe de ressources
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 Bicep suivant à votre modèle.
resource symbolicname 'Microsoft.Consumption/budgets@2018-03-31' = {
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 | 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 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 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 » '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 la 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, 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 |
Ce modèle montre comment créer un budget dans le cadre d’un abonnement. |
Créer un budget avec filtre |
Ce modèle montre comment créer un budget dans le cadre d’un abonnement. |
Créer un budget simple |
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 :
- Abonnements - 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 des ressources
Pour créer une ressource Microsoft.Consumption/budgets, ajoutez le json suivant à votre modèle.
{
"type": "Microsoft.Consumption/budgets",
"apiVersion": "2018-03-31",
"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 | '2018-03-31' |
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. | '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 » '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 |
Ce modèle montre comment créer un budget sous un abonnement. |
Créer un budget avec un 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 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 :
- Abonnements
- Groupes de ressources
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 Terraform suivant à votre modèle.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Consumption/budgets@2018-03-31"
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@2018-03-31 » |
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 » « 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 » « 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 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 la 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) |