平台中心
首页 / API 文档 / 平台管理 / 集群管理 / Machine 管理 / 查看 Machine 列表

查看 Machine 列表

请求信息

请求行

GET /apis/platform.tkestack.io/v1/machines

查看类型为 Machine 的对象列表。

请求参数

名称 类型 是否必填项 描述
allowWatchBookmarks boolean 否allowWatchBookmarks 请求使用 BOOKMARK 类型监视事件。没有实现书签的服务器可能会忽略此标志，而书签是由服务器自行发送的。客户端不应该假定书签在任何特定的间隔被返回，也不应该假定服务器将在会话期间发送任何 BOOKMARK 事件。如果这不是 watch 请求，这个字段将被忽略。如果在 apiserver 中未启用特性门 WatchBookmarks，则忽略该字段。
continue string 否服务器定义的值，⽤于从服务器中查询更多的返回结果。客户端只能从上⼀个查询结果中获取该值。当查询列表时设置了limit 参数，返回结果未包含服务器上可以查询到的所有数据，此时，会返回 continue 参数，并为 continue 参数赋值⼀个 Token。需要查询更多返回结果时，可将 continue 参数及其值作为查询参数查询更多结果。说明：如果列表配置发⽣变化或查询过期，输⼊此查询参数后，会返回 410 错误码，如果继续输⼊该查询参数进⾏查询，返回的查询结果可能不是最新的数据。
fieldSelector string 否字段选择器，可通过资源对象的字段过滤、筛选资源对象，默认返回所有资源对象。
labelSelector string 否标签选择器，可通过标签过滤、筛选资源对象，默认返回所有资源对象。
limit integer 否limit 是查询列表请求返回的最大响应数。 如果存在更多项，则服务器会将列表元数据上的 “continue” 字段设置为一个值，该值可与相同的初始查询一起使用用来检索下一组结果。如果所有请求的对象都被过滤掉了，则设置的限制返回的项目数可能少于请求的项目数（最多为零），并且客户端应仅使用 continue 字段的存在来确定是否有更多结果可用。服务器可能选择不支持 limit 参数，并将返回所有可用结果。如果指定了限制，并且 continue 字段为空，则客户端可能会认为没有更多结果可用。如果 watch 为 true，则不支持此字段。 服务器保证使用 continue 时返回的对象与发出单个列表调用无限制地相同，也就是说，在发出第一个请求后，任何创建、修改或删除的对象都不会包含在任何后续的继续请求中。有时这被称为一致快照，并确保使用限制接收非常大结果的较小块的客户端可以确保它们看到所有可能的对象。如果在分块列表期间更新对象，则将返回在计算第一个列表结果时存在的对象版本。
resourceVersion string 否当指定使用 watch 请求时，将显示在资源的特定版本之后发生的更改。默认从历史开始更改。当为 list 指定时：-如果未设置，则基于 quora -read 标志从远程存储返回结果；-如果它是 0，那么我们只是返回我们目前在缓存，没有保证；-如果设置为非零，那么结果至少与给定的 resourceVersion 一样为最新的值。
timeoutSeconds integer 否list/watch 方法的调用超时时长。这限制了调用的持续时间，不管是否活跃。
watch boolean 否监视对所描述的资源的更改，并将其作为添加、更新和删除通知的流返回。需要指定 resourceVersion。
pretty string 否如果为 true，则会将返回结果输出成适合打印的格式。

返回信息

Content-Type application/json, application/yaml, application/vnd.kubernetes.protobuf, application/json;stream=watch, application/vnd.kubernetes.protobuf;stream=watch

状态码: 200

OK

返回体示例

MachineList 是一个集群中所有节点的列表。

{
   "apiVersion": "platform.tkestack.io/v1",
   "items": [
     {
       "apiVersion": "platform.tkestack.io/v1",
       "kind": "Machine",
       "metadata": {
         "annotations": {
           "cpaas.io/display-name": "192.168.0.104"
         },
         "creationTimestamp": "2021-06-24T02:25:45Z",
         "name": "mc-192-168-0-104",
         "resourceVersion": "2078561",
         "selfLink": "/apis/platform.tkestack.io/v1/machines/mc-192-168-0-104",
         "uid": "719f0a5b-a730-41e3-8c15-1572675b6423"
       },
       "spec": {
         "clusterName": "global",
         "displayName": "",
         "finalizers": [
           "machine"
         ],
         "ip": "192.168.0.104",
         "ipv6": "",
         "networkDevice": "",
         "port": 22,
         "proxy": {},
         "publicIP": "",
         "role": "",
         "type": "Baremetal",
         "username": "root"
       },
       "status": {
         "conditions": [
           {
             "lastProbeTime": "2021-07-01T09:14:06Z",
             "lastTransitionTime": "2021-06-24T02:26:34Z",
             "status": "True",
             "type": "HealthCheck"
           }
         ],
         "machineInfo": {},
         "phase": "Running"
       }
     }
   ],
   "kind": "MachineList",
   "metadata": {
     "resourceVersion": "2083056",
     "selfLink": "/apis/platform.tkestack.io/v1/machines"
   }
 }

返回体说明

名称 类型 描述
apiVersion string 查看公共参数
items array 集群列表。
字段路径：items
items[] object 在 Kubernetes 集群中的节点实例。
字段路径：items[]
items[].apiVersion string 查看公共参数
items[].kind string 查看公共参数
items[].metadata object 查看公共参数
items[].spec object 节点的描述信息。
字段路径：items[].spec
spec.clusterName string 集群的名称。
字段路径：items[].spec.clusterName
spec.displayName string 节点的显示名称。
字段路径：items[].spec.displayName
spec.finalizers array 终结器是一个内部的值列表，必须为空才能从存储中永久删除对象。
字段路径：items[].spec.finalizers
spec.finalizers[] string
字段路径：items[].spec.finalizers[]
spec.ip string 节点 IP。
字段路径：items[].spec.ip
spec.ipv6 string IPV6 地址。
字段路径：items[].spec.ipv6
spec.networkDevice string 网络设备（网卡）名称。
字段路径：items[].spec.networkDevice
spec.port integer (int32) 端口号。
字段路径：items[].spec.port
spec.proxy object 通过 SSH 服务访问节点的代理。
字段路径：items[].spec.proxy
spec.publicIP string 节点的公网 IP。
字段路径：items[].spec.publicIP
spec.role string 节点的类型，控制节点（master）/计算节点（node）。
字段路径：items[].spec.role
spec.type string 节点的类型。
字段路径：items[].spec.type
spec.username string 用户名。
字段路径：items[].spec.username
items[].status object MachineStatus 表示关于节点状态的信息。
字段路径：items[].status
status.conditions array 节点的执行进度。
字段路径：items[].status.conditions
status.conditions[] object MachineCondition 包含了该节点当前条件的详细信息。
字段路径：items[].status.conditions[]
conditions[].lastProbeTime string (date-time) Time 是时间的包装。Time 支持正确的封送到 YAML 和 JSON。时间包提供方的许多工厂方法都提供了包装器。
字段路径：items[].status.conditions[].lastProbeTime
conditions[].lastTransitionTime string (date-time) Time 是时间的包装。Time 支持正确的封送到 YAML 和 JSON。时间包提供方的许多工厂方法都提供了包装器。
字段路径：items[].status.conditions[].lastTransitionTime
conditions[].status string 条件的状态，可以是 True、False、Unknown。
字段路径：items[].status.conditions[].status
conditions[].type string 条件的类型。
字段路径：items[].status.conditions[].type
status.machineInfo object MachineSystemInfo 是唯一标识节点的一组 id 或 uuid。
字段路径：items[].status.machineInfo
status.phase string 节点的执行进度阶段。
字段路径：items[].status.phase
kind string 查看公共参数
metadata object 查看公共参数

其他状态码

状态码: 401

Unauthorized