Use the remove operation to remove one or more certificates within one repository, whether it is a particular site repository or Administrator's repository.
A request XML packet that deletes certificate should include the remove operation node:
<packet>
<certificate>
<remove>
...
</remove>
</certificate>
</packet>
The remove node does not have a separate type, it is nested within type CertificateActionRequest (certificate_input.xsd
). The remove node has the following graphical representation:
Remarks
1. The filter node allows specifying multiple certificate names, which gives you opportunity to delete several certificates within one remove operation.
<packet>
<certificate>
<remove>
<filter>
<name>cert_1</name>
<name>cert_2</name>
<name>cert_3</name>
<name>cert_4</name>
</filter>
...
</remove>
</certificate>
</packet>
2. With a single remove operation, you can delete certificates from only one repository which is defined with required webspace or admin node. In other words, you should use either webspace node, or admin node within remove operation nodes:
<packet>
<certificate>
<remove>
<filter> ... </filter>
<webspace>site1.com</webspace>
</remove>
</certificate>
</packet>
or
<packet>
<certificate>
<remove>
<filter> ... </filter>
<admin/>
</remove>
</certificate>
</packet>
3. With one packet, you can remove multiple different certificates from any of the repositories you own. To do this, use the required number of remove nodes in the packet:
<packet>
<certificate>
<remove>
...
</remove>
<remove>
...
</remove>
</certificate>
</packet>
Important: When creating request packets, put nodes and elements in the order they follow in the packet structure.
The remove node of the output XML packet is structured as follows:
common.xsd
).
This packet removes certificate called common from repository of webspace doe.de.
<packet>
<certificate>
<remove>
<filter>
<name>common</name>
</filter>
<webspace>doe.de</webspace>
</remove>
</certificate>
</packet>
Response:
<packet version="1.4.2.0">
<certificate>
<remove>
<result>
<status>ok</status>
</result>
</remove>
</certificate>
</packet>
This packet removes three certificates: general, personal, sample.
Certificate general is installed to the Administrator's repository. Certificates personal and sample are installed to the repository of webspace johndoe.org.
<packet>
<certificate>
<remove>
<filter>
<name>general</name>
</filter>
<admin/>
</remove>
<remove>
<filter>
<name>personal</name>
<name>sample</name>
</filter>
<webspace>johndoe.org</webspace>
</remove>
</certificate>
</packet>
Response:
<packet version="1.4.2.0">
<certificate>
<remove>
<result>
<status>ok</status>
</result>
</remove>
<remove>
<result>
<status>ok</status>
</result>
<result>
<status>ok</status>
</result>
</remove>
</certificate>
</packet>