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