调用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 | 填写接入点名称。接入点命名规范如下：
父节点：CreateAccessPointConfiguration 子节点：无 |
NetworkOrigin | 字符串 | 是 | vpc | 接入点网络来源。取值如下：
父节点：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>
命令行工具ossutil
CreateAccessPoint接口所对应的ossutil命令，请参见create-access-point。