API概述

创建客户端

Mos

MinioClient minioClient =
    MinioClient.builder()
        .endpoint("https://play.min.io")
        .credentials("Q3A***********3P2F", "zuf+t************************KYY3TG")
        .build();

AWS S3

MinioClient minioClient =
    MinioClient.builder()
        .endpoint("https://s3.amazonaws.com")
        .credentials("YOUR-ACCESSKEYID", "YOUR-SECRETACCESSKEY")
        .build();

MinIO Client Builder

MOS客户端构建器用于创建MOS客户端。构建器具有以下方法来接受参数。

方法	描述
endpoint()	接受端点(endpoint)，可以是字符串、URL或okhttp3.HttpUrl对象，并可选地接受端口号和启用安全(TLS)连接的标志。字符串格式的端点(endpoint)可以如下所示：https://s3.amazonaws.com https://play.min.io https://play.min.io:9000 localhost play.min.io
credentials()	接受S3服务中帐户的访问密钥（也称为用户ID）和秘密密钥（也称为密码）。
region()	接受S3服务的区域名称。如果指定了区域名称，则所有操作都使用该区域，否则将按桶(bucket)进行区域探测。
httpClient()	自定义HTTP客户端以覆盖默认值。

示例

// 1. Create client to S3 service 'play.min.io' at port 443 with TLS security
// for anonymous access.
MinioClient minioClient = MinioClient.builder().endpoint("https://play.min.io").build();

// 2. Create client to S3 service 'play.min.io' at port 443 with TLS security
// using URL object for anonymous access.
MinioClient minioClient = MinioClient.builder().endpoint(new URL("https://play.min.io")).build();

// 3. Create client to S3 service 'play.min.io' at port 9000 with TLS security
// using okhttp3.HttpUrl object for anonymous access.
MinioClient minioClient =
    MinioClient.builder().endpoint(HttpUrl.parse("https://play.min.io:9000")).build();

// 4. Create client to S3 service 'play.min.io' at port 443 with TLS security
// for authenticated access.
MinioClient minioClient =
    MinioClient.builder()
        .endpoint("https://play.min.io")
        .credentials("Q3A***********3P2F", "zuf+t************************KYY3TG")
        .build();

// 5. Create client to S3 service 'play.min.io' at port 9000 with non-TLS security
// for authenticated access.
MinioClient minioClient =
    MinioClient.builder()
        .endpoint("play.min.io", 9000, false)
        .credentials("Q3A***********3P2F", "zuf+t************************KYY3TG")
        .build();

// 6. Create client to S3 service 'play.min.io' at port 9000 with TLS security
// for authenticated access.
MinioClient minioClient =
    MinioClient.builder()
        .endpoint("play.min.io", 9000, true)
        .credentials("Q3A***********3P2F", "zuf+t************************KYY3TG")
        .build();

// 7. Create client to S3 service 'play.min.io' at port 443 with TLS security
// and region 'us-west-1' for authenticated access.
MinioClient minioClient =
    MinioClient.builder()
        .endpoint(new URL("https://play.min.io"))
        .credentials("Q3A***********3P2F", "zuf+t************************KYY3TG")
        .region("us-west-1")
        .build();

// 8. Create client to S3 service 'play.min.io' at port 9000 with TLS security,
// region 'eu-east-1' and custom HTTP client for authenticated access.
MinioClient minioClient =
    MinioClient.builder()
        .endpoint("https://play.min.io:9000")
        .credentials("Q3A***********3P2F", "zuf+t************************KYY3TG")
        .region("eu-east-1")
        .httpClient(customHttpClient)
        .build();

桶操作

对象操作