Compartir a través de

Módulos de bicep de acción programada de Cost Management

  • Artículo

En este artículo se describen los módulos del Registro de Bicep de acciones programadas de Cost Management que le ayudan a enviar un correo electrónico según una programación o cuando se detecta una anomalía.

Las acciones programadas permiten configurar alertas de correo electrónico diarias, semanales o mensuales. Las acciones programadas se configuran en función de una vista de Cost Management, que se puede abrir y editar en Análisis de costos en Azure Portal. Las alertas por correo electrónico incluyen una imagen de la vista seleccionada y, opcionalmente, un vínculo a un archivo CSV con los datos de costos resumidos. También puede usar acciones programadas para configurar alertas de detección de anomalías para suscripciones.

Para obtener información sobre las alertas programadas, consulte Guardar y compartir vistas. Para obtener información sobre las alertas de anomalías, consulte Análisis de cargos inesperados.


Sintaxis

Versión: 1.1 Ámbitos: Suscripción, Grupo de recursos

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

Parámetros

Estos son los parámetros de los módulos de acción programada:

Nombre Escribir Descripción
name string Obligatorio. Nombre de la acción programada usada en el identificador de recurso.
kind string Opcional. Indica el tipo de acción programada. Valor predeterminado: correo electrónico.
private bool Opcional. Indica si la acción programada es privada y solo es editable por el usuario actual. Si es false, la acción programada se comparte con otros usuarios en el mismo ámbito. Se omite si kind es InsightAlert. Valor predeterminado: false.
builtInView string Opcional. Especifica la vista integrada que se va a usar. Es un acceso directo para el identificador de vista completo.
viewId string Opcional. Obligatorio si el tipo es Email y builtInView no está establecido. Identificador de recurso de la vista a la que envía la acción programada. La vista debe ser privada (nivel de inquilino) o propiedad del mismo ámbito que la acción programada. Se omite si el tipo es InsightAlert o si builtInView está establecido.
displayName string Opcional. Nombre para mostrar que se mostrará en el portal al ver la lista de acciones programadas. Valor predeterminado: (nombre de acción programada).
status string Opcional. Estado de la acción programada. Valor predeterminado: Habilitado.
notificationEmail string Necesario. Dirección de correo electrónico de la persona o equipo responsable de esta acción programada. Esta dirección de correo electrónico se incluye en los correos electrónicos. Valor predeterminado: (dirección de correo electrónico del usuario que implementa la plantilla).
emailRecipients array Necesario. Lista de direcciones de correo electrónico que deben recibir correos electrónicos. Se requiere al menos una dirección de correo electrónico válida.
emailSubject string Opcional. Asunto del correo electrónico que se envía a los destinatarios del correo electrónico. Valor predeterminado: (nombre de vista).
emailMessage string Opcional. Incluya un mensaje para que los destinatarios agreguen contexto sobre por qué reciben el correo electrónico, qué hacer o quién ponerse en contacto. Valor predeterminado: "" (sin mensaje).
emailLanguage string Opcional. Idioma que se usa para la plantilla de correo electrónico. Valor predeterminado: en.
emailRegionalFormat string Opcional. Formato regional que se usa para fechas, horas y números. Valor predeterminado: en-us.
includeCsv bool Opcional. Indica si se debe incluir un vínculo a un archivo CSV con los datos de respaldo del gráfico. Se omite si kind es InsightAlert. Valor predeterminado: false.
scheduleFrequency string Opcional. Frecuencia con la que se ejecuta la acción programada. Valor predeterminado: diario para Email y semanal para InsightAlert.
scheduleDaysOfWeek array Opcional. Obligatorio si kind es Email y scheduleFrequency es Weekly. Lista de días de la semana en que se deben entregar los correos electrónicos. Permitido: lunes, martes, miércoles, jueves, viernes, sábado, domingo. Valor predeterminado: lunes.
scheduleDayOfMonth int Opcional. Obligatorio si kind es Email y scheduleFrequency es Monthly. El día del mes en el que se deben entregar los correos electrónicos. El costo mensual no es final hasta el tercer día del mes. Este valor o scheduleWeeksOfMonth es necesario si scheduleFrequency es Monthly. Valor predeterminado: 0 (no establecido).
scheduleWeeksOfMonth array Opcional. Lista de semanas del mes en que se deben entregar los correos electrónicos. Este valor o scheduleDayOfMonth es necesario si scheduleFrequency es Monthly. Permitido: Primero, Segundo, Tercero, Cuarto, Último. Valor predeterminado [] (no establecido).
scheduleStartDate string Opcional. El primer día que se debe ejecutar la programación. Use la hora para indicar cuándo desea recibir correos electrónicos. Debe estar en el formato aaaa-MM-ddTHH:miZ. Valor predeterminado = Ahora.
scheduleEndDate string Opcional. El último día que se debe ejecutar la programación. Debe tener el formato aaaa-MM-dd. Valor predeterminado = 1 año desde la fecha de inicio.

Ejemplos

Los ejemplos siguientes le ayudan a enviar un correo electrónico según una programación o cuando se detecta una anomalía.

Programar un correo electrónico para una vista integrada

Suscripción  Grupo de recursos

Crea una acción programada compartida para la vista integrada 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' ]
  }
}

Programar un correo electrónico con una fecha de inicio personalizada

Suscripción  Grupo de recursos

Crea una acción programada privada para la vista integrada DailyCosts con fechas de inicio y finalización personalizadas.

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

Configuración de una alerta de anomalías

Subscription

Crea una alerta de anomalías para una suscripción.

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

Contenido relacionado

Recursos relacionados

Funcionalidades relacionadas de FinOps:

Productos relacionados:

Soluciones relacionadas: