Aggrega 能力无关图(IR)schema
自动生成的参考文档。请勿手动编辑——请从发布的 JSON Schema 重新生成。
Schema id:https://aggrega.ai/schemas/ir-v1beta1.schema.json
由 Topology Builder 输出的、经过展平且完全解析的一维图。
顶层类型: object
属性
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | 是 | 常量:"aggrega.ai/v1beta1" |
kind | const “IR” | 是 | 常量:"IR" |
metadata | IRMetadata | 是 | 图的标识:构建该图所依据的 Aggregate。 |
spec | IRSpec | 是 | 图本身:其节点、边以及按节点键控的负载。 |
不允许其他属性。
定义
Maintainer
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
name | string | 是 | 维护者的姓名。 |
email | string | 否 | 维护者的电子邮件地址。 |
url | string | 否 | 维护者的网址。 |
FieldProvenance
附件的 values 或 infra 载荷中某个叶子的来源。
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
origin | string | 是 | 该叶子是显式编写的,还是由注解驱动的展开阶段提供的。 |
side | string | 否 | 声明该注解的编写位置;显式叶子时不存在。 |
annotation_key | string | 否 | 提供此叶子的注解名称;显式叶子时不存在。 |
annotation_source | string | 否 | 注解声明的源位置,格式为 |
overridden_annotation | FieldProvenance | 否 | 被显式叶子取代了此叶子的注解贡献:当显式叶子覆盖了由注解提供的叶子时,即它所替换的被抑制来源。单数——始终只保留一个被抑制的贡献。 |
不允许其他属性。
AttachmentConnection
附件所属的连接,适用于写在组件所引出的连接上、而非组件自身附件块中的附件:即该连接所经由的 socket 以及它所在的别名。这一对值指定图中的一条边——其源是携带该附件的节点,且其 socket 和别名即为这两个值——因此使用方将该附件关联到这条边,并经由它关联到附件所呈现给的目标。
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
socket | string | 是 | 连接所经由的 socket:即附件所属边的 socket。 |
alias | string | 是 | 连接所在的别名:即附件所属边的别名。 |
不允许其他属性。
IRFeatureEntry
节点的一个已解析附件,承载于 feature_values_mapping 中。所有附件类别都共用这一结构——运维类 Feature、凭据类 Feature、身份类 Feature——因此没有哪个类别得到比其他类别信息损失更多的投影。凭据附件的 values 承载什么由作者决定:按引用的凭据承载指向密钥存储的指针,按值的凭据承载凭据材料本身,编译器原样承载所写的任一种形式,不解析其中任何一种。
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
type | string | 是 | 此附件所请求的 Catalog Feature 的 URI。 |
resolved_version | string | 是 | 编译期间解析出的确切语义化版本。 |
labels | map of string | 否 | 所附 Feature 的目录标签,按其目录实体声明的顺序原样承载——从不过滤、规范化或去除前缀,因此使用方读到的正是目录作者所写的内容。编译器不读取其中任何一项。当该 Feature 未声明标签,或其类型未解析到任何目录实体时不存在。 |
catalog_annotations | map of string | 否 | 所附 Feature 的目录注解——即此附件所指定的 Feature 实体的 metadata.annotations——按该实体声明的顺序原样承载,从不过滤、规范化或去除前缀,因此使用方读到的正是目录作者所写的内容,包括作者自有命名空间中的键。编译器不读取其中任何一项。它不同于 annotation_key 和 annotation_source,后两者指定并定位导致此附件产生的注解:那两个字段报告附件是如何产生的,而本字段报告它所指定实体的元数据;写在 features: 块中的附件承载这些注解,但不携带那两个字段。当该 Feature 未声明注解,或其类型未解析到任何目录实体时不存在。 |
binding | string | 否 | 指定此附件所填充的附件槽位;若未填充任何已声明槽位,则为 “free”。槽位在两处之一声明,由附件的编写位置决定是哪一处:节点自身附件块中的附件填充宿主 Component 在其 featuresSchema 中声明的槽位,写在连接上的附件则填充该连接的 socket 在宿主 Component 上该 socket 的 featuresSchema 中声明的槽位。两种情况都按名称配对——当 Feature 以槽位的名称附加(在组件的块上或在连接上)时,附件即填充该槽位——因此该值是已声明槽位集合中的一个确切键,绝不是从附件的键中读出的内容。socket 的槽位集合是封闭的,因为以其 socket 未声明的名称写在连接上的附件会使构建中止,所以携带连接的附件永远不会报告 free。之所以承载槽位名称而非单纯的布尔值,是因为填充了哪个槽位是答案中更有用的那一半。当无法解析宿主 Component 的已声明槽位集合时为空,这与 “free” 不同:free 是一个肯定的结论,即没有任何已声明槽位使用此名称。 |
values | object | 否 | 附件的运维配置载荷。对于凭据,为作者所声明的任一形式——指向密钥存储的指针,或凭据材料本身。 |
infra | object | 否 | 此附件的单实例物理规格。 |
inject | object | 否 | 与目标无关的注入路由。将本地变量映射到 Target 的 provides 键。 |
origin | string(枚举) | 否 | 区分写在 features: 块中的附件(explicit)与注解驱动展开阶段生成的合成附件(annotation),或当附件的 value/infra 叶子混合了两者时为 mixed(此时逐叶子的细节位于 provenance 映射中)。允许的值:"explicit"、"annotation"、"mixed" |
annotation_key | string | 否 | 触发合成附件的注解名称。当 origin 为 explicit 时不存在。 |
annotation_source | string | 否 | 注解声明的源位置,格式为 |
values_provenance | map of FieldProvenance | 否 | values 载荷的逐叶子来源,以点分叶子路径为键。 |
infra_provenance | map of FieldProvenance | 否 | infra 载荷的逐叶子来源,以点分叶子路径为键。 |
sensitive | 布尔值 | 否 | 当此附件处理作者声明为敏感的材料时为 true——即所附 Feature 在其 values、infra 或 provides 支柱中声明了敏感叶子,或者附件所填充的槽位将其承载的材料声明为敏感:宿主 Component 中同名的附件槽位,或者对于写在连接上的附件,为该连接的 socket 所声明的同名槽位。它根据合并后附件上的这些声明推导,绝不根据值的内容或名称推导。当两种声明均不存在时不设置。 |
sensitive_inject | map of map of string | 否 | inject 中所引用的 provides 键被所附 Feature 声明为敏感的那些投递键,采用 inject 自身的结构:先是机制,然后是投递键,以所引用的 provides 键为值。它是 inject 的子集。当附件未声明投递机制或未引用任何敏感 provides 键时不存在。 |
sensitive_payload_leaves | string[] | 否 | 该附件的 values 与 infra 负载中所携带的、被所附加的 Feature 声明为敏感的叶子,每个以该数据所在的、带支柱前缀的点分路径表示:values.db 的声明覆盖 db.password,而不会触及名为 dbPassword 的同级叶子。逐附件的答案绝不会分摊到各个叶子上,否则就会对保持可读的叶子作出错误的断言。键缺失表示该附件未列出其 Feature 声明为敏感的任何叶子。它并不断言负载不敏感,也不区分没有此类叶子可列出的附件与根本不报告这一维度的生产者——将缺失的键理解为可以明文显示或输出某个值的 guest,恰好理解反了。叶子按负载保存它们的顺序排列,values 支柱的叶子在 infra 支柱的叶子之前——与 values 和 infra 负载本身携带的顺序相同,这也使负载在相同输入的多次运行之间保持逐字节一致。当附件未携带其 Feature 声明为敏感的任何叶子时缺失。 |
connection | AttachmentConnection | 否 | 该附件所属的连接:在节点某个连接上编写的每个附件中都存在,在节点自身附件块的每个附件中都缺失。在连接上编写的附件在其他各方面都是节点的附件之一——以其限定名称(连接的别名与槽位以点连接)为键,并从连接的 socket 所声明的槽位获取其绑定和敏感性——因此该字段用于区分两者,并将连接作为数据携带,而不是留待从键中读取。使用方通过 socket 和别名将其与图的边关联:以携带该附件的节点为源、socket 与别名与此相同的边,就是呈现该附件的连接,而该边的目标就是它所呈现给的对象。由 Feature 附件引出的连接上的附件从不携带此字段,因为此类连接不携带附件。 |
realization | string | 否 | 实现该附件的 FeatureRecipe,格式为 |
不允许其他属性。
IRFeatureEntry.inject
与目标无关的注入路由。将本地变量映射到 Target 的 provides 键。
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
env | map of string | 否 | 环境变量投递:键是使用方的本地变量名,值是目标的 provides 键。 |
file | map of string | 否 | 文件挂载投递:键是使用方的本地文件路径,值是目标的 provides 键。 |
arg | map of string | 否 | 命令行参数投递:键是使用方的标志前缀,值是目标的 provides 键。 |
IRBoundaryFeature
投影到 IR 中的边界级 Feature 附件:Feature 类型 URI,加上边界作用域的 FeatureRecipe 进行渲染并据以解析其源的边界 infra。边界级附件不携带 values 负载。
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
type | string | 是 | 附加在此边界上的 Catalog Feature 的 URI。 |
infra | object | 否 | 边界附件的物理规格;边界作用域的 FeatureRecipe 据以求值其模板和源的 infra。 |
sensitive_payload_leaves | string[] | 否 | 该边界附件的 infra 负载中所携带的、被所附加的 Feature 声明为敏感的叶子,每个以该数据所在的、带支柱前缀的点分路径表示。此处只出现 infra.db 的声明覆盖 db.password,而不会触及名为 dbPassword 的同级叶子。键缺失表示该附件未列出其 Feature 声明为敏感的任何叶子,这包括所附加的 Feature 解析不到此读取方能够读取的 schema 的情况。它并不断言 infra 负载不敏感,也不区分没有此类叶子可列出的附件与根本不报告这一维度的生产者。将缺失的键理解为可以明文显示或输出某个值的使用方,恰好理解反了。叶子按负载保存它们的顺序排列,与 infra 负载本身携带的顺序相同,这也使图在相同输入的多次运行之间保持逐字节一致。当附件未携带其 Feature 声明为敏感的任何叶子时缺失。 |
realization | string | 否 | 实现该边界附件的 FeatureRecipe,格式为 |
不允许其他属性。
CatalogMetadata
从 Catalog 实体中显式提取的企业元数据套件,向 Wasm linter 公开生命周期和所有权数据。
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
maintainers | Maintainer[] | 否 | 目录实体列为其所有者的维护者。 |
license | string | 否 | 目录实体为其所描述的软件声明的 SPDX 许可证标识符。 |
repository | string | 否 | 目录实体指明的、存放其源文件的 Git 仓库的 URL。 |
home | string | 否 | 目录实体的主页、wiki 或文档的 URL。 |
keywords | string[] | 否 | 目录实体声明的描述性关键词。 |
不允许其他属性。
IRNode
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
description | string | 否 | 可选的、由开发者编写的文档,描述该组件实例在应用中的角色。从 Aggregate 透传,用于渲染和 lint 诊断。 |
labels | map of string | 是 | 该实体的鸭子类型标签和本体标签。 |
component | string | 是 | 底层 Component 的名称。 |
resolved_version | string | 是 | 编译期间解析出的该 Component 的确切语义化版本。 |
sync_wave | integer | 否 | 从所在边界的 syncWave 字段继承的部署波次(默认为 0;允许负值)。在 K8s 和 Helm 上,波次决定部署顺序:它成为一个 argocd.argoproj.io/sync-wave 注解,而在 chart 已标记为 Helm hook 的资源上,它还会成为该 hook 的 helm.sh/hook-weight。在 compose 上,该值既被记录为服务标签,又通过服务之间的 depends_on 为其渲染到的文件中的服务排序。在 cloudformation 上,它为调度组装配到的栈的资源供应排序,每个波次中的资源都被声明为依赖于前一波次的资源:即资源创建的顺序,以及反过来资源删除的顺序,而绝不是就绪状态,因为栈模板无法表达资源就绪的概念。在 terraform 上,它为边界装配到的根配置中的 module 块排序,每个波次中的 module 都被声明为依赖于前一波次的 module:即引擎执行操作的顺序,而绝不是就绪状态,因为配置无法表达资源就绪的概念。该值还会随节点的构建来源信息一同传递。 |
boundary_path | string | 否 | 该节点所在的 Release 边界的路径:从最外层边界向内的各边界名称,以 / 连接(例如,对于放置在边界 data 内所声明的边界 inner 中的组件,路径为 ‘data/inner’)。边界名称不能包含 /,因此路径可以无歧义地拆分回各个边界。Release 路由到某个边界中的导入 Aggregate 的节点携带该边界的路径。使渲染插件能够生成感知边界的唯一标识符。 |
subsystem_path | string | 否 | 该节点的组件所声明于的 Aggregate 子系统的路径:从最外层子系统向内的各子系统名称,以 . 连接(例如,对于在嵌套于子系统 backend 内的子系统 storage 中声明的组件,路径为 ‘backend.storage’)。子系统名称不能包含 .,因此路径可以无歧义地拆分回各个子系统。声明顶层 components 的 Aggregate 中的组件携带合成的 default,并由 synthesized_subsystem 标记。该路径相对于声明该组件的 Aggregate:导入的 Aggregate 所贡献的节点携带其在该 Aggregate 内的路径,不含导入时使用的名称(例如,对于导入的 Aggregate 中子系统 tier 里的组件,路径为 ‘tier’),因此来自不同 Aggregates 的节点可以共享同一路径。节点的 ID(以导入名称开头)和 source_file 可以区分它们。 |
synthesized_subsystem | 布尔值 | 否 | 当该节点的子系统由编译器合成时为 true——即为声明顶层 components 而非具名 subsystems 的 Aggregate 创建的 default 子系统。属于派生的来源信息,从不由作者编写:它将合成的 default 与用户显式命名为 default 的子系统区分开来。与 synthesized_boundary 相互独立(节点可以在任一维度或两个维度上都是合成的)。对于每个作者编写的子系统,该字段缺省(false)。 |
synthesized_boundary | 布尔值 | 否 | 当该节点的边界由编译器合成时为 true——即为声明顶层 components 而非具名 boundaries 的 Release 创建的 default 边界。属于派生的来源信息,从不由作者编写:它将合成的 default 与用户显式命名为 default 的边界区分开来,并将该节点的产物平铺路由到 dist/,而不是 dist/boundaries/default/。对于每个作者编写的边界,该字段缺省(false)。 |
catalog_metadata | CatalogMetadata | 否 | 从 Catalog 实体中显式提取的企业元数据套件,向 Wasm linter 公开生命周期和所有权数据。 |
catalog_annotations | map of string | 否 | 由平台架构师在 Domain 2 中编写的不可变的、固有的组件特征。 |
release_annotations | map of string | 否 | 从 Release 中的边界层叠传递下来的物理拓扑字符串和运维实际情况。 |
aggregate_annotations | map of string | 否 | 从 Aggregate 中的子系统层叠传递下来的认知元数据、开发者意图和 FinOps 信息。 |
self_inject | object | 否 | 从 Aggregate 携带而来的 Component 级自注入块;即该节点为自身声明的与内容无关的注入路由。在此 schema 层是不透明的;读取它的策略插件自行解析这些字节。 |
source_file | string | 否 | 编写该节点的 Aggregate 文件相对于工作区的路径。根层级节点携带根 Aggregate 的路径;子 aggregate 节点携带导入的 Aggregate 的文件路径。该路径相对于工作区根目录(包含 .aggrega-config.yaml 的目录),因此在工作区位于不同绝对路径的机器上,图都保持逐字节一致。按文件过滤诊断信息的使用方在比较之前,以同一工作区根目录解析该字段。当构建图时没有工作区根目录时不存在。 |
uses | object | 否 | 节点的 uses 块,与作者编写的完全一致:每个插槽名称映射到目标实例名称列表,或以别名为键的连接条目映射,顺序与作者声明的顺序相同。这是所写的块,与 edges 中解析后的连接是不同的事实:作者填写的插槽即使没有产生连接也会出现在这里,因此读者可以区分作者填写的插槽和能够到达目标的插槽。当节点未编写 uses 块时缺省。在此 schema 层是不透明的;读取它的策略插件自行解析其字节。 |
sensitive_payload_leaves | string[] | 否 | 该节点的 values 和 infra 负载所携带的、其 Component 声明为敏感的叶子,每个都以该数据所占据的、带支柱前缀的点分路径表示:values.db 的声明覆盖 db.password,而不会触及名为 dbPassword 的同级叶子。键缺省表示该节点没有列出其 Component 声明为敏感的叶子,这包括节点的 Component 解析不到此读取方可读的 schema 的情况。它并不断言节点的负载不敏感,也不区分没有此类叶子可列出的节点与根本不报告此维度的生产方。将缺省的键理解为允许以明文显示或输出某个值的使用方,恰恰理解反了。叶子按负载持有它们的顺序到达,values 支柱的在 infra 支柱的之前,这与这些负载本身携带的顺序相同,也正是它使图在相同输入的多次运行之间保持逐字节一致。当节点未携带其 Component 声明为敏感的叶子时缺省。 |
不允许其他属性。
IREdge
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
source | string | 是 | 消费方节点的 ID,即连接的起点。 |
target | string | 是 | 连接所到达节点的 ID。 |
socket | string | 否 | 此边所属的 usesSchema 类别(例如 ‘databases’、‘tools’)。 |
alias | string | 否 | 开发者为此连接定义的别名(例如 ‘primary_db’)。 |
socket_declaration | string(枚举) | 是 | 套接字的来源:当拥有该套接字的目录实体在 usesSchema 中列出它时(即消费方 Component,或对于由 Feature 编写的边而言为发起方 Feature),值为 declared;当 Aggregate 作者命名了目录未声明的套接字时,值为 ad-hoc。这是第三个维度,与边的编写来源无关:它说明套接字从何而来,而不是谁绘制了这条边,因此一条由 Release 编写、指向已声明套接字的边,与一条由 Aggregate 编写、指向临时套接字的边,在这两个维度上各自独立地不同。已声明的套接字带有其 usesSchema 条目,包括约束该边可到达哪些目标的选择器;临时套接字没有目录条目,因此也没有选择器,所以该边可承载的内容仅由目标声明的 provides 限定。该字段始终存在,因此消费方无需将缺失值解读为 declared,策略也可以要求每条边都是 declared。它不同于附件的绑定标记,后者针对另一主体回答同类问题。允许的值:"declared"、"ad-hoc" |
origin_feature | string | 否 | 如果此边由某个 Feature 自主声明(包括标记为 feature.aggrega.ai/kind: secret 的凭据 Features),则此字段标识该 Feature 的类型 URI。使 Wasm 插件能够隔离自身的拓扑。 |
origin_feature_instance | string | 否 | 声明此边的 Feature 的单附件实例名称。按实例定位边界作用域 FeatureRecipe 的已解析 provides,用于区分同一边界上同一 Feature 类型的两个附件。 |
origin_release | 布尔值 | 否 | 当此边由某个 Release 将已声明但未绑定的套接字连接到现有组件而创建时为 true。它标记的是边的编写来源,而非配置:对于开发者声明、Release 仅为其提供 infra 的边,仍属于 Aggregate 来源(origin_release 未设置;其 Release infra 出现在该边的 infra 映射中)。设置了 origin_feature => Feature 来源;origin_release 为 true => Release 来源;两者皆无 => Aggregate 来源。 |
values | object | 否 | 此边已解析的单连接开发者值(来自 Aggregate 边),在解析时按源套接字(消费方组件上的套接字,即该边的源)声明的 valueSchema 进行校验,并投射到消费方节点渲染上下文的 .context.uses. |
infra | object | 否 | 此边已解析的单连接 infra,由 Release 边条目提供,在解析时按源套接字(消费方组件上的套接字,即该边的源)声明的 infraSchema 进行校验,并投射到 .context.uses. |
inject | object | 否 | 与目标无关的注入路由。将本地变量映射到 Target 的 provides 键。 |
sensitive_payload_leaves | string[] | 否 | 该边的 values 和 infra 所携带的、被它们所针对的 socket 声明为敏感的叶子,每个以该数据所在的、带支柱前缀的点分路径表示:values.db 的声明覆盖 db.password,而不会触及名为 db_password 的同级叶子。从图中隐去已声明为敏感的值的界面,会在该边的 values 和 infra 中隐去这些叶子,也会在消费方节点针对同一连接的 uses 条目中隐去它们,因为该条目按作者编写的原样携带这些值。键缺失表示该边未列出其 socket 契约声明为敏感的任何叶子,这包括 socket 未声明此读取方能够读取的契约的情况。它并不断言该配置不敏感,将缺失的键理解为可以明文显示或输出某个值的使用方,恰好理解反了。叶子按负载保存它们的顺序排列,values 支柱的叶子在 infra 支柱的叶子之前,这使图在相同输入的多次运行之间保持逐字节一致。当边未携带其 socket 契约声明为敏感的任何叶子时缺失。 |
不允许其他属性。
IREdge.inject
与目标无关的注入路由。将本地变量映射到 Target 的 provides 键。
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
env | map of string | 否 | 环境变量投递:键是使用方的本地变量名,值是目标的 provides 键。 |
file | map of string | 否 | 文件挂载投递:键是使用方的本地文件路径,值是目标的 provides 键。 |
arg | map of string | 否 | 命令行参数投递:键是使用方的标志前缀,值是目标的 provides 键。 |
IRMetadata
图的标识:构建该图所依据的 Aggregate。
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
aggregate_name | string | 是 | 该 Aggregate 的 metadata.name。 |
不允许其他属性。
IRProvenance
用于诊断和审计的可追溯性元数据。
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
schema_version | string | 是 | 该图所遵循的 IR schema 版本——aggrega.ai/v1beta1,与图的 apiVersion 所携带的值相同。 |
compiler_version | string | 是 | 强制性合规标记。通过版本标识构建此图的 aggrega 二进制文件。 |
aggregate_version | string | 是 | 编译期间所用根 Aggregate 意图的确切语义版本。 |
manifest_version | string | 是 | 编译期间所用 Manifest 锁文件的确切语义版本。 |
release_version | string | 是 | 编译期间所用 Release 路由文件的确切语义版本。 |
允许其他属性。
IRSpec
图本身:其节点、边以及按节点键控的负载。
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
nodes | map of IRNode | 是 | 图中所有节点的字典,以其绝对 ID 为键。纯拓扑。键:一个或多个字母、数字、下划线、点或连字符。模式:^[a-zA-Z0-9_.-]+$。 |
edges | IREdge[] | 是 | 节点之间显式的逻辑网络路径和依赖关系。 |
values_mapping | object | 是 | 不透明透传认知载荷的唯一可信来源,按节点 ID 映射。 |
infra_mapping | object | 是 | 从 Release 注入的物理规格载荷,按节点 ID 映射。 |
feature_values_mapping | map of map of IRFeatureEntry | 是 | 节点 ID 到其所附 Feature 配置的规范化映射。一个桶承载节点上的所有附件,无论其产出什么——运维 Features、凭据 Features、身份 Features——以作者为每个附件指定的实例名称为键。写在节点某个连接上的附件以其限定名称为键,即连接别名与槽位以点连接,并在其自身的 connection 字段中指明所属连接。键:一个或多个字母、数字、下划线、点或连字符。模式:^[a-zA-Z0-9_.-]+$。 |
boundary_features | map of map of IRBoundaryFeature | 否 | 每个边界的 Feature 附件,先按边界路径、再按实例名称为键。仅当图中存在边界级 Feature 附件时才出现。键:一个或多个字母、数字、下划线、点、斜杠或连字符。模式:^[a-zA-Z0-9_./-]+$。 |
provenance | IRProvenance | 是 | 用于诊断和审计的可追溯性元数据。 |
不允许其他属性。
IRGraph
| 属性 | 类型 | 必需 | 描述 |
|---|---|---|---|
apiVersion | const “aggrega.ai/v1beta1” | 是 | 常量:"aggrega.ai/v1beta1" |
kind | const “IR” | 是 | 常量:"IR" |
metadata | IRMetadata | 是 | 图的标识:构建该图所依据的 Aggregate。 |
spec | IRSpec | 是 | 图本身:其节点、边以及按节点键控的负载。 |
不允许其他属性。