建立對象FC存取點後,OSS會自動為您產生對象FC存取點別名。您可以使用對象FC存取點別名訪問GetObject介面。
前提條件
已編寫處理GetObject請求的函數。具體操作,請參見編寫處理GetObject請求的函數。
使用SDK
Java
Java SDK 3.17.2及以上版本支援通過對象FC存取點別名的方式訪問OSS資源。
import com.aliyun.oss.ClientException;
import com.aliyun.oss.OSS;
import com.aliyun.oss.common.auth.*;
import com.aliyun.oss.OSSClientBuilder;
import com.aliyun.oss.OSSException;
import com.aliyun.oss.model.GetObjectRequest;
import java.io.File;
public class Demo {
public static void main(String[] args) throws Exception {
// 使用對象FC存取點的外網Endpoint進行訪問。
String endpoint = "https://oss-cn-qingdao.aliyuncs.com";
// 使用對象FC存取點的內網Endpoint進行訪問。
// String endpoint = "https://oss-cn-qingdao-internal.aliyuncs.com";
// 從環境變數中擷取訪問憑證。運行本程式碼範例之前,請確保已設定環境變數OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
EnvironmentVariableCredentialsProvider credentialsProvider = CredentialsProviderFactory.newEnvironmentVariableCredentialsProvider();
// 填寫對象FC存取點別名。
String bucketName = "fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias";
// 填寫不包含Bucket名稱在內的Object完整路徑。
String objectName = "yourObjectName";
// 填寫下載到本地的完整路徑。
String pathName = "yourPathName";
// 建立OSSClient執行個體。
OSS ossClient = new OSSClientBuilder().build(endpoint, credentialsProvider);
try {
// 下載Object到本地檔案,並儲存到指定的本地路徑中。如果指定的本地檔案存在會覆蓋,不存在則建立。
// 如果未指定本地路徑,則下載後的檔案預設儲存到樣本程式所屬專案對應本地路徑中。
ossClient.getObject(new GetObjectRequest(bucketName, objectName), new File(pathName));
} catch (OSSException oe) {
System.out.println("Caught an OSSException, which means your request made it to OSS, "
+ "but was rejected with an error response for some reason.");
System.out.println("Error Message:" + oe.getErrorMessage());
System.out.println("Error Code:" + oe.getErrorCode());
System.out.println("Request ID:" + oe.getRequestId());
System.out.println("Host ID:" + oe.getHostId());
} catch (ClientException ce) {
System.out.println("Caught an ClientException, which means the client encountered "
+ "a serious internal problem while trying to communicate with OSS, "
+ "such as not being able to access the network.");
System.out.println("Error Message:" + ce.getMessage());
} finally {
if (ossClient != null) {
ossClient.shutdown();
}
}
}
}
Python
Python SDK 2.18.3及以上版本支援通過對象FC存取點別名的方式訪問OSS資源。
# -*- coding: utf-8 -*-
import oss2
from oss2.credentials import EnvironmentVariableCredentialsProvider
auth = oss2.ProviderAuth(EnvironmentVariableCredentialsProvider())
# 使用對象FC存取點的外網Endpoint進行訪問。
endpoint = "https://oss-cn-qingdao.aliyuncs.com"
# 使用對象FC存取點的內網Endpoint進行訪問。。
# endpoint = "https://oss-cn-qingdao-internal.aliyuncs.com"
# 填寫對象FC存取點別名。
bucket_name = "fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias"
bucket = oss2.Bucket(auth, endpoint=endpoint, bucket_name=bucket_name)
# yourObjectName填寫Object完整路徑,完整路徑中不包含Bucket名稱。
# yourLocalFile填寫本地檔案路徑。如果指定的本地檔案存在會覆蓋,不存在則建立。
bucket.get_object_to_file('yourObjectName', 'yourLocalFile')
Go
Go SDK 1.2.2及以上版本支援通過對象FC存取點別名的方式訪問OSS資源。
package main
import (
"fmt"
"github.com/aliyun/aliyun-oss-go-sdk/oss"
"os"
)
func main() {
provider, err := oss.NewEnvironmentVariableCredentialsProvider()
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 建立OSSClient執行個體。
// yourEndpoint填寫Bucket對應的Endpoint,以華東1(杭州)為例,填寫為https://oss-cn-hangzhou.aliyuncs.com。其它Region請按實際情況填寫。
client, err := oss.New("http://oss-cn-qingdao.aliyuncs.com", "", "", oss.SetCredentialsProvider(&provider))
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// 填寫對象FC存取點別名。
bucketName := "fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias"
bucket, err := client.Bucket(bucketName)
if err != nil {
fmt.Println("Error:", err)
os.Exit(-1)
}
// yourObjectName填寫不包含Bucket名稱在內的Object完整路徑。
// yourLocalFile填寫下載到本地的完整路徑。
err = bucket.GetObjectToFile("yourObjectName", "yourLocalFile")
if err != nil {
fmt.Println("GetObject Error:", err)
os.Exit(-1)
}
fmt.Println("success")
}
使用命令列工具ossutil
通過ossutil請求OSS資源時,您需要將對象FC存取點別名作為bucketname。樣本如下:
ossutil cp oss://fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias/demo.txt /Users/demo/Desktop/demo.txt
更多命令樣本,請參見常用命令。
使用REST API
通過GetObject請求OSS資源時,您需要在Host中使用對象FC存取點別名,樣本如下:
GET /ObjectName HTTP/1.1
Host: fc-ap-01-3b00521f653d2b3223680ec39dbbe2****-opapalias.oss-cn-qingdao.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue