Freigeben über


Geplante Aktionsmodule für das Cost Management mit Bicep

In diesem Artikel werden die Bicep-Registry-Module für geplante Aktionen im Kostenmanagement beschrieben, die Ihnen helfen, eine E-Mail nach einem Zeitplan oder beim Erkennen einer Anomalie zu senden.

Mit geplanten Aktionen können Sie E-Mail-Benachrichtigungen täglich, wöchentlich oder monatlich konfigurieren. Geplante Aktionen werden basierend auf einer Kostenverwaltungsansicht konfiguriert, die in der Kostenanalyse in der Azure-Portal geöffnet und bearbeitet werden kann. E-Mail-Warnungen enthalten ein Bild der ausgewählten Ansicht und optional einen Link zu einer CSV-Datei mit den zusammengefassten Kostendaten. Sie können auch geplante Aktionen verwenden, um Anomalieerkennungswarnungen für Abonnements zu konfigurieren.

Informationen zu geplanten Warnungen finden Sie unter " Speichern und Freigeben von Ansichten". Informationen zu Anomaliewarnungen finden Sie unter Analysieren unerwarteter Gebühren.


Syntax

Version: 1.1 Bereiche: Abonnement, Ressourcengruppe

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'
  }
}

Parameter

Hier sind die Parameter für die geplanten Aktionsmodule:

Name Typ BESCHREIBUNG
name string Erforderlich. Name der geplanten Aktion, die in der Ressourcen-ID verwendet wird.
kind string Wahlfrei. Gibt die Art der geplanten Aktion an. Standard: E-Mail.
private bool Wahlfrei. Gibt an, ob die geplante Aktion privat und nur vom aktuellen Benutzer bearbeitet werden kann. Wenn falsch, wird die geplante Aktion mit anderen Benutzern im selben Bereich geteilt. Wird ignoriert, wenn der Typ InsightAlert ist. Standardwert: false.
builtInView string Wahlfrei. Gibt an, welche integrierte Ansicht verwendet werden soll. Es ist eine Abkürzung für die Gesamtansicht-ID.
viewId string Wahlfrei. Erforderlich, wenn Art Email und builtInView nicht festgelegt sind. Die Ressourcen-ID der Ansicht, an die die geplante Aktion gesendet wird. Die Ansicht muss entweder privat (Mandantenebene) sein oder zum selben Bereich wie die geplante Aktion gehören. Wird ignoriert, wenn der Typ InsightAlert ist oder wenn builtInView eingestellt ist.
displayName string Wahlfrei. Der Anzeigename, der im Portal angezeigt werden soll, wenn die Liste der geplanten Aktionen angezeigt wird. Standard: (Name der geplanten Aktion).
status string Wahlfrei. Der Status der geplanten Aktion. Standard: Aktiviert.
notificationEmail string Erforderlich. E-Mail-Adresse der Person oder des Teams, die für diese geplante Aktion verantwortlich ist. Diese E-Mail-Adresse ist in E-Mails enthalten. Standard: (E-Mail-Adresse des Benutzers, der die Vorlage bereitstellt).
emailRecipients array Erforderlich. Liste der E-Mail-Adressen, die E-Mails empfangen sollen. Mindestens eine gültige E-Mail-Adresse ist erforderlich.
emailSubject string Wahlfrei. Der Betreff der E-Mail, die an die E-Mail-Empfänger gesendet wird. Standard: (Ansichtsname).
emailMessage string Wahlfrei. Fügen Sie eine Nachricht für Empfänger hinzu, um Kontext darüber hinzuzufügen, warum sie die E-Mail erhalten, was zu tun ist und/oder wer kontaktiert werden soll. Standard: "" (keine Nachricht).
emailLanguage string Wahlfrei. Die Sprache, die für die E-Mail-Vorlage verwendet wird. Standard: en.
emailRegionalFormat string Wahlfrei. Das regionale Format, das für Datumsangaben, Uhrzeiten und Zahlen verwendet wird. Voreinstellung: en-us.
includeCsv bool Wahlfrei. Gibt an, ob eine Verknüpfung zu einer CSV-Datei mit den Sicherungsdaten für das Diagramm eingeschlossen werden soll. Wird ignoriert, wenn der Typ InsightAlert ist. Standardwert: false.
scheduleFrequency string Wahlfrei. Die Häufigkeit, mit der die geplante Aktion ausgeführt wird. Standard: Täglich für Email und wöchentlich für InsightAlert.
scheduleDaysOfWeek array Wahlfrei. Erforderlich, wenn der Typ Email ist und die scheduleFrequency Weekly ist. Liste der Wochentage, an denen E-Mails zugestellt werden sollen. Zulässig: Montag, Dienstag, Mittwoch, Donnerstag, Freitag, Samstag, Sonntag. Standard: Montag.
scheduleDayOfMonth int Wahlfrei. Erforderlich, wenn der Typ Email ist und die scheduleFrequency Monthly ist. Der Tag des Monats, an dem E-Mails zugestellt werden sollen. Die monatlichen Kosten sind erst am dritten Tag des Monats endgültig. Dieser Wert oder die scheduleWeeksOfMonth sind erforderlich, wenn scheduleFrequency Monthly ist. Standard: 0 (nicht festgelegt).
scheduleWeeksOfMonth array Wahlfrei. Liste der Wochen des Monats, in denen die E-Mails geliefert werden sollen. Dieser Wert oder scheduleDayOfMonth ist erforderlich, wenn scheduleFrequency Monthly ist. Zulässig: Erster, Zweiter, Dritter, Vierter, Letzter. Standard [] (nicht festgelegt).
scheduleStartDate string Wahlfrei. Der erste Tag, an dem der Zeitplan ausgeführt werden soll. Verwenden Sie die Zeit, um anzugeben, wann Sie E-Mails empfangen möchten. Muss im Format jjjj-MM-ddTHH:miZ vorliegen. Standard = Jetzt.
scheduleEndDate string Wahlfrei. Der letzte Tag, an dem der Zeitplan ausgeführt werden soll. Muss im Format jjjj-MM-tt sein. Standardwert = 1 Jahr ab Startdatum.

Beispiele

In den folgenden Beispielen erfahren Sie, wie Sie eine E-Mail nach einem Zeitplan oder beim Erkennen einer Anomalie senden können.

E-Mail für eine integrierte Ansicht planen

Abonnementressourcengruppe

Erstellt eine gemeinsam genutzte geplante Aktion für die integrierte Ansicht von 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' ]
  }
}

Eine E-Mail mit einem benutzerdefinierten Startdatum planen

Abonnementressourcengruppe

Erstellt eine private geplante Aktion für die integrierte DailyCosts-Ansicht mit benutzerdefinierten Anfangs-/Enddaten.

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
  }
}

Konfigurieren einer Anomaliebenachrichtigung

Abonnement

Erstellt eine Anomaliebenachrichtigung für ein 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'
  }
}

Feedback senden

Lassen Sie uns mit einer kurzen Bewertung wissen, wie wir abschneiden. Wir verwenden diese Rezensionen, um FinOps-Tools und -Ressourcen zu verbessern und zu erweitern.

Wenn Sie nach einem bestimmten Modul oder einer bestimmten Vorlage suchen, wählen Sie eine vorhandene Oder erstellen Sie eine neue Idee. Teilen Sie Ihre Ideen mit anderen. Wir konzentrieren uns auf Ideen mit den meisten Stimmen.


Verwandte Ressourcen:

Verwandte FinOps-Funktionen:

Verwandte Produkte:

Verwandte Lösungen: