Use the set-package-properties operation to display or hide a package from customers and resellers when they view Applications Catalog.

Request Packet Structure

A request XML package that retrieves the status of an application package download task should include the set-package-properties operation node:

<packet>
    <aps>
        <set-package-properties>
            ...
        </set-package-properties>
    </aps>
</packet>

The set-package-properties node is structured as follows:

image 66514.gif

Note: The interactive schema navigator for all request packets is available here: http://plesk.github.io/api-schemas/1.6.9.1/agent_input.svg.

  • filter, required

    This node sets a filtering rule to match particular packages. Data type: none.

    If it is defined with an empty value, than all packages will be matched.

  • package-id, optional

    Specifies the ID of package on the server from which an application should be installed. Data type: id_type (common.xsd).

  • properties, required

    Aggregates the package properties. Data type: complex.

  • visible, required

    Defines whether to display this package to customers and resellers among other packages in Application Catalog. Data type: boolean.

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

Response Packet Structure

The set-package-properties node of the output XML packet is structured as follows:

image 66517.gif

Note: The interactive schema navigator for all response packets is available here: http://plesk.github.io/api-schemas/1.6.9.1/agent_output.svg.

  • result, required

    Wraps the response retrieved from the server. Data type: resultType (common.xsd).

  • status, required

    Specifies the execution status of the operation. Data type: string. Allowed values: ok | error.

  • errcode, required if the operation fails

    Returns the error code. Data type: integer.

  • errtext, required if the operation fails

    Returns the error message. Data type: string.

  • filter-id, required if the operation succeeds

    Returns the package ID by which the operation was filtered. Data type: any.

  • id, optional.

    Not returned.

Samples

Hiding particular packages

This packet requests status to hide packages with IDs 10, 11 and 12.

<packet>
    <aps>
        <set-package-properties>
            <filter>
                <package-id>10</package-id>
                <package-id>11</package-id>
                <package-id>12</package-id>
            </filter>
            <properties>
                <visible>0</visible>
            </properties>
        </set-package-properties>
    </aps>
</packet>

Response:

<packet>
    <aps>
        <set-package-properties>
            <result>
                <status>ok</status>
                <filter-id>1</filter-id>
            </result>
        </set-package-properties>
    </aps>
</packet>