全部產品
Search
文件中心

Object Storage Service:使用對象FC存取點

更新時間:Jun 19, 2024

建立對象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