通过CreateAccessPoint接口创建接入点_对象存储(OSS)-阿里云帮助中心

调用CreateAccessPoint接口创建接入点。

注意事项

阿里云账号默认拥有创建接入点的权限。如果您希望通过RAM用户或者STS的方式创建接入点，您必须拥有oss:CreateAccessPoint权限。
单个阿里云账号支持创建1000个接入点。
单个Bucket支持创建100个接入点。

请求语法

PUT /?accessPoint HTTP/1.1
Date: GMT Date
Content-Length：ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointConfiguration>
  	<AccessPointName>ap-01</AccessPointName>
    <NetworkOrigin>vpc</NetworkOrigin>
    <VpcConfiguration>
      <VpcId>vpc-t4nlw426y44rd3iq4xxxx</VpcId>
    </VpcConfiguration>
</CreateAccessPointConfiguration>

请求头

此接口仅涉及公共请求头。更多信息，请参见公共请求头（Common Request Headers）。

请求元素

名称	类型	是否必选	示例值	描述
CreateAccessPointConfiguration	容器	是	不涉及	保存接入点信息的容器。父节点：无子节点：AccessPointName，NetworkOrigin和VpcConfiguration
AccessPointName	字符串	是	ap-01	填写接入点名称。接入点命名规范如下：接入点名称在当前阿里云账号单个地域内唯一。不允许以-ossalias结尾。只能包括小写字母、数字和短划线（-），不能以短横线开头或结尾。命名长度为3~19个字符。父节点：CreateAccessPointConfiguration 子节点：无
NetworkOrigin	字符串	是	vpc	接入点网络来源。取值如下： vpc：限制仅支持通过指定的VPC ID访问接入点。 internet：同时支持通过外网和内网Endpoint访问接入点。父节点：CreateAccessPointConfiguration 子节点：无
VpcConfiguration	容器	否	不涉及	保存VPC网络来源信息的容器。父节点：CreateAccessPointConfiguration 子节点：VpcId
VpcId	字符串	否	vpc-t4nlw426y44rd3iq4xxxx	仅当NetworkOrigin取值为vpc时，需要指定VPC ID。重要通过接入点限制VPC来源时，需确保选择的VPC地域与OSS支持的网关终端节点区域相匹配，否则会导致鉴权请求无法关联至对应的VPC，进而引发鉴权失败。关于OSS支持的网关终端节点地域，请参见OSS支持的网关终端节点地域。父节点：VpcId 子节点：无

响应头

此接口仅包含公共响应头。更多信息，请参见公共响应头（Common Response Headers）。

响应元素

名称	类型	示例值	描述
CreateAccessPointResult	容器	不涉及	保存接入点信息的容器。子节点：AccessPointArn，Alias
AccessPointArn	字符串	acs:oss:cn-hangzhou:128364106451xxxx:accesspoint/ap-01	接入点ARN。
Alias	字符串	ap-01-45ee7945007a2f0bcb595f63e2215cxxxx-ossalias	接入点别名。

示例

请求示例

PUT /?accessPoint HTTP/1.1
Date: Mon, 19 Jun 2023 03:15:40 GMT
Content-Length：0
Content-Type: application/xml
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
Authorization: OSS qn6q**************:77Dv****************    
<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointConfiguration>
  	<AccessPointName>ap-01</AccessPointName>
    <NetworkOrigin>vpc</NetworkOrigin>
    <VpcConfiguration>
      <VpcId>vpc-t4nlw426y44rd3iq4xxxx</VpcId>
    </VpcConfiguration>
</CreateAccessPointConfiguration>

返回示例

HTTP/1.1 200 OK
x-oss-request-id: 5C1B138A109F4E405B2Dxxxx
Date: Mon, 19 Jun 2023 03:15:40 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS
<?xml version="1.0" encoding="UTF-8"?>
<CreateAccessPointResult>
  <AccessPointArn>acs:oss:cn-hangzhou:128364106451xxxx:accesspoint/ap-01</AccessPointArn>
  <Alias>ap-01-45ee7945007a2f0bcb595f63e2215cxxxx-ossalias</Alias>
</CreateAccessPointResult>