通過GetAccessPoint擷取存取點資訊 - Object Storage Service

調用GetAccessPoint介面擷取存取點資訊。

注意事項

阿里雲帳號預設擁有擷取存取點資訊的許可權。如果您希望通過RAM使用者或者STS的方式擷取存取點資訊，您必須擁有oss:GetAccessPoint許可權。

請求文法

GET /?accessPoint HTTP/1.1
Date: GMT Date
Content-Length：ContentLength
Content-Type: ContentType
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
x-oss-access-point-name: apname
Authorization: SignatureValue

要求標頭

名稱	類型	是否必選	樣本值	描述
x-oss-access-point-name	字串	是	ap-01	存取點名稱。

此介面涉及的其他公用要求標頭，例如Date，Authorization等。更多資訊，請參見公用要求標頭（Common Request Headers）。

回應標頭

此介面僅包含公用回應標頭。更多資訊，請參見公用回應標頭（Common Response Headers）。

響應元素

名稱	類型	樣本值	描述
GetAccessPointResult	容器	不涉及	儲存存取點資訊的容器。父節點：無子節點：AccessPointName，Bucket，AccountId，NetworkOrigin，VpcConfiguration，AccessPointArn，CreationDate，Alias，Status和Endpoints
AccessPointName	字串	ap-01	存取點名稱。父節點：GetAccessPointResult 子節點：無
Bucket	字串	oss-example	配置存取點的Bucket名稱。父節點：GetAccessPointResult 子節點：無
AccountId	字串	111933544165xxxx	配置存取點的阿里雲帳號UID。父節點：GetAccessPointResult 子節點：無
NetworkOrigin	字串	vpc	存取點網路來源。傳回值如下： vpc：限制僅支援通過指定的VPC ID訪問存取點。 internet：同時持通過外網和內網Endpoint互連網訪問存取點。父節點：GetAccessPointResult 子節點：無
VpcConfiguration	容器	不涉及	儲存VPC網路來源資訊的容器。父節點：GetAccessPointResult 子節點：VpcId
VpcId	字串	vpc-t4nlw426y44rd3iq4xxxx	專用網路執行個體ID。父節點：VpcConfiguration 子節點：無
AccessPointArn	字串	arn:acs:oss-cn-hangzhou:111933544165xxxx:accesspoint/ap-01	存取點ARN。父節點：GetAccessPointResult 子節點：無
CreationDate	字串	1626769503	存取點建立時間，格式為時間戳記。父節點：GetAccessPointResult 子節點：無
Alias	字串	ap-01-ossalias	存取點別名。父節點：GetAccessPointResult 子節點：無
Status		enable	存取點所處狀態。傳回值如下： enable：存取點已建立完成。 disable：存取點已禁用。 creating：存取點正在建立中。 deleting：存取點已刪除。父節點：GetAccessPointResult 子節點：無
Endpoints	容器	不涉及	儲存存取點網路來源資訊的容器。父節點：GetAccessPointResult 子節點：PublicEndpoint和InternalEndpoint
PublicEndpoint	字串	ap-01.oss-cn-hangzhou.oss-accesspoint.aliyuncs.com	存取點的外網Endpoint。父節點：Endpoints 子節點：無
InternalEndpoint	字串	ap-01.oss-cn-hangzhou-internal.oss-accesspoint.aliyuncs.com	存取點的內網Endpoint。父節點：Endpoints 子節點：無
PublicAccessBlockConfiguration	容器	不涉及	儲存阻止公用訪問資訊的容器。父節點：GetAccessPointResult 子節點：BlockPublicAccess
BlockPublicAccess	布爾值	true	擷取存取點的阻止公用訪問配置資訊。 true：開啟阻止公用訪問。 false：關閉阻止公用訪問。父節點：PublicAccessBlockConfiguration 子節點：無

樣本

請求樣本

GET /?accessPoint HTTP/1.1
Date: Mon, 19 Jun 2023 03:15:40 GMT
Content-Length：10
Content-Type: application/xml
Host: oss-example.oss-cn-hangzhou.aliyuncs.com
x-oss-access-point-name: ap-01
Authorization: OSS qn6q**************:77Dv****************

返回樣本

HTTP/1.1 200
<?xml version="1.0" encoding="UTF-8"?>
<GetAccessPointResult>
  <AccessPointName>ap-01</AccessPointName>
  <Bucket>oss-example</Bucket>
  <AccountId>111933544165xxxx</AccountId>
  <NetworkOrigin>vpc</NetworkOrigin>
  <VpcConfiguration>
     <VpcId>vpc-t4nlw426y44rd3iq4xxxx</VpcId>
  </VpcConfiguration>
  <AccessPointArn>arn:acs:oss:cn-hangzhou:111933544165xxxx:accesspoint/ap-01</AccessPointArn>
  <CreationDate>1626769503</CreationDate>
  <Alias>ap-01-ossalias</Alias>
  <Status>enable</Status>
  <Endpoints>
    <PublicEndpoint>ap-01.oss-cn-hangzhou.oss-accesspoint.aliyuncs.com</PublicEndpoint>
    <InternalEndpoint>ap-01.oss-cn-hangzhou-internal.oss-accesspoint.aliyuncs.com</InternalEndpoint>
  </Endpoints>
  <PublicAccessBlockConfiguration>
    <BlockPublicAccess>true</BlockPublicAccess>
  </PublicAccessBlockConfiguration>
</GetAccessPointResult>