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

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeAccessPoints

要执行的操作，取值：DescribeAccessPoints。

RegionId String 是 cn-hangzhou

接入点所在的地域。

您可以通过调用DescribeRegions接口获取地域ID。

PageNumber Integer 否 1

列表的页码，默认值为1。

PageSize Integer 否 10

分页查询时每页的行数，最大值为50，默认值为10。

返回数据

名称 类型 示例值 描述
RequestId String 3E85D803-C7CF-4BCD-9CFE-6DBA1DFFA027

请求ID。
PageNumber Integer 1

当前页码。
PageSize Integer 10

每页包含多少条目。
TotalCount Integer 5

列表条条目数。
AccessPointSet Array

接入点信息。
AccessPointId String ap-cn-hangzhou-xs-D

接入点ID。
Status String recommended

专线接入点状态。

  • Recommended：表示状态良好，推荐接入。
  • Hot：表示接入客户较多，状态正常。
  • Full： 表示接入客户已满，不允许新增专线接入。
  • Disabled ：表示不可用。
Type String VPC

专线接入的网络类型。
AttachedRegionNo String cn-beijing

接入点地域。
Location String 北京市丰台

接入点位置。
HostOperator String 中立-皓宽

接入点运营商。
Name String 北京-丰台-A

接入点名称。
Description String ap-cn-hangzhou-dq-A-EU95

接入点描述。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeAccessPoints
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML 格式 

<DescribeAccessPoints>
  <AccessPointSet>
        <AccessPointType>
              <Name>杭州-德清-A</Name>
              <Status>recommended</Status>
              <Description>ap-cn-hangzhou-dq-A-EU95</Description>
              <Type>VPC</Type>
              <Location></Location>
              <HostOperator>联通</HostOperator>
              <AttachedRegionNo>cn-hangzhou</AttachedRegionNo>
              <AccessPointId>ap-cn-hangzhou-dq-A</AccessPointId>
        </AccessPointType>
        <AccessPointType>
              <Name>杭州-萧山-D</Name>
              <Status>recommended</Status>
              <Description>ap-cn-hangzhou-xs-EM21</Description>
              <Type>VPC</Type>
              <Location></Location>
              <HostOperator>中国移动</HostOperator>
              <AttachedRegionNo>cn-hangzhou</AttachedRegionNo>
              <AccessPointId>ap-cn-hangzhou-xs-D</AccessPointId>
        </AccessPointType>
        <AccessPointType>
              <Name>杭州-萧山-B</Name>
              <Status>recommended</Status>
              <Description>cn-hangzhou-xs-cm3-b</Description>
              <Type>VPC</Type>
              <Location></Location>
              <HostOperator>中国电信</HostOperator>
              <AttachedRegionNo>cn-hangzhou</AttachedRegionNo>
              <AccessPointId>ap-cn-hangzhou-xs-B</AccessPointId>
        </AccessPointType>
        <AccessPointType>
              <Name>杭州-江干-B</Name>
              <Status>recommended</Status>
              <Description>cn-hangzhou-jg-ne205-a</Description>
              <Type>VPC</Type>
              <Location></Location>
              <HostOperator>中立-世纪互联</HostOperator>
              <AttachedRegionNo>cn-hangzhou</AttachedRegionNo>
              <AccessPointId>ap-cn-hangzhou-jg-B</AccessPointId>
        </AccessPointType>
        <AccessPointType>
              <Name>杭州-江干-A</Name>
              <Status>recommended</Status>
              <Description>cn-hangzhou-jg-eu6-a</Description>
              <Type>VPC</Type>
              <Location></Location>
              <HostOperator>中国联通</HostOperator>
              <AttachedRegionNo>cn-hangzhou</AttachedRegionNo>
              <AccessPointId>ap-cn-hangzhou-jg-A</AccessPointId>
        </AccessPointType>
        <AccessPointType>
              <Name>杭州-萧山-A</Name>
              <Status>recommended</Status>
              <Description>cn-hangzhou-xs-cm10</Description>
              <Type>VPC</Type>
              <Location></Location>
              <HostOperator>中国联通</HostOperator>
              <AttachedRegionNo>cn-hangzhou</AttachedRegionNo>
              <AccessPointId>ap-cn-hangzhou-xs-A</AccessPointId>
        </AccessPointType>
        <AccessPointType>
              <Name>杭州-临安-A</Name>
              <Status>recommended</Status>
              <Description>cn-hangzhou-la-AM5-a</Description>
              <Type>VPC</Type>
              <Location></Location>
              <HostOperator>中立-华通</HostOperator>
              <AttachedRegionNo>cn-hangzhou</AttachedRegionNo>
              <AccessPointId>ap-cn-hangzhou-la-A</AccessPointId>
        </AccessPointType>
        <AccessPointType>
              <Name>杭州-余杭-A</Name>
              <Status>recommended</Status>
              <Description>cn-hangzhou-yh-TBC-a</Description>
              <Type>VPC</Type>
              <Location></Location>
              <HostOperator>中立-自营</HostOperator>
              <AttachedRegionNo>cn-hangzhou</AttachedRegionNo>
              <AccessPointId>ap-cn-hangzhou-yh-A</AccessPointId>
        </AccessPointType>
  </AccessPointSet>
  <PageNumber>1</PageNumber>
  <TotalCount>8</TotalCount>
  <PageSize>10</PageSize>
  <RequestId>86E1053D-8BE4-4B75-A370-183E8D3FDF25</RequestId>
</DescribeAccessPoints>

JSON 格式 

{
	"AccessPointSet": {
		"AccessPointType": [
			{
				"Name": "杭州-德清-A",
				"Status": "recommended",
				"Description": "ap-cn-hangzhou-dq-A-EU95",
				"Type": "VPC",
				"Location": "",
				"HostOperator": "联通",
				"AttachedRegionNo": "cn-hangzhou",
				"AccessPointId": "ap-cn-hangzhou-dq-A"
			},
			{
				"Name": "杭州-萧山-D",
				"Status": "recommended",
				"Description": "ap-cn-hangzhou-xs-EM21",
				"Type": "VPC",
				"Location": "",
				"HostOperator": "中国移动",
				"AttachedRegionNo": "cn-hangzhou",
				"AccessPointId": "ap-cn-hangzhou-xs-D"
			},
			{
				"Name": "杭州-萧山-B",
				"Status": "recommended",
				"Description": "cn-hangzhou-xs-cm3-b",
				"Type": "VPC",
				"Location": "",
				"HostOperator": "中国电信",
				"AttachedRegionNo": "cn-hangzhou",
				"AccessPointId": "ap-cn-hangzhou-xs-B"
			},
			{
				"Name": "杭州-江干-B",
				"Status": "recommended",
				"Description": "cn-hangzhou-jg-ne205-a",
				"Type": "VPC",
				"Location": "",
				"HostOperator": "中立-世纪互联",
				"AttachedRegionNo": "cn-hangzhou",
				"AccessPointId": "ap-cn-hangzhou-jg-B"
			},
			{
				"Name": "杭州-江干-A",
				"Status": "recommended",
				"Description": "cn-hangzhou-jg-eu6-a",
				"Type": "VPC",
				"Location": "",
				"HostOperator": "中国联通",
				"AttachedRegionNo": "cn-hangzhou",
				"AccessPointId": "ap-cn-hangzhou-jg-A"
			},
			{
				"Name": "杭州-萧山-A",
				"Status": "recommended",
				"Description": "cn-hangzhou-xs-cm10",
				"Type": "VPC",
				"Location": "",
				"HostOperator": "中国联通",
				"AttachedRegionNo": "cn-hangzhou",
				"AccessPointId": "ap-cn-hangzhou-xs-A"
			},
			{
				"Name": "杭州-临安-A",
				"Status": "recommended",
				"Description": "cn-hangzhou-la-AM5-a",
				"Type": "VPC",
				"Location": "",
				"HostOperator": "中立-华通",
				"AttachedRegionNo": "cn-hangzhou",
				"AccessPointId": "ap-cn-hangzhou-la-A"
			},
			{
				"Name": "杭州-余杭-A",
				"Status": "recommended",
				"Description": "cn-hangzhou-yh-TBC-a",
				"Type": "VPC",
				"Location": "",
				"HostOperator": "中立-自营",
				"AttachedRegionNo": "cn-hangzhou",
				"AccessPointId": "ap-cn-hangzhou-yh-A"
			}
		]
	},
	"PageNumber": 1,
	"TotalCount": 8,
	"PageSize": 10,
	"RequestId": "86E1053D-8BE4-4B75-A370-183E8D3FDF25"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidRegionId.NotSupport The RegionId provided does not support in our records. 输入的地域ID不正确。

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