## upgrade.gdc.goog/v1

### MaintenanceWindow

MaintenanceWindow specifies a recurring time window for applying for patch and minor version upgrades.

*Appears in:*
- [MaintenanceWindowList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/upgrade/v1/upgrade-v1.md.txt#maintenancewindowlist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `upgrade.gdc.goog/v1` |
| `kind` *string* | `MaintenanceWindow` |
| `metadata` *[ObjectMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#objectmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `spec` *[MaintenanceWindowSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/upgrade/v1/upgrade-v1.md.txt#maintenancewindowspec)* |   |

### MaintenanceWindowList

MaintenanceWindowList represents a collection of MaintenanceWindows.

| Field | Description |
|---|---|
| `apiVersion` *string* | `upgrade.gdc.goog/v1` |
| `kind` *string* | `MaintenanceWindowList` |
| `metadata` *[ListMeta](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#listmeta-v1-meta)* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `items` *[MaintenanceWindow](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/upgrade/v1/upgrade-v1.md.txt#maintenancewindow) array* |   |

### MaintenanceWindowSpec

MaintenanceWindowSpec provides the specification (i.e., desired state) of
a MaintenanceWindow.

*Appears in:*
- [MaintenanceWindow](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/upgrade/v1/upgrade-v1.md.txt#maintenancewindow)

| Field | Description |
|---|---|
| `upgradeType` *[UpgradeType](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/upgrade/v1/upgrade-v1.md.txt#upgradetype)* | UpgradeType indicates the type of the MaintenanceWindow, which is one of "MinorUpgrade" and "PatchUpgrade". |
| `recurrence` *string* | Recurrence encodes a RRULE string to indicate how the window recurs. https://icalendar.org/iCalendar-RFC-5545/3-8-5-3-recurrence-rule.html Ex. TimeWindow.StartTime = 2022-04-18T02:00:00Z TimeWindow.EndTime = 2022-04-18T06:00:00Z Recurrence = FREQ=WEEKLY;BYDAY=MO,WE These parameters would create a schedule that starts on 04/18/2022 from 2 a.m to 6 a.m. Every Monday and Wednesday after, the same 2.am-6.am pattern would recur. |
| `timeWindow` *[TimeWindow](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/upgrade/v1/upgrade-v1.md.txt#timewindow)* | TimeWindow contains the start and end times for the MaintenanceWindow. |
| `exclusions` *[TimeWindow](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/upgrade/v1/upgrade-v1.md.txt#timewindow) array* | Exclusions is an array of TimeWindows that were skipped. Exclusions will only contain times specific up to the hour. |

### TimeWindow

TimeWindow defines a chunk of time.

*Appears in:*
- [MaintenanceWindowSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/upgrade/v1/upgrade-v1.md.txt#maintenancewindowspec)

| Field | Description |
|---|---|
| `start` *[Time](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta)* | Start indicates the start of the window. |
| `end` *[Time](https://kubernetes.io/docs/reference/generated/kubernetes-api/v1.25/#time-v1-meta)* | End indicates the end of the window. |

### UpgradeType

*Underlying type:* `string`
UpgradeType specifies the type of an upgrade.
Only one of the following upgrade types may be specified.

*Appears in:*
- [MaintenanceWindowSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/gdcag/apis/service/upgrade/v1/upgrade-v1.md.txt#maintenancewindowspec)