Deleting an object request contents

The DELETE request to delete an object has these elements:

If you’re accessing the namespace as an authenticated user, an Authorization header

The URL of the object or symbolic link

To perform a privileged delete, the request must specify both of these URL query parameters:

privileged=true
reason=reason-text

reason-text must be from one through 1,024 characters long and can contain any valid UTF-8 characters, including white space.

You can specify the parameters in either of these ways:

As query parameters at the end of the URL, in this format:

?privileged=true&reason=reason-text

As form-encoded data (application/x-www-form-urlencoded content type) in the request. For example, in cURL, you can use the -d option to specify form-encoded data in a DELETE request.

These considerations apply:

If you use query parameters, you need to percent-encode characters in the reason parameter that have special meanings in URLs. For more information on percent-encoding, see URL considerations.

If you use form-encoded data, you need to percent-encode only ampersands (&) in the reason parameter. This prevents HCP from interpreting these characters as starting a new URL query parameter.

You cannot combine query parameters and form-encoded data in a single request.

Trademark and LegalDisclaimer

© 2016 Hitachi Data Systems Corporation. All rights reserved.