更新网关 - UpdateCoreIngress

agentarts::updateCoreIngress

Write

instance *

-

-

agentnetwork:instance:update

-

agentarts:AllowIngressPublicAccess

ingress_id

是

String

参数解释：

Ingress ID，用于唯一标识一个Ingress实例。获取方式：通过创建网关接口返回的id字段获取，或通过查询网关列表接口获取。

约束限制:

不涉及。

取值范围：

匹配标准的UUID格式，符合正则条件[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}。

默认取值:

不涉及。

description

否

String

参数解释：

Ingress描述信息，用于补充说明Ingress的用途或备注。

约束限制：

不涉及。

取值范围：

长度为 0 - 255 个字符。

默认取值：

不涉及。

enable_public_network

否

Boolean

参数解释：

是否启用公网访问，启用后将自动分配公网访问地址，禁用后将释放公网访问地址。

约束限制：

不涉及。

取值范围：

true：启用公网访问，false：禁用公网访问。

默认取值：

不涉及。

vpc

否

CoreIngressVpcConfig object

参数解释：

Ingress VPC网络配置，包含VPC ID和子网ID，用于指定Ingress关联的VPC网络。

约束限制：

不涉及。

vpc_id

否

String

参数解释：

VPC ID，用于指定Ingress关联的VPC网络。获取方式：在VPC控制台获取，具体参见查询VPC。

约束限制：

vpc_id和subnet_id需要同时填写或不填写。

取值范围：

长度为 1 - 64 个字符，匹配标准的UUID格式。

默认取值：

不涉及。

subnet_id

否

String

参数解释：

子网ID，用于指定Ingress关联的子网。获取方式：在VPC控制台获取，进入子网列表页面，在子网列表中，单击目标子网名称超链接，进入子网详情页面，在子网的“基本信息”页签中，查看子网的“网络ID”。

约束限制：

vpc_id和subnet_id需要同时填写或不填写。子网需属于指定的VPC。

取值范围：

长度为 1 - 64 个字符，匹配标准的UUID格式。

默认取值：

不涉及。

id

String

参数解释:

Ingress ID，用于唯一标识一个Ingress实例。

取值范围：

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔）。

name

String

参数解释:

Ingress名称，同一账号下名称不可重复。

取值范围：

以字母开头，长度为 2 - 48 个字符，可包含小写字母、数字和中划线。

description

String

参数解释:

Ingress描述。

取值范围：

长度为 0 - 255 个字符。

status

String

参数解释:

Ingress状态。

取值范围：

PENDING：操作进行中；ACTIVE：已就绪；FAILED：操作失败；DELETE_FAILED：删除失败；UPDATE_FAILED：更新失败。

enable_public_network

Boolean

参数解释:

是否启用公网访问。

取值范围：

true：启用公网访问；false：不启用公网访问。

public_domain_name

String

参数解释:

公网域名，创建完成后自动赋值，仅当enable_public_network为true时有值。

取值范围：

长度为 1 - 512 个字符。

vpc

IngressVpcConfig object

参数解释:

网络配置的VPC入网配置详情，包含VPC和子网信息。

取值范围:

不涉及。

created_at

String

参数解释:

资源创建时间，UTC时间格式，格式为YYYY-MM-DDTHH:mm:ssZ，由系统自动生成。

取值范围：

UTC时间格式，格式为YYYY-MM-DDTHH:mm:ssZ。

updated_at

String

参数解释:

资源最后更新时间，UTC时间格式，格式为YYYY-MM-DDTHH:mm:ssZ，由系统自动生成。

取值范围：

UTC时间格式，格式为YYYY-MM-DDTHH:mm:ssZ。

status

String

参数解释:

入站网络状态。

取值范围：

CREATING：创建中；ACTIVE：已就绪；FAILED：创建失败。

subnet_id

String

参数解释:

子网ID，用于指定Ingress关联的子网。获取方式：在VPC控制台获取，进入子网列表页面，在子网列表中，单击目标子网名称超链接，进入子网详情页面，在子网的“基本信息”页签中，查看子网的“网络ID”。

取值范围：

匹配标准的UUID格式（8-4-4-4-12的十六进制数字串，由连字符分隔）。

ip_address

String

参数解释:

分配的IP地址，由系统自动分配，用于通过VPC内部网络访问Agent运行时。

取值范围：

IPv4格式，长度为 1 - 48 个字符。

default_private_zone_domain_name

String

参数解释:

默认私网域名，通过该域名可在VPC内部访问Agent运行时，仅当status为ACTIVE时有值。

取值范围：

长度为 1 - 128 个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000400表示客户端请求参数错误。

取值范围：

固定值：AgentArts.03000400。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为1-512个字符。

error_code

String

参数解释:

错误码。枚举值说明：AgentArts.03000401表示未授权（认证令牌缺失、无效或已过期）。

取值范围:

不涉及。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为 1 - 512 个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000403表示禁止访问（认证后权限不足）。

取值范围：

固定值：AgentArts.03000403。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为 1 - 512 个字符。

coded_authorization_message

String

参数解释：

IAM5 当OpenAPI无权限时报错信息。

取值范围：

长度为 1 - 1024 个字符。

details

Array of CoreRunErrorDetail objects

参数解释：

依赖的下游服务错误信息列表。

取值范围：

最小数量 0，最大数量 10。

error_code

String

参数解释：

错误码。

取值范围：

长度为 18 个字符。

error_msg

String

参数解释：

错误信息。

取值范围：

长度为 1 - 1024 个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000404表示资源不存在。

取值范围：

固定值：AgentArts.03000404。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为 1 - 512 个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000409表示资源冲突。

取值范围：

固定值：AgentArts.03000409。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为 1 - 512 个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000429表示请求过于频繁（触发限流）。

取值范围：

固定值：AgentArts.03000429。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为 1 - 512 个字符。

error_code

String

参数解释：

错误码。枚举值说明：AgentArts.03000500表示服务器内部错误。

取值范围：

固定值：AgentArts.03000500。

error_msg

String

参数解释：

错误详细信息。

取值范围：

长度为 1 - 512 个字符。

202

更新成功，返回Ingress信息。

400

请求参数错误。

401

未授权（认证令牌缺失、无效或已过期）。

403

禁止访问（认证后权限不足、配额不足）。

404

资源不存在（指定的ingress_id未找到）。

409

资源冲突。

429

请求过于频繁（触发限流）。

500

服务器内部错误。