全部产品
Search
文档中心

对象存储 OSS:使用接入点

更新时间:Apr 02, 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

解冻归档存储、冷归档存储或者深度冷归档存储类型的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

删除指定的对象标签。