Condividi tramite

Moduli bicep dell'azione pianificata di Gestione costi

  • Articolo

Questo articolo descrive le azioni pianificate di Gestione costi moduli del Registro di sistema Bicep che consentono di inviare un messaggio di posta elettronica in base a una pianificazione o quando viene rilevata un'anomalia.

Le azioni pianificate consentono di configurare gli avvisi di posta elettronica su base giornaliera, settimanale o mensile. Le azioni pianificate vengono configurate in base a una visualizzazione Gestione costi, che può essere aperta e modificata nell'analisi dei costi nella portale di Azure. Gli avvisi di posta elettronica includono un'immagine della visualizzazione selezionata e, facoltativamente, un collegamento a un file CSV con i dati dei costi riepilogati. È anche possibile usare le azioni pianificate per configurare gli avvisi di rilevamento anomalie per le sottoscrizioni.

Per informazioni sugli avvisi pianificati, vedere Salvare e condividere visualizzazioni. Per informazioni sugli avvisi relativi alle anomalie, vedere Analizzare gli addebiti imprevisti.


Sintassi

Versione: 1.1 Ambiti: Sottoscrizione, Gruppo di risorse

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

Parametri

Ecco i parametri per i moduli di azione pianificati:

Nome Tipo Descrizione
name string Obbligatorio. Nome dell'azione pianificata usata nell'ID risorsa.
kind string Facoltativo. Indica il tipo di azione pianificata. Impostazione predefinita: posta elettronica.
private bool Facoltativo. Indica se l'azione pianificata è privata e modificabile solo dall'utente corrente. Se false, l'azione pianificata viene condivisa con altri utenti nello stesso ambito. Ignorato se il tipo è InsightAlert. Valore predefinito: false.
builtInView string Facoltativo. Specifica la visualizzazione predefinita da utilizzare. Si tratta di un collegamento per l'ID visualizzazione completa.
viewId string Facoltativo. Obbligatorio se il tipo è Email e builtInView non è impostato. ID risorsa della visualizzazione a cui invia l'azione pianificata. La vista deve essere privata (livello tenant) o di proprietà dello stesso ambito dell'azione pianificata. Ignorato se kind è InsightAlert o se builtInView è impostato.
displayName string Facoltativo. Nome visualizzato da visualizzare nel portale quando si visualizza l'elenco di azioni pianificate. Impostazione predefinita: (nome dell'azione pianificata).
status string Facoltativo. Stato dell'azione pianificata. Predefinito: Abilitata.
notificationEmail string Obbligatorio. Indirizzo di posta elettronica della persona o del team responsabile di questa azione pianificata. Questo indirizzo di posta elettronica è incluso nei messaggi di posta elettronica. Impostazione predefinita: (indirizzo di posta elettronica dell'utente che distribuisce il modello).
emailRecipients array Obbligatorio. Elenco di indirizzi di posta elettronica che devono ricevere messaggi di posta elettronica. È necessario almeno un indirizzo di posta elettronica valido.
emailSubject string Facoltativo. Oggetto del messaggio di posta elettronica inviato ai destinatari del messaggio di posta elettronica. Impostazione predefinita: (nome visualizzazione).
emailMessage string Facoltativo. Includere un messaggio per i destinatari per aggiungere contesto sul motivo per cui ricevono il messaggio di posta elettronica, cosa fare e/o chi contattare. Impostazione predefinita: "" (nessun messaggio).
emailLanguage string Facoltativo. Lingua utilizzata per il modello di posta elettronica. Impostazione predefinita: en.
emailRegionalFormat string Facoltativo. Formato a livello di area utilizzato per date, ore e numeri. Impostazione predefinita: en-us.
includeCsv bool Facoltativo. Indica se includere un collegamento a un file CSV con i dati di backup per il grafico. Ignorato se il tipo è InsightAlert. Valore predefinito: false.
scheduleFrequency string Facoltativo. Frequenza di esecuzione dell'azione pianificata. Impostazione predefinita: giornaliera per Email e settimanale per InsightAlert.
scheduleDaysOfWeek array Facoltativo. Obbligatorio se il tipo è Email e scheduleFrequency è Weekly. Elenco dei giorni della settimana in cui devono essere recapitati i messaggi di posta elettronica. Consentito: lunedì, martedì, mercoledì, giovedì, venerdì, sabato, domenica. Impostazione predefinita: lunedì.
scheduleDayOfMonth int Facoltativo. Obbligatorio se il tipo è Email e scheduleFrequency è Monthly. Giorno del mese in cui devono essere recapitati i messaggi di posta elettronica. Il costo mensile non è finale fino al terzo giorno del mese. Questo valore o scheduleWeeksOfMonth è obbligatorio se scheduleFrequency è Monthly. Valore predefinito: 0 (non impostato).
scheduleWeeksOfMonth array Facoltativo. Elenco di settimane del mese in cui devono essere recapitati i messaggi di posta elettronica. Questo valore o scheduleDayOfMonth è obbligatorio se scheduleFrequency è Monthly. Consentito: Primo, Secondo, Terzo, Quarto, Ultimo. Impostazione predefinita [] (non impostata).
scheduleStartDate string Facoltativo. Il primo giorno in cui deve essere eseguita la pianificazione. Usare il tempo per indicare quando si desidera ricevere messaggi di posta elettronica. Deve essere nel formato aa-MM-ggTHH:miZ. Default = Now.
scheduleEndDate string Facoltativo. Ultimo giorno in cui deve essere eseguita la pianificazione. Deve essere nel formato aaaa-MM-gg. Valore predefinito = 1 anno dalla data di inizio.

Esempi

Gli esempi seguenti consentono di inviare un messaggio di posta elettronica in base a una pianificazione o quando viene rilevata un'anomalia.

Pianificare un messaggio di posta elettronica per una visualizzazione predefinita

Sottoscrizione, Gruppo di risorse

Crea un'azione pianificata condivisa per la visualizzazione predefinita 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' ]
  }
}

Pianificare un messaggio di posta elettronica con una data di inizio personalizzata

Sottoscrizione, Gruppo di risorse

Crea un'azione pianificata privata per la visualizzazione predefinita DailyCosts con date di inizio/fine personalizzate.

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

Configurare un avviso di anomalia

Abbonamento

Crea un avviso di anomalia per una sottoscrizione.

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

Contenuto correlato

Risorse correlate:

Funzionalità FinOps correlate:

Prodotti correlati:

Soluzioni correlate: