Go to main content

Guía de la API de RESTful de Oracle® ZFS Storage Appliance (versión OS8.8.x)

Salir de la Vista de impresión

Actualización: Agosto de 2021
 
 

Personalizar alertas

Una alerta personalizada es una acción de alerta para un evento personalizado. Indicar custom para el valor de category.

El evento personalizado se define en un flujo de trabajo. En lugar de seleccionar eventos predefinidos, especifique las siguientes propiedades para describir el evento definido en el flujo de trabajo.

Tabla 10  Propiedades de alerta personalizada
Propiedad
Tipo
Descripción
severity
String
Opcional. Gravedad del evento que generó la alerta. Los valores válidos son: menor, grave o crítico.
description
String
Necesario. Una descripción del evento que generó la alerta.
response
String
Opcional. Una descripción de las acciones que realizará el sistema para mitigar los efectos de este evento.
impact
String
Opcional. Una descripción del efecto que este evento tiene sobre el dispositivo.
recommended_action
String
Opcional. Una descripción de las acciones que debe realizar el administrador para mitigar los efectos de este evento.

Configurar autorizaciones para crear y publicar alertas personalizadas

Para crear alertas personalizadas, el usuario debe tener la autorización allow_configure en el ámbito de alert. Para publicar alertas personalizadas, el usuario debe tener la autorización allow_configure en el ámbito de alert. Consulte Autorizaciones requeridas para utilizar alertas personalizadas de Guía de administración de Oracle® ZFS Storage Appliance, versión OS8.8.x.

Crear una alerta personalizada

Especificar custom para el valor decategory y establecer un valor para, al menos, la propiedad description de Tabla 10, Propiedades de alerta personalizada.

Ejemplo de solicitud:

POST /api/alert/v1/actions
Accept: application/json
Content-Type: application/json

{"category": "custom", "severity": "Minor", "description": "Custom alert description",
"response": "What the system will do", "impact": "What happened to the appliance", 
"recommended_action": "What the administrator should do"}

Resultado de ejemplo:

Tenga en cuenta la uuid de la alerta en la salida. La necesitará para publicar la alerta.

{
    "actions": {
        "href": "/api/alert/v1/actions/actions-004",
        "category": "custom",
        "severity": "Minor",
        "description": "Custom alert description",
        "response": "What the system will do",
        "impact": "What happened to the appliance",
        "recommended_action": "What the administrator should do",
        "uuid": "custom-alert-uuid"
    }
}

Modifique esta alerta personalizada de la misma manera que modifica cualquier otra alerta, tal como se describe en Modificar una acción de alerta, al agregar o cambiar los valores de las propiedades severity, description, response, impact o recommended_action.

Especifique una respuesta a esta alerta personalizada de la misma manera que especifica una respuesta a cualquier otra alerta, tal como se describe en Especificar una respuesta para un evento y Modificar una respuesta para un evento.

Suprima una respuesta de alerta o una alerta personalizada de la misma manera que haría para cualquier otra alerta, tal como se describe en Suprimir una respuesta para un evento y Suprimir una acción de alerta.

Publicar una alerta personalizada

Debe proporcionar el UUID de la alerta personalizada que se debe publicar. El UUID se muestra cuando crea la alerta y cuando la enumera. Consulte Crear una alerta personalizada y Enumerar una acción de alerta única.

Solo puede publicar una alerta que tenga un valor de category de custom.

Además del UUID de la alerta, debe especificar cualquiera de las propiedades enumeradas en Tabla 10, Propiedades de alerta personalizada que no se especifican en la alerta. Las propiedades que se especifican en la alerta pueden recibir nuevos valores cuando se publica la alerta.

Ejemplo de solicitud:

POST /api/alert/v1/postalert
Accept: application/json
Content-Type: application/json

{"uuid": "custom-alert-uuid"}

Resultado de ejemplo:

{
    "uuid": "posted-alert-uuid"
}