CreateAccessPoint

调用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>