// Automatically generated by 'openshift-apidocs-gen'. Do not edit.
:_mod-docs-content-type: ASSEMBLY
[id="datagather-insights-openshift-io-v1"]
= DataGather [insights.openshift.io/v1]
:toc: macro
:toc-title:

toc::[]


Description::
+
--
DataGather provides data gather configuration options and status for the particular Insights data gathering.

Compatibility level 1: Stable within a major release for a minimum of 12 months or 3 minor releases (whichever is longer).
--

Type::
  `object`

Required::
  - `spec`


== Specification

[cols="1,1,1",options="header"]
|===
| Property | Type | Description

| `apiVersion`
| `string`
| APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

| `kind`
| `string`
| Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

| `metadata`
| xref:../objects/index.adoc#io-k8s-apimachinery-pkg-apis-meta-v1-ObjectMeta[`ObjectMeta`]
| Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

| `spec`
| `object`
| spec holds user settable values for configuration

| `status`
| `object`
| status holds observed values from the cluster. They may not be overridden.

|===
=== .spec
Description::
+
--
spec holds user settable values for configuration
--

Type::
  `object`

Required::
  - `gatherers`



[cols="1,1,1",options="header"]
|===
| Property | Type | Description

| `dataPolicy`
| `array (string)`
| dataPolicy is an optional list of DataPolicyOptions that allows user to enable additional obfuscation of the Insights archive data.
It may not exceed 2 items and must not contain duplicates.
Valid values are ObfuscateNetworking and WorkloadNames.
When set to ObfuscateNetworking the IP addresses and the cluster domain name are obfuscated.
When set to WorkloadNames, the gathered data about cluster resources will not contain the workload names for your deployments. Resources UIDs will be used instead.
When omitted no obfuscation is applied.

| `gatherers`
| `object`
| gatherers is a required field that specifies the configuration of the gatherers.

| `storage`
| `object`
| storage is an optional field that allows user to define persistent storage for gathering jobs to store the Insights data archive.
If omitted, the gathering job will use ephemeral storage.

|===
=== .spec.gatherers
Description::
+
--
gatherers is a required field that specifies the configuration of the gatherers.
--

Type::
  `object`

Required::
  - `mode`



[cols="1,1,1",options="header"]
|===
| Property | Type | Description

| `custom`
| `object`
| custom provides gathering configuration.
It is required when mode is Custom, and forbidden otherwise.
Custom configuration allows user to disable only a subset of gatherers.
Gatherers that are not explicitly disabled in custom configuration will run.

| `mode`
| `string`
| mode is a required field that specifies the mode for gatherers. Allowed values are All and Custom.
When set to All, all gatherers will run and gather data.
When set to Custom, the custom configuration from the custom field will be applied.

|===
=== .spec.gatherers.custom
Description::
+
--
custom provides gathering configuration.
It is required when mode is Custom, and forbidden otherwise.
Custom configuration allows user to disable only a subset of gatherers.
Gatherers that are not explicitly disabled in custom configuration will run.
--

Type::
  `object`

Required::
  - `configs`



[cols="1,1,1",options="header"]
|===
| Property | Type | Description

| `configs`
| `array`
| configs is a required list of gatherers configurations that can be used to enable or disable specific gatherers.
It may not exceed 100 items and each gatherer can be present only once.
It is possible to disable an entire set of gatherers while allowing a specific function within that set.
The particular gatherers IDs can be found at https://github.com/openshift/insights-operator/blob/master/docs/gathered-data.md.
Run the following command to get the names of last active gatherers:
"oc get insightsoperators.operator.openshift.io cluster -o json \| jq '.status.gatherStatus.gatherers[].name'"

| `configs[]`
| `object`
| GathererConfig allows to configure specific gatherers

|===
=== .spec.gatherers.custom.configs
Description::
+
--
configs is a required list of gatherers configurations that can be used to enable or disable specific gatherers.
It may not exceed 100 items and each gatherer can be present only once.
It is possible to disable an entire set of gatherers while allowing a specific function within that set.
The particular gatherers IDs can be found at https://github.com/openshift/insights-operator/blob/master/docs/gathered-data.md.
Run the following command to get the names of last active gatherers:
"oc get insightsoperators.operator.openshift.io cluster -o json \| jq '.status.gatherStatus.gatherers[].name'"
--

Type::
  `array`




=== .spec.gatherers.custom.configs[]
Description::
+
--
GathererConfig allows to configure specific gatherers
--

Type::
  `object`

Required::
  - `name`
  - `state`



[cols="1,1,1",options="header"]
|===
| Property | Type | Description

| `name`
| `string`
| name is the required name of a specific gatherer.
It may not exceed 256 characters.
The format for a gatherer name is: {gatherer}/{function} where the function is optional.
Gatherer consists of a lowercase letters only that may include underscores (_).
Function consists of a lowercase letters only that may include underscores (_) and is separated from the gatherer by a forward slash (/).
The particular gatherers can be found at https://github.com/openshift/insights-operator/blob/master/docs/gathered-data.md.
Run the following command to get the names of last active gatherers:
"oc get insightsoperators.operator.openshift.io cluster -o json \| jq '.status.gatherStatus.gatherers[].name'"

| `state`
| `string`
| state is a required field that allows you to configure specific gatherer. Valid values are "Enabled" and "Disabled".
When set to Enabled the gatherer will run.
When set to Disabled the gatherer will not run.

|===
=== .spec.storage
Description::
+
--
storage is an optional field that allows user to define persistent storage for gathering jobs to store the Insights data archive.
If omitted, the gathering job will use ephemeral storage.
--

Type::
  `object`

Required::
  - `type`



[cols="1,1,1",options="header"]
|===
| Property | Type | Description

| `persistentVolume`
| `object`
| persistentVolume is an optional field that specifies the PersistentVolume that will be used to store the Insights data archive.
The PersistentVolume must be created in the openshift-insights namespace.

| `type`
| `string`
| type is a required field that specifies the type of storage that will be used to store the Insights data archive.
Valid values are "PersistentVolume" and "Ephemeral".
When set to Ephemeral, the Insights data archive is stored in the ephemeral storage of the gathering job.
When set to PersistentVolume, the Insights data archive is stored in the PersistentVolume that is
defined by the PersistentVolume field.

|===
=== .spec.storage.persistentVolume
Description::
+
--
persistentVolume is an optional field that specifies the PersistentVolume that will be used to store the Insights data archive.
The PersistentVolume must be created in the openshift-insights namespace.
--

Type::
  `object`

Required::
  - `claim`



[cols="1,1,1",options="header"]
|===
| Property | Type | Description

| `claim`
| `object`
| claim is a required field that specifies the configuration of the PersistentVolumeClaim that will be used to store the Insights data archive.
The PersistentVolumeClaim must be created in the openshift-insights namespace.

| `mountPath`
| `string`
| mountPath is an optional field specifying the directory where the PVC will be mounted inside the Insights data gathering Pod.
When omitted, this means no opinion and the platform is left to choose a reasonable default, which is subject to change over time.
The current default mount path is /var/lib/insights-operator
The path may not exceed 1024 characters and must not contain a colon.

|===
=== .spec.storage.persistentVolume.claim
Description::
+
--
claim is a required field that specifies the configuration of the PersistentVolumeClaim that will be used to store the Insights data archive.
The PersistentVolumeClaim must be created in the openshift-insights namespace.
--

Type::
  `object`

Required::
  - `name`



[cols="1,1,1",options="header"]
|===
| Property | Type | Description

| `name`
| `string`
| name is the name of the PersistentVolumeClaim that will be used to store the Insights data archive.
It is a string that follows the DNS1123 subdomain format.
It must be at most 253 characters in length, and must consist only of lower case alphanumeric characters, '-' and '.', and must start and end with an alphanumeric character.

|===
=== .status
Description::
+
--
status holds observed values from the cluster. They may not be overridden.
--

Type::
  `object`




[cols="1,1,1",options="header"]
|===
| Property | Type | Description

| `conditions`
| `array`
| conditions is an optional field that provides details on the status of the gatherer job.
It may not exceed 100 items and must not contain duplicates.

The current condition types are DataUploaded, DataRecorded, DataProcessed, RemoteConfigurationNotAvailable, RemoteConfigurationInvalid

The DataUploaded condition is used to represent whether or not the archive was successfully uploaded for further processing.
When it has a status of True and a reason of Succeeded, the archive was successfully uploaded.
When it has a status of Unknown and a reason of NoUploadYet, the upload has not occurred, or there was no data to upload.
When it has a status of False and a reason Failed, the upload failed. The accompanying message will include the specific error encountered.

The DataRecorded condition is used to represent whether or not the archive was successfully recorded.
When it has a status of True and a reason of Succeeded, the archive was recorded successfully.
When it has a status of Unknown and a reason of NoDataGatheringYet, the data gathering process has not started yet.
When it has a status of False and a reason of RecordingFailed, the recording failed and a message will include the specific error encountered.

The DataProcessed condition is used to represent whether or not the archive was processed by the processing service.
When it has a status of True and a reason of Processed, the data was processed successfully.
When it has a status of Unknown and a reason of NothingToProcessYet, there is no data to process at the moment.
When it has a status of False and a reason of Failure, processing failed and a message will include the specific error encountered.

The RemoteConfigurationAvailable condition is used to represent whether the remote configuration is available.
When it has a status of Unknown and a reason of Unknown or RemoteConfigNotRequestedYet, the state of the remote configuration is unknown—typically at startup.
When it has a status of True and a reason of Succeeded, the configuration is available.
When it has a status of False and a reason of NoToken, the configuration was disabled by removing the cloud.openshift.com field from the pull secret.
When it has a status of False and a reason of DisabledByConfiguration, the configuration was disabled in insightsdatagather.config.openshift.io.

The RemoteConfigurationValid condition is used to represent whether the remote configuration is valid.
When it has a status of Unknown and a reason of Unknown or NoValidationYet, the validity of the remote configuration is unknown—typically at startup.
When it has a status of True and a reason of Succeeded, the configuration is valid.
When it has a status of False and a reason of Invalid, the configuration is invalid.

The Progressing condition is used to represent the phase of gathering
When it has a status of False and the reason is DataGatherPending, the gathering has not started yet.
When it has a status of True and reason is Gathering, the gathering is running.
When it has a status of False and reason is GatheringSucceeded, the gathering successfully finished.
When it has a status of False and reason is GatheringFailed, the gathering failed.

| `conditions[]`
| `object`
| Condition contains details for one aspect of the current state of this API Resource.

| `finishTime`
| `string`
| finishTime is the time when Insights data gathering finished.

| `gatherers`
| `array`
| gatherers is a list of active gatherers (and their statuses) in the last gathering.

| `gatherers[]`
| `object`
| GathererStatus represents information about a particular
data gatherer.

| `insightsReport`
| `object`
| insightsReport provides general Insights analysis results.
When omitted, this means no data gathering has taken place yet or the
corresponding Insights analysis (identified by "insightsRequestID") is not available.

| `insightsRequestID`
| `string`
| insightsRequestID is an optional Insights request ID to track the status of the Insights analysis (in console.redhat.com processing pipeline) for the corresponding Insights data archive.
It may not exceed 256 characters and is immutable once set.

| `relatedObjects`
| `array`
| relatedObjects is an optional list of resources which are useful when debugging or inspecting the data gathering Pod
It may not exceed 100 items and must not contain duplicates.

| `relatedObjects[]`
| `object`
| ObjectReference contains enough information to let you inspect or modify the referred object.

| `startTime`
| `string`
| startTime is the time when Insights data gathering started.

|===
=== .status.conditions
Description::
+
--
conditions is an optional field that provides details on the status of the gatherer job.
It may not exceed 100 items and must not contain duplicates.

The current condition types are DataUploaded, DataRecorded, DataProcessed, RemoteConfigurationNotAvailable, RemoteConfigurationInvalid

The DataUploaded condition is used to represent whether or not the archive was successfully uploaded for further processing.
When it has a status of True and a reason of Succeeded, the archive was successfully uploaded.
When it has a status of Unknown and a reason of NoUploadYet, the upload has not occurred, or there was no data to upload.
When it has a status of False and a reason Failed, the upload failed. The accompanying message will include the specific error encountered.

The DataRecorded condition is used to represent whether or not the archive was successfully recorded.
When it has a status of True and a reason of Succeeded, the archive was recorded successfully.
When it has a status of Unknown and a reason of NoDataGatheringYet, the data gathering process has not started yet.
When it has a status of False and a reason of RecordingFailed, the recording failed and a message will include the specific error encountered.

The DataProcessed condition is used to represent whether or not the archive was processed by the processing service.
When it has a status of True and a reason of Processed, the data was processed successfully.
When it has a status of Unknown and a reason of NothingToProcessYet, there is no data to process at the moment.
When it has a status of False and a reason of Failure, processing failed and a message will include the specific error encountered.

The RemoteConfigurationAvailable condition is used to represent whether the remote configuration is available.
When it has a status of Unknown and a reason of Unknown or RemoteConfigNotRequestedYet, the state of the remote configuration is unknown—typically at startup.
When it has a status of True and a reason of Succeeded, the configuration is available.
When it has a status of False and a reason of NoToken, the configuration was disabled by removing the cloud.openshift.com field from the pull secret.
When it has a status of False and a reason of DisabledByConfiguration, the configuration was disabled in insightsdatagather.config.openshift.io.

The RemoteConfigurationValid condition is used to represent whether the remote configuration is valid.
When it has a status of Unknown and a reason of Unknown or NoValidationYet, the validity of the remote configuration is unknown—typically at startup.
When it has a status of True and a reason of Succeeded, the configuration is valid.
When it has a status of False and a reason of Invalid, the configuration is invalid.

The Progressing condition is used to represent the phase of gathering
When it has a status of False and the reason is DataGatherPending, the gathering has not started yet.
When it has a status of True and reason is Gathering, the gathering is running.
When it has a status of False and reason is GatheringSucceeded, the gathering successfully finished.
When it has a status of False and reason is GatheringFailed, the gathering failed.
--

Type::
  `array`




=== .status.conditions[]
Description::
+
--
Condition contains details for one aspect of the current state of this API Resource.
--

Type::
  `object`

Required::
  - `lastTransitionTime`
  - `message`
  - `reason`
  - `status`
  - `type`



[cols="1,1,1",options="header"]
|===
| Property | Type | Description

| `lastTransitionTime`
| `string`
| lastTransitionTime is the last time the condition transitioned from one status to another.
This should be when the underlying condition changed.  If that is not known, then using the time when the API field changed is acceptable.

| `message`
| `string`
| message is a human readable message indicating details about the transition.
This may be an empty string.

| `observedGeneration`
| `integer`
| observedGeneration represents the .metadata.generation that the condition was set based upon.
For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
with respect to the current state of the instance.

| `reason`
| `string`
| reason contains a programmatic identifier indicating the reason for the condition's last transition.
Producers of specific condition types may define expected values and meanings for this field,
and whether the values are considered a guaranteed API.
The value should be a CamelCase string.
This field may not be empty.

| `status`
| `string`
| status of the condition, one of True, False, Unknown.

| `type`
| `string`
| type of condition in CamelCase or in foo.example.com/CamelCase.

|===
=== .status.gatherers
Description::
+
--
gatherers is a list of active gatherers (and their statuses) in the last gathering.
--

Type::
  `array`




=== .status.gatherers[]
Description::
+
--
GathererStatus represents information about a particular
data gatherer.
--

Type::
  `object`

Required::
  - `lastGatherSeconds`
  - `name`



[cols="1,1,1",options="header"]
|===
| Property | Type | Description

| `conditions`
| `array`
| conditions provide details on the status of each gatherer.

The current condition type is DataGathered

The DataGathered condition is used to represent whether or not the data was gathered by a gatherer specified by name.
When it has a status of True and a reason of GatheredOK, the data has been successfully gathered as expected.
When it has a status of False and a reason of NoData, no data was gathered—for example, when the resource is not present in the cluster.
When it has a status of False and a reason of GatherError, an error occurred and no data was gathered.
When it has a status of False and a reason of GatherPanic, a panic occurred during gathering and no data was collected.
When it has a status of False and a reason of GatherWithErrorReason, data was partially gathered or gathered with an error message.

| `conditions[]`
| `object`
| Condition contains details for one aspect of the current state of this API Resource.

| `lastGatherSeconds`
| `integer`
| lastGatherSeconds is required field that represents the time spent gathering in seconds

| `name`
| `string`
| name is the required name of the gatherer.
It must contain at least 5 characters and may not exceed 256 characters.

|===
=== .status.gatherers[].conditions
Description::
+
--
conditions provide details on the status of each gatherer.

The current condition type is DataGathered

The DataGathered condition is used to represent whether or not the data was gathered by a gatherer specified by name.
When it has a status of True and a reason of GatheredOK, the data has been successfully gathered as expected.
When it has a status of False and a reason of NoData, no data was gathered—for example, when the resource is not present in the cluster.
When it has a status of False and a reason of GatherError, an error occurred and no data was gathered.
When it has a status of False and a reason of GatherPanic, a panic occurred during gathering and no data was collected.
When it has a status of False and a reason of GatherWithErrorReason, data was partially gathered or gathered with an error message.
--

Type::
  `array`




=== .status.gatherers[].conditions[]
Description::
+
--
Condition contains details for one aspect of the current state of this API Resource.
--

Type::
  `object`

Required::
  - `lastTransitionTime`
  - `message`
  - `reason`
  - `status`
  - `type`



[cols="1,1,1",options="header"]
|===
| Property | Type | Description

| `lastTransitionTime`
| `string`
| lastTransitionTime is the last time the condition transitioned from one status to another.
This should be when the underlying condition changed.  If that is not known, then using the time when the API field changed is acceptable.

| `message`
| `string`
| message is a human readable message indicating details about the transition.
This may be an empty string.

| `observedGeneration`
| `integer`
| observedGeneration represents the .metadata.generation that the condition was set based upon.
For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration is 9, the condition is out of date
with respect to the current state of the instance.

| `reason`
| `string`
| reason contains a programmatic identifier indicating the reason for the condition's last transition.
Producers of specific condition types may define expected values and meanings for this field,
and whether the values are considered a guaranteed API.
The value should be a CamelCase string.
This field may not be empty.

| `status`
| `string`
| status of the condition, one of True, False, Unknown.

| `type`
| `string`
| type of condition in CamelCase or in foo.example.com/CamelCase.

|===
=== .status.insightsReport
Description::
+
--
insightsReport provides general Insights analysis results.
When omitted, this means no data gathering has taken place yet or the
corresponding Insights analysis (identified by "insightsRequestID") is not available.
--

Type::
  `object`

Required::
  - `downloadedTime`
  - `uri`



[cols="1,1,1",options="header"]
|===
| Property | Type | Description

| `downloadedTime`
| `string`
| downloadedTime is a required field that specifies when the Insights report was last downloaded.

| `healthChecks`
| `array`
| healthChecks is an optional field that provides basic information about active Insights
recommendations, which serve as proactive notifications for potential issues in the cluster.
When omitted, it means that there are no active recommendations in the cluster.

| `healthChecks[]`
| `object`
| HealthCheck represents an Insights health check attributes.

| `uri`
| `string`
| uri is a required field that provides the URL link from which the report was downloaded.
The link must be a valid HTTPS URL and the maximum length is 2048 characters.

|===
=== .status.insightsReport.healthChecks
Description::
+
--
healthChecks is an optional field that provides basic information about active Insights
recommendations, which serve as proactive notifications for potential issues in the cluster.
When omitted, it means that there are no active recommendations in the cluster.
--

Type::
  `array`




=== .status.insightsReport.healthChecks[]
Description::
+
--
HealthCheck represents an Insights health check attributes.
--

Type::
  `object`

Required::
  - `advisorURI`
  - `description`
  - `totalRisk`



[cols="1,1,1",options="header"]
|===
| Property | Type | Description

| `advisorURI`
| `string`
| advisorURI is required field that provides the URL link to the Insights Advisor.
The link must be a valid HTTPS URL and the maximum length is 2048 characters.

| `description`
| `string`
| description is required field that provides basic description of the healthcheck.
It must contain at least 10 characters and may not exceed 2048 characters.

| `totalRisk`
| `string`
| totalRisk is the required field of the healthcheck.
It is indicator of the total risk posed by the detected issue; combination of impact and likelihood.
Allowed values are Low, Moderate, Important and Critical.
The value represents the severity of the issue.

|===
=== .status.relatedObjects
Description::
+
--
relatedObjects is an optional list of resources which are useful when debugging or inspecting the data gathering Pod
It may not exceed 100 items and must not contain duplicates.
--

Type::
  `array`




=== .status.relatedObjects[]
Description::
+
--
ObjectReference contains enough information to let you inspect or modify the referred object.
--

Type::
  `object`

Required::
  - `group`
  - `name`
  - `namespace`
  - `resource`



[cols="1,1,1",options="header"]
|===
| Property | Type | Description

| `group`
| `string`
| group is required field that specifies the API Group of the Resource.
Enter empty string for the core group.
This value is empty or it should follow the DNS1123 subdomain format.
It must be at most 253 characters in length, and must consist only of lower case alphanumeric characters, '-' and '.', and must start with an alphabetic character and end with an alphanumeric character.
Example: "", "apps", "build.openshift.io", etc.

| `name`
| `string`
| name is required field that specifies the referent that follows the DNS1123 subdomain format.
It must be at most 253 characters in length, and must consist only of lower case alphanumeric characters, '-' and '.', and must start with an alphabetic character and end with an alphanumeric character..

| `namespace`
| `string`
| namespace if required field of the referent that follows the DNS1123 labels format.
It must be at most 63 characters in length, and must must consist of only lowercase alphanumeric characters and hyphens, and must start with an alphabetic character and end with an alphanumeric character.

| `resource`
| `string`
| resource is required field of the type that is being referenced and follows the DNS1035 format.
It is normally the plural form of the resource kind in lowercase.
It must be at most 63 characters in length, and must must consist of only lowercase alphanumeric characters and hyphens, and must start with an alphabetic character and end with an alphanumeric character.
Example: "deployments", "deploymentconfigs", "pods", etc.

|===

== API endpoints

The following API endpoints are available:

* `/apis/insights.openshift.io/v1/datagathers`
- `DELETE`: delete collection of DataGather
- `GET`: list objects of kind DataGather
- `POST`: create a DataGather
* `/apis/insights.openshift.io/v1/datagathers/{name}`
- `DELETE`: delete a DataGather
- `GET`: read the specified DataGather
- `PATCH`: partially update the specified DataGather
- `PUT`: replace the specified DataGather
* `/apis/insights.openshift.io/v1/datagathers/{name}/status`
- `GET`: read status of the specified DataGather
- `PATCH`: partially update status of the specified DataGather
- `PUT`: replace status of the specified DataGather


=== /apis/insights.openshift.io/v1/datagathers



HTTP method::
  `DELETE`

Description::
  delete collection of DataGather




.HTTP responses
[cols="1,1",options="header"]
|===
| HTTP code | Reponse body
| 200 - OK
| xref:../objects/index.adoc#io-k8s-apimachinery-pkg-apis-meta-v1-Status[`Status`] schema
| 401 - Unauthorized
| Empty
|===

HTTP method::
  `GET`

Description::
  list objects of kind DataGather




.HTTP responses
[cols="1,1",options="header"]
|===
| HTTP code | Reponse body
| 200 - OK
| xref:../objects/index.adoc#io-openshift-insights-v1-DataGatherList[`DataGatherList`] schema
| 401 - Unauthorized
| Empty
|===

HTTP method::
  `POST`

Description::
  create a DataGather


.Query parameters
[cols="1,1,2",options="header"]
|===
| Parameter | Type | Description
| `dryRun`
| `string`
| When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
| `fieldValidation`
| `string`
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered.
|===

.Body parameters
[cols="1,1,2",options="header"]
|===
| Parameter | Type | Description
| `body`
| xref:../monitoring_apis/datagather-insights-openshift-io-v1.adoc#datagather-insights-openshift-io-v1[`DataGather`] schema
| 
|===

.HTTP responses
[cols="1,1",options="header"]
|===
| HTTP code | Reponse body
| 200 - OK
| xref:../monitoring_apis/datagather-insights-openshift-io-v1.adoc#datagather-insights-openshift-io-v1[`DataGather`] schema
| 201 - Created
| xref:../monitoring_apis/datagather-insights-openshift-io-v1.adoc#datagather-insights-openshift-io-v1[`DataGather`] schema
| 202 - Accepted
| xref:../monitoring_apis/datagather-insights-openshift-io-v1.adoc#datagather-insights-openshift-io-v1[`DataGather`] schema
| 401 - Unauthorized
| Empty
|===


=== /apis/insights.openshift.io/v1/datagathers/{name}

.Global path parameters
[cols="1,1,2",options="header"]
|===
| Parameter | Type | Description
| `name`
| `string`
| name of the DataGather
|===


HTTP method::
  `DELETE`

Description::
  delete a DataGather


.Query parameters
[cols="1,1,2",options="header"]
|===
| Parameter | Type | Description
| `dryRun`
| `string`
| When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
|===


.HTTP responses
[cols="1,1",options="header"]
|===
| HTTP code | Reponse body
| 200 - OK
| xref:../objects/index.adoc#io-k8s-apimachinery-pkg-apis-meta-v1-Status[`Status`] schema
| 202 - Accepted
| xref:../objects/index.adoc#io-k8s-apimachinery-pkg-apis-meta-v1-Status[`Status`] schema
| 401 - Unauthorized
| Empty
|===

HTTP method::
  `GET`

Description::
  read the specified DataGather




.HTTP responses
[cols="1,1",options="header"]
|===
| HTTP code | Reponse body
| 200 - OK
| xref:../monitoring_apis/datagather-insights-openshift-io-v1.adoc#datagather-insights-openshift-io-v1[`DataGather`] schema
| 401 - Unauthorized
| Empty
|===

HTTP method::
  `PATCH`

Description::
  partially update the specified DataGather


.Query parameters
[cols="1,1,2",options="header"]
|===
| Parameter | Type | Description
| `dryRun`
| `string`
| When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
| `fieldValidation`
| `string`
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered.
|===


.HTTP responses
[cols="1,1",options="header"]
|===
| HTTP code | Reponse body
| 200 - OK
| xref:../monitoring_apis/datagather-insights-openshift-io-v1.adoc#datagather-insights-openshift-io-v1[`DataGather`] schema
| 401 - Unauthorized
| Empty
|===

HTTP method::
  `PUT`

Description::
  replace the specified DataGather


.Query parameters
[cols="1,1,2",options="header"]
|===
| Parameter | Type | Description
| `dryRun`
| `string`
| When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
| `fieldValidation`
| `string`
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered.
|===

.Body parameters
[cols="1,1,2",options="header"]
|===
| Parameter | Type | Description
| `body`
| xref:../monitoring_apis/datagather-insights-openshift-io-v1.adoc#datagather-insights-openshift-io-v1[`DataGather`] schema
| 
|===

.HTTP responses
[cols="1,1",options="header"]
|===
| HTTP code | Reponse body
| 200 - OK
| xref:../monitoring_apis/datagather-insights-openshift-io-v1.adoc#datagather-insights-openshift-io-v1[`DataGather`] schema
| 201 - Created
| xref:../monitoring_apis/datagather-insights-openshift-io-v1.adoc#datagather-insights-openshift-io-v1[`DataGather`] schema
| 401 - Unauthorized
| Empty
|===


=== /apis/insights.openshift.io/v1/datagathers/{name}/status

.Global path parameters
[cols="1,1,2",options="header"]
|===
| Parameter | Type | Description
| `name`
| `string`
| name of the DataGather
|===


HTTP method::
  `GET`

Description::
  read status of the specified DataGather




.HTTP responses
[cols="1,1",options="header"]
|===
| HTTP code | Reponse body
| 200 - OK
| xref:../monitoring_apis/datagather-insights-openshift-io-v1.adoc#datagather-insights-openshift-io-v1[`DataGather`] schema
| 401 - Unauthorized
| Empty
|===

HTTP method::
  `PATCH`

Description::
  partially update status of the specified DataGather


.Query parameters
[cols="1,1,2",options="header"]
|===
| Parameter | Type | Description
| `dryRun`
| `string`
| When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
| `fieldValidation`
| `string`
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered.
|===


.HTTP responses
[cols="1,1",options="header"]
|===
| HTTP code | Reponse body
| 200 - OK
| xref:../monitoring_apis/datagather-insights-openshift-io-v1.adoc#datagather-insights-openshift-io-v1[`DataGather`] schema
| 401 - Unauthorized
| Empty
|===

HTTP method::
  `PUT`

Description::
  replace status of the specified DataGather


.Query parameters
[cols="1,1,2",options="header"]
|===
| Parameter | Type | Description
| `dryRun`
| `string`
| When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
| `fieldValidation`
| `string`
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered.
|===

.Body parameters
[cols="1,1,2",options="header"]
|===
| Parameter | Type | Description
| `body`
| xref:../monitoring_apis/datagather-insights-openshift-io-v1.adoc#datagather-insights-openshift-io-v1[`DataGather`] schema
| 
|===

.HTTP responses
[cols="1,1",options="header"]
|===
| HTTP code | Reponse body
| 200 - OK
| xref:../monitoring_apis/datagather-insights-openshift-io-v1.adoc#datagather-insights-openshift-io-v1[`DataGather`] schema
| 201 - Created
| xref:../monitoring_apis/datagather-insights-openshift-io-v1.adoc#datagather-insights-openshift-io-v1[`DataGather`] schema
| 401 - Unauthorized
| Empty
|===


