DescribeAccessPoints - 查询指定地域中的物理专线接入点 - 专有网络 VPC

调用DescribeAccessPoints接口查询指定地域中的物理专线接入点。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
RegionId	string	是	接入点所在的地域 ID。您可以通过调用 DescribeRegions 接口获取地域 ID。	cn-hangzhou
PageNumber	integer	否	列表的页码，默认值为 1。	1
PageSize	integer	否	分页查询时每页的行数，最大值为 50，默认值为 10。	10
AcceptLanguage	string	否	返回值语言，取值： zh-CN：中文。 en-US（默认值）：英文。	zh-CN

返回参数

名称	类型	描述	示例值
	object	请求 ID。
RequestId	string	请求 ID。	3E85D803-C7CF-4BCD-9CFE-6DBA1DFFA027
PageNumber	integer	列表的页码，默认值为 1。	1
PageSize	integer	分页查询时每页的行数，最大值为 50，默认值为 10。	10
TotalCount	integer	列表条条目数。	5
AccessPointSet	array<object>	查询到的接入点信息。
AccessPointType	object	查询到的接入点信息。
Status	string	物理专线的接入点状态。 recommended ：表示接入点状态良好，推荐接入。 hot ：表示接入的物理专线较多，状态正常。 full ：表示接入物理专线已满，不允许新增接入。 disabled ：表示接入点不可用。	recommended
Type	string	物理专线的网络类型。默认值：VPC。	VPC
HostOperator	string	接入点所属的运营商。	中国电信
Description	string	接入点描述信息。	接入点描述信息
AttachedRegionNo	string	接入点所在的地域 ID。	cn-hangzhou
Name	string	接入点名称。	杭州-余杭-C
AccessPointId	string	接入点 ID。	ap-cn-hangzhou-****
Location	string	接入点的位置。	杭州
AccessPointFeatureModels	array<object>	查询到的接入点特征模型。
AccessPointFeatureModel	object	查询到的接入点特征模型。
FeatureValue	string	接入点特性值。	true
FeatureKey	string	接入点特性。	AP_Support_VbrBandwidthLimit

示例

正常返回示例

JSON格式

{
  "RequestId": "3E85D803-C7CF-4BCD-9CFE-6DBA1DFFA027",
  "PageNumber": 1,
  "PageSize": 10,
  "TotalCount": 5,
  "AccessPointSet": {
    "AccessPointType": [
      {
        "Status": "recommended",
        "Type": "VPC",
        "HostOperator": "中国电信",
        "Description": "接入点描述信息",
        "AttachedRegionNo": "cn-hangzhou",
        "Name": "杭州-余杭-C",
        "AccessPointId": "ap-cn-hangzhou-****",
        "Location": "杭州",
        "AccessPointFeatureModels": {
          "AccessPointFeatureModel": [
            {
              "FeatureValue": "true",
              "FeatureKey": "AP_Support_VbrBandwidthLimit"
            }
          ]
        }
      }
    ]
  }
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidAccessPointType.NotSupport	Invalid access point type.	-
404	InvalidRegionId.NotFound	The RegionId provided does not exist in our records.	指定的RegionId不存在。请检查该参数是否正确。
404	InvalidRegionId.NotSupport	The RegionId provided does not support in our records.	输入的地域ID不正确。

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作
2023-09-20	OpenAPI 描述信息更新、OpenAPI 错误码发生变更	查看变更详情
2023-05-18	OpenAPI 错误码发生变更、OpenAPI 入参发生变更	查看变更详情