文档首页/ 智果（AgentArts）智能体平台/ API参考/ API/ 记忆库/ 网络访问/ 更新Space网络配置 - UpdateCoreSpaceNetwork
更新时间：2026-06-10 GMT+08:00
查看PDF
分享

更新Space网络配置 - UpdateCoreSpaceNetwork

功能介绍

更新指定Space的网络访问配置。

调用方法

请参见如何调用API。

URI

PUT /v1/core/spaces/{space_id}/network

表1 路径参数

参数

是否必选

参数类型

描述

space_id

是

String

参数解释：

记忆空间 ID，唯一标识一个记忆空间，可通过"创建Space"接口获取。

约束限制：

仅支持字母、数字和中划线。

取值范围：

长度1-48字符。

默认取值：

不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

public_access_enable

否

Boolean

参数解释：

是否开启公网访问。

约束限制：

不涉及。

取值范围：

  • true: 开启公网访问

  • false: 关闭公网访问

默认取值：

false

private_access_config

否

CoreSpacePrivateNetworkRequestBody object

参数解释：

内网访问配置，传入此对象表示开启内网访问。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表3 CoreSpacePrivateNetworkRequestBody

参数

是否必选

参数类型

描述

enable

是

Boolean

参数解释：

是否开启内网访问。

取值范围：

  • true: 开启内网访问

  • false: 关闭内网访问

vpc_id

是

String

参数解释：

租户 VPC ID，获取方式：查询VPC列表。

取值范围：

不涉及。

subnet_id

是

String

参数解释：

租户子网 ID，获取方式：查询子网列表。

取值范围：

不涉及。

响应参数

状态码：202

表4 响应Body参数

参数

参数类型

描述

public_access_enable

Boolean

参数解释：

是否开启公网访问。

约束限制：

不涉及。

取值范围：

  • true: 开启公网访问

  • false: 关闭公网访问

默认取值：

false

private_access_config

CoreSpacePrivateNetworkRequestBody object

参数解释：

内网访问配置，传入此对象表示开启内网访问。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。
表5 CoreSpacePrivateNetworkRequestBody

参数

参数类型

描述

enable

Boolean

参数解释：

是否开启内网访问。

取值范围：

  • true: 开启内网访问

  • false: 关闭内网访问

vpc_id

String

参数解释：

租户 VPC ID，获取方式：查询VPC列表。

取值范围：

不涉及。

subnet_id

String

参数解释：

租户子网 ID，获取方式：查询子网列表。

取值范围：

不涉及。

状态码：400

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息，描述错误详情，供问题排查使用。

取值范围：

不涉及。

状态码：401

表7 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息，描述错误详情，供问题排查使用。

取值范围：

不涉及。

状态码：403

表8 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息，描述错误详情，供问题排查使用。

取值范围：

不涉及。

encoded_authorization_message

String

参数解释：

编码后的授权失败信息。

取值范围：

不涉及。

details

Array of CoreSpaceCommonError objects

参数解释：

依赖的下游服务错误信息列表，包含导致当前请求失败的下游服务错误详情。

取值范围：

不涉及。
表9 CoreSpaceCommonError

参数

参数类型

描述

error_code

String

参数解释：

错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息，描述错误详情，供问题排查使用。

取值范围：

不涉及。

状态码：404

表10 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息，描述错误详情，供问题排查使用。

取值范围：

不涉及。

状态码：429

表11 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息，描述错误详情，供问题排查使用。

取值范围：

不涉及。

状态码：500

表12 响应Body参数

参数

参数类型

描述

error_code

String

参数解释：

错误码，标识错误类型，格式为 AgentArts.XXXXXXXX。

取值范围：

不涉及。

error_msg

String

参数解释：

错误信息，描述错误详情，供问题排查使用。

取值范围：

不涉及。

请求示例

/v1/core/spaces/123e4567-e89b-12d3-a456-426614174000/network

{
  "public_access_enable" : true,
  "private_access_config" : {
    "enable" : true,
    "vpc_id" : "32176dd1-a44a-4c40-99de-5f4359b46d93",
    "subnet_id" : "5d1c6d00-cfbe-42b9-8c9d-1e2c2cea7e19"
  }
}

响应示例

状态码：400

请求参数错误

{
  "error_code" : "AgentArts.01010001",
  "error_msg" : "Invalid request parameter format"
}

状态码：401

认证失败

{
  "error_code" : "AgentArts.01020002",
  "error_msg" : "Authentication failed"
}

状态码：403

权限不足

{
  "error_code" : "AgentArts.01010002",
  "error_msg" : "Insufficient permissions"
}

状态码：404

Space不存在

{
  "error_code" : "AgentArts.01010005",
  "error_msg" : "Specified space does not exist"
}

状态码：429

请求过于频繁

{
  "error_code" : "AgentArts.01020008",
  "error_msg" : "Too many requests"
}

状态码：500

内部服务错误

{
  "error_code" : "AgentArts.01010008",
  "error_msg" : "Internal service error"
}

状态码

状态码

描述

202

网络配置更新请求已接受

400

请求参数错误

401

认证失败

403

权限不足

404

Space不存在

429

请求过于频繁

500

内部服务错误

错误码

请参见错误码。

父主题： 网络访问

相关文档