使用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 |
