# REST Resource: projects.locations.instances.rules.retrohunts

- [Resource: Retrohunt](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1beta/projects.locations.instances.rules.retrohunts#Retrohunt)
  - [JSON representation](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1beta/projects.locations.instances.rules.retrohunts#Retrohunt.SCHEMA_REPRESENTATION)
- [State](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1beta/projects.locations.instances.rules.retrohunts#State)
- [Methods](https://docs.cloud.google.com/chronicle/docs/reference/rest/v1beta/projects.locations.instances.rules.retrohunts#METHODS_SUMMARY)

## Resource: Retrohunt

Retrohunt is an execution of a Rule over a time range in the past.

| JSON representation |
|---|
| ``` { "name": string, "processInterval": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/Shared.Types/Interval`) }, "executionInterval": { object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/Shared.Types/Interval`) }, "state": enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1beta/projects.locations.instances.rules.retrohunts#State`), "progressPercentage": number } ``` |

| Fields ||
|---|---|
| `name` | `string` The resource name of the retrohunt. Retrohunt is the child of a rule revision. {rule} in the format below is structured as {[ruleId@revisionId}](mailto:ruleId@revisionId}). Format: `projects/{project}/locations/{location}/instances/{instance}/rules/{rule}/retrohunts/{retrohunt}` |
| `processInterval` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/Shared.Types/Interval`)`` Required. The start and end time of the event time range this retrohunt processes. |
| `executionInterval` | ``object (`https://docs.cloud.google.com/chronicle/docs/reference/rest/Shared.Types/Interval`)`` Output only. The start and end time of the retrohunt execution. If the retrohunt is not yet finished, the end time of the interval will not be populated. |
| `state` | ``enum (`https://docs.cloud.google.com/chronicle/docs/reference/rest/v1beta/projects.locations.instances.rules.retrohunts#State`)`` Output only. The state of the retrohunt. |
| `progressPercentage` | `number` Output only. Percent progress of the retrohunt towards completion, from 0.00 to 100.00. |

## State

The possible states a retrohunt can be in.

| Enums ||
|---|---|
| `STATE_UNSPECIFIED` | Unspecified or unknown retrohunt state. |
| `RUNNING` | Running state. |
| `DONE` | Done state. |
| `CANCELLED` | Cancelled state. |
| `FAILED` | Failed state. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1beta/projects.locations.instances.rules.retrohunts/create` | Create a Retrohunt. |
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1beta/projects.locations.instances.rules.retrohunts/get` | Get a Retrohunt. |
| ### `https://docs.cloud.google.com/chronicle/docs/reference/rest/v1beta/projects.locations.instances.rules.retrohunts/list` | List Retrohunts. |