# Lease

`jumpstarter.dev/v1alpha1`

Lease is the Schema for the leases API

## Spec

| Field | Type | Description |
| --- | --- | --- |
| `spec.beginTime` | string | Requested start time. If omitted, lease starts when exporter is acquired. |
| `spec.clientRef` | object | The client that is requesting the lease |
| `spec.clientRef.name` | string | Name of the referent. (default: ``) |
| `spec.duration` | string | Duration of the lease. Must be positive when provided. |
| `spec.endTime` | string | Requested end time. If specified with BeginTime, Duration is calculated. |
| `spec.exporterRef` | object | Optionally pin this lease to a specific exporter name. |
| `spec.exporterRef.name` | string | Name of the referent. (default: ``) |
| `spec.release` | boolean | The release flag requests the controller to end the lease now |
| `spec.selector` | object | The selector for the exporter to be used (default: `{}`) |
| `spec.selector.matchExpressions` | array | matchExpressions is a list of label selector requirements. The requirements are ANDed. |
| `spec.selector.matchLabels` | object | matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels |
| `spec.tags` | object | User-defined tags for the lease. Immutable after creation. |

## Status

| Field | Type | Description |
| --- | --- | --- |
| `status.beginTime` | string | BeginTime is the actual start time of the lease. |
| `status.conditions` | array | Conditions represent the latest available observations of the lease state. |
| `status.conditions[].lastTransitionTime` | string | lastTransitionTime is the last time the condition transitioned from one status to another. |
| `status.conditions[].message` | string | message is a human readable message indicating details about the transition. |
| `status.conditions[].observedGeneration` | integer | observedGeneration represents the .metadata.generation that the condition was set based upon. |
| `status.conditions[].reason` | string | reason contains a programmatic identifier indicating the reason for the condition's last transition. |
| `status.conditions[].status` | `True` | `False` | `Unknown` | status of the condition, one of True, False, Unknown. |
| `status.conditions[].type` | string | type of condition in CamelCase or in foo.example.com/CamelCase. |
| `status.endTime` | string | EndTime is the actual end time of the lease. |
| `status.ended` | boolean | Ended indicates whether the lease has been terminated. |
| `status.exporterRef` | object | ExporterRef is a reference to the exporter assigned to this lease. |
| `status.exporterRef.name` | string | Name of the referent. (default: ``) |
| `status.priority` | integer | Priority is the effective priority of the lease from the access policy. |
| `status.spotAccess` | boolean | SpotAccess indicates whether this lease was granted with spot (preemptible) access. |