PLESK RPC API

Section 4.6 Performing Operations on Events

 Here are described the formats of the packets used at data exchange with log files.

Schema event_log_input.xsd


schema location:  event_log_input.xsd
 
Elements  Complex types  Simple types 
packet  filterType  class_type 
event_type 


schema location:  plesk_common.xsd
 
Complex types  Simple types 
buttonDataType  expandIPUsageStatus 
forwardingURL 
garbageOutput 
ipType 
netInterface 
objectStatus 
pleskOS 


schema location:  common.xsd
 
Complex types  Simple types 
resultType  base64 
boolean 
date 
datetime 
double 
emailType 
id_type 
int 
ip_address 
passwdType 
result_status 
short 
size 
string 
text 
unsignedInt 
unsignedShort 
urlType 
zipcodeType 


element packet
diagram
properties
content complex
children event_log
attributes
Name  Type  Use  Default  Fixed  Annotation
version  stringrequired      
annotation
documentation 
Root node for any input

element packet/event_log
diagram
properties
isRef 0
content complex
children get
annotation
documentation 
Event log operator request

element packet/event_log/get
diagram
properties
isRef 0
content complex
children options
annotation
documentation 
Get event log from server

element packet/event_log/get/options
diagram
properties
isRef 0
content complex
children flush_selected_range
annotation
documentation 
Operation options

element packet/event_log/get/options/flush_selected_range
diagram
type boolean
properties
isRef 0
content simple
default true
facets
whiteSpace collapse
annotation
documentation 
If 'true' is set, the specified range of event log records will be cleared

complexType filterType
diagram
children before after type class id
annotation
documentation 
Filter the list of events

element filterType/before
diagram
type unsignedInt
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Get all events occurred before the time specified. Time is a GMT UNIX timestamp

element filterType/after
diagram
type unsignedInt
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Get all events occurred after the time specified. Time is a GMT UNIX timestamp

element filterType/type
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Get events of the specified type only

element filterType/class
diagram
properties
isRef 0
annotation
documentation 
Get events only for the specified classes of objects

element filterType/id
diagram
type id_type
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Event class unique ID

simpleType class_type
type restriction of string
facets
whiteSpace collapse
enumeration client
enumeration domain
enumeration phosting
annotation
documentation 
Event class type specification

simpleType event_type
type restriction of string
facets
whiteSpace collapse
enumeration created
enumeration updated
enumeration deleted
annotation
documentation 
Event type specification

complexType buttonDataType
diagram
children code type name name_id group_name group_name_id href js_onclick enabled new_window tabindex
annotation
documentation 
Button data

element buttonDataType/code
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Button string ID

element buttonDataType/type
diagram
type restriction of string
properties
isRef 0
content simple
facets
whiteSpace collapse
enumeration link_button
enumeration comm_button
annotation
documentation 
Button type

element buttonDataType/name
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Button name

element buttonDataType/name_id
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Button name (string ID for localization)

element buttonDataType/group_name
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Button owner group name

element buttonDataType/group_name_id
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Button owner group name (string ID for localization)

element buttonDataType/href
diagram
type urlType
properties
isRef 0
content simple
facets
maxLength 255
whiteSpace collapse
annotation
documentation 
Button linked to

element buttonDataType/js_onclick
diagram
type text
properties
isRef 0
content simple
facets
whiteSpace preserve
annotation
documentation 
JavaScript code associated with the button onClick event handle

element buttonDataType/enabled
diagram
type boolean
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Button enabled flag

element buttonDataType/new_window
diagram
type boolean
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
New window flag. It should be specified in protocol 1.3.1.7 and higher

element buttonDataType/tabindex
diagram
type int
properties
isRef 0
content simple
default 0
facets
whiteSpace collapse
annotation
documentation 
Button tabulation index

simpleType expandIPUsageStatus
type restriction of string
facets
whiteSpace collapse
enumeration free
enumeration reserved
enumeration assigned
annotation
documentation 
IP address usage status in Expand DB

simpleType forwardingURL
type restriction of string
facets
minLength 1
maxLength 255
whiteSpace collapse
annotation
documentation 
URL, only symbolic name, not an IP

simpleType garbageOutput
type string
facets
whiteSpace collapse
annotation
documentation 
Garbage Output, for debug

simpleType ipType
type restriction of string
facets
whiteSpace collapse
enumeration shared
enumeration exclusive
annotation
documentation 
IP address usage status in Expand DB

simpleType netInterface
type restriction of string
facets
minLength 1
maxLength 200
whiteSpace collapse
annotation
documentation 
Server Network Interface name

simpleType objectStatus
type int
facets
whiteSpace collapse
annotation
documentation 
Plesk client and domain status.
Bit mask with bit flags:

0 - object is active
4 - object is under backup/restore

16 - object is disabled by Administrator

64 - object is disabled by Client

256 - object expired
Only 0, 16 and 64 flags are available for setting

simpleType pleskOS
type restriction of string
facets
whiteSpace collapse
enumeration Windows
enumeration RedHat
annotation
documentation 
Operation System, see enumerations for details

complexType resultType
diagram
children status errcode errtext
annotation
documentation 
Operation result

element resultType/status
diagram
type result_status
properties
isRef 0
content simple
facets
enumeration ok
enumeration error
annotation
documentation 
Result status (ok/error)

element resultType/errcode
diagram
type unsignedInt
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Error code if error occurred

element resultType/errtext
diagram
type xs:string
properties
isRef 0
content simple
annotation
documentation 
Error message if error occurred

simpleType base64
type restriction of xs:base64Binary
facets
whiteSpace collapse

simpleType boolean
type restriction of xs:boolean
used by
elements buttonDataType/enabled packet/event_log/get/options/flush_selected_range buttonDataType/new_window
facets
whiteSpace collapse

simpleType date
type restriction of xs:date
facets
whiteSpace collapse

simpleType datetime
type restriction of xs:dateTime
facets
whiteSpace collapse

simpleType double
type restriction of xs:double
facets
whiteSpace collapse

simpleType emailType
type restriction of string
facets
minLength 3
maxLength 255
whiteSpace collapse
pattern [\-\p{L}\p{N}\.]*@([\p{L}\p{N}][\-\p{L}\p{N}]*\.)*[\p{L}][\-\p{L}\p{N}]*\.?
annotation
documentation 
Any e-mail address

simpleType id_type
type restriction of xs:positiveInteger
used by
element filterType/id
facets
whiteSpace collapse
annotation
documentation 
Item ID

simpleType int
type restriction of xs:integer
used by
element buttonDataType/tabindex
simpleType objectStatus
facets
whiteSpace collapse

simpleType ip_address
type restriction of xs:string
facets
minLength 1
maxLength 15
whiteSpace collapse

simpleType passwdType
type restriction of string
facets
minLength 4
maxLength 64
whiteSpace collapse
annotation
documentation 
Typical password

simpleType result_status
type restriction of xs:string
used by
element resultType/status
facets
enumeration ok
enumeration error
annotation
documentation 
Result status

simpleType short
type restriction of xs:short
facets
whiteSpace collapse

simpleType size
type restriction of xs:unsignedLong
facets
whiteSpace collapse

simpleType string
type restriction of xs:string
used by
elements buttonDataType/code buttonDataType/group_name buttonDataType/group_name_id buttonDataType/name buttonDataType/name_id filterType/type buttonDataType/type
simpleTypes class_type emailType event_type expandIPUsageStatus forwardingURL garbageOutput ipType netInterface passwdType pleskOS urlType zipcodeType
attribute packet/@version
facets
whiteSpace collapse

simpleType text
type restriction of xs:string
used by
element buttonDataType/js_onclick
facets
whiteSpace preserve

simpleType unsignedInt
type restriction of xs:unsignedInt
used by
elements filterType/after filterType/before resultType/errcode
facets
whiteSpace collapse

simpleType unsignedShort
type restriction of xs:unsignedShort
facets
whiteSpace collapse

simpleType urlType
type restriction of string
used by
element buttonDataType/href
facets
maxLength 255
whiteSpace collapse
annotation
documentation 
URL

simpleType zipcodeType
type restriction of string
facets
maxLength 10
whiteSpace collapse


Schema event_log_output.xsd


schema location:  event_log_output.xsd
 
Elements  Simple types 
packet  class_type 
event_type 


schema location:  plesk_common.xsd
 
Complex types  Simple types 
buttonDataType  expandIPUsageStatus 
forwardingURL 
garbageOutput 
ipType 
netInterface 
objectStatus 
pleskOS 


schema location:  common.xsd
 
Complex types  Simple types 
resultType  base64 
boolean 
date 
datetime 
double 
emailType 
id_type 
int 
ip_address 
passwdType 
result_status 
short 
size 
string 
text 
unsignedInt 
unsignedShort 
urlType 
zipcodeType 


element packet
diagram
properties
content complex
children event_log system output
attributes
Name  Type  Use  Default  Fixed  Annotation
version  stringrequired      
annotation
documentation 
Root node for any input

element packet/event_log
diagram
properties
isRef 0
content complex
children get
annotation
documentation 
Event log operator request

element packet/event_log/get
diagram
properties
isRef 0
content complex
children result
annotation
documentation 
"Get" operation result

element packet/event_log/get/result
diagram
type extension of resultType
properties
isRef 0
content complex
children status errcode errtext event

element packet/event_log/get/result/event
diagram
properties
isRef 0
content complex
children type time class id

element packet/event_log/get/result/event/type
diagram
type event_type
properties
isRef 0
content simple
facets
whiteSpace collapse
enumeration created
enumeration updated
enumeration deleted
enumeration started
enumeration stopped
annotation
documentation 
Event type

element packet/event_log/get/result/event/time
diagram
type unsignedInt
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Event time as a GMT UNIX timestamp

element packet/event_log/get/result/event/class
diagram
type class_type
properties
isRef 0
content simple
facets
whiteSpace collapse
enumeration license
enumeration service
enumeration ip_address
enumeration admin_info
enumeration client
enumeration client_limits
enumeration client_status
enumeration client_prefs
enumeration client_perms
enumeration client_ip_pool
enumeration domain
enumeration domain_limits
enumeration domain_user
enumeration domain_status
enumeration phosting
enumeration fhosting
enumeration subdomain
enumeration mailname
enumeration maillist
enumeration webuser
enumeration dns_zone
annotation
documentation 
Event object class

element packet/event_log/get/result/event/id
diagram
type restriction of string
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Event object ID

element packet/system
diagram
type resultType
properties
isRef 0
content complex
children status errcode errtext
annotation
documentation 
The result from PA system level

element packet/output
diagram
type garbageOutput
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Debug garbage

simpleType class_type
type restriction of string
used by
element packet/event_log/get/result/event/class
facets
whiteSpace collapse
enumeration license
enumeration service
enumeration ip_address
enumeration admin_info
enumeration client
enumeration client_limits
enumeration client_status
enumeration client_prefs
enumeration client_perms
enumeration client_ip_pool
enumeration domain
enumeration domain_limits
enumeration domain_user
enumeration domain_status
enumeration phosting
enumeration fhosting
enumeration subdomain
enumeration mailname
enumeration maillist
enumeration webuser
enumeration dns_zone
annotation
documentation 
Event class type specification

simpleType event_type
type restriction of string
used by
element packet/event_log/get/result/event/type
facets
whiteSpace collapse
enumeration created
enumeration updated
enumeration deleted
enumeration started
enumeration stopped
annotation
documentation 
Event type specification

complexType buttonDataType
diagram
children code type name name_id group_name group_name_id href js_onclick enabled new_window tabindex
annotation
documentation 
Button data

element buttonDataType/code
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Button string ID

element buttonDataType/type
diagram
type restriction of string
properties
isRef 0
content simple
facets
whiteSpace collapse
enumeration link_button
enumeration comm_button
annotation
documentation 
Button type

element buttonDataType/name
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Button name

element buttonDataType/name_id
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Button name (string ID for localization)

element buttonDataType/group_name
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Button owner group name

element buttonDataType/group_name_id
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Button owner group name (string ID for localization)

element buttonDataType/href
diagram
type urlType
properties
isRef 0
content simple
facets
maxLength 255
whiteSpace collapse
annotation
documentation 
Button linked to

element buttonDataType/js_onclick
diagram
type text
properties
isRef 0
content simple
facets
whiteSpace preserve
annotation
documentation 
JavaScript code associated with the button onClick event handle

element buttonDataType/enabled
diagram
type boolean
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Button enabled flag

element buttonDataType/new_window
diagram
type boolean
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
New window flag. It should be specified in protocol 1.3.1.7 and higher

element buttonDataType/tabindex
diagram
type int
properties
isRef 0
content simple
default 0
facets
whiteSpace collapse
annotation
documentation 
Button tabulation index

simpleType expandIPUsageStatus
type restriction of string
facets
whiteSpace collapse
enumeration free
enumeration reserved
enumeration assigned
annotation
documentation 
IP address usage status in Expand DB

simpleType forwardingURL
type restriction of string
facets
minLength 1
maxLength 255
whiteSpace collapse
annotation
documentation 
URL, only symbolic name, not an IP

simpleType garbageOutput
type string
used by
element packet/output
facets
whiteSpace collapse
annotation
documentation 
Garbage Output, for debug

simpleType ipType
type restriction of string
facets
whiteSpace collapse
enumeration shared
enumeration exclusive
annotation
documentation 
IP address usage status in Expand DB

simpleType netInterface
type restriction of string
facets
minLength 1
maxLength 200
whiteSpace collapse
annotation
documentation 
Server Network Interface name

simpleType objectStatus
type int
facets
whiteSpace collapse
annotation
documentation 
Plesk client and domain status.
Bit mask with bit flags:

0 - object is active
4 - object is under backup/restore

16 - object is disabled by Administrator

64 - object is disabled by Client

256 - object expired
Only 0, 16 and 64 flags are available for setting

simpleType pleskOS
type restriction of string
facets
whiteSpace collapse
enumeration Windows
enumeration RedHat
annotation
documentation 
Operation System, see enumerations for details

complexType resultType
diagram
children status errcode errtext
used by
elements packet/event_log/get/result packet/system
annotation
documentation 
Operation result

element resultType/status
diagram
type result_status
properties
isRef 0
content simple
facets
enumeration ok
enumeration error
annotation
documentation 
Result status (ok/error)

element resultType/errcode
diagram
type unsignedInt
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Error code if error occurred

element resultType/errtext
diagram
type xs:string
properties
isRef 0
content simple
annotation
documentation 
Error message if error occurred

simpleType base64
type restriction of xs:base64Binary
facets
whiteSpace collapse

simpleType boolean
type restriction of xs:boolean
used by
elements buttonDataType/enabled buttonDataType/new_window
facets
whiteSpace collapse

simpleType date
type restriction of xs:date
facets
whiteSpace collapse

simpleType datetime
type restriction of xs:dateTime
facets
whiteSpace collapse

simpleType double
type restriction of xs:double
facets
whiteSpace collapse

simpleType emailType
type restriction of string
facets
minLength 3
maxLength 255
whiteSpace collapse
pattern [\-\p{L}\p{N}\.]*@([\p{L}\p{N}][\-\p{L}\p{N}]*\.)*[\p{L}][\-\p{L}\p{N}]*\.?
annotation
documentation 
Any e-mail address

simpleType id_type
type restriction of xs:positiveInteger
facets
whiteSpace collapse
annotation
documentation 
Item ID

simpleType int
type restriction of xs:integer
used by
element buttonDataType/tabindex
simpleType objectStatus
facets
whiteSpace collapse

simpleType ip_address
type restriction of xs:string
facets
minLength 1
maxLength 15
whiteSpace collapse

simpleType passwdType
type restriction of string
facets
minLength 4
maxLength 64
whiteSpace collapse
annotation
documentation 
Typical password

simpleType result_status
type restriction of xs:string
used by
element resultType/status
facets
enumeration ok
enumeration error
annotation
documentation 
Result status

simpleType short
type restriction of xs:short
facets
whiteSpace collapse

simpleType size
type restriction of xs:unsignedLong
facets
whiteSpace collapse

simpleType string
type restriction of xs:string
used by
elements buttonDataType/code buttonDataType/group_name buttonDataType/group_name_id packet/event_log/get/result/event/id buttonDataType/name buttonDataType/name_id buttonDataType/type
simpleTypes class_type emailType event_type expandIPUsageStatus forwardingURL garbageOutput ipType netInterface passwdType pleskOS urlType zipcodeType
attribute packet/@version
facets
whiteSpace collapse

simpleType text
type restriction of xs:string
used by
element buttonDataType/js_onclick
facets
whiteSpace preserve

simpleType unsignedInt
type restriction of xs:unsignedInt
used by
elements resultType/errcode packet/event_log/get/result/event/time
facets
whiteSpace collapse

simpleType unsignedShort
type restriction of xs:unsignedShort
facets
whiteSpace collapse

simpleType urlType
type restriction of string
used by
element buttonDataType/href
facets
maxLength 255
whiteSpace collapse
annotation
documentation 
URL

simpleType zipcodeType
type restriction of string
facets
maxLength 10
whiteSpace collapse

to top