調用ListAccessPoints接口獲取用戶級別或Bucket級別的接入點信息。
注意事項
阿里云賬號默認擁有獲取接入點信息的權限。如果您希望通過RAM用戶或者STS的方式獲取接入點信息,您必須擁有oss:ListAccessPoints
權限。
請求語法
獲取用戶級別接入點信息與獲取Bucket級別的接入點信息的區別僅在于請求Host。獲取用戶級別接入點信息的請求Host為外網Endpoint(例如oss-cn-hangzhou.aliyuncs.com
)或者內網Endpoint(例如oss-cn-hangzhou-internal.aliyuncs.com
);獲取Bucket級別接入點信息的請求Host為Bucket域名,例如oss-example.oss-cn-hangzhou.aliyuncs.com
。
獲取用戶級別接入點信息
GET /?accessPoint&max-keys=10&continuation-token=abcd HTTP/1.1
Date: GMT Date
Content-Length:ContentLength
Content-Type: application/xml
Host: oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
獲取Bucket級別接入點信息
GET /?accessPoint&max-keys=10&continuation-token=abcd HTTP/1.1
Date: GMT Date
Content-Length:ContentLength
Content-Type: application/xml
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Authorization: SignatureValue
請求頭
此接口僅涉及公共請求頭。更多信息,請參見公共請求頭(Common Request Headers)。
請求元素
名稱 | 類型 | 是否必選 | 示例值 | 描述 |
max-keys | 字符串 | 否 | 10 | 指定返回接入點的最大數量。取值如下:
說明 如果因為max-keys的設置無法一次完成列舉,返回結果會附加一個 |
continuation-token | 字符串 | 否 | abc | 指定List操作需要從此token開始。您可從返回結果中的NextContinuationToken獲取此token。 |
響應頭
此接口僅包含公共響應頭。更多信息,請參見公共響應頭(Common Response Headers)。
響應元素
名稱 | 類型 | 示例值 | 描述 |
ListAccessPointsResult | 容器 | 不涉及 | 保存本次列舉接入點信息結果的容器。 父節點:無 子節點:IsTruncated,NextContinuationToken,AccountId和AccessPoints |
IsTruncated | 布爾值 | true | 請求中返回的結果是否被截斷。返回值如下:
父節點:ListAccessPointsResult 子節點:無 |
NextContinuationToken | 字符串 | abc | 表明本次ListAccessPoints請求包含后續結果,需要將NextContinuationToken指定為continuation-token繼續獲取結果。 父節點:ListAccessPointsResult 子節點:無 |
AccountId | 字符串 | 111933544165**** | 接入點所屬的阿里云賬號UID。 父節點:ListAccessPointsResult 子節點:無 |
AccessPoints | 容器 | 不涉及 | 保存所有接入點信息的容器。 父節點:ListAccessPointsResult 子節點:AccessPoint |
AccessPoint | 容器 | 不涉及 | 保存單個接入點信息的容器。 父節點:AccessPoints 子節點:Bucket,AccessPointName,Alias,NetworkOrigin,VpcConfiguration和Status |
Bucket | 字符串 | oss-example | 配置接入點的Bucket名稱。 父節點:AccessPoint 子節點:無 |
AccessPointName | 字符串 | ap-01 | 接入點名稱。 父節點:AccessPoint 子節點:無 |
Alias | 字符串 | ap-01-ossalias | 接入點別名。 父節點:AccessPoint 子節點:無 |
NetworkOrigin | 字符串 | vpc | 接入點網絡來源。返回值如下:
父節點:AccessPoint 子節點:無 |
VpcConfiguration | 容器 | 不涉及 | 保存VPC網絡來源信息的容器。 父節點:AccessPoint 子節點:VpcId |
VpcId | 字符串 | vpc-t4nlw426y44rd3iq4**** | 專有網絡實例ID。 父節點:VpcConfiguration 子節點:無 |
Status | enable | 接入點所處狀態。返回值如下:
父節點:AccessPoint 子節點:VpcId |
示例
請求示例
獲取用戶級別接入點信息的請求示例
GET /?accessPoint&max-keys=10&continuation-token=abc HTTP/1.1 Date: Mon, 19 Jun 2023 03:15:40 GMT Content-Length:36 Content-Type: application/xml Host: oss-cn-hangzhou.aliyuncs.com Authorization: OSS qn6q**************:77Dv****************
獲取Bucket級別接入點信息的請求示例
GET /?accessPoint&max-keys=10&continuation-token=abc HTTP/1.1 Date: Mon, 19 Jun 2023 03:15:40 GMT Content-Length:36 Content-Type: application/xml Host: oss-example.oss-cn-hangzhou.aliyuncs.com Authorization: OSS qn6q**************:77Dv****************
返回示例
HTTP/1.1 200 <?xml version="1.0" encoding="UTF-8"?> <ListAccessPointsResult> <IsTruncated>true</IsTruncated> <NextContinuationToken>abc</NextContinuationToken> <AccountId>111933544165****</AccountId> <AccessPoints> <AccessPoint> <Bucket>oss-example</Bucket> <AccessPointName>ap-01</AccessPointName> <Alias>ap-01-ossalias</Alias> <NetworkOrigin>vpc</NetworkOrigin> <VpcConfiguration> <VpcId>vpc-t4nlw426y44rd3iq4****</VpcId> </VpcConfiguration> <Status>enable</Status> </AccessPoint> ... </AccessPoints> </ListAccessPointsResult>