Extension of Hosting Settings Descriptor

This extension is used to see which properties are available for different Plesk objects (such as domains, subdomains and webusers). In the descriptor of objects properties, which you can retrieve using the site/get-physical-hosting-descriptor operation, each property has the extension element. Inside the extension element there is either the service node, or one or several level nodes.

The extension node of physical hosting property can be represented graphically as follows:

hostingDescriptorExtension

  • The service node is required if the property is a service. It specifies if the service is a hosting property of a managed object defined by a child node. The node can contain several or all of the following child nodes in the preassigned order:
    • the domain node specifies if the property is visible when managing subscriptions.
    • the subdomain node specifies if the property is visible when managing typical subdomains.
    • the webuser node specifies if the property is visible when managing web users.
  • The level node is required if the property is not a service. It specifies if the property is visible when managing an object. The level node can have one of the following values:
    • domain. The property is visible when managing subscriptions.
    • subdomain. The property is visible when managing typical subdomains.

 

This extract from a physical hosting descriptor shows that the service property asp is available for subscriptions (domains), subdomains and web users.

<property>
            <name>asp</name>
            <type>boolean</type>
            <writable-by>admin</writable-by>
            <label>__asp_unix_support</label>
            <extension>
              <service>
                <domain>1</domain>
                <subdomain>1</subdomain>
                <webuser>1</webuser>
              </service>
            </extension>
          </property>

 

This extract from a physical hosting descriptor shows that:

  • The non-service property fp is available for subscriptions.
  • The non-service property ftp_quota is available for subscriptions and subdomains.
<property>
             <name>fp</name>
             <type>boolean</type>
             <writable-by>none</writable-by>
             <label>__fp_unix_support</label>
             <extension>
                <level>domain</level>
             </extension>
          </property>
          <property>
             <name>ftp_quota</name>
             <type>bytes</type>
             <writable-by>none</writable-by>
             <label>__hard_disk_quota</label>
             <extension>
                <level>domain</level>
                <level>subdomain</level>
             </extension>
           </property>

 

For details on hosting settings, refer to the section Managing Subscriptions > Subscription Settings > Limits, Permissions and Hosting Settings.

 

Leave your feedback on this topic here

If you have questions or need support, please visit the Plesk forum or contact your hosting provider.
The comments below are for feedback on the documentation only. No timely answers or help will be provided.