Merge pull request #27020 from jboxman/ocp-apis-46

Update API reference docs

Author: jboxman

_topic_map.yml

@@ -1808,6 +1808,8 @@ Topics:
     File: dns-config-openshift-io-v1
   - Name: 'FeatureGate [config.openshift.io/v1]'
     File: featuregate-config-openshift-io-v1
+  - Name: 'HelmChartRepository [helm.openshift.io/v1beta1]'
+    File: helmchartrepository-helm-openshift-io-v1beta1
   - Name: 'Image [config.openshift.io/v1]'
     File: image-config-openshift-io-v1
   - Name: 'Infrastructure [config.openshift.io/v1]'
@@ -1909,8 +1911,8 @@ Topics:
     File: configmap-core-v1
   - Name: 'ControllerRevision [apps/v1]'
     File: controllerrevision-apps-v1
-  - Name: 'Event [events.k8s.io/v1beta1]'
-    File: event-events-k8s-io-v1beta1
+  - Name: 'Event [events.k8s.io/v1]'
+    File: event-events-k8s-io-v1
   - Name: 'Event [core/v1]'
     File: event-core-v1
   - Name: 'Lease [coordination.k8s.io/v1]'
@@ -1926,6 +1928,8 @@ Topics:
     File: alertmanager-monitoring-coreos-com-v1
   - Name: 'PodMonitor [monitoring.coreos.com/v1]'
     File: podmonitor-monitoring-coreos-com-v1
+  - Name: 'Probe [monitoring.coreos.com/v1]'
+    File: probe-monitoring-coreos-com-v1
   - Name: 'Prometheus [monitoring.coreos.com/v1]'
     File: prometheus-monitoring-coreos-com-v1
   - Name: 'PrometheusRule [monitoring.coreos.com/v1]'
@@ -1949,10 +1953,12 @@ Topics:
     File: egressnetworkpolicy-network-openshift-io-v1
   - Name: 'HostSubnet [network.openshift.io/v1]'
     File: hostsubnet-network-openshift-io-v1
-  - Name: 'Ingress [networking.k8s.io/v1beta1]'
-    File: ingress-networking-k8s-io-v1beta1
-  - Name: 'IngressClass [networking.k8s.io/v1beta1]'
-    File: ingressclass-networking-k8s-io-v1beta1
+  - Name: 'Ingress [networking.k8s.io/v1]'
+    File: ingress-networking-k8s-io-v1
+  - Name: 'IngressClass [networking.k8s.io/v1]'
+    File: ingressclass-networking-k8s-io-v1
+  - Name: 'IPPool [whereabouts.cni.cncf.io/v1alpha1]'
+    File: ippool-whereabouts-cni-cncf-io-v1alpha1
   - Name: 'NetNamespace [network.openshift.io/v1]'
     File: netnamespace-network-openshift-io-v1
   - Name: 'NetworkAttachmentDefinition [k8s.cni.cncf.io/v1]'
@@ -1996,6 +2002,10 @@ Topics:
     File: operator-apis-index
   - Name: 'Authentication [operator.openshift.io/v1]'
     File: authentication-operator-openshift-io-v1
+  - Name: 'CloudCredential [operator.openshift.io/v1]'
+    File: cloudcredential-operator-openshift-io-v1
+  - Name: 'ClusterCSIDriver [operator.openshift.io/v1]'
+    File: clustercsidriver-operator-openshift-io-v1
   - Name: 'Console [operator.openshift.io/v1]'
     File: console-operator-openshift-io-v1
   - Name: 'Config [operator.openshift.io/v1]'
@@ -2032,8 +2042,12 @@ Topics:
     File: openshiftapiserver-operator-openshift-io-v1
   - Name: 'OpenShiftControllerManager [operator.openshift.io/v1]'
     File: openshiftcontrollermanager-operator-openshift-io-v1
+  - Name: 'OperatorPKI [network.operator.openshift.io/v1]'
+    File: operatorpki-network-operator-openshift-io-v1
   - Name: 'ServiceCA [operator.openshift.io/v1]'
     File: serviceca-operator-openshift-io-v1
+  - Name: 'Storage [operator.openshift.io/v1]'
+    File: storage-operator-openshift-io-v1
 - Name: OperatorHub APIs
   Dir: operatorhub_apis
   Topics:
@@ -2047,8 +2061,6 @@ Topics:
     File: installplan-operators-coreos-com-v1alpha1
   - Name: 'OperatorGroup [operators.coreos.com/v1]'
     File: operatorgroup-operators-coreos-com-v1
-  - Name: 'OperatorSource [operators.coreos.com/v1]'
-    File: operatorsource-operators-coreos-com-v1
   - Name: 'PackageManifest [packages.operators.coreos.com/v1]'
     File: packagemanifest-packages-operators-coreos-com-v1
   - Name: 'Subscription [operators.coreos.com/v1alpha1]'
@@ -2069,6 +2081,15 @@ Topics:
     File: project-project-openshift-io-v1
   - Name: 'ProjectRequest [project.openshift.io/v1]'
     File: projectrequest-project-openshift-io-v1
+- Name: Provisioning APIs
+  Dir: provisioning_apis
+  Topics:
+  - Name: About Provisioning APIs
+    File: provisioning-apis-index
+  - Name: 'BareMetalHost [metal3.io/v1alpha1]'
+    File: baremetalhost-metal3-io-v1alpha1
+  - Name: 'Provisioning [metal3.io/v1alpha1]'
+    File: provisioning-metal3-io-v1alpha1
 - Name: RBAC APIs
   Dir: rbac_apis
   Topics:
@@ -2106,19 +2127,23 @@ Topics:
     File: appliedclusterresourcequota-quota-openshift-io-v1
   - Name: 'ClusterResourceQuota [quota.openshift.io/v1]'
     File: clusterresourcequota-quota-openshift-io-v1
+  - Name: 'FlowSchema [flowcontrol.apiserver.k8s.io/v1alpha1]'
+    File: flowschema-flowcontrol-apiserver-k8s-io-v1alpha1
   - Name: 'LimitRange [core/v1]'
     File: limitrange-core-v1
   - Name: 'PriorityClass [scheduling.k8s.io/v1]'
     File: priorityclass-scheduling-k8s-io-v1
+  - Name: 'PriorityLevelConfiguration [flowcontrol.apiserver.k8s.io/v1alpha1]'
+    File: prioritylevelconfiguration-flowcontrol-apiserver-k8s-io-v1alpha1
   - Name: 'ResourceQuota [core/v1]'
     File: resourcequota-core-v1
 - Name: Security APIs
   Dir: security_apis
   Topics:
   - Name: About Security APIs
     File: security-apis-index
-  - Name: 'CertificateSigningRequest [certificates.k8s.io/v1beta1]'
-    File: certificatesigningrequest-certificates-k8s-io-v1beta1
+  - Name: 'CertificateSigningRequest [certificates.k8s.io/v1]'
+    File: certificatesigningrequest-certificates-k8s-io-v1
   - Name: 'CredentialsRequest [cloudcredential.openshift.io/v1]'
     File: credentialsrequest-cloudcredential-openshift-io-v1
   - Name: 'PodSecurityPolicyReview [security.openshift.io/v1]'
@@ -2148,6 +2173,10 @@ Topics:
     File: persistentvolumeclaim-core-v1
   - Name: 'StorageClass [storage.k8s.io/v1]'
     File: storageclass-storage-k8s-io-v1
+  - Name: 'StorageState [migration.k8s.io/v1alpha1]'
+    File: storagestate-migration-k8s-io-v1alpha1
+  - Name: 'StorageVersionMigration [migration.k8s.io/v1alpha1]'
+    File: storageversionmigration-migration-k8s-io-v1alpha1
   - Name: 'VolumeAttachment [storage.k8s.io/v1]'
     File: volumeattachment-storage-k8s-io-v1
   - Name: 'VolumeSnapshot [snapshot.storage.k8s.io/v1beta1]'

api-map.yaml

@@ -114,6 +114,11 @@
     version: v1
     plural: featuregates
     namespaced: false
+  - kind: HelmChartRepository
+    group: helm.openshift.io
+    version: v1beta1
+    plural: helmchartrepositories
+    namespaced: false
   - kind: Image
     group: config.openshift.io
     version: v1
@@ -316,7 +321,7 @@
     namespaced: true
   - kind: Event
     group: events.k8s.io
-    version: v1beta1
+    version: v1
     plural: events
     namespaced: true
   - kind: Event
@@ -346,6 +351,11 @@
     version: v1
     plural: podmonitors
     namespaced: true
+  - kind: Probe
+    group: monitoring.coreos.com
+    version: v1
+    plural: probes
+    namespaced: true
   - kind: Prometheus
     group: monitoring.coreos.com
     version: v1
@@ -395,14 +405,19 @@
     namespaced: false
   - kind: Ingress
     group: networking.k8s.io
-    version: v1beta1
+    version: v1
     plural: ingresses
     namespaced: true
   - kind: IngressClass
     group: networking.k8s.io
-    version: v1beta1
+    version: v1
     plural: ingressclasses
     namespaced: false
+  - kind: IPPool
+    group: whereabouts.cni.cncf.io
+    version: v1alpha1
+    plural: ippools
+    namespaced: true
   - kind: NetNamespace
     group: network.openshift.io
     version: v1
@@ -479,6 +494,16 @@
     version: v1
     plural: authentications
     namespaced: false
+  - kind: CloudCredential
+    group: operator.openshift.io
+    version: v1
+    plural: cloudcredentials
+    namespaced: false
+  - kind: ClusterCSIDriver
+    group: operator.openshift.io
+    version: v1
+    plural: clustercsidrivers
+    namespaced: false
   - kind: Console
     group: operator.openshift.io
     version: v1
@@ -569,11 +594,21 @@
     version: v1
     plural: openshiftcontrollermanagers
     namespaced: false
+  - kind: OperatorPKI
+    group: network.operator.openshift.io
+    version: v1
+    plural: operatorpkis
+    namespaced: true
   - kind: ServiceCA
     group: operator.openshift.io
     version: v1
     plural: servicecas
     namespaced: false
+  - kind: Storage
+    group: operator.openshift.io
+    version: v1
+    plural: storages
+    namespaced: false
 - name: OperatorHub APIs
   resources:
   - kind: CatalogSource
@@ -596,11 +631,6 @@
     version: v1
     plural: operatorgroups
     namespaced: true
-  - kind: OperatorSource
-    group: operators.coreos.com
-    version: v1
-    plural: operatorsources
-    namespaced: true
   - kind: PackageManifest
     group: packages.operators.coreos.com
     version: v1
@@ -636,6 +666,18 @@
     version: v1
     plural: projectrequests
     namespaced: false
+- name: Provisioning APIs
+  resources:
+  - kind: BareMetalHost
+    group: metal3.io
+    version: v1alpha1
+    plural: baremetalhosts
+    namespaced: true
+  - kind: Provisioning
+    group: metal3.io
+    version: v1alpha1
+    plural: provisionings
+    namespaced: false
 - name: RBAC APIs
   resources:
   - kind: ClusterRoleBinding
@@ -697,6 +739,11 @@
     version: v1
     plural: clusterresourcequotas
     namespaced: false
+  - kind: FlowSchema
+    group: flowcontrol.apiserver.k8s.io
+    version: v1alpha1
+    plural: flowschemas
+    namespaced: false
   - kind: LimitRange
     group: core
     version: v1
@@ -707,6 +754,11 @@
     version: v1
     plural: priorityclasses
     namespaced: false
+  - kind: PriorityLevelConfiguration
+    group: flowcontrol.apiserver.k8s.io
+    version: v1alpha1
+    plural: prioritylevelconfigurations
+    namespaced: false
   - kind: ResourceQuota
     group: core
     version: v1
@@ -716,7 +768,7 @@
   resources:
   - kind: CertificateSigningRequest
     group: certificates.k8s.io
-    version: v1beta1
+    version: v1
     plural: certificatesigningrequests
     namespaced: false
   - kind: CredentialsRequest
@@ -781,6 +833,16 @@
     version: v1
     plural: storageclasses
     namespaced: false
+  - kind: StorageState
+    group: migration.k8s.io
+    version: v1alpha1
+    plural: storagestates
+    namespaced: false
+  - kind: StorageVersionMigration
+    group: migration.k8s.io
+    version: v1alpha1
+    plural: storageversionmigrations
+    namespaced: false
   - kind: VolumeAttachment
     group: storage.k8s.io
     version: v1
@@ -909,25 +971,8 @@
     namespaced: true
 
 # No properties defined in OpenAPI spec
-#  - kind: OperatorPKI
-#    group: network.operator.openshift.io
-#    version: v1
-#  - kind: IPPool
+#  - kind: OverlappingRangeIPReservation
 #    group: whereabouts.cni.cncf.io
 #    version: v1alpha1
-#- name: migration.k8s.io
-#  resources:
-#  - kind: StorageState
-#    group: migration.k8s.io
-#    version: v1alpha1
-#  - kind: StorageVersionMigration
-#    group: migration.k8s.io
-#    version: v1alpha1
-#- name: metal3.io
-#  resources:
-#  - kind: BareMetalHost
-#    group: metal3.io
-#    version: v1alpha1
-#  - kind: Provisioning
-#    group: metal3.io
-#    version: v1alpha1
+#    plural: overlappingrangeipreservations
+#    namespaced: true

rest_api/authorization_apis/authorization-apis-index.adoc

@@ -73,15 +73,15 @@ Type::
 == SelfSubjectAccessReview [authorization.k8s.io/v1]
 
 Description::
-  SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a spec.namespace means "in all namespaces".  Self is a special case, because users should always be able to check whether they can perform an action
+  SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a spec.namespace means "in all namespaces".  Self is a special case, because users should always be able to check whether they can perform an action
 
 Type::
   `object`
 
 == SelfSubjectRulesReview [authorization.k8s.io/v1]
 
 Description::
-  SelfSubjectRulesReview enumerates the set of actions the current user can perform within a namespace. The returned list of actions may be incomplete depending on the server's authorization mode, and any errors experienced during the evaluation. SelfSubjectRulesReview should be used by UIs to show/hide actions, or to quickly let an end user reason about their permissions. It should NOT Be used by external systems to drive authorization decisions as this raises confused deputy, cache lifetime/revocation, and correctness concerns. SubjectAccessReview, and LocalAccessReview are the correct way to defer authorization decisions to the API server.
+  SelfSubjectRulesReview enumerates the set of actions the current user can perform within a namespace. The returned list of actions may be incomplete depending on the server's authorization mode, and any errors experienced during the evaluation. SelfSubjectRulesReview should be used by UIs to show/hide actions, or to quickly let an end user reason about their permissions. It should NOT Be used by external systems to drive authorization decisions as this raises confused deputy, cache lifetime/revocation, and correctness concerns. SubjectAccessReview, and LocalAccessReview are the correct way to defer authorization decisions to the API server.
 
 Type::
   `object`

rest_api/authorization_apis/selfsubjectaccessreview-authorization-k8s-io-v1.adoc

@@ -8,7 +8,7 @@ toc::[]
 
 
 Description::
-  SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a spec.namespace means "in all namespaces".  Self is a special case, because users should always be able to check whether they can perform an action
+  SelfSubjectAccessReview checks whether or the current user can perform an action.  Not filling in a spec.namespace means "in all namespaces".  Self is a special case, because users should always be able to check whether they can perform an action
 
 Type::
   `object`