創建接入點后,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
接入點別名域名兼容的操作
您可以通過接入點別名域名完成以下操作
接口 | 說明 |
配置接入點策略。 | |
獲取接入點策略配置。 | |
刪除接入點策略。 | |
列舉Bucket中所有文件(Object)的信息。 | |
上傳Object。 | |
獲取Object。 | |
拷貝Object。 | |
以追加寫的方式上傳Object。 | |
刪除單個Object。 | |
刪除多個Object。 | |
只返回某個Object的所有元數據,不返回文件內容。 | |
返回Object的部分元數據,包括該Object的ETag、Size(文件大小)以及LastModified等,不返回文件內容。 | |
通過HTML表單上傳的方式上傳Object。 | |
解凍歸檔存儲、冷歸檔存儲或者深度冷歸檔存儲類型的Object。 | |
對目標文件執行SQL語句,返回執行結果。 | |
初始化一個Multipart Upload事件。 | |
根據指定的Object名和uploadId來分塊(Part)上傳數據。 | |
通過在UploadPart請求的基礎上增加一個請求頭x-oss-copy-source來調用UploadPartCopy接口,實現從一個已存在的Object中拷貝數據來上傳一個Part。 | |
在將所有數據Part都上傳完成后,您必須調用該接口來完成整個文件的分片上傳。 | |
取消Multipart Upload事件并刪除對應的Part數據。 | |
列舉所有執行中的Multipart Upload事件,即已經初始化但還未完成(Complete)或者還未中止(Abort)的Multipart Upload事件。 | |
列舉指定uploadId所屬的所有已經上傳成功Part。 | |
修改Object的訪問權限。 | |
查看Object的訪問權限。 | |
創建軟鏈接。 | |
獲取軟鏈接。 | |
設置或更新對象標簽。 | |
獲取對象標簽信息。 | |
刪除指定的對象標簽。 |