全部產品
Search
文件中心

Object Storage Service:使用存取點

更新時間:Jun 19, 2024

建立存取點後,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

更多命令樣本,請參見常用命令

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

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

刪除指定的對象標籤。