如何使用存取點訪問OSS資源 - Object Storage Service

建立存取點後，OSS會自動為您產生存取點別名。您可以使用存取點別名訪問儲存空間（Bucket）內符合許可權要求的資料。

前提條件

已建立存取點。具體步驟，請參見建立存取點。

使用阿里雲SDK

僅Java SDK（3.16.3及以上版本）和Python SDK（2.18.0及以上版本）支援通過存取點別名的方式下載OSS資源。

Java

// 當存取點網路來源配置為允許互連網訪問時，您可以指定外網Endpoint或者ECS的VPC網路訪問（內網）Endpoint。
String endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 當存取點網路來源配置為允許VPC訪問時，您需要指定ECS的VPC網路訪問（內網）Endpoint。
// String endpoint = "https://oss-cn-hangzhou-internal.aliyuncs.com";
// 填寫存取點別名。
String bucketName = "ap-01-d571827a1e2ed76490899a8a922262****-ossalias";

Python

# 當存取點網路來源配置為允許互連網訪問時，您可以指定外網Endpoint或者ECS的VPC網路訪問（內網）Endpoint。
endpoint = "https://oss-cn-hangzhou.aliyuncs.com"
# 當存取點網路來源配置為允許VPC訪問時，您需要指定ECS的VPC網路訪問（內網）Endpoint。
# endpoint = "https://oss-cn-hangzhou-internal.aliyuncs.com"
# 填寫存取點別名。
bucket_name = "ap-01-d571827a1e2ed76490899a8a922262****-ossalias"

使用命令列工具ossutil

通過ossutil請求OSS資源時，您需要將存取點別名作為bucketname。樣本如下：

ossutil cp oss://ap-01-d571827a1e2ed76490899a8a922262****-ossalias/demo.txt /Users/demo/Desktop/demo.txt

關於該命令的更多說明，請參見cp（下載檔案）。

使用REST API

通過REST API請求OSS資源時，您需要在Host中使用存取點別名。樣本如下：

GET /ObjectName HTTP/1.1
Host: ap-01-9387d8ec9e23cb25320effffd78374****-ossalias.oss-cn-hangzhou.aliyuncs.com 
Date: GMT Date
Authorization: SignatureValue

存取點別名網域名稱相容的操作

您可以通過存取點別名網域名稱完成以下操作

介面	說明
PutAccessPointPolicy	配置存取點策略。
GetAccessPointPolicy	擷取存取點策略配置。
DeleteAccessPointPolicy	刪除存取點策略。
ListObjects（GetBucket）	列舉Bucket中所有檔案（Object）的資訊。
ListObjectsV2（GetBucketV2）	列舉Bucket中所有檔案（Object）的資訊。
ListObjectVersions（GetBucketVersions）	列出 Bucket 中包括刪除標記（Delete Marker）在內的所有 Object 的版本資訊。
PutObject	上傳Object。
GetObject	擷取Object。
CopyObject	拷貝Object。
AppendObject	以追加寫的方式上傳Object。
DeleteObject	刪除單個Object。
DeleteMultipleObjects	刪除多個Object。
HeadObject	只返回某個Object的所有中繼資料，不返迴文件內容。
GetObjectMeta	返回Object的部分中繼資料，包括該Object的ETag、Size（檔案大小）以及LastModified等，不返迴文件內容。
PostObject	通過HTML表單上傳的方式上傳Object。
RestoreObject	解凍Archive Storage、冷Archive Storage或者深度冷Archive Storage類型的Object。
SelectObject	對目標檔案執行SQL語句，返回執行結果。
InitiateMultipartUpload	初始化一個Multipart Upload事件。
UploadPart	根據指定的Object名和uploadId來分塊（Part）上傳資料。
UploadPartCopy	通過在UploadPart請求的基礎上增加一個要求標頭x-oss-copy-source來調用UploadPartCopy介面，實現從一個已存在的Object中拷貝資料來上傳一個Part。
CompleteMultipartUpload	在將所有資料Part都上傳完成後，您必須調用該介面來完成整個檔案的分區上傳。
AbortMultipartUpload	取消Multipart Upload事件並刪除對應的Part資料。
ListMultipartUploads	列舉所有執行中的Multipart Upload事件，即已經初始化但還未完成（Complete）或者還未中止（Abort）的Multipart Upload事件。
ListParts	列舉指定uploadId所屬的所有已經上傳成功Part。
PutObjectACL	修改Object的存取權限。
GetObjectACL	查看Object的存取權限。
PutSymlink	建立軟連結。
GetSymlink	擷取軟連結。
PutObjectTagging	設定或更新對象標籤。
GetObjectTagging	擷取對象標籤資訊。
DeleteObjectTagging	刪除指定的對象標籤。