文档首页/ 魔坊（ModelArts）模型训推平台/ API参考/ 模型推理（新版）/ 内网接入管理/ 修改添加自定义URL申请 - ModifyV2IntranetConnections
更新时间：2026-07-03 GMT+08:00
在线调试
CLI示例
查看PDF
分享

修改添加自定义URL申请 - ModifyV2IntranetConnections

功能介绍

本接口用于修改添加内网自定义URL请求，适用于需要同时更新或者添加多个内网接入点的场景。调用此接口前，确保调用者具备相应的更新权限，提供需要更新的参数，如IP地址、VPC ID、子网ID等。指定的内网接入点将添加新的配置，新的配置将对相关服务生效。如果提供的内网接入点ID列表中包含无效或不存在的ID，接口将返回相应的异常信息，提示用户检查ID的有效性，如果提供的更新参数不符合格式要求（如IP地址格式不正确），接口将返回相应的异常信息，提示用户检查参数的有效性。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，需具备如下身份策略权限。

    授权项

    访问级别

    资源类型（*为必须）

    条件键

    别名

    依赖的授权项

    modelarts::updateIntranetConnection

    Write

    -

    -

    modelarts:intranetConnection:update

    -

URI

POST /v2/{project_id}/intranet-connection/{id}/modify

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

用户项目ID。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

id

是

String

参数解释：

内网接入id。id可以根据查询当前租户的内网接入申请列表返回body的id字段得到。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

x-auth-token

是

String

参数解释：

用户Token。通过调用IAM服务获取用户Token接口获取响应消息头中X-Subject-Token的值。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表3 请求Body参数

参数

是否必选

参数类型

描述

custom_urls

是

Array of strings

参数解释：

自定义URL，格式为：{协议}://{域名}{路径}

约束限制：

url个数不超过10个，单个url长度不超过1024。

取值范围：

  • 协议范围：http，https，wss，ws。

  • 域名范围：支持域名或IP:端口。域名长度不超过63，包含字母、数字、中划线（-)且不能以中划线（-)开头或结尾，顶级域名不能包含数字；端口范围为1-65535。

  • 路径范围：斜杠（/）开头，仅包含字母、数字、点号（.）、中划线（-)、下划线（_）、斜杠（/）的路径。

默认取值：

不涉及。

响应参数

状态码：200

表4 响应Body参数

参数

参数类型

描述

applicant_user_name

String

参数解释：

申请方用户名。

取值范围：

不涉及。

id

String

参数解释：

内网接入id。

取值范围：

不涉及。

message

String

参数解释：

申请描述。

取值范围：

不涉及。

owner_domain_name

String

参数解释：

审核方domain name。

取值范围：

不涉及。

scene

String

参数解释：

内网访问场景。

约束限制：

不涉及。

取值范围：

  • POOL：用户资源池接入场景

  • VPC：用户VPC接入场景

默认取值：

不涉及。

service_id

String

参数解释：

服务ID。

取值范围：

不涉及。

service_name

String

参数解释：

服务名。

取值范围：

不涉及。

status

String

参数解释：

内网接入状态，支持列表查询。

约束限制：

不涉及。

取值范围：

  • APPROVING：审批中

  • REJECTED：拒绝

  • CONNECTING：接入中

  • CONNECTED：已接入

  • CANCELED：已取消

  • FAILED：失败

  • DELETING：删除中

默认取值：

不涉及。

subnet_id

String

参数解释：

子网ID。

取值范围：

不涉及。

url_list

Array of strings

参数解释：

访问地址列表。

custom_url_list

Array of strings

参数解释：

访问地址列表。

vpc_id

String

参数解释：

VPC ID。

取值范围：

不涉及。

dispatcher_group_id

String

参数解释：

服务绑定的dispatcher组ID。

取值范围：

不涉及。

type

String

参数解释：

接入粒度：SERVICE、GLOBAL

取值范围：

不涉及。

service_type

String

参数解释：

服务类型。

取值范围：

不涉及。

pool_id

String

参数解释：

资源池ID。

取值范围：

不涉及。

create_at

String

参数解释：

创建时间。

取值范围：

不涉及。

update_at

String

参数解释：

修改时间。

取值范围：

不涉及。

请求示例

待添加自定义URL的内网接入ID、用户名、IP地址。

http://127.0.0.1:8443/v2/{project_id}/intranet-connection/{id}/modify

{
  "custom_urls" : [ "http://100.**.**.**/v2/infer/ef4080a5-61c1-446c-a909-1088c18bc9df" ]
}

响应示例

状态码：200

内网接入信息。

{
  "applicant_user_name" : "user_name***example",
  "id" : "8cc00668-4b94-49bb-a79d-2581e9028b32",
  "message" : "Failed to delete lan client: 184b8383-512d-4fbf-88a7-f9c2aec1d0fd, {\"error_code\":\"EndPoint.0005\",\"error_msg\":\"The requested resource does not exist.\",\"request_id\":\"169eb55e-945b-48d4-8f33-dfbd41e434b2\"}",
  "owner_domain_name" : "domain_name***example",
  "scene" : "VPC",
  "service_id" : "ef4080a5-61c1-446c-a909-1088c18bc9df",
  "service_name" : "service_name***example",
  "status" : "CONNECTED",
  "subnet_id" : "f4f58570-0f91-43c6-9981-8f19397caab4",
  "url_list" : [ "http://100.**.**.**/v2/infer/ef4080a5-61c1-446c-a909-1088c18bc9df" ],
  "custom_url_list" : [ "http://100.**.**.**/v2/infer/ef4080a5-61c1-446c-a909-1088c18bc9df" ],
  "vpc_id" : "ea697f73-ffc8-40bc-a11f-e8a6bfc8ae36",
  "dispatcher_group_id" : "ca29ce14-b475-4bee-93b4-24951e280c77",
  "type" : "SERVICE"
}

状态码

状态码

描述

200

内网接入信息。

错误码

请参见错误码。

父主题： 内网接入管理