Skip to main content
Delete object
Last update:

Delete object

For your information

If the container has an access policy, it must allow deletion of the object, see the Actions subsection of the Access Policy instruction for details.

When deleting an object, consider the peculiarities of deleting objects with segments.

If versioning is enabled or suspended in a container, some objects can be restored after deletion, see the subsection Delete an object when versioning is enabled or suspended for details.

If versioning in the container is turned off (never enabled), the object is irrevocably deleted.

Delete object⁠

  1. In the Control Panel, on the top menu, click Products and select Object Storage.
  2. Go to the Containers section.
  3. Open the container page → Objects tab.
  4. Mark the object you want to delete.
  5. Click Delete.
  6. Enter the name of the object to confirm the deletion.
  7. Click Delete.

Delete a segmented object⁠

carefully

When storing an object, you cannot delete its segments in the service container — doing so will break the entire file.

To delete an object with segments, delete the manifest file.To delete, use the API you used to load the object.When deleting via the control panel, the Swift API is used.

If an object is loaded and deleted in different ways (for example, an object was loaded using the S3 API and deleted in the dashboard), the object segments may not be deleted, continue to be stored in the hidden container, and billed.

Delete an object when versioning is enabled or paused⁠

If versioning in a container is enabled or suspended, an object may have versions — objects with the same name that were loaded earlier than the current version of the object.

The behavior when deleting an object depends on whether you delete the object with or without specifying a version:

  • When deleting without specifying a version, the current version of the object is moved to the list of versions.An empty object with its version ID and the tag Deleted will be created as the current version .To make the object available to users, restore it from any version that does not have the tag Deleted.

  • if a particular version is deleted, the version is deleted with no possibility of recovery. If the version to be deleted is:

    • current — the version will become an empty object and will be included in the list of versions with the Deleted tag. The current version of the object becomes the most recent version from the list, which does not have the Deleted tag;
    • the previous one — it will be removed from the list of versions altogether.

    If the deleted version is the only version, the object cannot be restored.

Delete an object without specifying a version⁠

For your information

To delete an object without specifying a version via API or other tools, do not specify the version-id parameter.

  1. In the Control Panel, on the top menu, click Products and select Object Storage.
  2. Go to the Containers section.
  3. Open the container page → Objects tab.
  4. Make sure the Version toggle switch is off.
  5. Mark the object you want to delete.
  6. Click Delete.
  7. Enter the name of the object to confirm the deletion.
  8. Click Delete.

Delete a specific version⁠

For your information

To remove a specific version via the API or other tools, specify the version-id parameter with the value of the version ID.

  1. In the Control Panel, on the top menu, click Products and select Object Storage.
  2. Go to the Containers section.
  3. Open the container page → Objects tab.
  4. Turn on the Versions toggle switch.
  5. Check the box next to the version you want to uninstall.
  6. Click Delete.
  7. Enter the name of the object to confirm the deletion.
  8. Click Delete.