根据源端专线网络 ID 查询当前账号的源端专线网络详情。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请参见公共参数。

Action string 必选示例值：GetSourceNetwork

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

Version string 必选示例值：2025-01-01

API 的版本，取值：2025-01-01。

Id string 必选示例值：123456

要查询的源端专线网络资源 ID。仅支持查询当前账号下的资源。

返回参数

下方仅列出本接口特有的返回参数。更多信息请参见返回结构。

Id string 示例值：123456

源端专线网络资源 ID，字符串形式的整数。

AccountId string 示例值：1000000000

资源所属账号 ID。

SourceNetworkName string 示例值：source-private-network

源端专线网络名称。

CreateAt string 示例值：1791939600000

创建时间，Unix 时间戳，单位为毫秒，字符串形式。

UpdateAt string 示例值：1791939660000

最近更新时间，Unix 时间戳，单位为毫秒，字符串形式。

ResourceStatus string 示例值：Ready

专线网络资源状态：

Creating：创建中。

Ready：可用。

Failed：创建或删除资源失败。

Deleting：删除中。

仅 Ready 状态的源端专线网络资源可用于创建源端地址。Creating、Deleting 为处理中状态，需等待状态流转完成后再操作。删除完成后资源不再存在，调用 GetSourceNetwork 查询将返回 404。Failed 不区分创建失败与删除失败，当前接口不返回具体失败原因。

DedicatedLineConfig object 示例值：{"VpcConfig":{"VpcId":"vpc-example","SubNetId":"subnet-example","SecurityGroupIds":["sg-example"]},"IdcIP":"192.0.2.10","IdcPort":443}

创建时用户传入的 VPC 配置和源服务 IP/端口，不含服务内部代理资源。

VpcConfig object 示例值：{"VpcId":"vpc-example","SubNetId":"subnet-example","SecurityGroupIds":["sg-example"]}

用户侧 VPC、子网和安全组配置。

VpcId string 示例值：vpc-example

用户侧 VPC ID。请确保专线路由已覆盖源端服务所在网段。

SubNetId string 示例值：subnet-example

用户侧子网 ID，应属于指定 VPC。

SecurityGroupIds string[] 示例值：["sg-example"]

用户侧安全组 ID 列表，不能为空，应放通访问源端服务所需的端口。

IdcIP string 示例值：192.0.2.10

源端服务 IP 地址，对应控制台“源端 IP”。该 IP 必须可经所选 VPC 和专线网络访问，不支持填写域名或 URL。建议使用 IPv4 地址；如使用 IPv6 地址，请先确认专线网络及源端服务链路支持，不能仅凭 IP 格式校验通过判断连通性。示例地址为占位值，请替换为实际源服务地址。

IdcPort integer 示例值：443

源端服务实际监听的 TCP 端口，对应控制台“源端端口”。取值范围为 1～65535 的整数，无默认值；例如 HTTPS 服务填写 443，HTTP 服务填写 80。安全组、专线网络路由和源端服务需放通该端口，具体取值以源端服务配置为准。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	2002-00000013	invalid entity id	ID 缺失或不是可解析的整数。请传入 CreateSourceNetwork 接口返回的源端专线网络 ID。
404	2002-00000014	source network is not found	源端专线网络资源不存在，或不属于当前调用账号；资源删除完成后，查询该资源也会返回此错误。
500	2001-00000001	service internal error	查询数据库或内部依赖失败，实际 Message 以响应为准，请记录 RequestId 并提交工单排查。

存储迁移服务