使用接入点

更新时间:2025-01-10 08:57:50

创建接入点后,OSS会自动为您生成接入点别名。您可以使用接入点别名访问存储空间(Bucket)内符合权限要求的数据。

前提条件

已创建接入点。具体步骤,请参见创建接入点

使用阿里云SDK

Java SDK(3.16.3及以上版本)和Python SDK(2.18.0及以上版本)支持通过接入点别名的方式下载OSS资源。

Java
Python
// 当接入点网络来源配置为允许互联网访问时,您可以指定外网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";
# 当接入点网络来源配置为允许互联网访问时,您可以指定外网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)

PutObject

上传Object。

GetObject

获取Object。

CopyObject

拷贝Object。

AppendObject

以追加写的方式上传Object。

DeleteObject

删除单个Object。

DeleteMultipleObjects

删除多个Object。

HeadObject

只返回某个Object的所有元数据,不返回文件内容。

GetObjectMeta

返回Object的部分元数据,包括该ObjectETag、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

删除指定的对象标签。

  • 本页导读 (1)
  • 前提条件
  • 使用阿里云SDK
  • 使用命令行工具ossutil
  • 使用REST API
  • 接入点别名域名兼容的操作