8.13. Infrastructure [config.openshift.io/v1]
- 描述
-
基础架构包含有关基础架构的集群范围信息。规范名称是
集群兼容性级别
1:在主发行版本中至少有 12 个月或 3 个次版本(以更长的时间为准)。 - 类型
-
对象
- 必填
-
spec
-
8.13.1. 规格 复制链接链接已复制到粘贴板!
属性 | 类型 | 描述 |
---|---|---|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值,并可拒绝未识别的值。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| 标准对象元数据。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| spec 包含用户配置可设置值 |
|
| status 包含从集群中观察到的值。它们可能无法覆盖。 |
8.13.1.1. .spec 复制链接链接已复制到粘贴板!
- 描述
- spec 包含用户配置可设置值
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
|
cloudconfig 是对包含云供应商配置文件的 ConfigMap 的引用。此配置文件用于在使用内置云供应商集成或外部云控制器管理器时配置 Kubernetes 云供应商集成。此配置映射的命名空间是 openshift-config. cloudConfig 应该只由 kube_cloud_config 控制器使用。控制器负责为各种平台使用 spec 中的用户配置,并将其与此字段中提供的 ConfigMap 合并,以创建停止的 kube 云配置。控制器在 |
|
| platformSpec 包含特定于底层基础架构供应商所需的信息。 |
8.13.1.2. .spec.cloudConfig 复制链接链接已复制到粘贴板!
- 描述
-
cloudconfig 是对包含云供应商配置文件的 ConfigMap 的引用。此配置文件用于在使用内置云供应商集成或外部云控制器管理器时配置 Kubernetes 云供应商集成。此配置映射的命名空间是 openshift-config. cloudConfig 应该只由 kube_cloud_config 控制器使用。控制器负责为各种平台使用 spec 中的用户配置,并将其与此字段中提供的 ConfigMap 合并,以创建停止的 kube 云配置。控制器在
openshift-config-managed
命名空间中生成一个 ConfigMapkube-cloud-config
,并将 kube 云配置存储在cloud.conf
密钥中。所有客户端都应该只使用生成的 ConfigMap。 - 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 键允许指向 configmap 中的特定键/值。这对于逻辑文件引用非常有用。 |
|
|
8.13.1.3. .spec.platformSpec 复制链接链接已复制到粘贴板!
- 描述
- platformSpec 包含特定于底层基础架构供应商所需的信息。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| alibabacloud 包含特定于 Alibaba Cloud 基础架构供应商的设置。 |
|
| AWS 包含特定于 Amazon Web Services 基础架构供应商的设置。 |
|
| Azure 包含特定于 Azure 基础架构供应商的设置。 |
|
| baremetal 包含特定于 BareMetal 平台的设置。 |
|
| equinixMetal 包含特定于 Equinix Metal 基础架构供应商的设置。 |
|
| GCP 包含特定于 Google Cloud Platform 基础架构供应商的设置。 |
|
| ibmcloud 包含特定于 IBMCloud 基础架构供应商的设置。 |
|
| kubevirt 包含特定于 kubevirt 基础架构供应商的设置。 |
|
| OpenStack 包含特定于 OpenStack 基础架构供应商的设置。 |
|
| oVirt 包含特定于 oVirt 基础架构供应商的设置。 |
|
| powervs 包含特定于 IBM Power 系统虚拟服务器基础架构供应商的设置。 |
|
| type 是集群的底层基础架构供应商。这个值控制基础架构自动化,如服务负载均衡器、动态卷置备、机器创建和删除和其他集成。如果 None,则不会启用基础架构自动化。允许的值有 "AWS", "Azure", "BareMetal", "GCP", "Libvirt", "OpenStack", "VSphere", "oVirt", "KubeVirt", "EquinixMetal", "PowerVS", "AlibabaCloud" 和 "None"。独立组件可能不支持所有平台,如果不支持该平台,则必须将未识别的平台处理为 None。 |
|
| vSphere 包含特定于 VSphere 基础架构供应商的设置。 |
8.13.1.4. .spec.platformSpec.alibabaCloud 复制链接链接已复制到粘贴板!
- 描述
- alibabacloud 包含特定于 Alibaba Cloud 基础架构供应商的设置。
- 类型
-
对象
8.13.1.5. .spec.platformSpec.aws 复制链接链接已复制到粘贴板!
- 描述
- AWS 包含特定于 Amazon Web Services 基础架构供应商的设置。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| serviceEndpoints 列表包含自定义端点,该端点将覆盖 AWS 服务的默认服务端点。服务必须只有一个 ServiceEndpoint。 |
|
| AWSServiceEndpoint 存储自定义 url 的配置,以覆盖 AWS 服务的现有默认值。 |
8.13.1.6. .spec.platformSpec.aws.serviceEndpoints 复制链接链接已复制到粘贴板!
- 描述
- serviceEndpoints 列表包含自定义端点,该端点将覆盖 AWS 服务的默认服务端点。服务必须只有一个 ServiceEndpoint。
- 类型
-
array
8.13.1.7. .spec.platformSpec.aws.serviceEndpoints[] 复制链接链接已复制到粘贴板!
- 描述
- AWSServiceEndpoint 存储自定义 url 的配置,以覆盖 AWS 服务的现有默认值。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| name 是 AWS 服务的名称。所有服务名称的列表都可在 https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html 中找到,必须提供它,且不能为空。 |
|
| URL 是带有方案 https 的完全限定 URI,可覆盖客户端生成的默认端点。必须提供此功能,且不能为空。 |
8.13.1.8. .spec.platformSpec.azure 复制链接链接已复制到粘贴板!
- 描述
- Azure 包含特定于 Azure 基础架构供应商的设置。
- 类型
-
对象
8.13.1.9. .spec.platformSpec.baremetal 复制链接链接已复制到粘贴板!
- 描述
- baremetal 包含特定于 BareMetal 平台的设置。
- 类型
-
对象
8.13.1.10. .spec.platformSpec.equinixMetal 复制链接链接已复制到粘贴板!
- 描述
- equinixMetal 包含特定于 Equinix Metal 基础架构供应商的设置。
- 类型
-
对象
8.13.1.11. .spec.platformSpec.gcp 复制链接链接已复制到粘贴板!
- 描述
- GCP 包含特定于 Google Cloud Platform 基础架构供应商的设置。
- 类型
-
对象
8.13.1.12. .spec.platformSpec.ibmcloud 复制链接链接已复制到粘贴板!
- 描述
- ibmcloud 包含特定于 IBMCloud 基础架构供应商的设置。
- 类型
-
对象
8.13.1.13. .spec.platformSpec.kubevirt 复制链接链接已复制到粘贴板!
- 描述
- kubevirt 包含特定于 kubevirt 基础架构供应商的设置。
- 类型
-
对象
8.13.1.14. .spec.platformSpec.openstack 复制链接链接已复制到粘贴板!
- 描述
- OpenStack 包含特定于 OpenStack 基础架构供应商的设置。
- 类型
-
对象
8.13.1.15. .spec.platformSpec.ovirt 复制链接链接已复制到粘贴板!
- 描述
- oVirt 包含特定于 oVirt 基础架构供应商的设置。
- 类型
-
对象
8.13.1.16. .spec.platformSpec.powervs 复制链接链接已复制到粘贴板!
- 描述
- powervs 包含特定于 IBM Power 系统虚拟服务器基础架构供应商的设置。
- 类型
-
对象
8.13.1.17. .spec.platformSpec.vsphere 复制链接链接已复制到粘贴板!
- 描述
- vSphere 包含特定于 VSphere 基础架构供应商的设置。
- 类型
-
对象
8.13.1.18. .status 复制链接链接已复制到粘贴板!
- 描述
- status 包含从集群中观察到的值。它们可能无法覆盖。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| apiServerInternalURL 是一个有效的 URI,它带有方案 'https'、地址和可选端口(默认为 443)。apiServerInternalURL 可被 kubelet 等组件使用,使用基础架构供应商而不是 Kubernetes 网络联系 Kubernetes API 服务器。 |
|
| apiServerURL 是一个有效的 URI,它带有方案 'https'、地址和可选端口(默认为 443)。apiServerURL 可被 Web 控制台等组件使用,告知用户在哪里查找 Kubernetes API。 |
|
| controlPlaneTopology 代表通常在控制节点上运行的操作对象的预期。默认值为 'HighlyAvailable',它代表运算符在 "normal" 集群中具有的行为。'SingleReplica' 模式将在单节点部署中使用,Operator 不应该为高可用性操作配置操作对象。"External" 模式表示 control plane 在集群外部托管,且其组件在集群中不可见。 |
|
| etcdDiscoveryDomain 是用于获取用于发现 etcd 服务器和客户端的 SRV 记录的域。如需更多信息: https://github.com/etcd-io/etcd/blob/329be66e8b3f9e2e6af83c123ff89297e49ebd15/Documentation/op-guide/clustering.md#dns-discovery 弃用:从 4.7 开始,不再设置或遵守此字段。它将在以后的发行版本中被删除。 |
|
| infrastructureName 使用用户友好的名称唯一标识集群。设置后不应更改它。必须是最大长度 27,且必须具有字母数字字符或连字符。 |
|
|
infrastructureTopology 代表不在 control plane 节点上运行的基础架构服务的预期,通常由节点选择器表示,用于 |
|
| 平台是集群的底层基础架构供应商。弃用:改为使用 platformStatus.type。 |
|
| platformStatus 包含特定于底层基础架构供应商的状态信息。 |
8.13.1.19. .status.platformStatus 复制链接链接已复制到粘贴板!
- 描述
- platformStatus 包含特定于底层基础架构供应商的状态信息。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| alibabacloud 包含特定于 Alibaba Cloud 基础架构供应商的设置。 |
|
| AWS 包含特定于 Amazon Web Services 基础架构供应商的设置。 |
|
| Azure 包含特定于 Azure 基础架构供应商的设置。 |
|
| baremetal 包含特定于 BareMetal 平台的设置。 |
|
| equinixMetal 包含特定于 Equinix Metal 基础架构供应商的设置。 |
|
| GCP 包含特定于 Google Cloud Platform 基础架构供应商的设置。 |
|
| ibmcloud 包含特定于 IBMCloud 基础架构供应商的设置。 |
|
| kubevirt 包含特定于 kubevirt 基础架构供应商的设置。 |
|
| OpenStack 包含特定于 OpenStack 基础架构供应商的设置。 |
|
| oVirt 包含特定于 oVirt 基础架构供应商的设置。 |
|
| powervs 包含特定于 Power Systems Virtual Servers 基础架构供应商的设置。 |
|
|
type 是集群的底层基础架构供应商。这个值控制基础架构自动化,如服务负载均衡器、动态卷置备、机器创建和删除和其他集成。如果 None,则不会启用基础架构自动化。允许的值有 "AWS", "Azure", "BareMetal", "GCP", "Libvirt", "OpenStack", "VSphere", "oVirt", "EquinixMetal", "PowerVS", "AlibabaCloud" 和 "None"。独立组件可能不支持所有平台,如果不支持该平台,则必须将未识别的平台处理为 None。这个值将与 |
|
| vSphere 包含特定于 VSphere 基础架构供应商的设置。 |
8.13.1.20. .status.platformStatus.alibabaCloud 复制链接链接已复制到粘贴板!
- 描述
- alibabacloud 包含特定于 Alibaba Cloud 基础架构供应商的设置。
- 类型
-
对象
- 必填
-
region
-
resourceGroupID
-
属性 | 类型 | 描述 |
---|---|---|
|
| region 指定为集群创建的 Alibaba 云资源的区域。 |
|
| resourceGroupID 是集群的资源组的 ID。 |
|
| resourceTags 是应用于为集群创建的 Alibaba Cloud 资源的额外标签列表。 |
|
| AlibabaCloudResourceTag 是要添加的一组标签以应用到资源。 |
- 描述
- resourceTags 是应用于为集群创建的 Alibaba Cloud 资源的额外标签列表。
- 类型
-
array
- 描述
- AlibabaCloudResourceTag 是要添加的一组标签以应用到资源。
- 类型
-
对象
- 必填
-
key
-
value
-
属性 | 类型 | 描述 |
---|---|---|
|
| key 是标签的密钥。 |
|
| value 是标签值。 |
8.13.1.23. .status.platformStatus.aws 复制链接链接已复制到粘贴板!
- 描述
- AWS 包含特定于 Amazon Web Services 基础架构供应商的设置。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| 区域包含集群创建的新 AWS 资源的默认 AWS 区域。 |
|
| resourceTags 是应用于为集群创建的 AWS 资源的额外标签列表。有关标记 AWS 资源的信息,请参阅 https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html。AWS 支持每个资源最多 50 个标签。OpenShift 保留 25 个标签供用户使用,保留 25 个标签供用户使用。 |
|
| AWSResourceTag 是一个标签,可应用到集群的 AWS 资源。 |
|
| serviceEndpoints 列表包含自定义端点,该端点将覆盖 AWS 服务的默认服务端点。服务必须只有一个 ServiceEndpoint。 |
|
| AWSServiceEndpoint 存储自定义 url 的配置,以覆盖 AWS 服务的现有默认值。 |
8.13.1.24. .status.platformStatus.aws.resourceTags 复制链接链接已复制到粘贴板!
- 描述
- resourceTags 是应用于为集群创建的 AWS 资源的额外标签列表。有关标记 AWS 资源的信息,请参阅 https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html。AWS 支持每个资源最多 50 个标签。OpenShift 保留 25 个标签供用户使用,保留 25 个标签供用户使用。
- 类型
-
array
8.13.1.25. .status.platformStatus.aws.resourceTags[] 复制链接链接已复制到粘贴板!
- 描述
- AWSResourceTag 是一个标签,可应用到集群的 AWS 资源。
- 类型
-
对象
- 必填
-
key
-
value
-
属性 | 类型 | 描述 |
---|---|---|
|
| key 是标签的密钥 |
|
| value 是标签值。有些 AWS 服务不支持空值。由于标签添加到许多服务中的资源,标签值的长度必须满足所有服务的要求。 |
8.13.1.26. .status.platformStatus.aws.serviceEndpoints 复制链接链接已复制到粘贴板!
- 描述
- serviceEndpoints 列表包含自定义端点,该端点将覆盖 AWS 服务的默认服务端点。服务必须只有一个 ServiceEndpoint。
- 类型
-
array
8.13.1.27. .status.platformStatus.aws.serviceEndpoints[] 复制链接链接已复制到粘贴板!
- 描述
- AWSServiceEndpoint 存储自定义 url 的配置,以覆盖 AWS 服务的现有默认值。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| name 是 AWS 服务的名称。所有服务名称的列表都可在 https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html 中找到,必须提供它,且不能为空。 |
|
| URL 是带有方案 https 的完全限定 URI,可覆盖客户端生成的默认端点。必须提供此功能,且不能为空。 |
8.13.1.28. .status.platformStatus.azure 复制链接链接已复制到粘贴板!
- 描述
- Azure 包含特定于 Azure 基础架构供应商的设置。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| armEndpoint 指定用于在非外云(如 Azure Stack)中进行资源管理的 URL。 |
|
|
cloudName 是 Azure 云环境的名称,可用于使用适当的 Azure API 端点配置 Azure SDK。如果为空,则该值等于 |
|
| networkResourceGroupName 是网络资源的资源组,如集群使用的虚拟网络和子网。如果为空,则值与 ResourceGroupName 相同。 |
|
| resourceGroupName 是为集群创建的新 Azure 资源的 Resource Group。 |
8.13.1.29. .status.platformStatus.baremetal 复制链接链接已复制到粘贴板!
- 描述
- baremetal 包含特定于 BareMetal 平台的设置。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| apiServerInternalIP 是一个 IP 地址,用于联系集群中的组件可以使用的 Kubernetes API 服务器,如使用基础架构而不是 Kubernetes 网络的 kubelet。它是 Infrastructure.status.apiServerInternalURI 指向的 IP。它是 API 服务器前面的自托管负载均衡器的 IP。 |
|
| ingressIP 是一个外部 IP,路由到默认入口控制器。IP 是通配符 DNS 记录的合适的目标,用于解析默认路由主机名。 |
|
|
nodeDNSIP 是节点使用的内部 DNS 的 IP 地址。与 DNS 操作器管理不同, |
8.13.1.30. .status.platformStatus.equinixMetal 复制链接链接已复制到粘贴板!
- 描述
- equinixMetal 包含特定于 Equinix Metal 基础架构供应商的设置。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| apiServerInternalIP 是一个 IP 地址,用于联系集群中的组件可以使用的 Kubernetes API 服务器,如使用基础架构而不是 Kubernetes 网络的 kubelet。它是 Infrastructure.status.apiServerInternalURI 指向的 IP。它是 API 服务器前面的自托管负载均衡器的 IP。 |
|
| ingressIP 是一个外部 IP,路由到默认入口控制器。IP 是通配符 DNS 记录的合适的目标,用于解析默认路由主机名。 |
8.13.1.31. .status.platformStatus.gcp 复制链接链接已复制到粘贴板!
- 描述
- GCP 包含特定于 Google Cloud Platform 基础架构供应商的设置。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| resourceGroupName 是为集群创建的新 GCP 资源的项目 ID。 |
|
| 区域包含为集群创建的新 GCP 资源的区域。 |
8.13.1.32. .status.platformStatus.ibmcloud 复制链接链接已复制到粘贴板!
- 描述
- ibmcloud 包含特定于 IBMCloud 基础架构供应商的设置。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| CISInstanceCRN 是 Cloud Internet Services 实例的 CRN,管理集群基域的 DNS 区域 |
|
| 位置是部署集群的位置 |
|
| ProviderType 表示所创建的集群类型 |
|
| resourceGroupName 是为集群创建的新 IBMCloud 资源的资源组。 |
8.13.1.33. .status.platformStatus.kubevirt 复制链接链接已复制到粘贴板!
- 描述
- kubevirt 包含特定于 kubevirt 基础架构供应商的设置。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| apiServerInternalIP 是一个 IP 地址,用于联系集群中的组件可以使用的 Kubernetes API 服务器,如使用基础架构而不是 Kubernetes 网络的 kubelet。它是 Infrastructure.status.apiServerInternalURI 指向的 IP。它是 API 服务器前面的自托管负载均衡器的 IP。 |
|
| ingressIP 是一个外部 IP,路由到默认入口控制器。IP 是通配符 DNS 记录的合适的目标,用于解析默认路由主机名。 |
8.13.1.34. .status.platformStatus.openstack 复制链接链接已复制到粘贴板!
- 描述
- OpenStack 包含特定于 OpenStack 基础架构供应商的设置。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| apiServerInternalIP 是一个 IP 地址,用于联系集群中的组件可以使用的 Kubernetes API 服务器,如使用基础架构而不是 Kubernetes 网络的 kubelet。它是 Infrastructure.status.apiServerInternalURI 指向的 IP。它是 API 服务器前面的自托管负载均衡器的 IP。 |
|
|
cloudName 是客户端配置文件( |
|
| ingressIP 是一个外部 IP,路由到默认入口控制器。IP 是通配符 DNS 记录的合适的目标,用于解析默认路由主机名。 |
|
|
nodeDNSIP 是节点使用的内部 DNS 的 IP 地址。与 DNS 操作器管理不同, |
8.13.1.35. .status.platformStatus.ovirt 复制链接链接已复制到粘贴板!
- 描述
- oVirt 包含特定于 oVirt 基础架构供应商的设置。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| apiServerInternalIP 是一个 IP 地址,用于联系集群中的组件可以使用的 Kubernetes API 服务器,如使用基础架构而不是 Kubernetes 网络的 kubelet。它是 Infrastructure.status.apiServerInternalURI 指向的 IP。它是 API 服务器前面的自托管负载均衡器的 IP。 |
|
| ingressIP 是一个外部 IP,路由到默认入口控制器。IP 是通配符 DNS 记录的合适的目标,用于解析默认路由主机名。 |
|
| 弃用:从 4.6 开始,不再设置或遵守此字段。它将在以后的发行版本中被删除。 |
8.13.1.36. .status.platformStatus.powervs 复制链接链接已复制到粘贴板!
- 描述
- powervs 包含特定于 Power Systems Virtual Servers 基础架构供应商的设置。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| CISInstanceCRN 是 Cloud Internet Services 实例的 CRN,管理集群基域的 DNS 区域 |
|
| 区域包含集群创建的新 Power VS 资源的默认 Power VS 区域。 |
|
| serviceEndpoints 是自定义端点的列表,将覆盖 Power VS 服务的默认服务端点。 |
|
| PowervsServiceEndpoint 存储自定义 url 的配置,以覆盖现有 PowerVS Services 默认值。 |
|
| zone 包含集群创建的新 Power VS 资源的默认区域。注: 目前只支持单区 OCP 集群 |
- 描述
- serviceEndpoints 是自定义端点的列表,将覆盖 Power VS 服务的默认服务端点。
- 类型
-
array
- 描述
- PowervsServiceEndpoint 存储自定义 url 的配置,以覆盖现有 PowerVS Services 默认值。
- 类型
-
对象
- 必填
-
name
-
url
-
属性 | 类型 | 描述 |
---|---|---|
|
| name 是 Power VS 服务的名称。 |
|
| URL 是带有方案 https 的完全限定 URI,可覆盖客户端生成的默认端点。必须提供此功能,且不能为空。 |
8.13.1.39. .status.platformStatus.vsphere 复制链接链接已复制到粘贴板!
- 描述
- vSphere 包含特定于 VSphere 基础架构供应商的设置。
- 类型
-
对象
属性 | 类型 | 描述 |
---|---|---|
|
| apiServerInternalIP 是一个 IP 地址,用于联系集群中的组件可以使用的 Kubernetes API 服务器,如使用基础架构而不是 Kubernetes 网络的 kubelet。它是 Infrastructure.status.apiServerInternalURI 指向的 IP。它是 API 服务器前面的自托管负载均衡器的 IP。 |
|
| ingressIP 是一个外部 IP,路由到默认入口控制器。IP 是通配符 DNS 记录的合适的目标,用于解析默认路由主机名。 |
|
|
nodeDNSIP 是节点使用的内部 DNS 的 IP 地址。与 DNS 操作器管理不同, |
8.13.2. API 端点 复制链接链接已复制到粘贴板!
可用的 API 端点如下:
/apis/config.openshift.io/v1/infrastructures
-
DELETE
:删除基础架构的集合 -
GET
: 列出基础架构类型的对象 -
POST
:创建基础架构
-
/apis/config.openshift.io/v1/infrastructures/{name}
-
DELETE
:删除基础架构 -
GET
:读取指定的基础架构 -
PATCH
:部分更新指定的基础架构 -
PUT
:替换指定的基础架构
-
/apis/config.openshift.io/v1/infrastructures/{name}/status
-
GET
: 指定基础架构的读取状态 -
PATCH
:部分更新指定基础架构的状态 -
PUT
: 替换指定基础架构的状态
-
8.13.2.1. /apis/config.openshift.io/v1/infrastructures 复制链接链接已复制到粘贴板!
参数 | 类型 | 描述 |
---|---|---|
|
| 如果 'true',则输出被用户友善。 |
- HTTP 方法
-
DELETE
- 描述
- 删除基础架构集合
参数 | 类型 | 描述 |
---|---|---|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。 |
|
| 从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。 当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。 |
|
| 用于限制返回的对象列表的选择器。默认为任何内容。 |
|
| 通过标签限制返回的对象列表的选择器。默认为任何内容。 |
|
| 限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。 服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。 |
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
| resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
| list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。 |
|
| 观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。 |
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
401 - Unauthorized | 空 |
- HTTP 方法
-
GET
- 描述
- 列出基础架构的对象
参数 | 类型 | 描述 |
---|---|---|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。 |
|
| 从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。 当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。 |
|
| 用于限制返回的对象列表的选择器。默认为任何内容。 |
|
| 通过标签限制返回的对象列表的选择器。默认为任何内容。 |
|
| 限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。 服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。 |
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
| resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
| list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。 |
|
| 观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。 |
HTTP 代码 | 响应正文 |
---|---|
200 - OK | |
401 - Unauthorized | 空 |
- HTTP 方法
-
POST
- 描述
- 创建基础架构
参数 | 类型 | 描述 |
---|---|---|
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
参数 | 类型 | 描述 |
---|---|---|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK | |
201 - Created | |
202 - Accepted | |
401 - Unauthorized | 空 |
参数 | 类型 | 描述 |
---|---|---|
|
| 基础架构的名称 |
参数 | 类型 | 描述 |
---|---|---|
|
| 如果 'true',则输出被用户友善。 |
- HTTP 方法
-
DELETE
- 描述
- 删除基础架构
参数 | 类型 | 描述 |
---|---|---|
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| 应该删除对象前的持续时间(以秒为单位)。值必须是非负整数。值零表示立即删除。如果这个值是 nil,则使用指定类型的默认宽限期。如果没有指定,则默认为每个对象值。零表示立即删除。 |
|
| 弃用:请使用 PropagationPolicy,此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false,"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy,但不能同时设置两者。 |
|
| 是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置,但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为: 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系; 'Foreground' - 一个删除前台所有依赖的级联策略。 |
参数 | 类型 | 描述 |
---|---|---|
|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | 空 |
- HTTP 方法
-
GET
- 描述
- 读取指定的基础架构
参数 | 类型 | 描述 |
---|---|---|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
HTTP 代码 | 响应正文 |
---|---|
200 - OK | |
401 - Unauthorized | 空 |
- HTTP 方法
-
PATCH
- 描述
- 部分更新指定的基础架构
参数 | 类型 | 描述 |
---|---|---|
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
参数 | 类型 | 描述 |
---|---|---|
|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK | |
401 - Unauthorized | 空 |
- HTTP 方法
-
PUT
- 描述
- 替换指定的基础架构
参数 | 类型 | 描述 |
---|---|---|
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
参数 | 类型 | 描述 |
---|---|---|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK | |
201 - Created | |
401 - Unauthorized | 空 |
参数 | 类型 | 描述 |
---|---|---|
|
| 基础架构的名称 |
参数 | 类型 | 描述 |
---|---|---|
|
| 如果 'true',则输出被用户友善。 |
- HTTP 方法
-
GET
- 描述
- 指定基础架构的读取状态
参数 | 类型 | 描述 |
---|---|---|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
HTTP 代码 | 响应正文 |
---|---|
200 - OK | |
401 - Unauthorized | 空 |
- HTTP 方法
-
PATCH
- 描述
- 指定基础架构的部分更新状态
参数 | 类型 | 描述 |
---|---|---|
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
参数 | 类型 | 描述 |
---|---|---|
|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK | |
401 - Unauthorized | 空 |
- HTTP 方法
-
PUT
- 描述
- 替换指定基础架构的状态
参数 | 类型 | 描述 |
---|---|---|
|
| 出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理 |
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
参数 | 类型 | 描述 |
---|---|---|
|
HTTP 代码 | 响应正文 |
---|---|
200 - OK | |
201 - Created | |
401 - Unauthorized | 空 |