创建网关 - CreateCoreIngress

agentarts::createCoreIngress

Write

instance *

-

-

agentnetwork:instance:create

-

agentarts:AllowIngressPublicAccess

name

是

String

参数解释：

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

约束限制：

同一账号下名称不可重复，创建后不可修改。

取值范围：

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

默认取值：

不涉及。

description

否

String

参数解释：

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

约束限制：

不涉及。

取值范围：

长度为 0 - 255 个字符。

默认取值：

不涉及。

enable_public_network

否

Boolean

参数解释：

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

约束限制：

不涉及。

取值范围：

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

默认取值：

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 个字符。

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。

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 个字符。

error_code

String

参数解释：

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

取值范围：

固定值：AgentArts.03000500。

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

资源冲突（Ingress名称已存在）。

429

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

500

服务器内部错误。

502

下游服务Gateway不可用。

504

下游服务Gateway响应超时。