# REST Resource: projects.locations.instances.integrations.connectors.revisions

- [Resource: ConnectorRevision](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.integrations.connectors.revisions#ConnectorRevision)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.integrations.connectors.revisions#ConnectorRevision.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.integrations.connectors.revisions#METHODS_SUMMARY)

## Resource: ConnectorRevision

This service is available for customers who migrated SOAR to a customer managed project and have the Chronicle API enabled. Allows saving \& restoring different revisions of connector definitions.

| JSON representation |
|---|
| ``` { "name": string, "snapshot": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.integrations.connectors#IntegrationConnector`) }, "createTime": string, "comment": string, "connector": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.integrations.connectors#IntegrationConnector`) }, "author": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The unique name(ID) of the connector revision. Format: projects/{project}/locations/{location}/instances/{instance}/integrations/{integration}/connectors/{connector}/revisions/{revision} |
| `snapshot` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.integrations.connectors#IntegrationConnector`)`` Output only. The snapshot of the connector. |
| `createTime` | `string (https://developers.google.com/discovery/v1/type-format format)` Output only. Specifies the time the revision was created. |
| `comment` | `string` Optional. Comment describing the revision, limited to 400 characters. |
| `connector` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.integrations.connectors#IntegrationConnector`)`` Required. Used for creating a new revision. |
| `author` | `string` Output only. The SOAR USER who created the specific revision. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.integrations.connectors.revisions/create` | Creates a new snapshot (revision) of the current connector definition. |
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.integrations.connectors.revisions/delete` | Deletes a specific connector revision. |
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.integrations.connectors.revisions/list` | Lists all saved revisions of a specific connector. |
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1alpha/projects.locations.instances.integrations.connectors.revisions/rollback` | Restores the connector definition to the state captured in a specific revision. |