MinIO AIStor

https://docs.min.io/aistor/
Admin
MinIO AIStor is an enterprise-grade object storage platform that implements S3 API compatibility...
Tokens:1,249,467
Snippets:10,704
Trust Score:10
Update:6 days ago
Show doc for...
Tokens:
Raw
### Install Python dependencies for Delta Sharing quickstart

Source: https://docs.min.io/aistor/administration/aistor-tables/delta-sharing

Install the required Python libraries for the quickstart procedure. The command must be run in an environment with Python installed.

```bash
pip install minio deltalake delta-sharing pandas pyarrow

```

--------------------------------

### Install xl-meta tool

Source: https://docs.min.io/aistor/operations/debugging-and-troubleshooting

Installs the xl-meta tool using Go. Run this command to get the tool for decoding xl.meta files.

```bash
go install github.com/minio/minio/docs/debugging/xl-meta@latest

```

--------------------------------

### Validate installation with kubectl get all

Source: https://docs.min.io/aistor/installation/kubernetes/install/deploy-aistor-on-kubernetes

Lists all resources in the aistor namespace to verify the installation. The output should show running pods similar to the example.

```bash
kubectl get all -n aistor
```

```text
NAME                                         READY   STATUS    RESTARTS   AGE
pod/adminjob-operator-cfc97d9f-hjbp5         1/1     Running   0          4m16s
pod/object-store-operator-78c9f84b85-kmwlv   1/1     Running   0          4m16s

NAME                            TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)    AGE
service/object-store-operator   ClusterIP   10.43.210.230   <none>        4221/TCP   4m16s

NAME                                    READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/adminjob-operator       1/1     1            1           4m16s
deployment.apps/object-store-operator   1/1     1            1           4m16s

NAME                                               DESIRED   CURRENT   READY   AGE
replicaset.apps/adminjob-operator-cfc97d9f         1         1         1       4m16s
replicaset.apps/object-store-operator-78c9f84b85   1         1         1       4m16s
```

--------------------------------

### Example config.yaml with all fields

Source: https://docs.min.io/aistor/reference/aistor-server/configuration-file

Complete example configuration listing all available fields and example values. Remove any parameters you do not need. Includes core settings, behavior, network tuning, storage, logging, FTP/SFTP, and storage pools.

```yaml
version: v3

# Core settings
address: ":9000"
consoleAddress: ":9001"
rootUser: "minioadmin"
rootPassword: "secret-CHANGE-ME"
license: "/path/to/license.minio"
certsDir: "/etc/minio/certs"

# Behavior settings
api: "S3"
objectNaming: "safe"

# Network tuning
network:
  idleTimeout: "15s"
  readHeaderTimeout: "5s"
  connUserTimeout: "10m"
  dnsCacheTTL: "1h"
  maxIdleConnsPerHost: 2048
  sendBufSize: 4194304
  recvBufSize: 4194304
  writeBufSize: 65536
  readBufSize: 65536

# Storage configuration
storage:
  lazyAccessTime: "24h"

# Logging
log:
  json: false
  dir: ""
  size: 10485760
  compress: false

# FTP server configuration
ftp:
  address: ":8021"
  passivePortRange: "30000-40000"

# SFTP server configuration
sftp:
  address: ":8022"
  sshPrivateKey: "/etc/minio/sftp-key"

# Storage pools
pools:
  - nodes:
      - addresses:
          - "https://rack{1,3,5,7}.example.com:9000"
        path: "/mnt/disk{1...4}"
  - nodes:
      - addresses:
          - "https://rack{2,4,6,8}.example.com:9000"
        path: "/mnt/disk{1...4}"

```

--------------------------------

### Install the binary

Source: https://docs.min.io/aistor/operations/security/storage-hardening

Install the minio-lsm-bpf binary to /usr/local/bin/.

```bash
# Install to system path
sudo install -m 0755 minio-lsm-bpf /usr/local/bin/

```

--------------------------------

### Validate operator installation

Source: https://docs.min.io/aistor/administration/upgrade-aistor-server/upgrade-kubernetes-private-registry

Run `kubectl get all -n aistor` to validate the installation. The output should show running pods similar to the example provided.

```bash
kubectl get all -n aistor

```

```text
NAME                                         READY   STATUS    RESTARTS   AGE
pod/adminjob-operator-cfc97d9f-hjbp5         1/1     Running   0          4m16s
pod/object-store-operator-78c9f84b85-kmwlv   1/1     Running   0          4m16s

NAME                            TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)    AGE
service/object-store-operator   ClusterIP   10.43.210.230   <none>        4221/TCP   4m16s

NAME                                    READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/adminjob-operator       1/1     1            1           4m16s
deployment.apps/object-store-operator   1/1     1            1           4m16s

NAME                                               DESIRED   CURRENT   READY   AGE
replicaset.apps/adminjob-operator-cfc97d9f         1         1         1       4m16s
replicaset.apps/object-store-operator-78c9f84b85   1         1         1       4m16s

```

--------------------------------

### Expected Output from kubectl get all

Source: https://docs.min.io/aistor/administration/upgrade-aistor-server/open-source-minio/kubernetes

Example output from kubectl get all -n aistor showing running pods, services, deployments, and replicasets. Use this to verify the operator installation succeeded.

```text
NAME                                         READY   STATUS    RESTARTS   AGE
pod/adminjob-operator-cfc97d9f-hjbp5         1/1     Running   0          4m16s
pod/object-store-operator-78c9f84b85-kmwlv   1/1     Running   0          4m16s

NAME                            TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)    AGE
service/object-store-operator   ClusterIP   10.43.210.230   <none>        4221/TCP   4m16s

NAME                                    READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/adminjob-operator       1/1     1            1           4m16s
deployment.apps/object-store-operator   1/1     1            1           4m16s

NAME                                               DESIRED   CURRENT   READY   AGE
replicaset.apps/adminjob-operator-cfc97d9f         1         1         1       4m16s
replicaset.apps/object-store-operator-78c9f84b85   1         1         1       4m16s
```

--------------------------------

### get_object Examples

Source: https://docs.min.io/aistor/developers/sdk/python/api

Gets data from an object. Shows four variants: basic get, get by version-ID, get with offset and length, and get with SSE-C encryption. Each example closes the response and releases the connection.

```python
# Get data of an object.
try:
    response = client.get_object("my-bucket", "my-object")
    # Read data from response.
finally:
    response.close()
    response.release_conn()

# Get data of an object of version-ID.
try:
    response = client.get_object(
        "my-bucket", "my-object",
        version_id="dfbd25b3-abec-4184-a4e8-5a35a5c1174d",
    )
    # Read data from response.
finally:
    response.close()
    response.release_conn()

# Get data of an object from offset and length.
try:
    response = client.get_object(
        "my-bucket", "my-object", offset=512, length=1024,
    )
    # Read data from response.
finally:
    response.close()
    response.release_conn()

# Get data of an SSE-C encrypted object.
try:
    response = client.get_object(
        "my-bucket", "my-object",
        ssec=SseCustomerKey(b"32byteslongsecretkeymustprovided"),
    )
    # Read data from response.
finally:
    response.close()
    response.release_conn()

```

--------------------------------

### Run an example from the minio-rs repository

Source: https://docs.min.io/aistor/developers/sdk/rust

Command to run any example from the examples folder of the minio-rs GitHub repository. Replace <example_name> with the actual example name.

```bash
cargo run --example <example_name>

```

--------------------------------

### Install MinIO Python SDK from GitHub source

Source: https://docs.min.io/aistor/developers/sdk/python

Clone the minio/minio-py repository and install from source using setup.py.

```bash
git clone https://github.com/minio/minio-py
cd minio-py
python setup.py install
```

--------------------------------

### Install MinIO Go SDK with go get

Source: https://docs.min.io/aistor/developers/sdk/go

Run this command from your project directory to download the MinIO Go SDK version 7. This is the first step before using the SDK in your Go code.

```bash
go get github.com/minio/minio-go/v7

```

--------------------------------

### mc inventory get

Source: https://docs.min.io/aistor/reference/cli/mc-inventory/mc-inventory-get

Documentation for the mc inventory get command, including syntax, parameters, examples, and permissions.

```APIDOC
## mc inventory get

### Description
Retrieves an existing inventory configuration from a bucket and displays its details, including the bucket name, configuration ID, owner, and the complete YAML definition.

### Syntax
```
mc [GLOBALFLAGS] inventory get TARGET/BUCKET ID
```

### Parameters
#### TARGET/BUCKET
- **Type**: string
- **Required**: Yes
- **Description**: The full path to the bucket containing the inventory configuration. Specify both the alias and bucket name in the format `ALIAS/BUCKET`.

#### ID
- **Type**: string
- **Required**: Yes
- **Description**: The unique identifier of the inventory configuration to retrieve.

### Global Flags
This command supports any of the global flags.

### Examples
#### Retrieve an inventory configuration
```
mc inventory get myaistor/mybucket weekly-inventory > weekly-inventory.yml
```

### Permissions
The user or service account running this command must have the `s3:GetInventoryConfiguration` permission for the specified bucket.

### S3 Compatibility
The `mc` command-line tool is built for compatibility with the AWS S3 API and is tested with MinIO AIStor and AWS S3 for expected functionality and behavior. MinIO provides no guarantees for other S3-compatible services.
```

--------------------------------

### Start MinIO AIStor with SFTP configuration

Source: https://docs.min.io/aistor/reference/aistor-server

Example command that starts the MinIO AIStor server with SFTP enabled, specifying address, SSH private key, and key-exchange algorithms. The trailing ellipsis indicates additional options may follow. Parameters can also be set via the MINIO_OPTS environment variable.

```bash
minio http://server{1...4}/disk{1...4}                                 \
--sftp="address=:8022" --sftp="ssh-private-key=/home/miniouser/.ssh/id_rsa"   \
--sftp="kex-algos=diffie-hellman-group14-sha256,curve25519-sha256@libssh.org" \
...

```

--------------------------------

### Install decryption tool

Source: https://docs.min.io/aistor/operations/debugging-and-troubleshooting

Installs the inspect tool used to decrypt inspection files. Run this command to get the tool.

```bash
go install github.com/minio/minio/docs/debugging/inspect@latest

```

--------------------------------

### Get four sets with a filter, starting at item 2

Source: https://docs.min.io/aistor/reference/cli/admin/mc-admin-set/mc-admin-set-top

Lists four sets starting at index 2 with a filter.

```bash
mc admin set top [alias] --filter "PoolIndex = 1" --start 2 --count 4

```

--------------------------------

### Initialize MinIO client with minio.New

Source: https://docs.min.io/aistor/developers/sdk/go

This Go example creates a MinIO client using the play.min.io endpoint and static credentials. It requires the minio-go and credentials packages. The client is set up with SSL enabled and logs the client object after initialization.

```go
package main

import (
	"log"

	"github.com/minio/minio-go/v7"
	"github.com/minio/minio-go/v7/pkg/credentials"
)

func main() {
	endpoint := "play.min.io"
	accessKeyID := "Q3AM3UQ867SPQQA43P2F"
	secretAccessKey := "zuf+tfteSlswRu7BJ86wekitnifILbZam1KYY3TG"
	useSSL := true

	// Initialize minio client object.
	minioClient, err := minio.New(endpoint, &minio.Options{
		Creds:  credentials.NewStaticV4(accessKeyID, secretAccessKey, ""),
		Secure: useSSL,
	})
	if err != nil {
		log.Fatalln(err)
	}

	log.Printf("%#v\n", minioClient) // minioClient is now set up
}

```

--------------------------------

### Install MinIO AIStor Operator with License

Source: https://docs.min.io/aistor/administration/upgrade-aistor-server/open-source-minio/kubernetes

Installs the MinIO AIStor operator with the license value. Replace LICENSE_HERE with your license (starting with eyJ...). The operator installs to the aistor namespace.

```bash
helm install --create-namespace --take-ownership -n aistor aistor \
     minio/aistor-operator --set license="LICENSE_HERE"
```

--------------------------------

### Enable and start the service

Source: https://docs.min.io/aistor/operations/security/storage-hardening

Reload systemd, enable and start the minio-lsm-bpf service, and check its status.

```bash
sudo systemctl daemon-reload
sudo systemctl enable --now minio-lsm-bpf
sudo systemctl status minio-lsm-bpf

```

--------------------------------

### Apply tags to a bucket or object (generic example)

Source: https://docs.min.io/aistor/reference/cli/mc-tag/mc-tag-set

Generic example from the Examples section. Replace ALIAS, PATH, and TAGS with your deployment alias, bucket or object path, and ampersand-separated key-value pairs.

```bash
mc tag set ALIAS/PATH "TAGS"
```

--------------------------------

### Get anonymous policy for mybucket

Source: https://docs.min.io/aistor/reference/cli/mc-anonymous/mc-anonymous-get-json

Example for the TARGET parameter, specifying the alias and full bucket path for which to get the anonymous policy.

```bash
mc anonymous get-json myaistor/mybucket

```

--------------------------------

### Start AIStor Server with license and drives

Source: https://docs.min.io/aistor/reference/aistor-server

Starts the `minio server` process with a license file and a sequential series of directories using expansion notation. The license flag is required; without it, the server cannot start.

```bash
minio server --license /path/to/minio.license /mnt/disk{1...4}

```

--------------------------------

### makeBucket example

Source: https://docs.min.io/aistor/developers/sdk/haskell/api

Creates a new bucket with the specified region. If the region is not specified, the region from ConnectInfo is used. The example uses minioPlayCI and prints success or failure.

```haskell
{-# Language OverloadedStrings #-}

main :: IO ()
main = do
    res <- runMinio minioPlayCI $ do
        makeBucket bucketName (Just "us-east-1")
    case res of
        Left err -> putStrLn $ "Failed to make bucket: " ++ (show res)
        Right _ -> putStrLn $ "makeBucket successful."

```

--------------------------------

### GetBucketReplicationMetrics example

Source: https://docs.min.io/aistor/developers/sdk/go/api

Gets the latest replication metrics for a bucket. This is a MinIO specific extension. The example logs a fatal error if the call fails.

```go
replMetrics, err := minioClient.GetBucketReplicationMetrics(context.Background(), "my-bucketname")
if err != nil {
    log.Fatalln(err)
}
```

--------------------------------

### Create certificate and CA directories

Source: https://docs.min.io/aistor/installation/linux/network-encryption/enable-tls-encryption

Example paths for the certificates and CAs directories. Create these directories before adding certificates.

```bash
# example certificates path
/opt/minio/certs

# example CAs path
/opt/minio/certs/CAs
```

--------------------------------

### Get specific object example

Source: https://docs.min.io/aistor/reference/cli/mc-share/mc-share-download

Generates a URL that supports GET requests for an object. Replace `ALIAS`, `PATH`, and `DURATION` with actual values.

```bash
mc share download --expire DURATION ALIAS/PATH
```

--------------------------------

### getObjectTags(GetObjectTagsArgs args) - Get object tags

Source: https://docs.min.io/aistor/developers/sdk/java/api

Gets tags of an object. The example uses GetObjectTagsArgs.builder() to specify the bucket and object name.

```java
Tags tags = minioClient.getObjectTags(
    GetObjectTagsArgs.builder().bucket("my-bucketname").object("my-objectname").build());

```

--------------------------------

### SOURCE parameter example (local source)

Source: https://docs.min.io/aistor/reference/cli/mc-diff

Example for the `SOURCE` parameter when the source is a local filesystem folder. Specify the full path to that folder.

```shell
mc diff ~/path/to/mydata/ myaistor/mybucket/

```

--------------------------------

### minio server --ftp configuration example

Source: https://docs.min.io/aistor/reference/aistor-server

Example command enabling FTP/FTPS with an address port, passive port range, and TLS certificate and key paths.

```bash
minio http://server{1...4}/disk{1...4} \
--ftp="address=:8021"                         \
--ftp="passive-port-range=30000-40000"        \
--ftp="tls-private-key=path/to/private.key"   \
--ftp="tls-public-cert=path/to/public.crt"    \
...

```

--------------------------------

### Get warehouse response

Source: https://docs.min.io/aistor/developers/aistor-tables/aistor-tables-api

Example 200 OK response for getting a warehouse, including name, bucket, uuid, created-at timestamp, and properties.

```json
{
  "name": "analytics",
  "bucket": "mybucket",
  "uuid": "9c12d441-03fe-4693-9a96-a0705ddf69c1",
  "created-at": "2025-10-22T10:30:00Z",
  "properties": {
    "owner": "data-team",
    "description": "Data science tables",
    "environment": "production"
  }
}
```

--------------------------------

### Print disk usage for a bucket (ALIAS parameter example)

Source: https://docs.min.io/aistor/reference/cli/mc-du

Example of the `ALIAS` parameter, showing how to specify a bucket path.

```bash
mc du myaistor/mybucket

```

--------------------------------

### Validate Operator Installation with kubectl

Source: https://docs.min.io/aistor/administration/upgrade-aistor-server/open-source-minio/kubernetes

Validates the installation by listing all resources in the aistor namespace. The output should show running pods similar to the example.

```bash
kubectl get all -n aistor
```

--------------------------------

### Get four pools with filter, starting at item 2

Source: https://docs.min.io/aistor/reference/cli/admin/mc-admin-pool/mc-admin-pool-top

Lists up to four pools matching the filter, starting from index 2. Combines --filter, --start, and --count flags.

```bash
mc admin pool top [alias] --filter "PoolIndex = 1" --start 2 --count 4

```

--------------------------------

### Run FileUploader - Go commands

Source: https://docs.min.io/aistor/developers/sdk/go

Initializes a Go module, fetches the MinIO SDK dependencies, and runs the FileUploader program.

```bash
go mod init example/FileUploader
go get github.com/minio/minio-go/v7
go get github.com/minio/minio-go/v7/pkg/credentials
go run FileUploader.go

```

--------------------------------

### Example output of mc admin config get notify_nsq

Source: https://docs.min.io/aistor/administration/bucket-notifications/publish-events-to-nsq

Example output showing two NSQ endpoints configured with identifiers primary and secondary.

```shell
notify_nsq:primary nsqd_address="https://nsq.example.com" queue_dir="" queue_limit="0"  tls="off" tls_skip_verify="off" topic=""
notify_nsq:secondary nsqd_address="https://nsq.example.com" queue_dir="" queue_limit="0"  tls="off" tls_skip_verify="off" topic=""

```

--------------------------------

### Create a share with a Delta table (generic example)

Source: https://docs.min.io/aistor/reference/cli/mc-table-share/mc-table-share-create

Generic example for creating a share with a Delta Lake table. Replace ALIAS, SHARE, SCHEMA, NAME, BUCKET, and PATH with your values.

```bash
mc table share create ALIAS/SHARE SCHEMA "NAME:delta:BUCKET:PATH"

```

--------------------------------

### mc tree example with alias and path placeholders

Source: https://docs.min.io/aistor/reference/cli/mc-tree

Generic example showing the `mc tree` command with placeholders `ALIAS` and `PATH`. Replace `ALIAS` with the deployment alias and `PATH` with the bucket path.

```bash
mc tree ALIAS/PATH
```

--------------------------------

### Example object store values file

Source: https://docs.min.io/aistor/administration/upgrade-aistor-server/upgrade-kubernetes-private-registry

Example values file showing the repositories configuration from your initial installation. The Helm chart automatically references images from these repositories.

```yaml
objectStore:
  name: primary-object-store
  pools:
  - name: pool-0
    servers: 8
    volumesPerServer: 8
    size: 2Ti
  services:
    minio:
      serviceType: NodePort
      nodePort: 31000

```

--------------------------------

### Example request with all supported arguments

Source: https://docs.min.io/aistor/developers/security-token-service/assumerolewithwebidentity

Example POST request using all supported arguments. Replace the hostname with your AIStor Server URL.

```http
POST https://aistor.example.net?Action=AssumeRoleWithWebIdentity
&WebIdentityToken=TOKEN
&Version=2011-06-15
&DurationSeconds=86000
&Policy={}

```

--------------------------------

### Get four nodes with a filter, starting at item 2

Source: https://docs.min.io/aistor/reference/cli/admin/mc-admin-node/mc-admin-node-top

Combines `--filter`, `--start`, and `--count` flags to retrieve a limited set of nodes. Starts at index 2 and returns 4 nodes matching the filter.

```bash
mc admin node top [alias] --filter "PoolIndex = 1" --start 2 --count 4

```

--------------------------------

### Get the UID of minio-user

Source: https://docs.min.io/aistor/operations/security/storage-hardening

Determine the UID that MinIO AIStor runs as, for example 1000.

```bash
# Get the UID of minio-user (for example, 1000)
id -u minio-user

```

--------------------------------

### Example internode initialization success line

Source: https://docs.min.io/aistor/operations/rdma/validate-rdma

Example output showing the success line with remote peer count, local NIC count, and primary listener address.

```text
RDMA: internode initialized with 15 remote peer(s), 2 local NIC(s), primary listener 10.0.0.1:5555

```

--------------------------------

### getPresignedObjectUrl(GetPresignedObjectUrlArgs args) - Get presigned URL for download, upload, and metadata lookup

Source: https://docs.min.io/aistor/developers/sdk/java/api

Gets presigned URLs for HTTP methods GET, PUT, and HEAD with custom expiry and query parameters. The example shows how to set response-content-type and print the URLs.

```java
// Get presigned URL string to download 'my-objectname' in 'my-bucketname'
// with an expiration of 2 hours.
//
// Additionally also add 'response-content-type' to dynamically set content-type
// for the server response.
Map<String, String> reqParams = new HashMap<String, String>();
reqParams.put("response-content-type", "application/json");

String url =
   minioClient.getPresignedObjectUrl(
       GetPresignedObjectUrlArgs.builder()
           .method(Method.GET)
           .bucket("my-bucketname")
           .object("my-objectname")
           .expiry(2, TimeUnit.HOURS)
           .extraQueryParams(reqParams)
           .build());
System.out.println(url);

// Get presigned URL string to upload 'my-objectname' in 'my-bucketname'
// with an expiration of 1 day.
String url =
   minioClient.getPresignedObjectUrl(
       GetPresignedObjectUrlArgs.builder()
           .method(Method.PUT)
           .bucket("my-bucketname")
           .object("my-objectname")
           .expiry(1, TimeUnit.DAYS)
           .build());
System.out.println(url);

// Get presigned URL string to lookup metadata for 'my-objectname' in 'my-bucketname'
// with an expiration of 2 hours.
//
// Additionally also add 'response-content-type' to dynamically set content-type
// for the server metadata response.
Map<String, String> reqParams = new HashMap<String, String>();
reqParams.put("response-content-type", "application/json");

String url =
   minioClient.getPresignedObjectUrl(
       GetPresignedObjectUrlArgs.builder()
           .method(Method.HEAD)
           .bucket("my-bucketname")
           .object("my-objectname")
           .expiry(2, TimeUnit.HOURS)
           .extraQueryParams(reqParams)
           .build());
System.out.println(url);

```

--------------------------------

### MakeBucketAsync(MakeBucketArgs args) example

Source: https://docs.min.io/aistor/developers/sdk/dotnet/api

Creates a bucket using a MakeBucketArgs object. Checks existence with BucketExistsAsync using bktExistArgs, then creates the bucket with mkBktArgs and prints the bucket name. Catches MinioException and prints the error.

```csharp
try
{
   // Create bucket if it doesn't exist.
   bool found = await minioClient.BucketExistsAsync(bktExistArgs);
   if (found)
   {
      Console.WriteLine(bktExistArgs.BucketName +" already exists");
   }
   else
   {
     // Create bucket 'my-bucketname'.
     await minioClient.MakeBucketAsync(mkBktArgs);
     Console.WriteLine(mkBktArgs.BucketName + " is created successfully");
   }
}
catch (MinioException e)
{
   Console.WriteLine("Error occurred: " + e);
}
```

--------------------------------

### Go RDMA upload and download with minio-go

Source: https://docs.min.io/aistor/developers/s3-over-rdma

Complete Go example showing how to enable RDMA on the client, allocate a page-aligned buffer, and perform an upload and download. Requires the minio-cpp library built with RDMA and a cuObjServer connection.

```go
package main

import (
	"context"
	"log"
	"unsafe"

	minio "github.com/minio/minio-go/v7"
	"github.com/minio/minio-go/v7/pkg/credentials"
)

func main() {
	const size = 1 << 20 // 1 MiB

	client, err := minio.New("aistor.example.net:9000", &minio.Options{
		Creds:      credentials.NewStaticV4("ACCESS_KEY", "SECRET_KEY", ""),
		Secure:     false,
		EnableRDMA: true,
	})
	if err != nil {
		log.Fatal(err)
	}

	if !minio.IsRDMAAvailable() {
		log.Fatal("no cuObjServer connection; the transfer would fall back to HTTP")
	}

	ctx := context.Background()

	src := minio.AlignedBuffer(size)
	if src == nil {
		log.Fatal("AlignedBuffer failed")
	}
	defer minio.FreeAlignedBuffer(src)

	// Fill the registered buffer in place. Do not build the payload in a
	// separate slice and pass that instead: the transfer reads from src.
	payload := unsafe.Slice((*byte)(src), size)
	for i := range payload {
		payload[i] = byte(i)
	}

	info, err := client.PutObject(ctx, "my-bucket", "my-object", nil, 0, minio.PutObjectOptions{
		RDMABuffer:     src,
		RDMABufferSize: size,
	})
	if err != nil {
		log.Fatal(err)
	}
	log.Printf("uploaded etag=%s size=%d", info.ETag, info.Size)

	dst := minio.AlignedBuffer(size)
	if dst == nil {
		log.Fatal("AlignedBuffer failed")
	}
	defer minio.FreeAlignedBuffer(dst)

	obj, err := client.GetObject(ctx, "my-bucket", "my-object", minio.GetObjectOptions{
		RDMABuffer:     dst,
		RDMABufferSize: size,
	})
	if err != nil {
		log.Fatal(err)
	}
	stat, err := obj.Stat()
	if err != nil {
		log.Fatal(err)
	}
	log.Printf("downloaded size=%d", stat.Size)
}

```

--------------------------------

### GetBucketVersioning: Get bucket versioning configuration

Source: https://docs.min.io/aistor/developers/sdk/go/api

Gets the versioning configuration for an S3 bucket. The example creates a MinIO client for S3, retrieves the versioning configuration, and prints it using %+v.

```go
s3Client, err := minio.New("s3.amazonaws.com", &minio.Options{
	Creds:  credentials.NewStaticV4("YOUR-ACCESSKEYID", "YOUR-SECRETACCESSKEY", ""),
	Secure: true,
})
if err != nil {
    log.Fatalln(err)
}

// Get versioning configuration set on an S3 bucket and print it out
versioningConfig, err := s3Client.GetBucketVersioning(context.Background(), "my-bucketname")
if err != nil {
    log.Fatalln(err)
}
fmt.Printf("%+v\n", versioningConfig)

```

--------------------------------

### Start resync with mc replicate resync start

Source: https://docs.min.io/aistor/reference/cli/mc-replicate/mc-replicate-resync

Starts the resynchronization procedure using the specified bucket as the source and the --remote-bucket as the remote target. The example uses the 'data' bucket on the deployment associated with the 'myaistor' alias. Mutually exclusive with 'mc replicate resync status'.

```bash
mc replicate resync start myaistor/data --remote-bucket "ARN"

```
Tokens:
Raw