30.9. DeploymentConfig [apps.openshift.io/v1]


描述

部署配置定义 pod 的模板,并管理部署新镜像或配置更改。单个部署配置通常与单个微服务类似。可以支持许多不同的部署模式,包括完整重启、可自定义更新和完全自定义行为,以及预和部署后 hook。每个单个部署都以复制控制器表示。

当其配置被改变或镜像流中的标签改变时,部署会被"触发"。可以禁用触发器以允许手动控制部署。"strategy" 决定如何执行部署,可以随时进行更改。当有任何方法触发新部署时,latestVersion 字段会被更新。

类型
对象
必填
  • spec

30.9.1. 规格

Expand
属性类型描述

apiVersion

字符串

APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

字符串

kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ObjectMeta

 

spec

对象

DeploymentConfigSpec 代表部署的所需状态。

status

对象

DeploymentConfigStatus 代表当前的部署状态。

30.9.1.1. .spec

描述
DeploymentConfigSpec 代表部署的所需状态。
类型
对象
Expand
属性类型描述

minReadySeconds

整数

MinReadySeconds 是新创建的 pod 在没有任何容器崩溃的情况下应该就绪的最小秒数,使其被视为可用。默认值为 0 (pod 在就绪后将被视为可用)

paused

布尔值

paused 表示部署配置已暂停,从而导致模板更改或模板更改没有因其他触发器导致的新部署。

replicas

整数

replicas 是所需副本数。

revisionHistoryLimit

整数

RevisionHistoryLimit 是要保留的旧 ReplicationController 的数量,以允许回滚。此字段是允许显式零且未指定的指针。默认值为 10。(这仅适用于通过新组 API 资源创建的 DeploymentConfig,不适用于旧的资源。)

selector

对象(字符串)

选择器是 pod 的标签查询,它应该与 Replicas 计数匹配。

策略

对象

DeploymentStrategy 描述了如何执行部署。

模板

PodTemplateSpec

模板是描述在检测到副本不足时创建的 pod 的对象。

test

布尔值

测试可确保此部署配置为零个副本,但部署正在运行。这允许将部署配置用作持续部署测试 - 触发镜像,运行部署,然后成功或失败。后策略 hook 和 After 操作可用于将成功部署与操作集成。

触发器

数组

触发器决定对 DeploymentConfig 的更新如何生成新的部署。如果没有定义触发器,则只能在带有新的 LatestVersion 的 DeploymentConfig 中明确进行新部署。如果为 null,则默认为具有配置更改触发器。

triggers[]

对象

DeploymentTriggerPolicy 描述了导致新部署的单个触发器的策略。

30.9.1.2. .spec.strategy

描述
DeploymentStrategy 描述了如何执行部署。
类型
对象
Expand
属性类型描述

activeDeadlineSeconds

整数

activeDeadlineSeconds 是此部署配置的部署器 Pod 在系统主动尝试终止前可能会在节点上活跃的持续时间(以秒为单位)。

annotations

对象(字符串)

注解是一组键,值对添加到自定义部署器和生命周期 pre/post hook pod 中。

customParams

对象

CustomDeploymentStrategyParams 是 Custom 部署策略的输入。

labels

对象(字符串)

标签是一组键,值对添加到自定义部署器和生命周期 pre/post hook pod 中。

recreateParams

对象

RecreateDeploymentStrategyParams 是 Recreate 部署策略的输入。

资源

ResourceRequirements

资源包含执行部署和任何 hook 的资源要求。

rollingParams

对象

RollingDeploymentStrategyParams 是 Rolling 部署策略的输入。

type

字符串

type 是部署策略的名称。

30.9.1.3. .spec.strategy.customParams

描述
CustomDeploymentStrategyParams 是 Custom 部署策略的输入。
类型
对象
Expand
属性类型描述

命令

数组(字符串)

命令是可选的,并覆盖容器镜像中的 CMD。

环境

数组(EnvVar_v2)

环境包含将提供给 Image 的容器的环境。

镜像

字符串

image 指定可进行部署的容器镜像。

30.9.1.4. .spec.strategy.recreateParams

描述
RecreateDeploymentStrategyParams 是 Recreate 部署策略的输入。
类型
对象
Expand
属性类型描述

mid

对象

LifecycleHook 定义特定的部署生命周期操作。任何时候只能指定一种操作。

post

对象

LifecycleHook 定义特定的部署生命周期操作。任何时候只能指定一种操作。

pre

对象

LifecycleHook 定义特定的部署生命周期操作。任何时候只能指定一种操作。

timeoutSeconds

整数

timeoutSeconds 是放弃前等待更新的时间。如果值为 nil,则使用默认值。

30.9.1.5. .spec.strategy.recreateParams.mid

描述
LifecycleHook 定义特定的部署生命周期操作。任何时候只能指定一种操作。
类型
对象
必填
  • failurePolicy
Expand
属性类型描述

execNewPod

对象

ExecNewPodHook 是一个 hook 实现,它根据指定容器在新 pod 中运行命令,它假定是部署模板的一部分。

failurePolicy

字符串

failurePolicy 指定 hook 失败时要执行的操作。

tagImages

数组

TagImages 指示部署器将容器中引用的当前镜像标记为镜像流标签。

tagImages[]

对象

TagImageHook 是一个将特定容器中的镜像标记到 ImageStreamTag 的请求。

30.9.1.6. .spec.strategy.recreateParams.mid.execNewPod

描述
ExecNewPodHook 是一个 hook 实现,它根据指定容器在新 pod 中运行命令,它假定是部署模板的一部分。
类型
对象
必填
  • 命令
  • containerName
Expand
属性类型描述

命令

数组(字符串)

command 是 action 命令及其参数。

containerName

字符串

containerName 是部署 pod 模板中容器的名称,其容器镜像将用于 hook pod 的容器。

env

数组(EnvVar_v2)

env 是一组环境变量,用于提供给 hook pod 的容器。

数组(字符串)

卷是 pod 模板中命名卷的列表,应复制到 hook pod。pod 规格中未找到的卷名称将被忽略。空列表表示不会复制卷。

30.9.1.7. .spec.strategy.recreateParams.mid.tagImages

描述
TagImages 指示部署器将容器中引用的当前镜像标记为镜像流标签。
类型
数组

30.9.1.8. .spec.strategy.recreateParams.mid.tagImages[]

描述
TagImageHook 是一个将特定容器中的镜像标记到 ImageStreamTag 的请求。
类型
对象
必填
  • containerName
  • to
Expand
属性类型描述

containerName

字符串

containerName 是部署配置中的容器名称,其 image 值将用作标签的来源。如果只有一个容器,则该值将默认为该容器的名称。

to

ObjectReference_v2

将容器镜像设置为目标 ImageStreamTag。

30.9.1.9. .spec.strategy.recreateParams.post

描述
LifecycleHook 定义特定的部署生命周期操作。任何时候只能指定一种操作。
类型
对象
必填
  • failurePolicy
Expand
属性类型描述

execNewPod

对象

ExecNewPodHook 是一个 hook 实现,它根据指定容器在新 pod 中运行命令,它假定是部署模板的一部分。

failurePolicy

字符串

failurePolicy 指定 hook 失败时要执行的操作。

tagImages

数组

TagImages 指示部署器将容器中引用的当前镜像标记为镜像流标签。

tagImages[]

对象

TagImageHook 是一个将特定容器中的镜像标记到 ImageStreamTag 的请求。

30.9.1.10. .spec.strategy.recreateParams.post.execNewPod

描述
ExecNewPodHook 是一个 hook 实现,它根据指定容器在新 pod 中运行命令,它假定是部署模板的一部分。
类型
对象
必填
  • 命令
  • containerName
Expand
属性类型描述

命令

数组(字符串)

command 是 action 命令及其参数。

containerName

字符串

containerName 是部署 pod 模板中容器的名称,其容器镜像将用于 hook pod 的容器。

env

数组(EnvVar_v2)

env 是一组环境变量,用于提供给 hook pod 的容器。

数组(字符串)

卷是 pod 模板中命名卷的列表,应复制到 hook pod。pod 规格中未找到的卷名称将被忽略。空列表表示不会复制卷。

30.9.1.11. .spec.strategy.recreateParams.post.tagImages

描述
TagImages 指示部署器将容器中引用的当前镜像标记为镜像流标签。
类型
数组

30.9.1.12. .spec.strategy.recreateParams.post.tagImages[]

描述
TagImageHook 是一个将特定容器中的镜像标记到 ImageStreamTag 的请求。
类型
对象
必填
  • containerName
  • to
Expand
属性类型描述

containerName

字符串

containerName 是部署配置中的容器名称,其 image 值将用作标签的来源。如果只有一个容器,则该值将默认为该容器的名称。

to

ObjectReference_v2

将容器镜像设置为目标 ImageStreamTag。

30.9.1.13. .spec.strategy.recreateParams.pre

描述
LifecycleHook 定义特定的部署生命周期操作。任何时候只能指定一种操作。
类型
对象
必填
  • failurePolicy
Expand
属性类型描述

execNewPod

对象

ExecNewPodHook 是一个 hook 实现,它根据指定容器在新 pod 中运行命令,它假定是部署模板的一部分。

failurePolicy

字符串

failurePolicy 指定 hook 失败时要执行的操作。

tagImages

数组

TagImages 指示部署器将容器中引用的当前镜像标记为镜像流标签。

tagImages[]

对象

TagImageHook 是一个将特定容器中的镜像标记到 ImageStreamTag 的请求。

30.9.1.14. .spec.strategy.recreateParams.pre.execNewPod

描述
ExecNewPodHook 是一个 hook 实现,它根据指定容器在新 pod 中运行命令,它假定是部署模板的一部分。
类型
对象
必填
  • 命令
  • containerName
Expand
属性类型描述

命令

数组(字符串)

command 是 action 命令及其参数。

containerName

字符串

containerName 是部署 pod 模板中容器的名称,其容器镜像将用于 hook pod 的容器。

env

数组(EnvVar_v2)

env 是一组环境变量,用于提供给 hook pod 的容器。

数组(字符串)

卷是 pod 模板中命名卷的列表,应复制到 hook pod。pod 规格中未找到的卷名称将被忽略。空列表表示不会复制卷。

30.9.1.15. .spec.strategy.recreateParams.pre.tagImages

描述
TagImages 指示部署器将容器中引用的当前镜像标记为镜像流标签。
类型
数组

30.9.1.16. .spec.strategy.recreateParams.pre.tagImages[]

描述
TagImageHook 是一个将特定容器中的镜像标记到 ImageStreamTag 的请求。
类型
对象
必填
  • containerName
  • to
Expand
属性类型描述

containerName

字符串

containerName 是部署配置中的容器名称,其 image 值将用作标签的来源。如果只有一个容器,则该值将默认为该容器的名称。

to

ObjectReference_v2

将容器镜像设置为目标 ImageStreamTag。

30.9.1.17. .spec.strategy.rollingParams

描述
RollingDeploymentStrategyParams 是 Rolling 部署策略的输入。
类型
对象
Expand
属性类型描述

intervalSeconds

整数

intervalSeconds 是更新后轮询部署状态之间等待的时间。如果值为 nil,则使用默认值。

maxSurge

IntOrString

maxSurge 是原始 pod 数之上可以调度的最大 pod 数量。值可以是绝对数字(例如 5),也可以是更新开始时 pod 总数的百分比(例如 10%)。绝对数字通过舍入到百分比来计算。

如果 MaxUnavailable 为 0。默认情况下使用 25%。

示例:当它被设置为 30% 时,在滚动更新启动时,新 RC 可以立即扩展 30%。旧 pod 被终止后,可以进一步扩展新的 RC,确保更新期间随时运行的 pod 总数达到原始 pod 最多 130%。

maxUnavailable

IntOrString

maxUnavailable 是更新期间不可用的 pod 的最大数量。值可以是绝对数字(例如 5),也可以是更新开始时的总 pod 的百分比(例如:10%)。绝对数字通过向下舍入来计算为百分比。

如果 MaxSurge 为 0。默认情况下使用 25%。

示例:当它被设置为 30% 时,旧的 RC 可以在滚动更新启动时立即缩减 30%。新 pod 就绪后,可以进一步缩减旧的 RC,然后扩展新的 RC,确保更新期间始终提供至少 70 的原始 pod 数。

post

对象

LifecycleHook 定义特定的部署生命周期操作。任何时候只能指定一种操作。

pre

对象

LifecycleHook 定义特定的部署生命周期操作。任何时候只能指定一种操作。

timeoutSeconds

整数

timeoutSeconds 是放弃前等待更新的时间。如果值为 nil,则使用默认值。

updatePeriodSeconds

整数

updatePeriodSeconds 是各个 pod 更新之间等待的时间。如果值为 nil,则使用默认值。

30.9.1.18. .spec.strategy.rollingParams.post

描述
LifecycleHook 定义特定的部署生命周期操作。任何时候只能指定一种操作。
类型
对象
必填
  • failurePolicy
Expand
属性类型描述

execNewPod

对象

ExecNewPodHook 是一个 hook 实现,它根据指定容器在新 pod 中运行命令,它假定是部署模板的一部分。

failurePolicy

字符串

failurePolicy 指定 hook 失败时要执行的操作。

tagImages

数组

TagImages 指示部署器将容器中引用的当前镜像标记为镜像流标签。

tagImages[]

对象

TagImageHook 是一个将特定容器中的镜像标记到 ImageStreamTag 的请求。

30.9.1.19. .spec.strategy.rollingParams.post.execNewPod

描述
ExecNewPodHook 是一个 hook 实现,它根据指定容器在新 pod 中运行命令,它假定是部署模板的一部分。
类型
对象
必填
  • 命令
  • containerName
Expand
属性类型描述

命令

数组(字符串)

command 是 action 命令及其参数。

containerName

字符串

containerName 是部署 pod 模板中容器的名称,其容器镜像将用于 hook pod 的容器。

env

数组(EnvVar_v2)

env 是一组环境变量,用于提供给 hook pod 的容器。

数组(字符串)

卷是 pod 模板中命名卷的列表,应复制到 hook pod。pod 规格中未找到的卷名称将被忽略。空列表表示不会复制卷。

30.9.1.20. .spec.strategy.rollingParams.post.tagImages

描述
TagImages 指示部署器将容器中引用的当前镜像标记为镜像流标签。
类型
数组

30.9.1.21. .spec.strategy.rollingParams.post.tagImages[]

描述
TagImageHook 是一个将特定容器中的镜像标记到 ImageStreamTag 的请求。
类型
对象
必填
  • containerName
  • to
Expand
属性类型描述

containerName

字符串

containerName 是部署配置中的容器名称,其 image 值将用作标签的来源。如果只有一个容器,则该值将默认为该容器的名称。

to

ObjectReference_v2

将容器镜像设置为目标 ImageStreamTag。

30.9.1.22. .spec.strategy.rollingParams.pre

描述
LifecycleHook 定义特定的部署生命周期操作。任何时候只能指定一种操作。
类型
对象
必填
  • failurePolicy
Expand
属性类型描述

execNewPod

对象

ExecNewPodHook 是一个 hook 实现,它根据指定容器在新 pod 中运行命令,它假定是部署模板的一部分。

failurePolicy

字符串

failurePolicy 指定 hook 失败时要执行的操作。

tagImages

数组

TagImages 指示部署器将容器中引用的当前镜像标记为镜像流标签。

tagImages[]

对象

TagImageHook 是一个将特定容器中的镜像标记到 ImageStreamTag 的请求。

30.9.1.23. .spec.strategy.rollingParams.pre.execNewPod

描述
ExecNewPodHook 是一个 hook 实现,它根据指定容器在新 pod 中运行命令,它假定是部署模板的一部分。
类型
对象
必填
  • 命令
  • containerName
Expand
属性类型描述

命令

数组(字符串)

command 是 action 命令及其参数。

containerName

字符串

containerName 是部署 pod 模板中容器的名称,其容器镜像将用于 hook pod 的容器。

env

数组(EnvVar_v2)

env 是一组环境变量,用于提供给 hook pod 的容器。

数组(字符串)

卷是 pod 模板中命名卷的列表,应复制到 hook pod。pod 规格中未找到的卷名称将被忽略。空列表表示不会复制卷。

30.9.1.24. .spec.strategy.rollingParams.pre.tagImages

描述
TagImages 指示部署器将容器中引用的当前镜像标记为镜像流标签。
类型
数组

30.9.1.25. .spec.strategy.rollingParams.pre.tagImages[]

描述
TagImageHook 是一个将特定容器中的镜像标记到 ImageStreamTag 的请求。
类型
对象
必填
  • containerName
  • to
Expand
属性类型描述

containerName

字符串

containerName 是部署配置中的容器名称,其 image 值将用作标签的来源。如果只有一个容器,则该值将默认为该容器的名称。

to

ObjectReference_v2

将容器镜像设置为目标 ImageStreamTag。

30.9.1.26. .spec.triggers

描述
触发器决定对 DeploymentConfig 的更新如何生成新的部署。如果没有定义触发器,则只能在带有新的 LatestVersion 的 DeploymentConfig 中明确进行新部署。如果为 null,则默认为具有配置更改触发器。
类型
数组

30.9.1.27. .spec.triggers[]

描述
DeploymentTriggerPolicy 描述了导致新部署的单个触发器的策略。
类型
对象
Expand
属性类型描述

imageChangeParams

对象

DeploymentTriggerImageChangeParams 代表 ImageChange 触发器的参数。

type

字符串

触发器的类型

30.9.1.28. .spec.triggers[].imageChangeParams

描述
DeploymentTriggerImageChangeParams 代表 ImageChange 触发器的参数。
类型
对象
必填
  • from
Expand
属性类型描述

automatic

布尔值

自动意味着,检测新标签值应该会在 pod 模板中进行镜像更新。

containerNames

数组(字符串)

containerNames 用于限制对 pod 中指定容器名称集合的标签更新。如果多个触发器指向同一容器,则生成的行为将未定义。将来的 API 版本将进入验证错误。如果 ContainerNames 没有指向有效的容器,则触发器将被忽略。将来的 API 版本将进入验证错误。

from

ObjectReference_v2

from 是对镜像流标签的引用,用于监视更改。from.Name 是唯一需要的子字段 - 如果 From.Namespace 为空,则使用当前部署触发器的命名空间。

lastTriggeredImage

字符串

lastTriggeredImage 是要触发的最后一个镜像。

30.9.1.29. .status

描述
DeploymentConfigStatus 代表当前的部署状态。
类型
对象
必填
  • latestVersion
  • observedGeneration
  • replicas
  • updatedReplicas
  • availableReplicas
  • unavailableReplicas
Expand
属性类型描述

availableReplicas

整数

availableReplicas 是此部署配置的目标可用 pod 的总数。

conditions

数组

条件代表部署配置当前状态的最新可用影响。

conditions[]

对象

DeploymentCondition 描述了部署配置在特定时间点上的状态。

详情

对象

DeploymentDetails 捕获有关部署原因的信息。

latestVersion

整数

LatestVersion 用于确定与部署配置关联的当前部署是否不同步。

observedGeneration

整数

observedGeneration 是部署配置控制器观察到的最新生成。

readyReplicas

整数

此部署的目标就绪 pod 总数。

replicas

整数

replicas 是此部署配置的目标 pod 总数。

unavailableReplicas

整数

UnavailableReplicas 是此部署配置的目标不可用 pod 的总数。

updatedReplicas

整数

UpdatedReplicas 是此部署配置带有所需模板 spec 的非终止 pod 总数。

30.9.1.30. .status.conditions

描述
条件代表部署配置当前状态的最新可用影响。
类型
array

30.9.1.31. .status.conditions[]

描述
DeploymentCondition 描述了部署配置在特定时间点上的状态。
类型
对象
必填
  • type
  • status
Expand
属性类型描述

lastTransitionTime

time

条件从一个状态转换到另一个状态最后一次的时间。

lastUpdateTime

time

最后一次更新此条件的时间。

message

字符串

人类可读的消息,指示有关转换的详细信息。

reason

字符串

条件最后一次转换的原因。

status

字符串

条件的状态,True, False, Unknown 之一。

type

字符串

部署条件的类型。

30.9.1.32. .status.details

描述
DeploymentDetails 捕获有关部署原因的信息。
类型
对象
必填
  • 原因
Expand
属性类型描述

原因

数组

原因是与创建新部署的所有原因相关的扩展数据

causes[]

对象

DeploymentCause 捕获有关部署特定原因的信息。

message

字符串

如果用户手动触发此部署,则消息是用户指定的更改消息

30.9.1.33. .status.details.causes

描述
原因是与创建新部署的所有原因相关的扩展数据
类型
数组

30.9.1.34. .status.details.causes[]

描述
DeploymentCause 捕获有关部署特定原因的信息。
类型
对象
必填
  • type
Expand
属性类型描述

imageTrigger

对象

DeploymentCauseImageTrigger 代表有关来自镜像更改触发器的部署原因的详细信息

type

字符串

导致创建新部署的触发器类型

30.9.1.35. .status.details.causes[].imageTrigger

描述
DeploymentCauseImageTrigger 代表有关来自镜像更改触发器的部署原因的详细信息
类型
对象
必填
  • from
Expand
属性类型描述

from

ObjectReference_v2

from 是触发部署的更改对象的引用。该字段可能具有 DockerImage、ImageStreamTag 或 ImageStreamImage 类型。

30.9.2. API 端点

可用的 API 端点如下:

  • /apis/apps.openshift.io/v1/deploymentconfigs

    • GET :列出或监视类型为 DeploymentConfig 的对象
  • /apis/apps.openshift.io/v1/watch/deploymentconfigs

    • GET: 观察单个对 DeploymentConfig 列表的更改。已弃用:将 'watch' 参数与列表操作一起使用。
  • /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs

    • DELETE :删除 DeploymentConfig 集合
    • GET :列出或监视类型为 DeploymentConfig 的对象
    • POST :创建一个 DeploymentConfig
  • /apis/apps.openshift.io/v1/watch/namespaces/{namespace}/deploymentconfigs

    • GET: 观察单个对 DeploymentConfig 列表的更改。已弃用:将 'watch' 参数与列表操作一起使用。
  • /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}

    • DELETE :删除 DeploymentConfig
    • GET :读取指定的 DeploymentConfig
    • PATCH :部分更新指定的 DeploymentConfig
    • PUT :替换指定的 DeploymentConfig
  • /apis/apps.openshift.io/v1/watch/namespaces/{namespace}/deploymentconfigs/{name}

    • GET: 观察对类型为 DeploymentConfig 的对象的更改。已弃用:使用带有列表操作的 'watch' 参数,而是过滤到带有 'fieldSelector' 参数的单个项目。
  • /apis/apps.openshift.io/v1/namespaces/{namespace}/deploymentconfigs/{name}/status

    • GET: 指定 DeploymentConfig 的读取状态
    • PATCH :部分更新指定 DeploymentConfig 的状态
    • PUT: 替换指定 DeploymentConfig 的状态

30.9.2.1. /apis/apps.openshift.io/v1/deploymentconfigs

Expand
表 30.209. 全局查询参数
参数类型描述

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。如果 apiserver 中没有启用功能门 WatchBookmarks,则忽略此字段。

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

pretty

字符串

如果 'true',则输出被用户友善。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

HTTP 方法
GET
描述
列出或监视类型为 DeploymentConfig 的对象
Expand
表 30.210. HTTP 响应
HTTP 代码响应正文

200 - OK

DeploymentConfigList schema

401 - 未授权

Expand
表 30.211. 全局查询参数
参数类型描述

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。如果 apiserver 中没有启用功能门 WatchBookmarks,则忽略此字段。

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

pretty

字符串

如果 'true',则输出被用户友善。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

HTTP 方法
GET
描述
观察单个对 DeploymentConfig 列表的更改。已弃用:改为使用 'watch' 参数和列表操作。
Expand
表 30.212. HTTP 响应
HTTP 代码响应正文

200 - OK

WatchEvent 模式

401 - Unauthorized

Expand
表 30.213. 全局路径参数
参数类型描述

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 30.214. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
DELETE
描述
删除 DeploymentConfig 集合
Expand
表 30.215. 查询参数
参数类型描述

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

gracePeriodSeconds

整数

应该删除对象前的持续时间(以秒为单位)。值必须是非负整数。值零表示立即删除。如果这个值是 nil,则使用指定类型的默认宽限期。如果没有指定,则默认为每个对象值。零表示立即删除。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

orphanDependents

布尔值

弃用:请使用 PropagationPolicy,此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false,"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy,但不能同时设置两者。

propagationPolicy

字符串

是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置,但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为: 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系; 'Foreground' - 一个删除前台所有依赖的级联策略。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

Expand
表 30.216. 主体参数
参数类型描述

正文(body)

DeleteOptions 模式

 
Expand
表 30.217. HTTP 响应
HTTP 代码响应正文

200 - OK

Status 模式

401 - Unauthorized

HTTP 方法
GET
描述
列出或监视类型为 DeploymentConfig 的对象
Expand
表 30.218. 查询参数
参数类型描述

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。如果 apiserver 中没有启用功能门 WatchBookmarks,则忽略此字段。

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

Expand
表 30.219. HTTP 响应
HTTP 代码响应正文

200 - OK

DeploymentConfigList schema

401 - 未授权

HTTP 方法
POST
描述
创建 DeploymentConfig
Expand
表 30.220. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 30.221. 主体参数
参数类型描述

正文(body)

DeploymentConfig schema

 
Expand
表 30.222. HTTP 响应
HTTP 代码响应正文

200 - OK

DeploymentConfig schema

201 - Created

DeploymentConfig schema

202 - Accepted

DeploymentConfig schema

401 - 未授权

Expand
表 30.223. 全局路径参数
参数类型描述

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 30.224. 全局查询参数
参数类型描述

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。如果 apiserver 中没有启用功能门 WatchBookmarks,则忽略此字段。

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

pretty

字符串

如果 'true',则输出被用户友善。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

HTTP 方法
GET
描述
观察单个对 DeploymentConfig 列表的更改。已弃用:改为使用 'watch' 参数和列表操作。
Expand
表 30.225. HTTP 响应
HTTP 代码响应正文

200 - OK

WatchEvent 模式

401 - Unauthorized

Expand
表 30.226. 全局路径参数
参数类型描述

name

字符串

DeploymentConfig 的名称

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 30.227. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
DELETE
描述
删除 DeploymentConfig
Expand
表 30.228. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

gracePeriodSeconds

整数

应该删除对象前的持续时间(以秒为单位)。值必须是非负整数。值零表示立即删除。如果这个值是 nil,则使用指定类型的默认宽限期。如果没有指定,则默认为每个对象值。零表示立即删除。

orphanDependents

布尔值

弃用:请使用 PropagationPolicy,此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false,"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy,但不能同时设置两者。

propagationPolicy

字符串

是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置,但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为: 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系; 'Foreground' - 一个删除前台所有依赖的级联策略。

Expand
表 30.229. 主体参数
参数类型描述

正文(body)

DeleteOptions 模式

 
Expand
表 30.230. HTTP 响应
HTTP 代码响应正文

200 - OK

Status 模式

202 - Accepted

Status 模式

401 - Unauthorized

HTTP 方法
GET
描述
读取指定的 DeploymentConfig
Expand
表 30.231. HTTP 响应
HTTP 代码响应正文

200 - OK

DeploymentConfig schema

401 - 未授权

HTTP 方法
PATCH
描述
部分更新指定的 DeploymentConfig
Expand
表 30.232. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段,但对于非应用补丁类型(JsonPatch、MergePatch、OptMergePatch)是可选的。

force

布尔值

强制将"强制"应用请求。这意味着用户会重新清空由其他人员拥有的冲突字段。对于非应用补丁请求,必须取消设置 force 标志。

Expand
表 30.233. 主体参数
参数类型描述

正文(body)

Patch 模式

 
Expand
表 30.234. HTTP 响应
HTTP 代码响应正文

200 - OK

DeploymentConfig schema

401 - 未授权

HTTP 方法
PUT
描述
替换指定的 DeploymentConfig
Expand
表 30.235. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 30.236. 主体参数
参数类型描述

正文(body)

DeploymentConfig schema

 
Expand
表 30.237. HTTP 响应
HTTP 代码响应正文

200 - OK

DeploymentConfig schema

201 - Created

DeploymentConfig schema

401 - 未授权

Expand
表 30.238. 全局路径参数
参数类型描述

name

字符串

DeploymentConfig 的名称

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 30.239. 全局查询参数
参数类型描述

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。如果 apiserver 中没有启用功能门 WatchBookmarks,则忽略此字段。

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

pretty

字符串

如果 'true',则输出被用户友善。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

HTTP 方法
GET
描述
观察对类型为 DeploymentConfig 的对象的更改。已弃用:使用带有列表操作的 'watch' 参数,而是过滤到带有 'fieldSelector' 参数的单个项目。
Expand
表 30.240. HTTP 响应
HTTP 代码响应正文

200 - OK

WatchEvent 模式

401 - Unauthorized

Expand
表 30.241. 全局路径参数
参数类型描述

name

字符串

DeploymentConfig 的名称

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 30.242. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
GET
描述
指定 DeploymentConfig 的读取状态
Expand
表 30.243. HTTP 响应
HTTP 代码响应正文

200 - OK

DeploymentConfig schema

401 - 未授权

HTTP 方法
PATCH
描述
指定 DeploymentConfig 的部分更新状态
Expand
表 30.244. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段,但对于非应用补丁类型(JsonPatch、MergePatch、OptMergePatch)是可选的。

force

布尔值

强制将"强制"应用请求。这意味着用户会重新清空由其他人员拥有的冲突字段。对于非应用补丁请求,必须取消设置 force 标志。

Expand
表 30.245. 主体参数
参数类型描述

正文(body)

Patch 模式

 
Expand
表 30.246. HTTP 响应
HTTP 代码响应正文

200 - OK

DeploymentConfig schema

401 - 未授权

HTTP 方法
PUT
描述
替换指定 DeploymentConfig 的状态
Expand
表 30.247. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 30.248. 主体参数
参数类型描述

正文(body)

DeploymentConfig schema

 
Expand
表 30.249. HTTP 响应
HTTP 代码响应正文

200 - OK

DeploymentConfig schema

201 - Created

DeploymentConfig schema

401 - 未授权

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat