The mc alias set command sets or updates an alias in the AIStor Client configuration. Syntax Example The following command sets an alias named myaistor:

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 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 ilm tier ls command shows the remote tiers configured on a deployment. The mc ilm tier list command has equivalent functionality to mc ilm tier ls. Syntax Example The following example outputs a list of the existing remote tiers on the myaistor deployment.

Syntax The mc ilm rule export command exports the object lifecycle management configuration for an AIStor bucket. The mc ilm rule export command outputs to STDOUT by default. You can output the contents to a .json file for archival or ingestion using mc ilm rule import.

The mc put command uploads objects from a local filesystem to an AIStor deployment. You can also use mc put to upload objects to S3-compatible services. Syntax Example The following command uploads a file from the local filesystem to 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 idp openid accesskey info outputs information about the specified access key(s). This command works against access keys created by an OIDC user after authenticating to AIStor. Authenticated users can manage their own long-term Access Keys using the AIStor Console. AIStor supports using AssumeRoleWithWebIdentity to generate temporary access keys using the Security Token Service. Example and syntax Example The following example outputs details for the access key mykey from the myaistor deployment:

The mc support telemetry record command streams captured trace calls to a file. Use the --sample flag to modify the number of calls traced and adjust the impact on performance. In addition to creating a file with the telemetry data, the command outputs the number of packets saved, the file name and path, and instructions for uploading the generated file to SUBNET. You can replay a recorded file and stream the telemetry to an OpenTelemetry Protocol (OTLP)-compatible collector by HTTP interface with mc support telemetry replay.

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.