mc inventory delete

mc inventory delete deletes an existing inventory configuration from a bucket.

For running jobs, AIStor stops the job within approximately 10 seconds of deletion.

This command has the following aliases:

mc inventory remove
mc inventory rm
mc inventory del

Deleting an inventory configuration immediately and permanently removes all associated data, including it’s YAML definition, stored metadata, and scheduling information for the job. It does not remove nor affect previously generated output files or partially generated files from deleting a job mid-run.

mc inventory delete does not prompt for confirmation nor support an ‘undo’ operation. To re-create a deleted job, you must use mc inventory put.

Syntax

Example Syntax

The command has the following syntax:

mc [GLOBALFLAGS] inventory delete  \
                       TARGET/BUCKET \
                       ID

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

TARGET/BUCKET

Required

The full path to the bucket containing the inventory configuration to delete. Specify both the alias and bucket name in the format ALIAS/BUCKET.

ID

Required

The unique identifier of the inventory configuration to delete.

Global flags

This command supports any of the global flags.

Examples

Delete an inventory configuration

The following command deletes an inventory configuration:

mc inventory delete myaistor/mybucket old-inventory

Replace myaistor with the alias of your AIStor deployment.
Replace mybucket with the name of the bucket.
Replace old-inventory with the inventory configuration ID to delete.

S3 compatibility

The mc commandline tool is built for compatibility with the AWS S3 API and is tested with AIStor 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.

Permissions

The user or service account running this command must have the s3:PutInventoryConfiguration permission for the specified bucket.

For more information on AIStor policies and permissions, see Access Management.

Behavior

Deleting a repeating job

For jobs with a repeating schedule (hourly, daily, weekly, monthly, yearly), deleting the configuration stops both current and future executions.

Use mc inventory suspend to pause a repeating job.

Use mc inventory cancel to cancel the current execution of a repeating job.

Error handling

Deleting a configuration that does not exist returns an error. Use mc inventory list to verify the configuration ID before attempting deletion.