通過CreateAccessPoint介面建立存取點 - Object Storage Service

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