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

更新时间:
复制 MD 格式

调用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

object

AccessPointType

array<object>

查询到的接入点信息。

array<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

object

AccessPointFeatureModel

array<object>

查询到的接入点特征模型。

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.

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

变更历史

更多信息,参考变更详情