调用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>
命令行工具ossutil
ListAccessPoints接口所对应的ossutil命令，请参见list-access-points。