文档中心

对象存储

加速器

GetAccessPoint

GetAccessPoint

功能描述

GetAccessPoint 接口用于获取指定接入点的详细配置信息，包括其名称、别名、关联的存储桶、网络来源以及访问域名等。

请求消息样式

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
AccessPointName	Path	String	是	ap-test	您要查询的接入点的名称。
x-tos-account-id	Header	String	是	200********	您的火山引擎账号 ID。

请求元素

该请求无请求消息元素。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

名称	参数类型	示例值	说明
Name	String	ap-test	接入点名称。
Alias	String	ap-test-5007a2f0bcb595f63e2215cxxxx-tosalias	接入点别名。
Bucket	String	bkt01	接入点关联的存储桶名称。
BucketAccountId	String	200********	存储桶所属的账号 ID。
AccessPointType	String	Regular	接入点类型。目前固定返回 Regular，表示常规接入点。
Status	String	enable	接入点状态。取值如下： enable：已启用。 disable：已禁用。 creating：创建中。 deleting：删除中。
NetworkOrigin	String	internet	允许访问此接入点的网络来源。取值如下： internet：允许来自互联网和 VPC 网络的访问。 vpc：只允许来自指定 VPC 网络的访问。
AccessPointTrn	String	trn:tos:cn-beijing:200********accesspoint/ap-test	接入点的唯一资源标识符。
CreationDate	String	2021-05-06T02:27:04.000Z	接入点的创建时间，格式为 ISO 8601。
VpcId	String	vpc-123	当 NetworkOrigin 为 vpc 时，返回该字段，表示允许访问的 VPC 网络 ID。
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。

请求示例

返回示例

最近更新时间：2026.04.01 11:06:30

这个页面对您有帮助吗？

有用

有用

无用

无用