应用场景
已开通对象存储(经典版)Ⅰ型服务,使用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:路径格式(https://oos-cn.ctyunapi.cn/Bucketname)。
true:虚拟主机格式(https://Bucketname.oos-cn.ctyunapi.cn)。
默认为false。
withChunkedEncodingDisabled 请求负载时是否禁用分块编码的选项。
取值:
false:不禁用。
true:禁用。
默认为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:路径格式(https://oos-cn.ctyunapi.cn/Bucketname)。
true:虚拟主机格式(https://Bucketname.oos-cn.ctyunapi.cn)。
默认为false。
withChunkedEncodingDisabled 请求负载时是否禁用分块编码的选项。
取值:
false:不禁用。
true:禁用。
默认为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 |
西藏拉萨 | xzls | oos-xzls.ctyunapi.cn |
安徽芜湖 | ahwh | oos-ahwh.ctyunapi.cn |
广东深圳 | gdsz | oos-gdsz.ctyunapi.cn |
江苏苏州 | jssz | oos-jssz.ctyunapi.cn |
上海2 | sh2 | oos-sh2.ctyunapi.cn |