使用S3 Java SDK访问OOS
更新时间 2025-10-10 15:40:16
最近更新时间: 2025-10-10 15:40:16
本节主要介绍如何通过S3 Java SDK访问OOS。
应用场景
已开通对象存储（经典版）Ⅰ型服务，使用S3 Java SDK访问OOS Bucket和Object。
前提条件
已开通象存储（经典版）Ⅰ型服务，并已创建访问密钥AccessKeyID和SecretAccessKey。
当前AccessKeyID和SecretAccessKey具有OOS相关资源的访问权限。
已创建S3 Java SDK 1.x版本，并能正常使用。
可调用的API详见详见OOS兼容哪些Amazons S3 API。
具体方法
可以通过下列两种方式中的一种配置AccessKey：
通过代码配置AccessKey
通过配置文件读取AccessKey
通过代码配置AccessKey
对于Amazon S3 Java SDK 1.x版本，可以通过以下代码进行初始化配置，以下以Amazon S3 Java SDK 1.11.837版本为例：
AmazonS3 s3 = AmazonS3ClientBuilder.standard()
.withCredentials(new AWSStaticCredentialsProvider(new BasicAWSCredentials(AccessKeyID, SecretAccessKey)))
.withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration(
Endpoint,
Region))
.withPathStyleAccessEnabled(false)
.withChunkedEncodingDisabled(true)
.build(); | 参数 | 描述 |
|---|---|
| AccessKeyID | OOS对应的AccessKeyID。 |
| SecretAccessKey | OOS对应的SecretAccessKey。 |
| Endpoint | OOS的Endpoint。详见“OOS具体地区与域名对应关系表”。 |
| Region | OOS的Endpoint的对应Region。详见“OOS具体地区与域名对应关系表”。 |
| withPathStyleAccessEnabled | 请求的DNS格式。 取值：
默认为false。 |
| withChunkedEncodingDisabled | 请求负载时是否禁用分块编码的选项。 取值：
默认为false。OOS目前不支持分块编码，因此此项必须设置为true。 |
通过配置文件读取AccessKey
按照以下步骤进行配置：
在~/.aws/credentials路径下的证书文件中配置OOS访问密钥。
[default] aws_access_key_id = [AccessKeyID] aws_secret_access_key = [SecretAccessKey]设置Endpoint。
AmazonS3 s3 = AmazonS3ClientBuilder.standard() .withEndpointConfiguration(new AwsClientBuilder.EndpointConfiguration( Endpoint, Region)) .withPathStyleAccessEnabled(false) .withChunkedEncodingDisabled(true) .build();
| 参数 | 描述 |
|---|---|
| AccessKeyID | OOS对应的AccessKeyID。 |
| SecretAccessKey | OOS对应的SecretAccessKey。 |
| Endpoint | OOS的Endpoint。详见“OOS具体地区与域名对应关系表”。 |
| Region | OOS的Endpoint的对应Region。详见“OOS具体地区与域名对应关系表”。 |
| withPathStyleAccessEnabled | 请求的DNS格式。 取值：
默认为false。 |
| withChunkedEncodingDisabled | 请求负载时是否禁用分块编码的选项。 取值：
默认为false。OOS目前不支持分块编码，因此此项必须设置为true。 |
OOS具体地区与域名对应关系表
| 地区 | OOS Region | OOS API Endpoint |
|---|---|---|
| 对象存储网络 | cn | oos-cn.ctyunapi.cn |
| 郑州 | hazz | oos-hazz.ctyunapi.cn |
| 沈阳 | lnsy | oos-lnsy.ctyunapi.cn |
| 四川成都 | sccd | oos-sccd.ctyunapi.cn |
| 乌鲁木齐 | xjwlmq | oos-xjwlmq.ctyunapi.cn |
| 甘肃兰州 | gslz | oos-gslz.ctyunapi.cn |
| 山东青岛 | sdqd | oos-sdqd.ctyunapi.cn |
| 贵州贵阳 | gzgy | oos-gzgy.ctyunapi.cn |
| 湖北武汉 | hbwh | oos-hbwh.ctyunapi.cn |
| 安徽芜湖 | ahwh | oos-ahwh.ctyunapi.cn |
| 广东深圳 | gdsz | oos-gdsz.ctyunapi.cn |
| 江苏苏州 | jssz | oos-jssz.ctyunapi.cn |
| 上海2 | sh2 | oos-sh2.ctyunapi.cn |
