CreateAccessPoint interface creates an access point for the specified bucket. Each access point associates with a specific bucket and provides a unique domain name to access the data in that bucket. You can configure network sources and independent access control policies for different access point.

Request syntax

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"​
}​

Request parameters and headers

For common request headers, see Common Parameters.

Field name

Location

Type

Required

Example value

Description

Field name	Location	Type	Required	Example value	Description
AccessPointName	Path	String	Yes	ap-test	Name of the access point. Must be unique within the same account and region.
x-tos-account-id	Header	String	Yes	200********	Your Volcano Engine account ID.

Request body elements

Field name

Location

Type

Required

Example value

Description

Field name	Location	Type	Required	Example value	Description
Bucket	Body	String	Yes	bkt01	Name of the bucket associated with the access point. You can specify buckets outside this account.
BucketAccountId	Body	String	No	200*********	The account ID of the target bucket. This parameter is optional if accessing a bucket under the current account name.
NetworkOrigin	Body	String	Yes	internet	Network sources allowed to access this endpoint. The options are as follows: internet: allows access from the internet and VPC networks. vpc: only allows access from specified VPC networks.
VpcId	Body	String	No	vpc-********	Specify the VPC network ID allowed for access. tip This parameter is required when the NetworkOrigin parameter value is vpc.

Response headers

The response contains common headers. For more information, see Common Parameters.

Response body elements

Field name

Type

Example value

Description

Field name	Type	Example value	Description
AccessPointTrn	String	trn:tos:cn-beijing:200********accesspoint/ap-test	Unique resource identifier of the access point.
Alias	String	ap-test-5007a2f0bcb595f63e2215c****-tosalias	Alias of the access point. When creating an access point, TOS automatically generates a globally unique alias for it.

Sample request

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"​
}​

Sample response

{​
    "AccessPointTrn": "trn:tos:cn-beijing:200********:accesspoint/ap-test",​
    "Alias": "ap-test-5007a2f0bcb595f63e2215c****-tosalias"​
}​

Last updated: 2026.04.01 14:38:54

Public security network record in Beijing: No. 11010802032137