Partager via

Modules bicep de l’action planifiée Cost Management

  • Article

Cet article décrit les actions planifiées Cost Management des modules Bicep Registry qui vous aident à envoyer un e-mail selon une planification ou lorsqu’une anomalie est détectée.

Les actions planifiées vous permettent de configurer des alertes par e-mail quotidiennement, hebdomadaires ou mensuelles. Les actions planifiées sont configurées en fonction d’une vue Cost Management, qui peut être ouverte et modifiée dans l’analyse des coûts dans l’Portail Azure. Les alertes par e-mail incluent une image de l’affichage sélectionné et éventuellement un lien vers un fichier CSV avec les données de coût résumées. Vous pouvez également utiliser des actions planifiées pour configurer des alertes de détection d’anomalies pour les abonnements.

Pour en savoir plus sur les alertes planifiées, consultez Enregistrer et partager des vues. Pour en savoir plus sur les alertes d’anomalies, consultez Analyser les frais inattendus.


Syntaxe

Version : étendues 1.1 : Abonnement, groupe de ressources

module <string> 'br/public:cost/<scope>-scheduled-action:1.1' = {
  name: <string>
  params: {
    name: <string>
    kind: 'Email' | 'InsightAlert'
    private: <bool>
    builtInView: 'AccumulatedCosts' | 'CostByService' | 'DailyCosts'
    viewId: <string>
    displayName: <string>
    status: 'Enabled' | 'Disabled'
    notificationEmail: <string>
    emailRecipients: [ <string>, <string>, ... ]
    emailSubject: <string>
    emailMessage: <string>
    emailLanguage: <string>
    emailRegionalFormat: <string>
    includeCsv: <bool>
    scheduleFrequency: 'Daily' | 'Weekly' | 'Monthly'
    scheduleDaysOfWeek: [ 'Monday', 'Tuesday', 'Wednesday', 'Thursday', 'Friday', 'Saturday', 'Sunday' ]
    scheduleDayOfMonth: <int>
    scheduleWeeksOfMonth: [ 'First', 'Second', 'Third', 'Fourth', 'Last' ]
    scheduleStartDate: 'yyyy-MM-ddTHH:miZ'
    scheduleEndDate: 'yyyy-MM-dd'
  }
}

Paramètres

Voici les paramètres des modules d’action planifiés :

Nom Type Description
name string Obligatoire. Nom de l’action planifiée utilisée dans l’ID de ressource.
kind string facultatif. Indique le type d’action planifiée. Valeur par défaut : e-mail.
private bool facultatif. Indique si l’action planifiée est privée et modifiable uniquement par l’utilisateur actuel. Si la valeur est false, l’action planifiée est partagée avec d’autres utilisateurs dans la même étendue. Ignoré si le type est InsightAlert. Valeur par défaut : false.
builtInView string facultatif. Spécifie la vue intégrée à utiliser. Il s’agit d’un raccourci pour l’ID d’affichage complet.
viewId string facultatif. Obligatoire si le type est Email et que builtInView n’est pas défini. ID de ressource de la vue à laquelle l’action planifiée envoie. La vue doit être privée (niveau du locataire) ou appartenant à la même étendue que l’action planifiée. Ignoré si le type est InsightAlert ou si builtInView est défini.
displayName string facultatif. Nom complet à afficher dans le portail lors de l’affichage de la liste des actions planifiées. Valeur par défaut : (nom de l’action planifiée).
status string facultatif. État de l’action planifiée. Valeur par défaut : Activé.
notificationEmail string Obligatoire. Adresse e-mail de la personne ou de l’équipe responsable de cette action planifiée. Cette adresse e-mail est incluse dans les e-mails. Valeur par défaut : (adresse e-mail de l’utilisateur déployant le modèle).
emailRecipients array Obligatoire. Liste des adresses e-mail qui doivent recevoir des e-mails. Au moins une adresse e-mail valide est requise.
emailSubject string facultatif. Objet de l’e-mail envoyé aux destinataires de l’e-mail. Valeur par défaut : (nom de la vue).
emailMessage string facultatif. Incluez un message pour que les destinataires ajoutent un contexte sur la raison pour laquelle ils obtiennent l’e-mail, ce qu’il faut faire et/ou qui contacter. Valeur par défaut : "" (aucun message).
emailLanguage string facultatif. Langue utilisée pour le modèle d’e-mail. Valeur par défaut : en.
emailRegionalFormat string facultatif. Format régional utilisé pour les dates, les heures et les nombres. Valeur par défaut : en-us.
includeCsv bool facultatif. Indique s’il faut inclure un lien vers un fichier CSV avec les données de stockage du graphique. Ignoré si le type est InsightAlert. Valeur par défaut : false.
scheduleFrequency string facultatif. Fréquence à laquelle l’action planifiée s’exécute. Valeur par défaut : Quotidienne pour Email et Hebdomadaire pour InsightAlert.
scheduleDaysOfWeek array facultatif. Obligatoire si le type est Email et scheduleFrequency est Weekly. Liste des jours de la semaine pendant lesquels les e-mails doivent être remis. Autorisé : lundi, mardi, mercredi, jeudi, vendredi, samedi, dimanche. Valeur par défaut : Lundi.
scheduleDayOfMonth int facultatif. Obligatoire si le type est Email et scheduleFrequency est Monthly. Jour du mois où les e-mails doivent être remis. Le coût mensuel n’est pas final jusqu’au troisième jour du mois. Cette valeur ou scheduleWeeksOfMonth est requise si scheduleFrequency est Monthly. Valeur par défaut : 0 (non défini).
scheduleWeeksOfMonth array facultatif. Liste des semaines du mois où les e-mails doivent être remis. Cette valeur ou scheduleDayOfMonth est requise si scheduleFrequency est Monthly. Autorisé : Premier, Deuxième, Troisième, Quatrième, Dernier. Valeur par défaut [] (non définie).
scheduleStartDate string facultatif. Le premier jour de la planification doit s’exécuter. Utilisez l’heure pour indiquer quand vous souhaitez recevoir des e-mails. Doit être au format aaaa-MM-ddTHH :miZ. Valeur par défaut = Maintenant.
scheduleEndDate string facultatif. Le dernier jour de la planification doit s’exécuter. Doit être au format aaaa-MM-jj. Valeur par défaut = 1 an à partir de la date de début.

Exemples

Les exemples suivants vous aident à envoyer un e-mail selon une planification ou lorsqu’une anomalie est détectée.

Planifier un e-mail pour une vue intégrée

Abonnement Groupe de ressources

Crée une action planifiée partagée pour l’affichage intégré DailyCosts.

module dailyCostsAlert 'br/public:cost/subscription-scheduled-action:1.0.2' = {
  name: 'dailyCostsAlert'
  params: {
    name: 'DailyCostsAlert'
    displayName: 'My schedule'
    builtInView: 'DailyCosts'
    emailRecipients: [ 'ema@contoso.com' ]
    notificationEmail: 'ema@contoso.com'
    scheduleFrequency: 'Weekly'
    scheduleDaysOfWeek: [ 'Monday' ]
  }
}

Planifier un e-mail avec une date de début personnalisée

Abonnement Groupe de ressources

Crée une action planifiée privée pour l’affichage intégré DailyCosts avec des dates de début/fin personnalisées.

module privateAlert 'br/public:cost/resourcegroup-scheduled-action:1.0.2' = {
  name: 'privateAlert'
  params: {
    name: 'PrivateAlert'
    displayName: 'My private schedule'
    private: true
    builtInView: 'DailyCosts'
    emailRecipients: [ 'priya@contoso.com' ]
    notificationEmail: 'priya@contoso.com'
    scheduleFrequency: 'Monthly'
    scheduleDayOfMonth: 1
    scheduleStartDate: scheduleStartDate
    scheduleEndDate: scheduleEndDate
  }
}

Configurer une alerte d’anomalie

Abonnement

Crée une alerte d’anomalie pour un abonnement.

module anomalyAlert 'br/public:cost/subscription-scheduled-action:1.0.2' = {
  name: 'anomalyAlert'
  params: {
    name: 'AnomalyAlert'
    kind: 'InsightAlert'
    displayName: 'My anomaly check'
    emailRecipients: [ 'ana@contoso.com' ]
    notificationEmail: 'ana@contoso.com'
  }
}

Contenu connexe

Ressources connexes :

Fonctionnalités FinOps connexes :

Produits connexes :

Solutions connexes :