Geplante Kostenmanagement-Aktionsmodule
In diesem Artikel werden die geplanten Aktionen Bicep-Registrierungsmodule für das Kostenmanagement beschrieben, die Ihnen beim Senden einer E-Mail zu einem Zeitplan oder beim Erkennen einer Anomalie helfen.
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 |
Optional. Gibt die Art der geplanten Aktion an. Standard: E-Mail. |
private |
bool |
Optional. Gibt an, ob die geplante Aktion privat und nur vom aktuellen Benutzer bearbeitet werden kann. Wenn false, wird die geplante Aktion für andere Benutzer im selben Bereich freigegeben. Wird ignoriert, wenn die Art ist InsightAlert . Standardwert: false. |
builtInView |
string |
Optional. Gibt an, welche integrierte Ansicht verwendet werden soll. Es ist eine Verknüpfung für die Vollbild-ID. |
viewId |
string |
Optional. Erforderlich, wenn art und Email builtInView nicht festgelegt ist. Die Ressourcen-ID der Ansicht, an die die geplante Aktion gesendet wird. Die Ansicht muss entweder privat (Mandantebene) oder im Besitz desselben Bereichs wie die geplante Aktion sein. Wird ignoriert, wenn die Art festgelegt ist InsightAlert oder ob builtInView festgelegt ist. |
displayName |
string |
Optional. Der Anzeigename, der im Portal angezeigt werden soll, wenn die Liste der geplanten Aktionen angezeigt wird. Standard: (Name der geplanten Aktion). |
status |
string |
Optional. 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 |
Optional. Der Betreff der E-Mail, die an die E-Mail-Empfänger gesendet wird. Standard: (Ansichtsname). |
emailMessage |
string |
Optional. 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 |
Optional. Die Sprache, die für die E-Mail-Vorlage verwendet wird. Standard: en. |
emailRegionalFormat |
string |
Optional. Das regionale Format, das für Datumsangaben, Uhrzeiten und Zahlen verwendet wird. Standard: en-us. |
includeCsv |
bool |
Optional. Gibt an, ob eine Verknüpfung zu einer CSV-Datei mit den Sicherungsdaten für das Diagramm eingeschlossen werden soll. Wird ignoriert, wenn die Art ist InsightAlert . Standardwert: false. |
scheduleFrequency |
string |
Optional. 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 |
Optional. Erforderlich, wenn Art ist Email und scheduleFrequency ist Weekly . Liste der Wochentage, an denen E-Mails zugestellt werden sollen. Zulässig: Montag, Dienstag, Mittwoch, Donnerstag, Freitag, Samstag, Sonntag. Standard: Montag. |
scheduleDayOfMonth |
int |
Optional. Erforderlich, wenn Art ist Email und scheduleFrequency ist Monthly . Der Tag des Monats, an dem E-Mails zugestellt werden sollen. Die monatlichen Kosten sind erst am dritten Tag des Monats abgeschlossen. Dieser Wert oder scheduleWeeksOfMonth ist erforderlich, wenn scheduleFrequency ist Monthly . Standard: 0 (nicht festgelegt). |
scheduleWeeksOfMonth |
array |
Optional. Liste der Wochen des Monats, die E-Mails zugestellt werden sollen. Dieser Wert oder scheduleDayOfMonth ist erforderlich, wenn scheduleFrequency ist Monthly . Zulässig: First, Second, Third, Fourth, Last. Standard [] (nicht festgelegt). |
scheduleStartDate |
string |
Optional. 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. Default = Now. |
scheduleEndDate |
string |
Optional. 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 können Sie eine E-Mail an einen Zeitplan senden oder wenn eine Anomalie erkannt wird.
Planen einer E-Mail für eine integrierte Ansicht
Abonnement Ressourcengruppe
Erstellt eine freigegebene geplante Aktion für die integrierte DailyCosts-Ansicht.
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' ]
}
}
Planen einer E-Mail mit einem benutzerdefinierten Startdatum
Abonnement Ressourcengruppe
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'
}
}
Zugehöriger Inhalt
Verwandte Ressourcen:
- Bicep-Registrierung: Geplante Aktionen für Abonnements
- Bicep-Registrierung: Geplante Aktionen für Ressourcengruppen
- ScheduledActions-API-Referenz
Verwandte FinOps-Funktionen:
Verwandte Produkte:
Verwandte Lösungen: