調用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 | 接入點網絡來源。返回值如下:
父節點: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 | 接入點所處狀態。返回值如下:
父節點: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 | 獲取接入點的阻止公共訪問配置信息。
父節點: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>