The get-permission-descriptor operation is used to retrieve descriptor of reseller's permissions. For details on descriptor, refer to the Representation of Object Descriptors section. For details on reseller's permissions, refer to the Permissions section.
A request XML packet retrieving reseller permissions descriptor includes the get-permission-descriptor operation node:
<packet version="1.6.0.0">
<reseller>
<get-permission-descriptor>
...
</get-permission-descriptor>
</reseller>
</packet>
The get-permission-descriptor node has the following graphical representation:
A response get-permission-descriptor node is structured as follows:
common.xsd
).common.xsd
). Allowed values: ok|error
.common.xsd
).Note: This descriptor contains permission extensions. For details, refer to the Representation of Object Descriptors: Property Descriptor > Extension of Permissions Descriptor section.
The following packet retrieves permissions descriptor for a reseller account:
<packet version="1.6.0.0">
<reseller>
<get-permission-descriptor>
<filter>
<login>JDoe</login>
</filter>
</get-permission-descriptor>
</reseller>
</packet>
A positive response received from the server looks as follows:
<packet version="1.6.0.0">
<reseller>
<get-permission-descriptor>
<result>
<status>ok</status>
<filter-id>180</filter-id>
<id>180</id>
<descriptor>
<property>
...
</property>
<property>
...
</property>
</descriptor>
</result>
</get-permission-descriptor>
</reseller>
</packet>
Note: Data structures that describe a number of properties are omitted to improve the readability of the sample.