The mc ilm tier update command modifies an existing configured remote tier. Syntax Example The following example updates the credentials for an existing remote tier called S3TIER on the myaistor deployment.

The mc support perf site-replication command measures the speed of site replication operations from the specified ALIAS to other configured peers. The command displays results in a terminal user interface (TUI) with a spinner during testing and a tabular output showing RX (receive) and TX (transmit) statistics for each server. Use this command to identify potential site replication performance bottlenecks in your deployment. Syntax Example The following command tests the speed of site replication operations from the myaistor site to other configured peers.

The mc legalhold info command returns the current legal hold setting for an object or objects. mc legalhold requires that the specified bucket has object locking enabled. You can enable object locking at bucket creation. See mc mb --with-lock for documentation on creating buckets with object locking enabled. Version changed Beginning with RELEASE.2025-05-20T20-30-00Z, AIStor allows setting object locking and retention rules on any existing bucket. Earlier versions of AIStor only allowed setting retention rules for buckets at the bucket’s creation.

The mc share ls command displays any unexpired presigned URLs generated by mc share upload or mc share download. The mc share list command has equivalent functionality to mc share ls. Applications can perform a PUT to retrieve the object from the URL. For more information on shareable object URLs, see the Amazon S3 documentation on Pre-Signed URLs. Syntax Example The following command lists all upload and download presigned URLs respectively for the mydata bucket on the myaistor AIStor deployment:

The mc ls command lists buckets and objects on an AIStor deployment. You can also use mc ls to list objects on S3-compatible services. Syntax Example The following command lists all objects in a bucket on the myaistor deployment:

The mc od command copies a local file to a remote location in a specified number of parts and part sizes. The command outputs the time it took to upload the file. Use the mc od to mimic the functionality of the Linux dd command. Example The following command Upload 200MiB of a file to a bucket in 5 parts of size 40MiB. The output shows the results of the upload, including the length of time it took for the upload to complete.

The mc replicate ls command lists all replication rules on an AIStor bucket. The output includes the remote bucket, rule ID, priority, and ARN for each rule. Syntax Example The following command lists all enabled replication rules for the mydata bucket on the myaistor AIStor deployment:

The mc support telemetry replay command replays a file of telemetry data to an OpenTelemetry collector. You can record a file to replay later with mc support telemetry record. Syntax Example The following command replays a local file of telemetry data to a localhost OTLP server.

The mc qos rule add command adds a single new Quality of Service (QoS) rule to an AIStor deployment. For more information, see Bucket-level Quality of Service. Syntax Example The following command adds a QoS rule to limit the s3.GetObject API to 100 requests per second for the bucket1 bucket:

The mc support top command returns statistics for distributed AIStor Object Store deployments, similar to the output of the top command in a shell. mc support top requires distributed topologies. The command has the following syntax: mc support top COMMAND [COMMAND FLAGS] [ARGUMENTS ...] Subcommands Subcommand Description api Summarize real-time S3 API events on a deployment. disk Display current drive usage and performance statistics. locks List the ten oldest object locks, including age, type, owner, and resource. net Display real-time network metrics for the deployment. rpc Display metrics for remote procedure calls (RPC), with interactive sorting options.