3.2 对象类资源格式

Kubernetes API 仅接受及响应 JSON 格式的数据（JSON对象），同时，为了便于使用，它也允许用户提供YAML个数的POST对象，但API Server需要事先自定将其转换为JSON格式后方能提交。API Server接受和返回的所有JSON对象都遵循同一个模式，它们都具有 kind 和 apiVersion 字段，用于标识对象所属的资源类型、API 群组及相关的版本。

进一步地，大多数的对象或列表类型的资源还需要具有是三个嵌套型的字段 metadata、spec 和 status。其中 metadata 字段为资源提供元数据信息，如名称、隶属的空间名称和标签等；spec 则用于定义用户期望的状态，不同的资源类型，其状态的意义也各有不同，例如 Pod 资源最为核心的功能在于运行容器；而status则记录着活动对象的当前状态信息，它由 kubernetes 系统自行维护，对用户来说为只读字段。

每个资源通常仅接受并返回单一类型的数据，而一种类型可以被多个反映特定用例的资源所接受或返回。例如对于 Pod 类型的资源来说，用户可创建、更新或删除Pod对象，然而，每个Pod对象的metadata、spec和status字段的值却又是各自独立的对象型数据，它们可被单独操作，求其是 status 对象，是由 kubernetes 系统单独进行自动更新，而不能由用户手动操作它。