sla.create

Beschreibung

object sla.create(object/array SLAs)

Mit dieser Methode können neue SLA-Objekte erstellt werden.

Diese Methode ist nur für die Benutzertypen Admin und Super admin verfügbar. Die Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle entzogen werden. Weitere Informationen finden Sie unter Benutzerrollen.

Parameter

(object/array) Zu erstellende SLA-Objekte.

Zusätzlich zu den standardmäßigen SLA-Eigenschaften akzeptiert die Methode die folgenden Parameter.

Parameter Typ Beschreibung
service_tags array Zu erstellende SLA-Service-Tags für die SLA.

Parameterverhalten:
- erforderlich
schedule array Zu erstellender SLA-Zeitplan für die SLA.
Die Angabe eines leeren Parameters wird als 24x7-Zeitplan interpretiert.
Standard: 24x7-Zeitplan.
excluded_downtimes array Zu erstellende ausgeschlossene SLA-Ausfallzeiten für die SLA.

Rückgabewerte

(object) Gibt ein Objekt zurück, das die IDs der erstellten SLAs unter der Eigenschaft slaids enthält. Die Reihenfolge der zurückgegebenen IDs entspricht der Reihenfolge der übergebenen SLAs.

Beispiele

Erstellen eines SLA

Weisen Sie an, einen SLA-Eintrag zu erstellen für:

  • die Verfolgung der Verfügbarkeit von SQL-Engine-bezogenen Services;
  • einen benutzerdefinierten Zeitplan für alle Wochentage, wobei die letzte Stunde am Samstag ausgeschlossen ist;
  • ein Gültigkeitsdatum am letzten Tag des Jahres 2022;
  • mit einer geplanten Ausfallzeit von 1 Stunde und 15 Minuten, beginnend um Mitternacht am 4. Juli;
  • die Berechnung des wöchentlichen SLA-Berichts wird aktiviert sein;
  • das minimal akzeptable SLO beträgt 99,9995 %.

Anfrage:

{
    "jsonrpc": "2.0",
    "method": "sla.create",
    "params": [
        {
            "name": "Datenbank-Verfügbarkeit",
            "slo": "99.9995",
            "period": "1",
            "timezone": "America/Toronto",
            "description": "Stellen Sie eine ausgezeichnete Verfügbarkeit für die wichtigsten Datenbank-Engines bereit.",
            "effective_date": 1672444800,
            "status": 1,
            "schedule": [
                {
                    "period_from": 0,
                    "period_to": 601200
                }
            ],
            "service_tags": [
                {
                    "tag": "database",
                    "operator": "0",
                    "value": "mysql"
                },
                {
                    "tag": "database",
                    "operator": "0",
                    "value": "postgresql"
                }
            ],
            "excluded_downtimes": [
                {
                    "name": "Einführung des Software-Versions-Upgrades",
                    "period_from": "1648760400",
                    "period_to": "1648764900"
                }
            ]
        }
    ],
    "id": 1
}

Antwort:

{
    "jsonrpc": "2.0",
    "result": {
        "slaids": [
            "5"
        ]
    },
    "id": 1
}

Quelle

CSla::create() in ui/include/classes/api/services/CSla.php.