<a id="usm-control-plane-auditable-events"></a>

# Unified Stream Manager Control Plane Auditable Event Methods on Confluent Cloud

Confluent Cloud audit logs contain records of auditable events for Unified Stream Manager (USM)
control plane operations. An auditable event is a USM control plane
operation, such as registering or deregistering a cluster, that generates a
message that Confluent Cloud stores as a record in the audit log.

The following sections describe the auditable event methods for the USM
control plane service. Use them to identify and monitor USM operations,
such as registering, retrieving, listing, and deregistering on-premises Confluent Platform
Apache Kafka® and Connect clusters with Confluent Cloud. For details on registering a
cluster, see [Register Your Confluent Platform Cluster](../../../usm/register/overview.md#cloud-usm-register).

<a id="usm-kafka-cluster-auditable-events"></a>

## USM Kafka cluster auditable events

The following operations on registered on-premises Confluent Platform Kafka clusters generate
USM control plane auditable event messages for the
`io.confluent.cloud/request` event type.

| Method name                                                      | Action triggering an auditable event message                                    |
|------------------------------------------------------------------|---------------------------------------------------------------------------------|
| [RegisterUsmKafkaCluster](#registerusmkafkacluster-examples)     | A request to register an on-premises Confluent Platform Kafka cluster with USM. |
| [GetUsmKafkaCluster](#getusmkafkacluster-examples)               | A request to retrieve a registered Kafka cluster.                               |
| [ListUsmKafkaClusters](#listusmkafkaclusters-examples)           | A request to list registered Kafka clusters in an environment.                  |
| [DeregisterUsmKafkaCluster](#deregisterusmkafkacluster-examples) | A request to deregister a Kafka cluster.                                        |

<a id="registerusmkafkacluster-examples"></a>

### RegisterUsmKafkaCluster

The `RegisterUsmKafkaCluster` event is generated by a request to
register an on-premises Confluent Platform Kafka cluster with USM.

HTTP route: `POST /usm/v1/kafka-clusters`

To view example event messages, expand the following dropdowns:

### Success

```json
{
  "datacontenttype": "application/json",
  "data": {
    "serviceName": "crn://confluent.cloud/",
    "methodName": "RegisterUsmKafkaCluster",
    "cloudResources": [
      {
        "scope": {
          "resources": [
            {
              "type": "ORGANIZATION",
              "resourceId": "org-22"
            },
            {
              "type": "ENVIRONMENT",
              "resourceId": "env-1"
            }
          ]
        },
        "resource": {
          "type": "USM_KAFKA_CLUSTER",
          "resourceId": "usmkc-stgclz7ztra5e0bi0rokk75wsbqjqwhe"
        }
      }
    ],
    "authenticationInfo": {
      "principal": {
        "confluentUser": {
          "resourceId": "u-abc123"
        }
      },
      "result": "SUCCESS",
      "identity": "crn://confluent.cloud/organization=org-22/identity-provider=Confluent/identity=u-abc123"
    },
    "requestMetadata": {
      "requestId": [
        "d5ff29d4-2360-4d64-9d10-639ecc1f71cc"
      ],
      "clientAddress": [
        {
          "ip": "192.0.2.1"
        }
      ]
    },
    "request": {
      "accessType": "MODIFICATION",
      "data": {
        "spec": {
          "region": "us-west-2",
          "cloud": "AWS",
          "confluent_platform_kafka_cluster_id": "test-id-55",
          "display_name": "test-kafka-55",
          "environment": {
            "id": "env-1",
            "related": "",
            "resource_name": ""
          }
        }
      }
    },
    "result": {
      "status": "SUCCESS",
      "data": {
        "environment": {
          "id": "env-1",
          "related": "https://api.confluent.cloud/org/v2/environments/env-1",
          "resource_name": "crn://confluent.cloud/organization=org-22/environment=env-1"
        },
        "id": "usmkc-stgclz7ztra5e0bi0rokk75wsbqjqwhe",
        "region": "us-west-2",
        "cloud": "AWS",
        "confluent_platform_kafka_cluster_id": "test-id-55",
        "display_name": "test-kafka-55"
      }
    },
    "resourceName": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-kafka-cluster=usmkc-stgclz7ztra5e0bi0rokk75wsbqjqwhe"
  },
  "subject": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-kafka-cluster=usmkc-stgclz7ztra5e0bi0rokk75wsbqjqwhe",
  "specversion": "1.0",
  "id": "21dc47a2-5b30-4f10-a1f7-1e6a29d3794c",
  "source": "crn://confluent.cloud/",
  "time": "2026-05-22T06:14:29.421143593Z",
  "type": "io.confluent.cloud/request"
}
```

### Failure: A USM Kafka cluster with the given Confluent Platform ID already exists in the environment

```json
{
  "datacontenttype": "application/json",
  "data": {
    "serviceName": "crn://confluent.cloud/",
    "methodName": "RegisterUsmKafkaCluster",
    "cloudResources": [
      {
        "scope": {
          "resources": [
            {
              "type": "ORGANIZATION",
              "resourceId": "org-22"
            }
          ]
        },
        "resource": {
          "type": "ENVIRONMENT",
          "resourceId": "env-1"
        }
      }
    ],
    "authenticationInfo": {
      "principal": {
        "confluentUser": {
          "resourceId": "u-abc123"
        }
      },
      "result": "SUCCESS",
      "identity": "crn://confluent.cloud/organization=org-22/identity-provider=Confluent/identity=u-abc123"
    },
    "requestMetadata": {
      "requestId": [
        "444d8a20-febc-44be-8c89-8763e53dac5c"
      ],
      "clientAddress": [
        {
          "ip": "192.0.2.1"
        }
      ]
    },
    "request": {
      "accessType": "MODIFICATION",
      "data": {
        "spec": {
          "cloud": "AWS",
          "confluent_platform_kafka_cluster_id": "test-id-5",
          "display_name": "test-kafka-5",
          "environment": {
            "id": "env-1",
            "related": "",
            "resource_name": ""
          },
          "region": "us-west-2"
        }
      }
    },
    "result": {
      "status": "FAILURE",
      "data": {
        "errors": [
          {
            "id": "dd5bc6cf02b9d50729c46645e2b9f5c3",
            "status": "409",
            "code": "conflict",
            "detail": "A USM Kafka Cluster with Confluent Platform ID 'test-id-5' already exists in environment 'env-1'",
            "source": {}
          }
        ]
      }
    },
    "resourceName": "crn://confluent.cloud/organization=org-22/environment=env-1"
  },
  "subject": "crn://confluent.cloud/organization=org-22/environment=env-1",
  "specversion": "1.0",
  "id": "7c8eb7c1-a9d7-4d9d-ba70-2c7dc5df705a",
  "source": "crn://confluent.cloud/",
  "time": "2026-05-22T06:11:48.033796921Z",
  "type": "io.confluent.cloud/request"
}
```

<a id="getusmkafkacluster-examples"></a>

### GetUsmKafkaCluster

The `GetUsmKafkaCluster` event is generated by a request to retrieve a
registered Kafka cluster.

HTTP route: `GET /usm/v1/kafka-clusters/{id}`

To view example event messages, expand the following dropdowns:

### Success

```json
{
  "datacontenttype": "application/json",
  "data": {
    "serviceName": "crn://confluent.cloud/",
    "methodName": "GetUsmKafkaCluster",
    "cloudResources": [
      {
        "scope": {
          "resources": [
            {
              "type": "ORGANIZATION",
              "resourceId": "org-22"
            },
            {
              "type": "ENVIRONMENT",
              "resourceId": "env-1"
            }
          ]
        },
        "resource": {
          "type": "USM_KAFKA_CLUSTER",
          "resourceId": "usmkc-stgclz7ztra5e0bi0rokk75wsbqjqwhe"
        }
      }
    ],
    "authenticationInfo": {
      "principal": {
        "confluentUser": {
          "resourceId": "u-abc123"
        }
      },
      "result": "SUCCESS",
      "identity": "crn://confluent.cloud/organization=org-22/identity-provider=Confluent/identity=u-abc123"
    },
    "requestMetadata": {
      "requestId": [
        "913b6d34-b4ba-4a9e-b6f1-0e8b854b9720"
      ],
      "clientAddress": [
        {
          "ip": "192.0.2.1"
        }
      ]
    },
    "request": {
      "accessType": "READ_ONLY",
      "data": {
        "environment_id": "env-1",
        "id": "usmkc-stgclz7ztra5e0bi0rokk75wsbqjqwhe"
      }
    },
    "result": {
      "status": "SUCCESS",
      "data": {
        "region": "us-west-2",
        "cloud": "AWS",
        "confluent_platform_kafka_cluster_id": "test-id-55",
        "display_name": "test-kafka-55",
        "environment": {
          "id": "env-1",
          "related": "https://api.confluent.cloud/org/v2/environments/env-1",
          "resource_name": "crn://confluent.cloud/organization=org-22/environment=env-1"
        },
        "id": "usmkc-stgclz7ztra5e0bi0rokk75wsbqjqwhe"
      }
    },
    "resourceName": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-kafka-cluster=usmkc-stgclz7ztra5e0bi0rokk75wsbqjqwhe"
  },
  "subject": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-kafka-cluster=usmkc-stgclz7ztra5e0bi0rokk75wsbqjqwhe",
  "specversion": "1.0",
  "id": "2025e2e1-d714-4a40-a8e3-b52660d65ab6",
  "source": "crn://confluent.cloud/",
  "time": "2026-05-22T09:53:02.707734472Z",
  "type": "io.confluent.cloud/request"
}
```

### Failure: Kafka cluster not found with the given USM ID

```json
{
  "datacontenttype": "application/json",
  "data": {
    "serviceName": "crn://confluent.cloud/",
    "methodName": "GetUsmKafkaCluster",
    "cloudResources": [
      {
        "scope": {
          "resources": [
            {
              "type": "ORGANIZATION",
              "resourceId": "org-22"
            },
            {
              "type": "ENVIRONMENT",
              "resourceId": "env-1"
            }
          ]
        },
        "resource": {
          "type": "USM_KAFKA_CLUSTER",
          "resourceId": "usmkc-stgclz7ztra50bi0rokk75wsbqjqwhe"
        }
      }
    ],
    "authenticationInfo": {
      "principal": {
        "confluentUser": {
          "resourceId": "u-abc123"
        }
      },
      "result": "SUCCESS",
      "identity": "crn://confluent.cloud/organization=org-22/identity-provider=Confluent/identity=u-abc123"
    },
    "requestMetadata": {
      "requestId": [
        "c0179653-3f7e-44f7-82cc-6b938cf7272a"
      ],
      "clientAddress": [
        {
          "ip": "192.0.2.1"
        }
      ]
    },
    "request": {
      "accessType": "READ_ONLY",
      "data": {
        "id": "usmkc-stgclz7ztra50bi0rokk75wsbqjqwhe",
        "environment_id": "env-1"
      }
    },
    "result": {
      "status": "FAILURE",
      "data": {
        "errors": [
          {
            "id": "ca671dcfd71a648c96e2cf8a023e0fc9",
            "status": "404",
            "detail": "Not Found: Kafka cluster not found with USM ID: usmkc-stgclz7ztra50bi0rokk75wsbqjqwhe",
            "source": {}
          }
        ]
      }
    },
    "resourceName": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-kafka-cluster=usmkc-stgclz7ztra50bi0rokk75wsbqjqwhe"
  },
  "subject": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-kafka-cluster=usmkc-stgclz7ztra50bi0rokk75wsbqjqwhe",
  "specversion": "1.0",
  "id": "776d506b-74f8-4e05-9cf5-9a66df1409e2",
  "source": "crn://confluent.cloud/",
  "time": "2026-05-22T09:54:42.767100095Z",
  "type": "io.confluent.cloud/request"
}
```

<a id="listusmkafkaclusters-examples"></a>

### ListUsmKafkaClusters

The `ListUsmKafkaClusters` event is generated by a request to list
registered Kafka clusters in an environment.

HTTP route: `GET /usm/v1/kafka-clusters`

To view an example event message, expand the following dropdown:

### Success

```json
{
  "datacontenttype": "application/json",
  "data": {
    "serviceName": "crn://confluent.cloud/",
    "methodName": "ListUsmKafkaClusters",
    "cloudResources": [
      {
        "scope": {
          "resources": [
            {
              "type": "ORGANIZATION",
              "resourceId": "org-22"
            }
          ]
        },
        "resource": {
          "type": "ENVIRONMENT",
          "resourceId": "env-1"
        }
      }
    ],
    "authenticationInfo": {
      "principal": {
        "confluentUser": {
          "resourceId": "u-abc123"
        }
      },
      "result": "SUCCESS",
      "identity": "crn://confluent.cloud/organization=org-22/identity-provider=Confluent/identity=u-abc123"
    },
    "requestMetadata": {
      "requestId": [
        "b2f1f500-affe-4b56-b213-1744dd00b39d"
      ],
      "clientAddress": [
        {
          "ip": "192.0.2.1"
        }
      ]
    },
    "request": {
      "accessType": "READ_ONLY",
      "data": {
        "environment_id": "env-1",
        "page_size": 0.0,
        "page_token": ""
      }
    },
    "result": {
      "status": "SUCCESS"
    },
    "resourceName": "crn://confluent.cloud/organization=org-22/environment=env-1"
  },
  "subject": "crn://confluent.cloud/organization=org-22/environment=env-1",
  "specversion": "1.0",
  "id": "e142a861-b812-4e82-b85d-670fab819f33",
  "source": "crn://confluent.cloud/",
  "time": "2026-05-22T08:16:59.154377382Z",
  "type": "io.confluent.cloud/request"
}
```

<a id="deregisterusmkafkacluster-examples"></a>

### DeregisterUsmKafkaCluster

The `DeregisterUsmKafkaCluster` event is generated by a request to
deregister a Kafka cluster.

HTTP route: `DELETE /usm/v1/kafka-clusters/{id}`

To view example event messages, expand the following dropdowns:

### Success

```json
{
  "datacontenttype": "application/json",
  "data": {
    "serviceName": "crn://confluent.cloud/",
    "methodName": "DeregisterUsmKafkaCluster",
    "cloudResources": [
      {
        "scope": {
          "resources": [
            {
              "type": "ORGANIZATION",
              "resourceId": "org-22"
            },
            {
              "type": "ENVIRONMENT",
              "resourceId": "env-1"
            }
          ]
        },
        "resource": {
          "type": "USM_KAFKA_CLUSTER",
          "resourceId": "usmkc-stgcjmzz617e84xey7ih754ga77zolbo"
        }
      }
    ],
    "authenticationInfo": {
      "principal": {
        "confluentUser": {
          "resourceId": "u-abc123"
        }
      },
      "result": "SUCCESS",
      "identity": "crn://confluent.cloud/organization=org-22/identity-provider=Confluent/identity=u-abc123"
    },
    "requestMetadata": {
      "requestId": [
        "a5aad017-e76e-4a4e-b6c4-a2c71ae25b67"
      ],
      "clientAddress": [
        {
          "ip": "192.0.2.1"
        }
      ]
    },
    "request": {
      "accessType": "MODIFICATION",
      "data": {
        "environment_id": "env-1",
        "unique_kafka_cluster_id": "usmkc-stgcjmzz617e84xey7ih754ga77zolbo"
      }
    },
    "result": {
      "status": "SUCCESS",
      "data": {
        "message": "A Kafka Cluster is being deleted."
      }
    },
    "resourceName": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-kafka-cluster=usmkc-stgcjmzz617e84xey7ih754ga77zolbo"
  },
  "subject": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-kafka-cluster=usmkc-stgcjmzz617e84xey7ih754ga77zolbo",
  "specversion": "1.0",
  "id": "c0cd5c33-0789-476e-954b-6e760a09cebc",
  "source": "crn://confluent.cloud/",
  "time": "2026-05-22T10:00:34.859863603Z",
  "type": "io.confluent.cloud/request"
}
```

### Failure: No Kafka cluster found with the given USM ID in the environment

```json
{
  "datacontenttype": "application/json",
  "data": {
    "serviceName": "crn://confluent.cloud/",
    "methodName": "DeregisterUsmKafkaCluster",
    "cloudResources": [
      {
        "scope": {
          "resources": [
            {
              "type": "ORGANIZATION",
              "resourceId": "org-22"
            },
            {
              "type": "ENVIRONMENT",
              "resourceId": "env-1"
            }
          ]
        },
        "resource": {
          "type": "USM_KAFKA_CLUSTER",
          "resourceId": "usmkc-stgcjmzz617e84xey7ih754ga77zolbo"
        }
      }
    ],
    "authenticationInfo": {
      "principal": {
        "confluentUser": {
          "resourceId": "u-abc123"
        }
      },
      "result": "SUCCESS",
      "identity": "crn://confluent.cloud/organization=org-22/identity-provider=Confluent/identity=u-abc123"
    },
    "requestMetadata": {
      "requestId": [
        "0e0d9adc-f736-4317-bcdf-37c36bfdefc8"
      ],
      "clientAddress": [
        {
          "ip": "192.0.2.1"
        }
      ]
    },
    "request": {
      "accessType": "MODIFICATION",
      "data": {
        "environment_id": "env-1",
        "unique_kafka_cluster_id": "usmkc-stgcjmzz617e84xey7ih754ga77zolbo"
      }
    },
    "result": {
      "status": "FAILURE",
      "data": {
        "errors": [
          {
            "id": "0627ec8e805ec148c8da535eefe08bbb",
            "status": "404",
            "detail": "Not Found: No Kafka Cluster found with USM ID: usmkc-stgcjmzz617e84xey7ih754ga77zolbo in environment: env-1",
            "source": {}
          }
        ]
      }
    },
    "resourceName": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-kafka-cluster=usmkc-stgcjmzz617e84xey7ih754ga77zolbo"
  },
  "subject": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-kafka-cluster=usmkc-stgcjmzz617e84xey7ih754ga77zolbo",
  "specversion": "1.0",
  "id": "1a701bac-0402-4893-8e9a-cc01e2c1a44b",
  "source": "crn://confluent.cloud/",
  "time": "2026-05-22T10:01:12.227888721Z",
  "type": "io.confluent.cloud/request"
}
```

<a id="usm-connect-cluster-auditable-events"></a>

## USM Connect cluster auditable events

The following operations on registered on-premises Confluent Platform Connect clusters
generate USM control plane auditable event messages for
the `io.confluent.cloud/request` event type.

| Method name                                                          | Action triggering an auditable event message                                      |
|----------------------------------------------------------------------|-----------------------------------------------------------------------------------|
| [RegisterUsmConnectCluster](#registerusmconnectcluster-examples)     | A request to register an on-premises Confluent Platform Connect cluster with USM. |
| [GetUsmConnectCluster](#getusmconnectcluster-examples)               | A request to retrieve a registered Connect cluster.                               |
| [ListUsmConnectClusters](#listusmconnectclusters-examples)           | A request to list registered Connect clusters in an environment.                  |
| [DeregisterUsmConnectCluster](#deregisterusmconnectcluster-examples) | A request to deregister a Connect cluster.                                        |

<a id="registerusmconnectcluster-examples"></a>

### RegisterUsmConnectCluster

The `RegisterUsmConnectCluster` event is generated by a request to
register an on-premises Confluent Platform Connect cluster with USM.

HTTP route: `POST /usm/v1/connect-clusters`

To view example event messages, expand the following dropdowns:

### Success

```json
{
  "datacontenttype": "application/json",
  "data": {
    "serviceName": "crn://confluent.cloud/",
    "methodName": "RegisterUsmConnectCluster",
    "cloudResources": [
      {
        "scope": {
          "resources": [
            {
              "type": "ORGANIZATION",
              "resourceId": "org-22"
            },
            {
              "type": "ENVIRONMENT",
              "resourceId": "env-1"
            }
          ]
        },
        "resource": {
          "type": "USM_CONNECT_CLUSTER",
          "resourceId": "usmcc-stgch17ovqk2dfw7q1jf4ndz0fwfr1te"
        }
      }
    ],
    "authenticationInfo": {
      "principal": {
        "confluentUser": {
          "resourceId": "u-abc123"
        }
      },
      "result": "SUCCESS",
      "identity": "crn://confluent.cloud/organization=org-22/identity-provider=Confluent/identity=u-abc123"
    },
    "requestMetadata": {
      "requestId": [
        "0445bd42-5f41-4133-9fe0-241c556a1183"
      ],
      "clientAddress": [
        {
          "ip": "192.0.2.1"
        }
      ]
    },
    "request": {
      "accessType": "MODIFICATION",
      "data": {
        "spec": {
          "cloud": "AWS",
          "confluent_platform_connect_cluster_id": "test-connect-11",
          "environment": {
            "id": "env-1",
            "related": "",
            "resource_name": ""
          },
          "kafka_cluster_id": "test-id-5",
          "region": "us-west-2"
        }
      }
    },
    "result": {
      "status": "SUCCESS",
      "data": {
        "kafka_cluster_id": "test-id-5",
        "region": "us-west-2",
        "cloud": "AWS",
        "confluent_platform_connect_cluster_id": "test-connect-11",
        "environment": {
          "id": "env-1",
          "related": "https://api.confluent.cloud/org/v2/environments/env-1",
          "resource_name": "crn://confluent.cloud/organization=org-22/environment=env-1"
        },
        "id": "usmcc-stgch17ovqk2dfw7q1jf4ndz0fwfr1te"
      }
    },
    "resourceName": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-connect-cluster=usmcc-stgch17ovqk2dfw7q1jf4ndz0fwfr1te"
  },
  "subject": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-connect-cluster=usmcc-stgch17ovqk2dfw7q1jf4ndz0fwfr1te",
  "specversion": "1.0",
  "id": "d7f1ae29-6b0c-40aa-9e0f-d6021c5ac7a5",
  "source": "crn://confluent.cloud/",
  "time": "2026-05-22T06:17:52.685518175Z",
  "type": "io.confluent.cloud/request"
}
```

### Failure: A USM Connect cluster with the given Connect group ID and Kafka cluster ID is already registered

```json
{
  "datacontenttype": "application/json",
  "data": {
    "serviceName": "crn://confluent.cloud/",
    "methodName": "RegisterUsmConnectCluster",
    "cloudResources": [
      {
        "scope": {
          "resources": [
            {
              "type": "ORGANIZATION",
              "resourceId": "org-22"
            }
          ]
        },
        "resource": {
          "type": "ENVIRONMENT",
          "resourceId": "env-1"
        }
      }
    ],
    "authenticationInfo": {
      "principal": {
        "confluentUser": {
          "resourceId": "u-abc123"
        }
      },
      "result": "SUCCESS",
      "identity": "crn://confluent.cloud/organization=org-22/identity-provider=Confluent/identity=u-abc123"
    },
    "requestMetadata": {
      "requestId": [
        "ea54536c-139b-42a2-ba57-f829cded2b48"
      ],
      "clientAddress": [
        {
          "ip": "192.0.2.1"
        }
      ]
    },
    "request": {
      "accessType": "MODIFICATION",
      "data": {
        "spec": {
          "cloud": "AWS",
          "confluent_platform_connect_cluster_id": "test-connect-1",
          "environment": {
            "id": "env-1",
            "related": "",
            "resource_name": ""
          },
          "kafka_cluster_id": "test-id-5",
          "region": "us-west-2"
        }
      }
    },
    "result": {
      "status": "FAILURE",
      "data": {
        "errors": [
          {
            "id": "a4ff89f53031003106fa18584a416e3f",
            "status": "409",
            "code": "conflict",
            "detail": "A USM Connect Cluster with Connect Group ID 'test-connect-1' and Kafka Cluster with ID 'test-id-5' in environment 'env-1' is already registered",
            "source": {}
          }
        ]
      }
    },
    "resourceName": "crn://confluent.cloud/organization=org-22/environment=env-1"
  },
  "subject": "crn://confluent.cloud/organization=org-22/environment=env-1",
  "specversion": "1.0",
  "id": "7fa25d87-be3d-4da7-be66-0c8a3d8cbc8c",
  "source": "crn://confluent.cloud/",
  "time": "2026-05-22T06:16:58.216786224Z",
  "type": "io.confluent.cloud/request"
}
```

<a id="getusmconnectcluster-examples"></a>

### GetUsmConnectCluster

The `GetUsmConnectCluster` event is generated by a request to retrieve
a registered Connect cluster.

HTTP route: `GET /usm/v1/connect-clusters/{id}`

To view example event messages, expand the following dropdowns:

### Success

```json
{
  "datacontenttype": "application/json",
  "data": {
    "serviceName": "crn://confluent.cloud/",
    "methodName": "GetUsmConnectCluster",
    "cloudResources": [
      {
        "scope": {
          "resources": [
            {
              "type": "ORGANIZATION",
              "resourceId": "org-22"
            },
            {
              "type": "ENVIRONMENT",
              "resourceId": "env-1"
            }
          ]
        },
        "resource": {
          "type": "USM_CONNECT_CLUSTER",
          "resourceId": "usmcc-stgch17ovqk2dfw7q1jf4ndz0fwfr1te"
        }
      }
    ],
    "authenticationInfo": {
      "principal": {
        "confluentUser": {
          "resourceId": "u-abc123"
        }
      },
      "result": "SUCCESS",
      "identity": "crn://confluent.cloud/organization=org-22/identity-provider=Confluent/identity=u-abc123"
    },
    "requestMetadata": {
      "requestId": [
        "cb873be6-e836-4cbd-8672-f64ea7e5296a"
      ],
      "clientAddress": [
        {
          "ip": "192.0.2.1"
        }
      ]
    },
    "request": {
      "accessType": "READ_ONLY",
      "data": {
        "environment_id": "env-1",
        "id": "usmcc-stgch17ovqk2dfw7q1jf4ndz0fwfr1te"
      }
    },
    "result": {
      "status": "SUCCESS",
      "data": {
        "environment": {
          "id": "env-1",
          "related": "https://api.confluent.cloud/org/v2/environments/env-1",
          "resource_name": "crn://confluent.cloud/organization=org-22/environment=env-1"
        },
        "id": "usmcc-stgch17ovqk2dfw7q1jf4ndz0fwfr1te",
        "kafka_cluster_id": "test-id-5",
        "region": "us-west-2",
        "cloud": "AWS",
        "confluent_platform_connect_cluster_id": "test-connect-11"
      }
    },
    "resourceName": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-connect-cluster=usmcc-stgch17ovqk2dfw7q1jf4ndz0fwfr1te"
  },
  "subject": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-connect-cluster=usmcc-stgch17ovqk2dfw7q1jf4ndz0fwfr1te",
  "specversion": "1.0",
  "id": "eb483893-c6fd-4446-bd89-f7850ae94f52",
  "source": "crn://confluent.cloud/",
  "time": "2026-05-22T06:30:43.803677189Z",
  "type": "io.confluent.cloud/request"
}
```

### Failure: Connect cluster not found with the given USM ID

```json
{
  "datacontenttype": "application/json",
  "data": {
    "serviceName": "crn://confluent.cloud/",
    "methodName": "GetUsmConnectCluster",
    "cloudResources": [
      {
        "scope": {
          "resources": [
            {
              "type": "ORGANIZATION",
              "resourceId": "org-22"
            },
            {
              "type": "ENVIRONMENT",
              "resourceId": "env-1"
            }
          ]
        },
        "resource": {
          "type": "USM_CONNECT_CLUSTER",
          "resourceId": "usmcc-p7mxvhby6gtl4kjz20khbqdooyf"
        }
      }
    ],
    "authenticationInfo": {
      "principal": {
        "confluentUser": {
          "resourceId": "u-abc123"
        }
      },
      "result": "SUCCESS",
      "identity": "crn://confluent.cloud/organization=org-22/identity-provider=Confluent/identity=u-abc123"
    },
    "requestMetadata": {
      "requestId": [
        "24077be2-999c-4f22-bb71-ab97f2b39da7"
      ],
      "clientAddress": [
        {
          "ip": "192.0.2.1"
        }
      ]
    },
    "request": {
      "accessType": "READ_ONLY",
      "data": {
        "environment_id": "env-1",
        "id": "usmcc-p7mxvhby6gtl4kjz20khbqdooyf"
      }
    },
    "result": {
      "status": "FAILURE",
      "data": {
        "errors": [
          {
            "status": "404",
            "detail": "Not Found: Connect Cluster not found with USM ID: usmcc-p7mxvhby6gtl4kjz20khbqdooyf",
            "source": {},
            "id": "d9d4455bdd02533d875c800b44d982ba"
          }
        ]
      }
    },
    "resourceName": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-connect-cluster=usmcc-p7mxvhby6gtl4kjz20khbqdooyf"
  },
  "subject": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-connect-cluster=usmcc-p7mxvhby6gtl4kjz20khbqdooyf",
  "specversion": "1.0",
  "id": "6808baf5-b0d6-4565-8a8d-7e3db6feb6ee",
  "source": "crn://confluent.cloud/",
  "time": "2026-05-22T06:19:30.138287187Z",
  "type": "io.confluent.cloud/request"
}
```

<a id="listusmconnectclusters-examples"></a>

### ListUsmConnectClusters

The `ListUsmConnectClusters` event is generated by a request to list
registered Connect clusters in an environment.

HTTP route: `GET /usm/v1/connect-clusters`

To view an example event message, expand the following dropdown:

### Success

```json
{
  "datacontenttype": "application/json",
  "data": {
    "serviceName": "crn://confluent.cloud/",
    "methodName": "ListUsmConnectClusters",
    "cloudResources": [
      {
        "scope": {
          "resources": [
            {
              "type": "ORGANIZATION",
              "resourceId": "org-22"
            }
          ]
        },
        "resource": {
          "type": "ENVIRONMENT",
          "resourceId": "env-1"
        }
      }
    ],
    "authenticationInfo": {
      "principal": {
        "confluentUser": {
          "resourceId": "u-abc123"
        }
      },
      "result": "SUCCESS",
      "identity": "crn://confluent.cloud/organization=org-22/identity-provider=Confluent/identity=u-abc123"
    },
    "requestMetadata": {
      "requestId": [
        "099219a2-9b85-4733-8855-c8b7bf45624e"
      ],
      "clientAddress": [
        {
          "ip": "192.0.2.1"
        }
      ]
    },
    "request": {
      "accessType": "READ_ONLY",
      "data": {
        "page_token": "",
        "environment_id": "env-1",
        "page_size": 0.0
      }
    },
    "result": {
      "status": "SUCCESS"
    },
    "resourceName": "crn://confluent.cloud/organization=org-22/environment=env-1"
  },
  "subject": "crn://confluent.cloud/organization=org-22/environment=env-1",
  "specversion": "1.0",
  "id": "3df53307-0b03-441d-ab55-a37babf8cd66",
  "source": "crn://confluent.cloud/",
  "time": "2026-05-22T08:15:56.631580246Z",
  "type": "io.confluent.cloud/request"
}
```

<a id="deregisterusmconnectcluster-examples"></a>

### DeregisterUsmConnectCluster

The `DeregisterUsmConnectCluster` event is generated by a request to
deregister a Connect cluster.

HTTP route: `DELETE /usm/v1/connect-clusters/{id}`

To view example event messages, expand the following dropdowns:

### Success

```json
{
  "datacontenttype": "application/json",
  "data": {
    "serviceName": "crn://confluent.cloud/",
    "methodName": "DeregisterUsmConnectCluster",
    "cloudResources": [
      {
        "scope": {
          "resources": [
            {
              "type": "ORGANIZATION",
              "resourceId": "org-22"
            },
            {
              "type": "ENVIRONMENT",
              "resourceId": "env-1"
            }
          ]
        },
        "resource": {
          "type": "USM_CONNECT_CLUSTER",
          "resourceId": "usmcc-stgctzg9ybn3op1ka8sgnoixpnd1iy76"
        }
      }
    ],
    "authenticationInfo": {
      "principal": {
        "confluentUser": {
          "resourceId": "u-abc123"
        }
      },
      "result": "SUCCESS",
      "identity": "crn://confluent.cloud/organization=org-22/identity-provider=Confluent/identity=u-abc123"
    },
    "requestMetadata": {
      "requestId": [
        "3f03e3da-83ad-4f8d-a230-0478a5bacfed"
      ],
      "clientAddress": [
        {
          "ip": "192.0.2.1"
        }
      ]
    },
    "request": {
      "accessType": "MODIFICATION",
      "data": {
        "environment_id": "env-1",
        "unique_connect_cluster_id": "usmcc-stgctzg9ybn3op1ka8sgnoixpnd1iy76"
      }
    },
    "result": {
      "status": "SUCCESS",
      "data": {
        "message": "A Connect Cluster is being deleted."
      }
    },
    "resourceName": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-connect-cluster=usmcc-stgctzg9ybn3op1ka8sgnoixpnd1iy76"
  },
  "subject": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-connect-cluster=usmcc-stgctzg9ybn3op1ka8sgnoixpnd1iy76",
  "specversion": "1.0",
  "id": "8e1e84bc-ac78-4d41-805e-1c71cb19e543",
  "source": "crn://confluent.cloud/",
  "time": "2026-05-22T10:04:26.934107229Z",
  "type": "io.confluent.cloud/request"
}
```

### Failure: No Connect cluster found with the given USM ID in the environment

```json
{
  "datacontenttype": "application/json",
  "data": {
    "serviceName": "crn://confluent.cloud/",
    "methodName": "DeregisterUsmConnectCluster",
    "cloudResources": [
      {
        "scope": {
          "resources": [
            {
              "type": "ORGANIZATION",
              "resourceId": "org-22"
            },
            {
              "type": "ENVIRONMENT",
              "resourceId": "env-1"
            }
          ]
        },
        "resource": {
          "type": "USM_CONNECT_CLUSTER",
          "resourceId": "usmcc-stgch17ovqk2dfw7q1jf4ndz0fwfr1te"
        }
      }
    ],
    "authenticationInfo": {
      "principal": {
        "confluentUser": {
          "resourceId": "u-abc123"
        }
      },
      "result": "SUCCESS",
      "identity": "crn://confluent.cloud/organization=org-22/identity-provider=Confluent/identity=u-abc123"
    },
    "requestMetadata": {
      "requestId": [
        "81b75c15-043c-4601-9150-40599f957adc"
      ],
      "clientAddress": [
        {
          "ip": "192.0.2.1"
        }
      ]
    },
    "request": {
      "accessType": "MODIFICATION",
      "data": {
        "environment_id": "env-1",
        "unique_connect_cluster_id": "usmcc-stgch17ovqk2dfw7q1jf4ndz0fwfr1te"
      }
    },
    "result": {
      "status": "FAILURE",
      "data": {
        "errors": [
          {
            "id": "5d9a63c4cf2665363f09bba1c7b3bdd5",
            "status": "404",
            "detail": "Not Found: No Connect Cluster found with USM ID: usmcc-stgch17ovqk2dfw7q1jf4ndz0fwfr1te in environment: env-1",
            "source": {}
          }
        ]
      }
    },
    "resourceName": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-connect-cluster=usmcc-stgch17ovqk2dfw7q1jf4ndz0fwfr1te"
  },
  "subject": "crn://confluent.cloud/organization=org-22/environment=env-1/usm-connect-cluster=usmcc-stgch17ovqk2dfw7q1jf4ndz0fwfr1te",
  "specversion": "1.0",
  "id": "1a29f1e2-7fb9-40a1-b973-eb97f8f8c688",
  "source": "crn://confluent.cloud/",
  "time": "2026-05-22T10:02:44.305813983Z",
  "type": "io.confluent.cloud/request"
}
```