全部產品
Search
文件中心

Object Storage Service:CreateAccessPoint

更新時間:Aug 30, 2024

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