Alertes personnalisées

Langue :

Une alerte personnalisée est une action d'alerte pour un événement personnalisé. Spécifiez custom pour la valeur de category.

L'événement personnalisé est défini dans un workflow. Au lieu d'effectuer une sélection parmi des événements prédéfinis, spécifiez les propriétés suivantes qui décrivent l'événement défini dans le workflow.

Table 10 Propriétés des alertes personnalisées

Propriété	Type	Description
`severity`	String	Facultatif. Gravité de l'événement qui a déclenché l'alerte. Les valeurs valides sont : Minor, Major ou Critical.
`description`	String	Obligatoire. Description de l'événement qui a déclenché l'alerte.
`response`	String	Facultatif. Description des actions qui seront effectuées par le système pour atténuer les effets de l'événement.
`impact`	String	Facultatif. Description de l'effet de l'événement sur l'appareil.
`recommended_action`	String	Facultatif. Description des mesures que l'administrateur doit prendre pour atténuer les effets de l'événement.

Configuration d'autorisations pour créer et publier des alertes personnalisées

Pour créer des alertes personnalisées, l'utilisateur doit disposer de l'autorisation allow_configure dans la portée alert. Pour publier des alertes personnalisées, l'utilisateur doit disposer de l'autorisation allow_post dans la portée alert. Reportez-vous à la section Autorisations requises pour utiliser des alertes personnalisées du manuel Guide d’administration d’Oracle® ZFS Storage Appliance, version OS8.8.x.

Création d'une alerte personnalisée

Spécifiez custom pour la valeur de category, et définissez une valeur pour la propriété description au moins du Table 10, Propriétés des alertes personnalisées.

Exemple de demande :

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

Exemple de résultat :

Notez l'UUID de l'alerte dans la sortie. Vous en aurez besoin pour publier l'alerte.

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

Modifiez cette alerte personnalisée comme toute autre alerte, tel que décrit dans Modification d'une action d'alerte, en ajoutant ou en modifiant les valeurs des propriétés severity, description, response, impact ou recommended_action.

Spécifiez une réponse à cette alerte personnalisée comme pour toute autre alerte, tel que décrit dans Définition d'une réponse à un événement et Modification d'une réponse à un événement.

Supprimez une réponse à une alerte ou une alerte personnalisée comme pour toute autre alerte, tel que décrit dans Suppression d'une réponse à un événement et Suppression d'une action d'alerte.

Publication d'une alerte personnalisée

Vous devez fournir l'UUID de l'alerte personnalisée à publier. L'UUID apparaît lorsque vous créez ou énumérez l'alerte. Reportez-vous à Création d'une alerte personnalisée et à Obtention d'une seule action d'alerte.

Vous ne pouvez publier qu'une alerte dont la valeur category indique custom.

Outre l'UUID de l'alerte, vous devez spécifier des propriétés parmi celles répertoriées dans le Table 10, Propriétés des alertes personnalisées qui ne sont pas indiquées dans l'alerte. Celles qui le sont peuvent recevoir de nouvelles valeurs à la publication de l'alerte.

Exemple de demande :

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

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

Exemple de résultat :

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