# CloudMonitoringIntegration

> API reference for Cloud Monitoring Integrations (core.apoxy.dev/v1alpha2)

**API Group:** `core.apoxy.dev/v1alpha2`

## Operations

### List Cloud Monitoring Integrations

<APIEndpoint method="GET" path="/apis/core.apoxy.dev/v1alpha2/cloudmonitoringintegrations" />

List CloudMonitoringIntegration

**Response**

- `200`: OK

---

### Create Cloud Monitoring Integration

<APIEndpoint method="POST" path="/apis/core.apoxy.dev/v1alpha2/cloudmonitoringintegrations" />

Create a CloudMonitoringIntegration

**Request Body**

Spec fields (`CloudMonitoringIntegrationSpec`):

| Field | Type | Description |
| --- | --- | --- |
| `axiomCredentials` | [AxiomCredentials](#axiomcredentials) | AxiomCredentials configures Axiom integration. Only one of DatadogCredentials, GrafanaCredentials, or AxiomCredentials may be specified. |
| `datadogCredentials` | [DatadogCredentials](#datadogcredentials) | DatadogCredentials configures DataDog integration. Only one of DatadogCredentials, GrafanaCredentials, or AxiomCredentials may be specified. |
| `enabled` | boolean | Enabled indicates whether the monitoring integration is active. |
| `grafanaCredentials` | [GrafanaCredentials](#grafanacredentials) | GrafanaCredentials configures Grafana Cloud integration. Only one of DatadogCredentials, GrafanaCredentials, or AxiomCredentials may be specified. |

**Response**

- `200`: OK
- `201`: Created
- `202`: Accepted

---

### Delete All Cloud Monitoring Integrations

<APIEndpoint method="DELETE" path="/apis/core.apoxy.dev/v1alpha2/cloudmonitoringintegrations" />

Delete collection of CloudMonitoringIntegration

**Response**

- `200`: OK

---

### Get Cloud Monitoring Integration

<APIEndpoint method="GET" path="/apis/core.apoxy.dev/v1alpha2/cloudmonitoringintegrations/{name}" />

Get the specified CloudMonitoringIntegration

**Response**

- `200`: OK

---

### Replace Cloud Monitoring Integration

<APIEndpoint method="PUT" path="/apis/core.apoxy.dev/v1alpha2/cloudmonitoringintegrations/{name}" />

Replace the specified CloudMonitoringIntegration

**Request Body**

Spec fields (`CloudMonitoringIntegrationSpec`):

| Field | Type | Description |
| --- | --- | --- |
| `axiomCredentials` | [AxiomCredentials](#axiomcredentials) | AxiomCredentials configures Axiom integration. Only one of DatadogCredentials, GrafanaCredentials, or AxiomCredentials may be specified. |
| `datadogCredentials` | [DatadogCredentials](#datadogcredentials) | DatadogCredentials configures DataDog integration. Only one of DatadogCredentials, GrafanaCredentials, or AxiomCredentials may be specified. |
| `enabled` | boolean | Enabled indicates whether the monitoring integration is active. |
| `grafanaCredentials` | [GrafanaCredentials](#grafanacredentials) | GrafanaCredentials configures Grafana Cloud integration. Only one of DatadogCredentials, GrafanaCredentials, or AxiomCredentials may be specified. |

**Response**

- `200`: OK
- `201`: Created

---

### Update Cloud Monitoring Integration

<APIEndpoint method="PATCH" path="/apis/core.apoxy.dev/v1alpha2/cloudmonitoringintegrations/{name}" />

Partially update the specified CloudMonitoringIntegration

**Response**

- `200`: OK
- `201`: Created

---

### Delete Cloud Monitoring Integration

<APIEndpoint method="DELETE" path="/apis/core.apoxy.dev/v1alpha2/cloudmonitoringintegrations/{name}" />

Delete a CloudMonitoringIntegration

**Response**

- `200`: OK
- `202`: Accepted

---

## Schema Reference

### AxiomCredentials

| Field | Type | Description |
| --- | --- | --- |
| `apiToken` | string | APIToken is the Axiom API token. This field should reference a secret in production environments. **(required)** |
| `datasetName` | string | DatasetName is the name of the Axiom dataset to send data to. **(required)** |
| `region` | string | Region specifies the Axiom region. Common values: us, eu **(required)** |

### DatadogCredentials

| Field | Type | Description |
| --- | --- | --- |
| `apiKey` | string | APIKey is the DataDog API key. This field should reference a secret in production environments. **(required)** |
| `site` | string | Site specifies the DataDog site to send data to. Common values: datadoghq.com, datadoghq.eu, us3.datadoghq.com, us5.datadoghq.com, ddog-gov.com **(required)** |

### GrafanaCredentials

| Field | Type | Description |
| --- | --- | --- |
| `apiKey` | string | APIKey is the Grafana Cloud API key. This field should reference a secret in production environments. **(required)** |
| `endpoint` | string | Endpoint is the OTLP endpoint URL for Grafana Cloud. Example: https://otlp-endpoint-xyz.grafana.net/otlp **(required)** |
| `instanceId` | string | InstanceID is the Grafana Cloud instance identifier. **(required)** |