Skip to content

mc tag remove

Syntax

The mc tag remove command removes all tags from a bucket or object.

The following command removes tags for the mydata bucket on the myminio MinIO deployment:

mc tag remove myminio/mydata

The command has the following syntax:

mc [GLOBALFLAGS] tag remove                \
                 [--rewind "string"]       \
                 [--versions]              \
                 [--version-id "string"]*  \
  • 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.

mc tag remove --version-id is mutually exclusive with multiple parameters. See the reference documentation for more information.

Parameters

ALIAS

mc-cmd

Required

The alias for a MinIO deployment and the full path to the object on which to remove all tags (e.g. bucket and path to object). For example:

mc tag remove myminio/mybucket/object.txt
--recursive, r

mc-cmd

Optional

Note

Added: RELEASE.2023-05-04T18-10-16Z

Recursively removes all tags from all objects at the specified ALIAS.

--rewind

mc-cmd

Optional

Directs mc tag remove to operate only on the object version(s) that existed at specified point-in-time.

  • To rewind to a specific date in the past, specify the date as an ISO8601-formatted timestamp. For example: --rewind "2020.03.24T10:00".
  • To rewind a duration in time, specify the duration as a string in #d#hh#mm#ss format. For example: --rewind "1d2hh3mm4ss".

--rewind requires that the specified ALIAS be an S3-compatible service that supports Bucket Versioning. For MinIO deployments, use mc version to enable or disable bucket versioning.

--versions

mc-cmd

Optional

Directs mc tag remove to operate on all object versions that exist in the bucket.

--versions requires that the specified ALIAS be an S3-compatible service that supports Bucket Versioning. For MinIO deployments, use mc version to enable or disable bucket versioning.

Use --versions and --rewind together to remove tags from all object versions which existed at a specific point in time.

--version-id, vid

mc-cmd

Optional

Directs mc tag remove to operate only on the specified object version.

--version-id requires that the specified ALIAS be an S3-compatible service that supports Bucket Versioning. For MinIO deployments, use mc version to enable or disable bucket versioning.

Mutually exclusive with the following parameters:

Global Flags

This command supports any of the global flags.

Examples

Remove Tags from a Bucket or Object

Use mc tag remove to remove tags from a bucket or object:

mc tag remove ALIAS/PATH
  • Replace ALIAS with the alias of the MinIO deployment.
  • Replace PATH with the path to the bucket or object on the MinIO deployment.

Behavior

S3 Compatibility

SILO is the supported server for PGSTY mcli; compatibility with upstream MinIO and other S3 services is best effort.