为当前账号创建源端专线网络。

调试

API Explorer

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

去调试

请求参数

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

Action string 必选示例值：CreateSourceNetwork

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

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

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

SourceNetworkName string 必选示例值：source-private-network

源端专线网络名称。长度为 3～32 个字符，仅支持小写字母、数字和中划线（-），必须以字母或数字开头和结尾，不支持下划线；同一账号内名称唯一。与控制台“创建专线网络”的名称字段对应。

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

用户侧专线网络和源服务配置。VpcConfig、IdcIP、IdcPort 均必填；仅接收用户配置，不接收内部代理实例和网卡信息。

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”。必须是可经所选 VPC 和专线访问的 IP，不能填写域名或 URL。建议使用 IPv4；如使用 IPv6，请先确认专线及源服务链路支持，不能仅凭 IP 格式校验通过判断连通性。示例地址为占位值，请替换为实际源服务地址。

IdcPort integer 必选示例值：443

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

返回参数

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

Id string 示例值：123456

创建的源端专线网络资源 ID，成功仅表示创建请求已受理。

AccountId string 示例值：1000000000

源端专线网络资源所属账号 ID，由鉴权身份确定。

请求示例

返回示例

错误码

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

状态码	错误码	错误信息	说明
400	2002-00000012	invalid source network body	请求体或专线配置无效。可能原因包括源端专线网络名称不符合规则、DedicatedLineConfig 缺失、VPC/子网/安全组为空、源端 IP 地址非法或端口非正数。实际 Message 会指出具体字段，根据错误信息修正后重试。
400	2002-00000005	exceed the MaxSourceNetworksPerAccount	当前账号下源端专线网络资源数量已超过配额。请删除不再使用的源端专线网络资源，或提交工单申请提升配额。
400	2002-00000011	can not get valid account id	无法从鉴权上下文取得有效的账号 ID。请检查调用身份是否正确。
409	2002-00000002	duplicated source network name or alias error	当前账号下已存在同名源端专线网络资源。请更换名称后重试，或复用已有源端专线网络资源。
500	2001-00000001	service internal error	服务内部错误或依赖服务调用失败。请根据 RequestId 排查；实际 Message 以服务返回为准。

存储迁移服务