Documentation

mc version suspend

Syntax

The mc version suspend command disables versioning on the specified bucket.

The following command disables versioning for the mybucket bucket on the myminio MinIO deployment:

mc version suspend myminio/mybucket

The command has the following syntax:

mc [GLOBALFLAGS] version suspend ALIAS
  • Brackets [] indicate optional parameters.

  • Parameters sharing a line are mutually dependent.

  • Parameters separated using the pipe | operator are mutually exclusive.

Copy the example to a text editor and modify as-needed before running the command in the terminal/shell.

Parameters

ALIAS

The full path to the bucket on which to disable versioning. For example:

mc version suspend myminio/mybucket

Global Flags

This command supports any of the global flags.

Example

Disable Bucket Versioning

Use mc version suspend to disable versioning for a bucket:

mc version suspend ALIAS/PATH
  • Replace ALIAS with the alias of a configured MinIO deployment.

  • Replace PATH with the bucket on which to disable versioning.

Behavior

Bucket Versioning with Existing Data

Disabling bucket versioning on a bucket with existing versioned data does not remove any versioned objects. Applications can continue to access versioned data after disabling bucket versioning. Use mc rm --versions ALIAS/BUCKET/OBJECT to delete an object and all its versions.

S3 Compatibility

The mc commandline tool is built for compatibility with the AWS S3 API and is tested with MinIO and AWS S3 for expected functionality and behavior.

MinIO provides no guarantees for other S3-compatible services, as their S3 API implementation is unknown and therefore unsupported. While mc commands may work as documented, any such usage is at your own risk.