mediatype.update
Beschreibung
object mediatype.update(object/array mediaTypes)
Diese Methode ermöglicht es Ihnen, vorhandene Medientypen zu aktualisieren.
Diese Methode ist nur für den Benutzertyp Super admin verfügbar.
Berechtigungen zum Aufrufen der Methode können in den Einstellungen der Benutzerrolle widerrufen werden.
Weitere Informationen finden Sie unter Benutzerrollen.
Wenn Übermittlungsmethoden im Feature-Flag $ZBX_FEATURE_FLAGS['media_type_denylist'] in der Frontend-Konfigurationsdatei (zabbix.conf.php) angegeben sind, ist der Benutzer nicht berechtigt, die Methode für die entsprechenden Medientypen aufzurufen.
Parameter
(object/array) Zu aktualisierende Medientyp-Eigenschaften.
Die Eigenschaft mediatypeid muss für jeden Medientyp definiert werden, alle
anderen Eigenschaften sind optional. Nur die übergebenen Eigenschaften werden
aktualisiert, alle anderen bleiben unverändert.
Zusätzlich zu den Standard-Medientyp-Eigenschaften akzeptiert die Methode die folgenden Parameter.
| Parameter | Type | Beschreibung |
|---|---|---|
| message_templates | array | Nachrichtenvorlagen zum Ersetzen der aktuellen Nachrichtenvorlagen. |
Rückgabewerte
(object) Gibt ein Objekt zurück, das die IDs der aktualisierten Medientypen
unter der Eigenschaft "mediatypeids" enthält.
Beispiele
Aktivieren eines Medientyps
Aktivieren Sie einen Medientyp, d. h. setzen Sie seinen Status auf „0“.
{
"jsonrpc": "2.0",
"method": "mediatype.update",
"params": {
"mediatypeid": "6",
"status": "0"
},
"id": 1
}Antwort:
{
"jsonrpc": "2.0",
"result": {
"mediatypeids": [
"6"
]
},
"id": 1
}Quelle
CMediaType::update() in ui/include/classes/api/services/CMediaType.php.