Zabbix Documentation 1.8

3.04.04.4 (current)| In development:5.0 (devel)| Unsupported:1.82.02.22.43.23.44.2Guidelines

User Tools

Site Tools


Sidebar

api:user:updatemedia

updateMedia()

Available since version: 1.8

Parameters

Multidimensional array with user data and user media data

ParameterTypeOptionalDescriptionDetails
usersarray User objects to update
mediasarray Yes Media objects which should be updated (removed / added).

Returns

ParameterDescription
resultOperation successful. Result will contain array of updated User IDs.
errorIn case of any errors

Example

Add two user media, remove all current for user with ID “100100000010092”

{
"jsonrpc":"2.0",
"method":"user.updateMedia",
"params":{ 
"users": [
  { "userid": "100100000010092" }
],
"medias": [
  {"mediatypeid": "100100000000001", "sendto": "[email protected]", "active": "2", "severity": "56", "period": "5-7,09:00-17:00;"},
  {"mediatypeid": "100100000000002", "sendto": "[email protected]", "active": "2", "severity": "63", "period": "1-5,07:00-19:00;"}
]
},
"auth":"f223adf833b2bf2ff38574a67bba6372",
"id":2
}

User media updated successfully:

{
"jsonrpc":"2.0",
"result":{
   "userids":["100100000010092"]
},
"id":2
}