文档首页/ 云专线 DC/ API参考 (联盟区域) / API/ 专线接入点管理/ 查询指定专线接入点详情
更新时间：2026-01-08 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询指定专线接入点详情

功能介绍

查询指定的专线接入点详情

调用方法

请参见如何调用API。

URI

GET /v3/{project_id}/dcaas/direct-connect-locations/{direct_connect_location_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户项目ID

最小长度：0

最大长度：36

direct_connect_location_id

是

String

direct-connect-locationID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。 获取Token，请参考《统一身份认证服务API参考》的“获取用户Token”章节。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

最小长度：0

最大长度：10240

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

direct_connect_location

DirectConnectLocationEntry object

direct-connect-location专线接入点详情

request_id

String

请求ID。

最小长度：0

最大长度：36
表4 DirectConnectLocationEntry

参数

参数类型

描述

id

String

专线接入站点资源的ID

最小长度：0

最大长度：36

name

String

专线接入点的名称

最小长度：0

最大长度：64

region_id

String

Location所属Region

最小长度：0

最大长度：36

site_code

String

专线接入点对应的站点编码

最小长度：0

最大长度：64

address

AddressBody object

专线接入点的位置信息。

locales

LocalesBody object

Locale地址描述信息。

provider_list

Array of ProviderResponseBody objects

可支持的运营商列表。

public_border_group

String

专线接入点所属public_border_group

最小长度：0

最大长度：64

latitude

String

地理位置纬度

最小长度：0

最大长度：36

longitude

String

地理位置经度

最小长度：0

最大长度：36

description

String

描述信息。

最小长度：0

最大长度：255

created_time

String

创建时间。

updated_time

String

更新时间。

available_port_speeds

Array of strings

接入点内设备可选的端口类型

最小长度：1

最大长度：255

数组长度：0 - 6
表5 AddressBody

参数

参数类型

描述

en_us

String

英文名称。

最小长度：0

最大长度：255

zh_cn

String

中文信息。

最小长度：0

最大长度：255
表6 LocalesBody

参数

参数类型

描述

en_us

String

区域英文名称。

最小长度：0

最大长度：255

zh_cn

String

区域中文名称。

最小长度：0

最大长度：255
表7 ProviderResponseBody

参数

参数类型

描述

id

String

运营商id

最小长度：0

最大长度：36

short_name

String

运营商简写

最小长度：0

最大长度：36

type

String

运营商类型

最小长度：0

最大长度：36

provider_value

ProviderValueBody object

运营商名称

description

String

运营商说明

最小长度：0

最大长度：36
表8 ProviderValueBody

参数

参数类型

描述

en_us

String

英文名称。

最小长度：0

最大长度：255

zh_cn

String

中文信息。

最小长度：0

最大长度：255

请求示例

查询指定专线接入点详情

GET https://{dc_endpoint}/v3/92ea72fe26294aa180a2712c28e43c21/dcaas/direct-connect-locations/00825bc2-59e9-4e00-a7f9-e8164971bd93

响应示例

状态码：200

OK

专线位置查询详情结果

{
  "direct_connect_location" : {
    "name" : "example",
    "id" : "00825bc2-59e9-4e00-a7f9-e8164971bd93",
    "region_id" : "xxxxxxx",
    "site_code" : "xxxxxx",
    "address" : {
      "en_us" : "xxx",
      "zh_cn" : "xxx"
    },
    "public_border_group" : null,
    "locales" : {
      "en_us" : "xxx",
      "zh_cn" : "xxx"
    },
    "provider_list" : [ {
      "id" : "773dd278-1cae-4a8c-ad53-f2d8e8a9b9f9",
      "short_name" : "others",
      "type" : "LEVEL_TWO",
      "provider_value" : {
        "en_us" : "Other",
        "zh_cn" : "Other"
      }
    }, {
      "id" : "b6fd0ad8-dac4-4e21-a987-bce2f28ee861",
      "short_name" : "telcom",
      "type" : "LEVEL_ONE",
      "provider_value" : {
        "en_us" : "example1",
        "zh_cn" : "example1"
      }
    }, {
      "id" : "ea30d085-aa48-49b0-a519-8f3085e8137a",
      "short_name" : "mobile",
      "type" : "LEVEL_ONE",
      "provider_value" : {
        "en_us" : "example2",
        "zh_cn" : "example2"
      }
    }, {
      "id" : "a237b909-e60d-4292-8afe-9600ddfef755",
      "short_name" : "unicom",
      "type" : "LEVEL_ONE",
      "provider_value" : {
        "en_us" : "example3",
        "zh_cn" : "example3"
      }
    } ],
    "latitude" : "26.6476",
    "longitude" : "106.6302",
    "description" : "test",
    "created_time" : "2023-11-23T01:24:52.000Z",
    "updated_time" : "2024-08-24T01:26:18.911Z",
    "available_port_speeds" : [ "100G", "1G", "10G", "40G" ],
    "location_type" : "pop",
    "city" : "example",
    "support_region_type" : "None"
  },
  "request_id" : "81cb340e3c33c47c678c7b06a3502552"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。

父主题： 专线接入点管理