Kubernetes API

Kubernetes API 是通过 RESTful 接口提供 Kubernetes 功能服务并负责集群状态存储的应用程序。

Kubernetes 资源和"意向记录"都是作为 API 对象储存的，并可以通过调用 RESTful 风格的 API 进行修改。 API 允许以声明方式管理配置。用户可以直接和 Kubernetes API 交互，也可以通过 kubectl 这样的工具进行交互。核心的 Kubernetes API 是很灵活的，可以扩展以支持定制资源。

APIVersions

apiVersions 列出了可用的版本，以便客户端能够发现位于 /api（即旧版 v1 API 的根路径）处的 API。

FieldSelectorRequirement

FieldSelectorRequirement 是一种选择器，包含键（key）、值（values）以及用于关联键与值的运算符（operator）。

FieldsV1

FieldsV1 将一组字段存储在类似 Trie 的数据结构中，格式为 JSON。

每个键要么是一个 “.”，表示字段本身，并且始终映射到空集；要么是一个字符串，表示子字段或项。该字符串遵循以下四种格式之一： f:<name>，其中 <name> 是结构体中字段的名称，或映射中的键； v:<value>，其中 <value> 是列表项的精确 JSON 格式值； i:<index>，其中 <index> 是项在列表中的位置； k:<keys>，其中 <keys> 是列表项的键值。是列表项的键字段到其唯一值的映射。如果某个键映射到空的字段值，则该键所代表的字段属于该集合。

确切格式定义在 sigs.k8s.io/structured-merge-diff 中。


   (Note that &lt;suffix&gt; may be empty, from the &#34;&#34; case in &lt;decimalSI&gt;.)

&lt;digit&gt;           ::= 0 | 1 | ... | 9 &lt;digits&gt;          ::= &lt;digit&gt; | &lt;digit&gt;&lt;digits&gt; &lt;number&gt;          ::= &lt;digits&gt; | &lt;digits&gt;.&lt;digits&gt; | &lt;digits&gt;. | .&lt;digits&gt; &lt;sign&gt;            ::= &#34;+&#34; | &#34;-&#34; &lt;signedNumber&gt;    ::= &lt;number&gt; | &lt;sign&gt;&lt;number&gt; &lt;suffix&gt;          ::= &lt;binarySI&gt; | &lt;decimalExponent&gt; | &lt;decimalSI&gt; &lt;binarySI&gt;        ::= Ki | Mi | Gi | Ti | Pi | Ei

   (International System of units; See: http://physics.nist.gov/cuu/Units/binary.html)

&lt;decimalSI&gt;       ::= m | &#34;&#34; | k | M | G | T | P | E

   (Note that 1024 = 1Ki but 1000 = 1k; I didn&#39;t choose the capitalization.)

&lt;decimalExponent&gt; ::= &#34;e&#34; &lt;signedNumber&gt; | &#34;E&#34; &lt;signedNumber&gt; ```

无论使用三种指数形式中的哪一种，任何 Quantity 都不能表示幅度大于 2^63-1 的数字，也不能超过 3 位小数。更大或更精确的数字将被截断或向上取整。（例如：0.1m 将向上取整为 1m。）如果将来需要更大或更小的数量，这可能会被扩展。

当 Quantity 从字符串解析时，它会记住其后缀类型，并在再次序列化时使用相同的类型。

在序列化之前，Quantity 将被置于 &#34;规范形式&#34;（canonical form）。这意味着指数/后缀将向上或向下调整（尾数相应增加或减少），使得：

- 不会丢失精度 - 不会输出小数位 - 指数（或后缀）尽可能大。

除非数字为负数，否则符号将被省略。

示例：

- 1.5 将被序列化为 &#34;1500m&#34; - 1.5Gi 将被序列化为 &#34;1536Mi&#34;

只要格式正确，非规范值仍可被解析，但会以其规范形式重新输出。（因此请始终使用规范形式，或者不要进行 diff。）

此格式旨在使不编写某种特殊处理代码就使用这些数字变得困难，希望以此促使实现者也使用定点实现。