共用方式為

成本管理排程動作 bicep 模組

  • 發行項

本文說明成本管理排程動作 Bicep 登錄模組，可協助您依排程傳送電子郵件，或偵測到異常時傳送電子郵件。

排程的動作可讓您每天、每周或每月設定電子郵件警示。 排程的動作是根據成本管理檢視來設定的，可在 Azure 入口網站的成本分析中開啟和編輯。 電子郵件警示包含所選檢視的圖片，以及選擇性地連結至包含摘要成本數據的 CSV 檔案。 您也可以使用排程的動作來設定訂用帳戶的異常偵測警示。

若要瞭解排程的警示，請參閱 儲存和共享檢視。 若要瞭解異常警示，請參閱 分析非預期的費用。


語法

版本： 1.1 範圍： 訂用帳戶、資源群組

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

參數

以下是排程動作模組的參數：

名稱 類型​​ 描述
name string 必要。 資源識別碼中使用的排程動作名稱。
kind string 選擇性。 表示排程動作的種類。 預設值：電子郵件。
private bool 選擇性。 指出排程的動作是否為私用，而且只能由目前用戶編輯。 如果為 false，排程的動作會與相同範圍內的其他用戶共用。 如果 kind 為 InsightAlert，則會忽略 。 預設：false。
builtInView string 選擇性。 指定要使用的內建檢視。 這是完整檢視標識碼的快捷方式。
viewId string 選擇性。 如果 kind 為 Email 且未設定 builtInView，則為必要專案。 排程動作所傳送之檢視的資源標識碼。 檢視必須是私人（租用戶層級），或擁有與排程動作相同的範圍。 如果 kind 為 InsightAlert 或已設定 builtInView，則會忽略 。
displayName string 選擇性。 檢視排程動作清單時，入口網站中顯示的顯示名稱。 預設值：（排程的動作名稱）。
status string 選擇性。 排程動作的狀態。 預設：啟用。
notificationEmail string 必要。 負責此排程動作的人員或小組的電子郵件位址。 此電子郵件位址包含在電子郵件中。 預設值：（部署範本的使用者電子郵件位址）。
emailRecipients array 必要。 應接收電子郵件的電子郵件地址清單。 至少需要一個有效的電子郵件位址。
emailSubject string 選擇性。 傳送給電子郵件收件者的電子郵件主旨。 預設值：（檢視名稱）。
emailMessage string 選擇性。 包含郵件給收件者，以新增他們收到電子郵件的原因、該怎麼做和/或聯繫人的內容。 預設值： "" （沒有訊息）。
emailLanguage string 選擇性。 用於電子郵件範本的語言。 默認值：en。
emailRegionalFormat string 選擇性。 用於日期、時間和數位的區域格式。 默認值：en-us。
includeCsv bool 選擇性。 指出是否要包含 CSV 檔案的連結，以及圖表的備份數據。 如果 kind 為 InsightAlert，則會忽略 。 預設：false。
scheduleFrequency string 選擇性。 排程動作執行的頻率。 預設值：的每日和 Email 每周的 InsightAlert。
scheduleDaysOfWeek array 選擇性。 如果 kind 為 Email ，且 scheduleFrequency 為 ，則為 Weekly必要項。 應傳遞電子郵件的一周天數清單。 允許：星期一、星期二、星期三、星期四、星期五、星期六、星期日。 默認值：星期一。
scheduleDayOfMonth int 選擇性。 如果 kind 為 Email ，且 scheduleFrequency 為 ，則為 Monthly必要項。 應傳遞電子郵件的當月日。 每月成本直到當月的第三天才會結束。 如果 scheduleFrequency 為 Monthly，則需要此值或 scheduleWeeksOfMonth。 預設值：0（未設定）。
scheduleWeeksOfMonth array 選擇性。 應傳遞電子郵件的當月周清單。 如果 scheduleFrequency 為 Monthly，則需要此值或 scheduleDayOfMonth。 允許：第一個、第二個、第三個、第四個、最後一個。 預設 [] （未設定）。
scheduleStartDate string 選擇性。 排程應該執行的第一天。 使用時間指出您想要接收電子郵件的時間。 格式必須是 yyyy-MM-ddTHH：miZ。 預設值 = Now。
scheduleEndDate string 選擇性。 排程應該執行的最後一天。 格式必須是 yyyy-MM-dd。 預設值 = 開始日期起的 1 年。

範例

下列範例可協助您依排程或偵測到異常時傳送電子郵件。

排程內建檢視的電子郵件

訂用帳戶 資源群組

建立每日成本內建檢視的共用排程動作。

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

排程具有自定義開始日期的電子郵件

訂用帳戶 資源群組

使用自定義開始/結束日期，為 DailyCosts 內建檢視建立私人排程動作。

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

設定異常警示

訂用帳戶

建立訂用帳戶的異常警示。

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

相關內容

相關資源：

相關的 FinOps 功能：

相關產品：

相關解決方案：