删除指定的节点
请求信息
请求行
DELETE /kubernetes/{cluster}/api/v1/nodes/{name}
删除一个节点。
请求行参数
名称 | 类型 | 是否必填项 | 描述 |
---|---|---|---|
name | string | 是 | 节点的名称。 |
请求参数
名称 | 类型 | 是否必填项 | 描述 |
---|---|---|---|
dryRun | string | 否 | 当该参数出现时,表示不应该持久化修改。一个无效的或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。 有效值为:All,将处理所有的试运行阶段。 |
gracePeriodSeconds | integer | 否 | 对象被删除之前的宽限期,单位:秒。值必须是非负整数。值 0 表示立即删除。如果该值为 nil,则将使用指定类型的默认宽限期。 |
orphanDependents | boolean | 否 | 已弃用:请使用 PropagationPolicy,此字段将在 1.7 中弃用。 是否应该孤立依赖对象。 如果为 true / false,则将 “orphan” 终结器添加到对象的终结器列表中/从该列表中删除。 可以设置此字段或 PropagationPolicy,但不能同时设置。 |
propagationPolicy | string | 否 | 是否以及如何执行垃圾回收。 可以设置此字段或 OrphanDependents,但不能两者都设置。 默认策略由 meta.finalizers 中设置的现有终结器和特定于资源的默认策略决定。 可接受的值为:Orphan,孤立; Background,允许垃圾收集器在后台删除依赖项; Foreground,一种级联策略,删除前台中的所有依赖项。 |
pretty | string | 否 | 如果为 true,则会将返回结果输出成适合打印的格式。 |
请求体
Content-Type
*/*
请求体示例
当删除一个 API 对象时,DeleteOptions 可能被提供。
{
"apiVersion": "",
"dryRun": [
""
],
"gracePeriodSeconds": 1,
"kind": "",
"orphanDependents": false,
"preconditions": {
"resourceVersion": "",
"uid": ""
},
"propagationPolicy": ""
}
请求体说明
名称 | 类型 | 是否必填项 | 描述 |
---|---|---|---|
apiVersion | string | 否 | 查看公共参数 |
dryRun | array | 否 |
当该参数出现时,表示不应该持久化修改。一个无效的或无法识别的 dryRun 指令将导致错误响应,并且不会进一步处理请求。
有效值为:All,将处理所有的试运行阶段。
字段路径:dryRun |
dryRun[] | string | 否 |
字段路径:dryRun[] |
gracePeriodSeconds | integer (int64) | 否 |
对象被删除之前的宽限期,单位:秒。值必须是非负整数。值 0 表示立即删除。如果该值为 nil,则将使用指定类型的默认宽限期。
字段路径:gracePeriodSeconds |
kind | string | 否 | 查看公共参数 |
orphanDependents | boolean | 否 |
已弃用:请使用 PropagationPolicy,此字段将在 1.7 中弃用。 是否应该孤立依赖对象。 如果为 true / false,则将 “orphan” 终结器添加到对象的终结器列表中/从该列表中删除。 可以设置此字段或 PropagationPolicy,但不能同时设置。
字段路径:orphanDependents |
preconditions | object | 否 |
在执行操作(更新、删除等)之前,必须满足先决条件。
字段路径:preconditions |
preconditions.resourceVersion | string | 否 |
指定目标资源版本。
字段路径:preconditions.resourceVersion |
preconditions.uid | string | 否 |
指定的目标 UID。
字段路径:preconditions.uid |
propagationPolicy | string | 否 |
是否以及如何执行垃圾回收。 可以设置此字段或 OrphanDependents,但不能两者都设置。 默认策略由 meta.finalizers 中设置的现有终结器和特定于资源的默认策略决定。 可接受的值为:Orphan,孤立; Background,允许垃圾收集器在后台删除依赖项; Foreground,一种级联策略,删除前台中的所有依赖项。
字段路径:propagationPolicy |
返回信息
Content-Type
application/json
,
application/yaml
,
application/vnd.kubernetes.protobuf
状态码: 200
OK
返回体示例
Status 是不返回其他对象的请求的返回值。
{
"apiVersion": "v1",
"details": {
"kind": "nodes",
"name": "192.168.0.104",
"uid": "66657421-cd82-43f1-b527-386be0cfa9be"
},
"kind": "Status",
"metadata": {},
"status": "Success"
}
返回体说明
名称 | 类型 | 描述 |
---|---|---|
apiVersion | string | 查看公共参数 |
details | object |
StatusDetails 是一组附加属性,服务器可以通过设置这些属性来提供关于响应的附加信息。Status 对象的 Reason 字段定义了将要设置的属性。客户端必须忽略与定义的每个属性类型不匹配的字段,并且应该假设任何属性可能是空的、无效的或未定义的。
字段路径:details |
details.kind | string |
与状态 StatusReason 关联的资源的 kind 属性。某些操作可能与请求的资源类型不同。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
字段路径:details.kind |
details.name | string |
与状态 StatusReason 关联的资源的名称属性(当只有一个名称可以描述时)。
字段路径:details.name |
details.uid | string |
资源的 UID。更多信息:http://kubernetes.io/docs/user-guide/identifiers#uids
字段路径:details.uid |
kind | string | 查看公共参数 |
metadata | object | 查看公共参数 |
status | string |
操作的状态,取值为 “Success” 或 “Failure”。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
字段路径:status |