The mc retention set command configures the Write-Once Read-Many (WORM) locking settings for an object or object(s) in a bucket. You can also set the default object lock settings for a bucket, where all objects without explicit object lock settings inherit the bucket default. To lock an object under legal hold, use mc legalhold set. Object Locking on Existing Buckets 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 that allowed object locking at the bucket’s creation.

The mc share download command generates a temporary presigned URL with integrated access credentials for downloading objects from an AIStor bucket. The temporary URL expires after a configurable time limit. Applications can perform a GET to retrieve the object from the URL. Users can open the URL in a browser to download the object. For more information on shareable object URLs, see the Amazon S3 documentation on Pre-Signed URLs. Syntax Example The following command generates a new presigned download URL for the mydata bucket on the myaistor AIStor deployment:

Syntax Example The following command retrieves the anonymous access policy for the mydata bucket on the myaistor AIStor deployment: mc anonymous get myaistor/mydata Syntax Syntax The command has the following syntax:

The mc batch generate command creates a basic YAML-formatted template file for the specified job type. After AIStor creates the file, open it in your preferred text editor tool to further customize. You can define one job task definition per batch file. See job types for the supported jobs you can generate. Syntax Example The following command creates a basic YAML file for a replicate job on the mybucket bucket of the myaistor alias.

The mc admin user disable command disables an AIStor user on the target AIStor deployment. Clients cannot use the user credentials to authenticate to the AIStor deployment. Disabling a user does not remove that user from the deployment. Use mc admin user enable to enable a disabled user on an AIStor deployment. To manage external Identity Provider users, see OIDC or AD/LDAP. Syntax Example The following command disables user myuser on the myaistor AIStor deployment:

The mc admin user ls command lists all AIStor users on the target AIStor deployment. The mc admin user list command has equivalent functionality to mc admin user ls. mc admin user ls does not return the access key or secret key associated to a user. Use mc admin user info to retrieve detailed user information, including the user access key. To manage external Identity Provider users, see OIDC or AD/LDAP.

The mc alias import command imports an alias configuration from a JSON file or STDIN. The command reads the configuration and adds it as a new alias or updates an existing one. Syntax Example The following command imports an alias configuration from a file:

The mc alias remove command removes an alias from the AIStor Client configuration. Syntax Example The following command removes the alias named myaistor:

The mc anonymous list retrieves all anonymous (that is, unauthenticated or public) access policies for a bucket. Buckets with anonymous policies allow clients to access the bucket contents and perform actions consistent with the specified policy without authentication. Syntax Example The following command lists all anonymous access policies for the mydata bucket on the myaistor AIStor deployment:

Description The mc admin scanner commands provide information about the scanner process. Subcommands mc admin scanner includes the following subcommands: