阿里云账号默认拥有获取接入点信息的权限。如果您希望通过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。
名称
类型
是否必选
示例值
描述
max-keys
字符串
否
10
指定返回接入点的最大数量。取值如下:
获取用户级别接入点时,取值要求大于0小于等于1000
获取Bucket级别接入点时,取值要求大于0小于等于100
如果因为max-keys的设置无法一次完成列举,返回结果会附加一个
continuation-token
abc
指定List操作需要从此token开始。您可从返回结果中的NextContinuationToken获取此token。
ListAccessPointsResult
容器
不涉及
保存本次列举接入点信息结果的容器。
父节点:无
子节点:IsTruncated,NextContinuationToken,AccountId和AccessPoints
IsTruncated
布尔值
true
请求中返回的结果是否被截断。返回值如下:
true:表示本次未返回全部结果。
false:表示本次已返回全部结果。
父节点:ListAccessPointsResult
子节点:无
NextContinuationToken
表明本次ListAccessPoints请求包含后续结果,需要将NextContinuationToken指定为continuation-token继续获取结果。
AccountId
111933544165****
接入点所属的阿里云账号UID。
AccessPoints
保存所有接入点信息的容器。
子节点:AccessPoint
AccessPoint
保存单个接入点信息的容器。
父节点:AccessPoints
子节点:Bucket,AccessPointName,Alias,NetworkOrigin,VpcConfiguration和Status
Bucket
oss-example
配置接入点的Bucket名称。
父节点:AccessPoint
AccessPointName
ap-01
接入点名称。
Alias
ap-01-ossalias
接入点别名。
NetworkOrigin
vpc
vpc:仅支持通过指定的VPCID访问接入点。
internet:同时支持通过外网和内网Endpoint访问接入点。
VpcConfiguration
子节点:VpcId
VpcId
vpc-t4nlw426y44rd3iq4****
专有网络实例ID。
父节点:VpcConfiguration
Status
enable
接入点所处状态。返回值如下:
enable:接入点已创建完成。
disable:接入点已禁用。
creating:接入点正在创建中。
deleting:接入点已删除。
请求示例
GET/accessPoint&max-keys=10&continuation-token=abcHTTP/1.1Date:Mon,19Jun202303:15:40GMTContent-Length:36Content-Type:application/xmlHost:oss-cn-hangzhou.aliyuncs.comAuthorization:OSSqn6q**************:77Dv****************获取Bucket级别接入点信息的请求示例GET/accessPoint&max-keys=10&continuation-token=abcHTTP/1.1Date:Mon,19Jun202303:15:40GMTContent-Length:36Content-Type:application/xmlHost:oss-example.oss-cn-hangzhou.aliyuncs.comAuthorization:OSSqn6q**************:77Dv****************