You need to enable JavaScript to run this app.
文档中心
对象存储

对象存储

复制全文
下载 pdf
加速器
CreateAccessPoint
复制全文
下载 pdf
CreateAccessPoint
功能描述​
CreateAccessPoint 接口用于为指定的存储桶(Bucket)创建一个接入点(AccessPoint)。每个接入点都与一个特定的存储桶关联,并提供一个唯一的域名用于访问该存储桶中的数据。同时,您可以为不同接入点配置网络来源和独立的访问控制策略。​
请求消息样式​
​
PUT /accesspoint/{AccessPointName} HTTP/1.1​
Host:{BucketName}.tos-cn-beijing.volces.com​
Date: GMT Date​
Authorization: authorization string​
x-tos-account-id: AccountId​
​
{​
"Bucket": "string",​
"BucketAccountId": "string",​
"NetworkOrigin": "string",​
"VpcId": "string"​
}​
​
请求参数和消息头​
该请求使用的公共请求消息头,请参见公共参数。​
​
名称​
位置​
参数类型​
是否必选​
示例值​
说明​
AccessPointName​
Path​
String​
是​
ap-test​
接入点的名称。在同一账号同一地域下必须唯一。​
x-tos-account-id​
Header​
String​
是​
200********​
您的火山引擎账号 ID。​
​
请求元素​
​
名称​
位置​
参数类型​
是否必选​
示例值​
说明​
Bucket​
Body​
String​
是​
bkt01​
接入点所关联的存储桶名称。您可以指定非本账号下的存储桶。​
BucketAccountId​
Body​
String​
否​
200*********​
目标存储桶所属的账号 ID。若访问当前账号名下的存储桶,则该参数可选。​
NetworkOrigin​
Body​
String​
是​
internet​
允许访问此接入点的网络来源。取值如下:​
  • internet:允许来自互联网和 VPC 网络的访问。​
  • vpc:只允许来自指定 VPC 网络的访问。​
VpcId​
Body​
String​
否​
vpc-********​
用于指定允许访问的 VPC 网络 ID。​
说明​
当 NetworkOrigin 参数值为 vpc 时,此参数必选。​
​
响应消息头​
该请求返回的公共响应消息头,请参见公共参数。​
响应元素​
​
名称​
参数类型​
示例值​
说明​
AccessPointTrn​
String​
trn:tos:cn-beijing:200********accesspoint/ap-test​
接入点的唯一资源标识符。​
Alias​
String​
ap-test-5007a2f0bcb595f63e2215c****-tosalias​
接入点的别名。创建接入点时,TOS 会自动为此接入点生成一个全局唯一的别名。​
​
请求示例​
​
PUT /accesspoint/ap-test HTTP/1.1​
Host:{BucketName}.tos-cn-beijing.volces.com​
Date: Fri, 30 Jul 2021 06:45:39 GMT​
Authorization: TOS4-HMAC-SHA256 Credential=AKLT**********/20210730/cn-beijing/tos/request, SignedHeaders=host;x-tos-account-id;x-tos-date, Signature=...​
x-tos-account-id: 200********​
Content-Type: application/json; charset=utf-8​
Content-Length: 77​
​
{​
"Bucket": "bkt01",​
"NetworkOrigin": "internet"​
}​
​
返回示例​
​
{​
"AccessPointTrn": "trn:tos:cn-beijing:200********:accesspoint/ap-test",​
"Alias": "ap-test-5007a2f0bcb595f63e2215c****-tosalias"​
}​
​
最近更新时间:2026.04.01 11:06:30
这个页面对您有帮助吗?
有用
有用
无用
无用