This page documents the installation of the AIStor Key Encryption Service. You may require root or sudo permissions to perform some of the steps. Install the AIStor KES binary on each node in your KES cluster. Linux AMD64 curl --progress-bar --retry 10 -L https://dl.min.io/aistor/kes/release/linux-amd64/kes -o kes chmod +x ./kes mv ./kes /usr/local/bin/kes kes --version ARM64

The mc stat command displays information on objects in an AIStor bucket, including object metadata. You can also use it to retrieve bucket metadata. You can use mc stat against the local filesystem to produce similar results to the stat command-line tool. Syntax Example The following command displays information on all objects in the mydata bucket on the myaistor AIStor deployment:

The mc qos rule export command exports the Quality of Service (QoS) configuration from a bucket on an AIStor deployment in YAML format. For more information, see Bucket-level Quality of Service. Syntax Example The following command exports the QoS configuration from the mybucket bucket on the myaistor deployment to a file named qos.yaml:

Create MinIO client MinIO MinioClient minioClient = MinioClient.builder() .endpoint("https://play.min.io") .credentials("Q3AM3UQ867SPQQA43P2F", "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG") .build(); AWS S3 MinioClient minioClient = MinioClient.builder() .endpoint("https://s3.amazonaws.com") .credentials("YOUR-ACCESSKEYID", "YOUR-SECRETACCESSKEY") .build(); Bucket operations Object operations bucketExists composeObject deleteBucketCors copyObject deleteBucketEncryption deleteObjectTags deleteBucketLifecycle disableObjectLegalHold deleteBucketNotification downloadObject deleteBucketPolicy enableObjectLegalHold deleteBucketReplication getObject deleteBucketTags getObjectAcl deleteObjectLockConfiguration getObjectAttributes getBucketCors getObjectRetention getBucketEncryption getObjectTags getBucketLifecycle getPresignedObjectUrl getBucketNotification getPresignedPostFormData getBucketPolicy isObjectLegalHoldEnabled getBucketReplication listObjects getBucketTags promptObject getBucketVersioning putObject getObjectLockConfiguration putObjectFanOut listBuckets removeObject listenBucketNotification removeObjects makeBucket restoreObject removeBucket selectObjectContent setBucketCors setObjectRetention setBucketEncryption setObjectTags setBucketLifecycle statObject setBucketNotification uploadObject setBucketPolicy uploadSnowballObjects setBucketReplication setBucketTags setBucketVersioning setObjectLockConfiguration 1. MinIO Client Builder MinIO Client Builder is used to create MinIO client. Builder has below methods to accept arguments.

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.

Drive type MinIO recommends using flash-based storage (NVMe or SSD) for all workload types at any scale. Workloads that require high performance should prefer NVMe over SSD. For best performance, use 30+TB drives with NVMe over PCIe 4.0 or 5.0. Directly attached storage For best performance, provide AIStor with drives attached directly to each host node as a JBOD array with no RAID or similar management layers. AIStor requires the XFS filesystem for best performance and behavior at scale. Using any other type of backing storage (SAN/NAS, ext4, RAID, LVM) typically results in a reduction in performance, reliability, predictability, and consistency.

The AIStor Security Token Service (STS) AssumeRoleWithCustomToken API endpoint generates a token for use with the AIStor External Identity Management Plugin. Request endpoint The AssumeRoleWithCustomToken endpoint has the following form: POST https://aistor.example.net?Action=AssumeRoleWithCustomToken[&ARGS] The following example uses all supported arguments. Replace the aistor.example.net hostname with the appropriate URL for your AIStor cluster:

The MinIO Rust SDK is a Simple Storage Service (aka S3) client for performing bucket and object operations to any Amazon S3 compatible object storage service. It provides a strongly-typed, async-first interface to the MinIO and Amazon S3-compatible object storage APIs. Each supported S3 operation has a corresponding request builder (for example: [BucketExists], [PutObject], [UploadPartCopy]), which allows users to configure request parameters using a fluent builder pattern. All request builders implement the [S3Api] trait, which provides the async send method to execute the request and return a typed response.

This page reflects limits and thresholds that apply to AIStor Server. Linux Kernel Requirements MinIO strongly recommends Linux kernel 6.8 or later for production deployments. See Linux Kernel Requirements for recommended distributions and performance details. S3 API practical limits Item Specification Maximum object size ~48 PiB (10,000 parts at 5 TiB each) Minimum object size 0 B Maximum object size per PUT operation 5 TiB for non-multipart upload~48 PiB for multipart upload Maximum versions per object 10,000; configurable with the MINIO_API_OBJECT_MAX_VERSIONS environment variable Bucket limits Item Specification Maximum number of buckets 500,000 (soft limit) Maximum length for bucket names 63 bytes Maximum length for each / separated segment of an object name 255 bytes Maximum objects per bucket no limit Erasure code limits Erasure coding requires more than one drive. For clusters with a single node and single drive, there is no erasure coding functionality.

Go GitHub: minio/minio-go You can install the Go SDK using the following command: go get github.com/minio/minio-go/v7 Quickstart: Go Quickstart Reference: Go API docs Python GitHub: minio/minio-py