本文說明成本管理排程動作 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 |
選擇性。 選擇要使用的內建視圖。 這是完整檢視 ID 的快捷方式。 |
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 年。 |
範例
下列範例可協助您依排程或偵測到異常時傳送電子郵件。
將電子郵件排程於內建檢視中
訂閱 資源群組
為 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' ]
}
}
安排電子郵件並設定特定開始日期
訂閱 資源群組
使用自定義開始/結束日期,為 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 工具和資源。
如果您要尋找特定的模組或範本,請投票給現有模組或建立新想法。 與其他人分享您的想法。 我們專注於擁有最多選票的想法。
相關內容
相關資源:
- Bicep 登錄: 訂用帳戶的排程動作
- Bicep 登錄: 資源群組的排程動作
- ScheduledActions API 參考文件
相關的 FinOps 功能:
相關產品:
相關解決方案: