Delen via

Bicep-modules voor geplande actie van Cost Management

  • Artikel

In dit artikel worden de door Cost Management geplande acties Bicep Registry-modules beschreven waarmee u een e-mailbericht kunt verzenden volgens een planning of wanneer een anomalie wordt gedetecteerd.

Met geplande acties kunt u e-mailwaarschuwingen dagelijks, wekelijks of maandelijks configureren. Geplande acties worden geconfigureerd op basis van een Cost Management-weergave, die kan worden geopend en bewerkt in Kostenanalyse in Azure Portal. E-mailwaarschuwingen bevatten een afbeelding van de geselecteerde weergave en eventueel een koppeling naar een CSV-bestand met de samengevatte kostengegevens. U kunt ook geplande acties gebruiken om anomaliedetectiewaarschuwingen voor abonnementen te configureren.

Zie Weergaven opslaan en delen voor meer informatie over geplande waarschuwingen. Zie Onverwachte kosten analyseren voor meer informatie over anomaliewaarschuwingen.


Syntaxis

Versie: 1.1 Bereiken: Abonnement, Resourcegroep

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

Parameters

Dit zijn de parameters voor de geplande actiemodules:

Name Type Description
name string Vereist. Naam van de geplande actie die wordt gebruikt in de resource-id.
kind string Optioneel. Geeft het type geplande actie aan. Standaard: e-mail.
private bool Optioneel. Geeft aan of de geplande actie privé is en alleen kan worden bewerkt door de huidige gebruiker. Als dit onwaar is, wordt de geplande actie gedeeld met andere gebruikers in hetzelfde bereik. Genegeerd als soort is InsightAlert. Standaard: onwaar.
builtInView string Optioneel. Hiermee geeft u op welke ingebouwde weergave moet worden gebruikt. Het is een snelkoppeling voor de volledige weergave-id.
viewId string Optioneel. Vereist als soort is Email en builtInView niet is ingesteld. De resource-id van de weergave waarnaar de geplande actie wordt verzonden. De weergave moet privé zijn (tenantniveau) of eigendom zijn van hetzelfde bereik als de geplande actie. Genegeerd als soort is InsightAlert of als builtInView is ingesteld.
displayName string Optioneel. De weergavenaam die moet worden weergegeven in de portal bij het weergeven van de lijst met geplande acties. Standaard: (naam van geplande actie).
status string Optioneel. De status van de geplande actie. Standaard: Ingeschakeld.
notificationEmail string Vereist. E-mailadres van de persoon of het team die verantwoordelijk is voor deze geplande actie. Dit e-mailadres is opgenomen in e-mailberichten. Standaard: (e-mailadres van de gebruiker die de sjabloon implementeert).
emailRecipients array Vereist. Lijst met e-mailadressen die e-mailberichten moeten ontvangen. Er is ten minste één geldig e-mailadres vereist.
emailSubject string Optioneel. Het onderwerp van het e-mailbericht dat naar de geadresseerden van de e-mail wordt verzonden. Standaard: (weergavenaam).
emailMessage string Optioneel. Voeg een bericht toe voor geadresseerden om context toe te voegen over waarom ze het e-mailbericht ontvangen, wat u moet doen en/of wie er contact moet opnemen. Standaard: "" (geen bericht).
emailLanguage string Optioneel. De taal die wordt gebruikt voor de e-mailsjabloon. Standaard: en.
emailRegionalFormat string Optioneel. De regionale indeling die wordt gebruikt voor datums, tijden en getallen. Standaard: en-us.
includeCsv bool Optioneel. Geeft aan of een koppeling naar een CSV-bestand met de back-upgegevens voor de grafiek moet worden opgenomen. Genegeerd als soort is InsightAlert. Standaard: onwaar.
scheduleFrequency string Optioneel. De frequentie die door de geplande actie wordt uitgevoerd. Standaard: Dagelijks voor Email en Wekelijks voor InsightAlert.
scheduleDaysOfWeek array Optioneel. Vereist als soort is Email en scheduleFrequency is Weekly. Lijst met dagen van de week dat e-mailberichten moeten worden bezorgd. Toegestaan: maandag, dinsdag, woensdag, donderdag, vrijdag, zaterdag, zondag. Standaard: maandag.
scheduleDayOfMonth int Optioneel. Vereist als soort is Email en scheduleFrequency is Monthly. De dag van de maand dat e-mailberichten moeten worden bezorgd. De maandelijkse kosten zijn pas de derde dag van de maand definitief. Deze waarde of scheduleWeeksOfMonth is vereist als scheduleFrequency is Monthly. Standaard: 0 (niet ingesteld).
scheduleWeeksOfMonth array Optioneel. Lijst met weken van de maand dat e-mailberichten moeten worden bezorgd. Deze waarde of scheduleDayOfMonth is vereist als scheduleFrequency is Monthly. Toegestaan: Eerste, Tweede, Derde, Vierde, Laatste. Standaard [] (niet ingesteld).
scheduleStartDate string Optioneel. De eerste dag dat het schema moet worden uitgevoerd. Gebruik de tijd om aan te geven wanneer u e-mailberichten wilt ontvangen. Moet de notatie jjjj-MM-ddTHH:miZ hebben. Standaard = Nu.
scheduleEndDate string Optioneel. De laatste dag dat het schema moet worden uitgevoerd. Moet de notatie jjjj-MM-dd hebben. Standaard = 1 jaar vanaf begindatum.

Voorbeelden

De volgende voorbeelden helpen u bij het verzenden van een e-mailbericht volgens een planning of wanneer een anomalie wordt gedetecteerd.

Een e-mailbericht plannen voor een ingebouwde weergave

Abonnementsresourcegroep

Hiermee maakt u een gedeelde geplande actie voor de ingebouwde weergave 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' ]
  }
}

Een e-mailbericht plannen met een aangepaste begindatum

Abonnementsresourcegroep

Hiermee maakt u een persoonlijke geplande actie voor de ingebouwde weergave DailyCosts met aangepaste begin- en einddatums.

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

Een anomaliewaarschuwing configureren

Abonnement

Hiermee maakt u een anomaliewaarschuwing voor een 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'
  }
}

Gerelateerde inhoud

Gerelateerde resources:

Gerelateerde FinOps-mogelijkheden:

Gerelateerde producten:

Verwante oplossingen: