PLESK RPC API

Section 4.4 Performing Operations on DNS

 The given structures allow for creating packets with the information necessary for performing operations on DNS records. 

Schema dns_input.xsd


schema location:  dns_input.xsd
 
Elements  Complex types 
packet  filterType 


schema location:  plesk_dns.xsd
 
Complex types 
dnsRecord 
dnsSetRecord 


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 dns
attributes
Name  Type  Use  Default  Fixed  Annotation
version  stringrequired      
annotation
documentation 
Root node for any input

element packet/dns
diagram
properties
isRef 0
content complex
children add_rec get_rec del_rec
annotation
documentation 
DNS operator request

element packet/dns/add_rec
diagram
type dnsRecord
properties
isRef 0
content complex
children domain_id type host value opt

element packet/dns/get_rec
diagram
properties
isRef 0
content complex
children filter
annotation
documentation 
Get domain(s) data from server

element packet/dns/get_rec/filter
diagram
type filterType
properties
isRef 0
content complex
children domain_id id
annotation
documentation 
Filter domains to be refreshed

element packet/dns/del_rec
diagram
properties
isRef 0
content complex
children filter
annotation
documentation 
Delete domain(s) from server

element packet/dns/del_rec/filter
diagram
type filterType
properties
isRef 0
content complex
children domain_id id
annotation
documentation 
Filter domains to be deleted

complexType filterType
diagram
children domain_id id
used by
elements packet/dns/get_rec/filter packet/dns/del_rec/filter
annotation
documentation 
Filter the list of domains

element filterType/domain_id
diagram
type id_type
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Record ID (ID in Plesk DB)

element filterType/id
diagram
type id_type
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Record ID (ID in Plesk DB)

complexType dnsRecord
diagram
children domain_id type host value opt
used by
element packet/dns/add_rec
annotation
documentation 
DNS record

element dnsRecord/domain_id
diagram
type id_type
properties
isRef 0
content simple
facets
whiteSpace collapse

element dnsRecord/type
diagram
type restriction of string
properties
isRef 0
content simple
facets
whiteSpace collapse
pattern A
pattern CNAME
pattern MX
pattern NS
pattern PTR

element dnsRecord/host
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse

element dnsRecord/value
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse

element dnsRecord/opt
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse

complexType dnsSetRecord
diagram
children type host value opt
annotation
documentation 
DNS record (setting)

element dnsSetRecord/type
diagram
type restriction of string
properties
isRef 0
content simple
facets
whiteSpace collapse
pattern A
pattern CNAME
pattern MX
pattern NS
pattern PTR

element dnsSetRecord/host
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse

element dnsSetRecord/value
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse

element dnsSetRecord/opt
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse

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 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
elements filterType/domain_id dnsRecord/domain_id 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 dnsRecord/host dnsSetRecord/host buttonDataType/name buttonDataType/name_id dnsRecord/opt dnsSetRecord/opt dnsRecord/type dnsSetRecord/type buttonDataType/type dnsRecord/value dnsSetRecord/value
simpleTypes emailType 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
element 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 dns_output.xsd


schema location:  dns_output.xsd
 
Elements 
packet 


schema location:  plesk_dns.xsd
 
Complex types 
dnsRecord 
dnsSetRecord 


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 dns system output
attributes
Name  Type  Use  Default  Fixed  Annotation
version  stringrequired      
annotation
documentation 
Root node for any input

element packet/dns
diagram
properties
isRef 0
content complex
children add_rec get_rec del_rec
annotation
documentation 
Domain operator request

element packet/dns/add_rec
diagram
properties
isRef 0
content complex
children result
annotation
documentation 
Add DNS record

element packet/dns/add_rec/result
diagram
type extension of resultType
properties
isRef 0
content complex
children status errcode errtext id

element packet/dns/add_rec/result/id
diagram
type id_type
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
New Record ID

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

element packet/dns/get_rec/result
diagram
type extension of resultType
properties
isRef 0
content complex
children status errcode errtext id data

element packet/dns/get_rec/result/id
diagram
type id_type
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Record ID

element packet/dns/get_rec/result/data
diagram
type dnsRecord
properties
isRef 0
content complex
children domain_id type host value opt
annotation
documentation 
Domain data. Will not be returned if status isn't "ok"

element packet/dns/del_rec
diagram
properties
isRef 0
content complex
children result
annotation
documentation 
"Delete" operation result

element packet/dns/del_rec/result
diagram
type extension of resultType
properties
isRef 0
content complex
children status errcode errtext id

element packet/dns/del_rec/result/id
diagram
type id_type
properties
isRef 0
content simple
facets
whiteSpace collapse
annotation
documentation 
Record 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

complexType dnsRecord
diagram
children domain_id type host value opt
used by
element packet/dns/get_rec/result/data
annotation
documentation 
DNS record

element dnsRecord/domain_id
diagram
type id_type
properties
isRef 0
content simple
facets
whiteSpace collapse

element dnsRecord/type
diagram
type restriction of string
properties
isRef 0
content simple
facets
whiteSpace collapse
pattern A
pattern CNAME
pattern MX
pattern NS
pattern PTR

element dnsRecord/host
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse

element dnsRecord/value
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse

element dnsRecord/opt
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse

complexType dnsSetRecord
diagram
children type host value opt
annotation
documentation 
DNS record (setting)

element dnsSetRecord/type
diagram
type restriction of string
properties
isRef 0
content simple
facets
whiteSpace collapse
pattern A
pattern CNAME
pattern MX
pattern NS
pattern PTR

element dnsSetRecord/host
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse

element dnsSetRecord/value
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse

element dnsSetRecord/opt
diagram
type string
properties
isRef 0
content simple
facets
whiteSpace collapse

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/dns/add_rec/result packet/dns/get_rec/result packet/dns/del_rec/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
used by
elements dnsRecord/domain_id packet/dns/add_rec/result/id packet/dns/get_rec/result/id packet/dns/del_rec/result/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 dnsRecord/host dnsSetRecord/host buttonDataType/name buttonDataType/name_id dnsRecord/opt dnsSetRecord/opt dnsRecord/type dnsSetRecord/type buttonDataType/type dnsRecord/value dnsSetRecord/value
simpleTypes emailType 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
element 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

to top