如何使用接入点访问OSS资源 - 对象存储 OSS

创建接入点后，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）	列举Bucket中所有文件（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	解冻归档存储、冷归档存储或者深度冷归档存储类型的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	删除指定的对象标签。