Storing an annotation request-specific return codes

The table below describes the HTTP return codes that have specific meaning for this request. For descriptions of all possible return codes, see HTTP return codes.

Code Meaning Description
201 Created

HCP successfully stored the annotation.

400 Bad Request

One of:

The URL in the request is not well-formed.

The namespace is configured with custom metadata XML checking enabled, and the request included custom metadata that is not well-formed XML.

The request has a Content-Encoding header that specifies gzip, but the annotation is not in gzip-compressed format.

The request contains an unsupported query parameter or an invalid value for a query parameter.

The specified object has ten annotations, and the request is trying to add an annotation.

The request contains an If-Match, If-None-Match, If-Modified-Since, or If-Unmodified-since header.

If more information about the error is available, the HTTP response headers include the HCP-specific X‑HCP-ErrorMessage header.

403 Forbidden

One of:

The Authorization header or hcp-ns-auth cookie specifies invalid credentials.

The namespace requires client authentication, and the request does not have an Authorization header or hcp-ns-auth cookie.

The user doesn’t have write permission.

The object is under retention, and the namespace does not allow adding or replacing annotations for objects under retention.

The namespace does not exist.

The access method (HTTP or HTTPS) is disabled.

If more information about the error is available, the response headers include the HCP-specific X‑HCP-ErrorMessage header.

404 Not Found

One of:

HCP could not find an object or version at the specified URL. The specified object or version does not exist, or the request specified the current version of an object that has been deleted.

Any component of the URL except for the last component in the path is a symbolic link to a directory.

413

File Too Large

The request is trying to store a non-default annotation that is larger than one MB or a default annotation that is larger than one GB. The maximum size of the default annotation is one GB, and the maximum size for all other annotations is one MB

415

Unsupported Media Type

The request has a Content-Encoding header with a value other than gzip.

Trademark and LegalDisclaimer

© 2016 Hitachi Data Systems Corporation. All rights reserved.