Allowing object overwrites

Content Platform Tenant Management Help

File Size
4269 KB
Part Number

When using HCP and the Hitachi API for Amazon S3, executing a PUT request for an object that has the same name as an existing object in a versioned namespace creates a new version of the object. For objects in non-versioned namespaces, you can enable an overwrite option to overwrite the prior contents of an object when executing a PUT request for an existing object. This option is available when creating or editing a non-versioned namespace.

Observe the following guidelines when using the overwrite option with objects in a non-versioned namespace:
  • By default, the overwrite option is disabled. Executing a PUT request for an existing object results in a 409 Conflict error.
  • If the overwrite option is enabled for a namespace, executing a PUT request for an existing object in that namespace succeeds and overwrites the previous contents of the object. This behavior is similar to issuing a DELETE request followed by a PUT request for an object in a non-versioned namespace.
  • The overwrite option applies to the S3 compatible API only. It does not apply to REST or NFS/CIFS.
  • For versioned namespaces, the overwrite option has no effect until versioning is disabled.
  • If the overwrite option is selected and subsequent versioning is enabled for the namespace, the overwrite option remains selected and has no effect unless versioning is disabled.
  • Objects under retention cannot be overwritten.
  • Any custom metadata included with the overwrite PUT request is written with the object and any existing custom metadata associated with the prior instance of the object is deleted. If you add custom metadata with an overwrite PUT request, the custom metadata will be added to the object.
  • The overwrite option is replicated to other HCP systems that support the overrite feature.
  • If you replicate a namespace that suports the overwrite option to an HCP version that does not support this option, the overwrite option is not available for the earlier version. However, the object overwrite succeeds, and a DELETE request and a PUT request are sent to the replica system.
  1. In the top-level menu of the Tenant Management Console, click Namespaces.
  2. In the list of namespaces, click the name of the namespace you want.
  3. Check Allow overwrite of objects via Hitachi API for Amazon S3 if versioning is disabled.