## 功能描述 `ListAccessPoints `接口用于列出您账号下符合条件的接入点。您可以不加任何参数以列出所有接入点，也可以指定存储桶名称来筛选关联到该存储桶的接入点。 ## 请求消息样式 ```HTTP GET /accesspoint?bucket={BucketName}&maxResult={MaxResult}&nextToken={NextToken} HTTP/1.1 Host: {BucketName}.tos-cn-beijing.volces.com Date: GMT Date Authorization: authorization string x-tos-account-id: AccountId ``` ## 请求参数和消息头该请求使用的公共请求消息头，请参见[公共参数](https://www.volcengine.com/docs/6349/75044)。 |名称 |位置 |参数类型 |是否必选 |示例值 |说明 | |---|---|---|---|---|---| |bucket |Query |String |否 |bkt01 |用于筛选和指定存储桶关联的接入点。如果提供此参数，则响应结果只返回属于该存储桶的接入点列表。 | |maxResult |Query |Integer |否 |100 |设置单次请求返回的接入点最大数量。默认值为 1000，最大值为 1000。 | |nextToken |Query |String |否 |token1 |当上一次列举接入点的结果被截断时，TOS 会返回 `NextToken` 字段。您可以在下一次请求中包含此字段的值，以获取剩余的结果。 | |x\-tos\-account\-id |Header |String |是 |200\*\*\*\*\*\*\*\* |您的火山引擎账号 ID。 | ## 请求元素该请求无请求消息元素。 ## 响应消息头该请求返回的公共响应消息头，请参见[公共参数](https://www.volcengine.com/docs/6349/75044)。 ## 响应元素 |名称 |参数类型 |示例值 |说明 | |---|---|---|---| |IsTruncated |Boolean |true |指示返回的结果是否被截断：|\ | | | ||\ | | | |* `true`：表示还有部分结果未返回。|\ | | | |* `false`：表示已返回全部结果。 | |NextToken |String |token |仅当 `IsTruncated` 为 `true` 时，该字段出现，其值可用于下一次请求的 `nextToken` 参数，以获取下一页的结果。 | |AccessPoints |Array |\- |接入点列表。 | | Name |String |ap\-test |接入点名称。|\ | | | |父节点： `AccessPoints`。 | |Alias |String |ap\-test\-\*\*\*\*\*\*\*\* |接入点别名。|\ | | | |父节点：`AccessPoints`。 | |Bucket |String |bkt01 |接入点关联的存储桶名称。|\ | | | |父节点：`AccessPoints`。 | |BucketAccountId |String |200\*\*\*\*\*\*\*\* |存储桶所属的账号 ID。|\ | | | |父节点：`AccessPoints`。 | |AccessPointType |String |Regular |接入点类型。固定取值为 `Regular`。|\ | | | |父节点： `AccessPoints`。 | |Status |String |enable |接入点状态。|\ | | | |父节点：`AccessPoints`。 | |NetworkOrigin |String |internet |允许访问的网络来源。|\ | | | |父节点：`AccessPoints`。 | |AccessPointTrn |String |trn:tos:\*\*\*\*\*\*\*\* |接入点的 TRN。|\ | | | |父节点： `AccessPoints`。 | |Endpoints |Object |\- |接入点的访问域名集合。 | |ExtranetEndpoint |String |ap\-test\-200\*\*\*\*\*\*\*\*tos\-accesspoint.cn\-beijing.volces.com |公网访问域名。|\ | | | |父节点： `Endpoints`。 | |IntranetEndpoint |String |ap\-test\-200\*\*\*\*\*\*\*\*tos\-accesspoint.cn\-beijing.ivolces.com |VPC 网络访问域名。|\ | | | |父节点： `Endpoints`。 | ## 请求示例 ```HTTP GET /accesspoint?bucket=bkt01&maxResult=100&nextToken=token1 HTTP/1.1 Host: {BucketName}.tos-cn-beijing.volces.com Date: Fri, 30 Jul 2021 06:45:39 GMT Authorization: TOS4-HMAC-SHA256 Credential=AKLT**********/20210730/cn-beijing/tos/request, SignedHeaders=host;x-tos-account-id;x-tos-date, Signature=... x-tos-account-id: 200******** ``` ## 返回示例 ```JSON { "IsTruncated": true, "NextToken": "token", "AccessPoints": [ { "Name": "ap-test", "Alias": "ap-test-5007a2f0bcb595f63e2215cxxxx-tosalias", "Bucket": "bkt01", "BucketAccountId": "200********", "AccessPointType": "Regular", "Status": "enable", "NetworkOrigin": "internet", "AccessPointTrn": "trn:tos:cn-beijing:200********:accesspoint/ap-test", "Endpoints": { "IntranetEndpoint": "ap-test-5007a2f0bcb595f63e2215c****-tosalias.cn-beijing.ivolces.com", "ExtranetEndpoint": "ap-test-5007a2f0bcb595f63e2215c****-tosalias.cn-beijing.volces.com" } }, { "Name": "ap-test-2", "Alias": "ap-test-2-5007a2f0bcb595f63e2215cxxxx-tosalias", "Bucket": "bkt01", "BucketAccountId": "200********", "AccessPointType": "Regular", "Status": "enable", "NetworkOrigin": "internet", "AccessPointTrn": "trn:tos:cn-beijing:200********:accesspoint/ap-test-2", "Endpoints": { "IntranetEndpoint": "ap-test-2-5007a2f0bcb595f63e2215c****-tosalias.cn-beijing.ivolces.com", "ExtranetEndpoint": "ap-test-2-5007a2f0bcb595f63e2215c****-tosalias.cn-beijing.volces.com" } } ] } ```

对象存储