Adding Delegation Rule

Use the add-delegation-rule operation to add a delegation rule.

Request Packet Structure

A request XML packet adding a delegation rule includes the add-delegation-rule operation node:

<packet>
<sso>
   <add-delegation-rule>
...
   </add-delegation-rule>
</sso>
</packet>

The add-delegation-rule node is presented by type SSOAddDelegationRuleInput (sso.xsd), and its graphical representation is as follows:

• The sp-id node is required. It specifies ID of a specific service provider. A user of the SP (specified by sp-login) will be treated by Plesk as Plesk user specified by plesk-login. Data type: string.
• The sp-login node is required. It specifies the login of the SP user. Data type: string.
• The plesk-login node is required. It specifies the login of the Plesk user. Data type: string.

Important: When creating request packets, put nodes and elements in the order they follow in the packet structure.

Response Packet Structure

The add-delegation-rule node of the output XML packet is presented by type SSOAddDelegationRuleOutput (sso.xsd) and structured as follows:

• The result node is required. It wraps the response retrieved from the server. Data type: resultFilterType (common.xsd).
• The status node is required. It specifies the execution status of the operation. Data type: string. Allowed values: ok | error.
• The errcode node is optional. It returns the error code if the operation fails. Data type: integer.
• The errtext node is optional. It returns the error message if the operation fails. Data type: string.

Samples

The packet that delegates resources of Plesk user MyUser to user MyExample registered at the SP specified by ID fvsrf4564asdsRdh4 looks as follows:

<packet version="1.5.2.0">
<sso>
   <add-delegation-rule>
		<sp-id>fvsrf4564asdsRdh4</sp-id>
		<sp-login>MyUser</sp-login>
		<plesk-login>MyExample</plesk-login>
   </add-delegation-rule>
</sso>
</packet>

Response:

<packet version="1.5.2.0">
<sso>
   <add-delegation-rule>
      <result>
          <status>ok</status>
      </result>
   </add-delegation-rule>
</sso>
</packet>