Object Storage Service：OSSClient初始化

使用OSS網域名稱建立OSSClient

以下代碼使用OSS網域名稱建立OSSClient。關於不同地區的OSS網域名稱，請參見OSS地區和訪問網域名稱。

// yourEndpoint填寫Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
String endpoint = "yourEndpoint";

// 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請先配置環境變數。
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();

// 建立OSSClient執行個體。
OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider);

// 關閉OSSClient。
ossClient.shutdown();                    

使用自訂網域名建立OSSClient

以下代碼使用自訂網域名建立OSSClient。關於使用自訂網域名訪問OSS的更多資訊，請參見綁定自訂網域名至Bucket預設網域名稱。

// yourEndpoint填寫自訂網域名。
String endpoint = "yourEndpoint";

// 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請先配置環境變數。
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();

// 建立ClientBuilderConfiguration執行個體，您可以根據實際情況修改預設參數。
ClientBuilderConfiguration conf = new ClientBuilderConfiguration();

// 設定是否支援CNAME。CNAME用於將自訂網域名綁定到目標Bucket。
conf.setSupportCname(true);

// 建立OSSClient執行個體。
OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider, conf);

// 關閉OSSClient。
ossClient.shutdown();                    

使用STS建立OSSClient

以下代碼使用STS建立OSSClient。

• 關於搭建STS服務的具體操作，請參見使用STS臨時訪問憑證訪問OSS。

• 您可以通過調用STS服務的AssumeRole介面或者使用各語言STS SDK來擷取臨時訪問憑證。

• 臨時訪問憑證包括臨時存取金鑰（AccessKeyId和AccessKeySecret）和安全性權杖（SecurityToken）。臨時訪問憑證有效時間單位為秒，最小值為900，最大值以當前角色設定的最大會話時間為準。更多資訊，請參見設定RAM角色最大會話時間。

• 完整程式碼範例，請參見使用簽名URL下載。

// yourEndpoint填寫Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
String endpoint = "yourEndpoint";

// 從環境變數中擷取STS的存取金鑰（AccessKey ID和AccessKey Secret）和安全性權杖（SecurityToken）作為訪問憑證。運行本程式碼範例之前，請先配置環境變數。
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();

// 建立OSSClient執行個體。
OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider);

// 關閉OSSClient。
ossClient.shutdown();                    

使用STSAssumeRole建立OSSClient

以下代碼使用STSAssumeRole建立OSSClient。

// 授權STSAssumeRole訪問的Region。以華東1（杭州）為例，其它Region請根據實際情況填寫。
String region = "cn-hangzhou";

// 從環境變數中擷取RAM使用者的存取金鑰（AccessKeyId和AccessKeySecret）。運行本程式碼範例之前，請先配置環境變數。
String accessKeyId = System.getenv("ALIYUN_ACCESS_KEY_ID");
String accessKeySecret = System.getenv("ALIYUN_ACCESS_KEY_SECRET");

// 從環境變數中擷取RAM角色的RamRoleArn。運行本程式碼範例之前，請先配置環境變數。
String roleArn = System.getenv("ALIYUN_STS_ROLE_ARN");  

// 建立STSAssumeRoleSessionCredentialsProvider執行個體。
STSAssumeRoleSessionCredentialsProvider credentialsProvider = CredentialsProviderFactory.newSTSAssumeRoleSessionCredentialsProvider(
region, accessKeyId, accessKeySecret, roleArn);

// yourEndpoint填寫Bucket所在地區對應的Endpoint。以華東1（杭州）為例，Endpoint填寫為https://oss-cn-hangzhou.aliyuncs.com。
String endpoint = "yourEndpoint";

// 建立ClientBuilderConfiguration執行個體。
ClientBuilderConfiguration conf = new ClientBuilderConfiguration();

// 建立OSSClient執行個體。
OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider, conf);

// 關閉OSSClient。
ossClient.shutdown();

使用EcsRamRole建立OSSClient

在Elastic Compute Service上，您可以通過執行個體RAM角色的方式訪問OSS。執行個體RAM角色允許您將一個角色關聯到雲端服務器執行個體，在執行個體內部基於臨時憑證STS訪問OSS。臨時憑證由系統自動產生和更新，應用程式可以使用指定的執行個體中繼資料URL擷取臨時憑證，無需特別管理。

以下代碼用於使用EcsRamRole建立OSSClient。

// 以華東1（杭州）為例，其它endpoint請根據實際情況填寫。
String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";     

// 通過ECS RAM角色擷取訪問憑證，例如以角色名稱（ecs-ram-role）訪問為例。
InstanceProfileCredentialsProvider credentialsProvider = CredentialsProviderFactory.newInstanceProfileCredentialsProvider("ecs-ram-role");

// 建立OSSClient執行個體。
 OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider, new ClientBuilderConfiguration());

// 關閉OSSClient。
ossClient.shutdown(); 

專有雲或專有域環境建立OSSClient

以下代碼使用專有雲或專有域環境建立OSSClient。

// yourEndpoint填寫Bucket所在地區對應的Endpoint。
String endpoint = "yourEndpoint";

// 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請先配置環境變數。
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();

// 建立ClientBuilderConfiguration執行個體，您可以根據實際情況修改預設參數。
ClientBuilderConfiguration conf = new ClientBuilderConfiguration();

// 關閉CNAME選項。
conf.setSupportCname(false);

// 建立OSSClient執行個體。
OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider, conf);

// 關閉OSSClient。
ossClient.shutdown();                    

使用IP建立OSSClient

以下代碼使用IP建立OSSClient。

// 某些特殊情況（例如專有域）下，您需要將IP地址作為Endpoint使用，請根據實際IP地址填寫。
String endpoint = "https://10.10.10.10";

// 從環境變數中擷取訪問憑證。運行本程式碼範例之前，請先配置環境變數。
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();

// 建立ClientBuilderConfiguration。
ClientBuilderConfiguration conf = new ClientBuilderConfiguration();

// 開啟次層網域訪問OSS，預設不開啟。OSS Java SDK 2.1.2及之前的版本需要設定此值，OSS Java SDK 2.1.2及之後的版本會自動檢測到IP地址，不需要再設定此值。
conf.setSLDEnabled(true);

// 建立OSSClient執行個體。
OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider, conf);

// 關閉OSSClient。
ossClient.shutdown();