## upgrade.gdc.goog/v1

### ComponentOverride

ComponentOverride changes the upgrade for an Operable Component (OC).

*Appears in:*
- [OrganizationUpgradeExecutionOverrideSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#organizationupgradeexecutionoverridespec)

| Field | Description |
|---|---|
| `name` *string* | Name is the Operable Component (OC) name this override applies to. |
| `subcomponents` *[SubcomponentOverride](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#subcomponentoverride) array* | Subcomponents is the list of Subcomponent upgrades to change. |
| `tasks` *[TaskOverride](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#taskoverride) array* | Tasks is the list of upgrade tasks to change. |

### ErrorStatus

*Appears in:*
- [OrganizationUpgradeExecutionOverrideStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#organizationupgradeexecutionoverridestatus)

### 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/appliance/apis/service/upgrade/v1/upgrade-v1#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/appliance/apis/service/upgrade/v1/upgrade-v1#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/appliance/apis/service/upgrade/v1/upgrade-v1#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/appliance/apis/service/upgrade/v1/upgrade-v1#maintenancewindow)

| Field | Description |
|---|---|
| `upgradeType` *[UpgradeType](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#upgradetype)* | UpgradeType indicates the type of the MaintenanceWindow, which is one of `UpgradeTypeMinor` and `UpgradeTypePatch`. |
| `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/appliance/apis/service/upgrade/v1/upgrade-v1#timewindow)* | TimeWindow contains the start and end times for the MaintenanceWindow. |
| `exclusions` *[TimeWindow](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#timewindow) array* | Exclusions is an array of TimeWindows that were skipped. Exclusions will only contain times specific up to the hour. |

### OrganizationUpgradeExecutionOverride

OrganizationUpgradeExecutionOverride defines ways to modify the execution of an upgrade for a version of GDC.
This impacts all upgrades, both current and future.

*Appears in:*
- [OrganizationUpgradeExecutionOverrideList](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#organizationupgradeexecutionoverridelist)

| Field | Description |
|---|---|
| `apiVersion` *string* | `upgrade.gdc.goog/v1` |
| `kind` *string* | `OrganizationUpgradeExecutionOverride` |
| `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` *[OrganizationUpgradeExecutionOverrideSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#organizationupgradeexecutionoverridespec)* |   |
| `status` *[OrganizationUpgradeExecutionOverrideStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#organizationupgradeexecutionoverridestatus)* |   |

### OrganizationUpgradeExecutionOverrideList

OrganizationUpgradeExecutionOverrideList is a collection of OrganizationUpgradeExecutionOverrides.

| Field | Description |
|---|---|
| `apiVersion` *string* | `upgrade.gdc.goog/v1` |
| `kind` *string* | `OrganizationUpgradeExecutionOverrideList` |
| `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` *[OrganizationUpgradeExecutionOverride](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#organizationupgradeexecutionoverride) array* |   |

### OrganizationUpgradeExecutionOverrideSpec

OrganizationUpgradeExecutionOverrideSpec is the desired changes for an OrganizationUpgrade.

*Appears in:*
- [OrganizationUpgradeExecutionOverride](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#organizationupgradeexecutionoverride)

| Field | Description |
|---|---|
| `for` *[OrganizationUpgradeSelector](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#organizationupgradeselector)* | For specifies which OrganizationUpgrades this applies to. |
| `components` *[ComponentOverride](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#componentoverride) array* | Components is the list of Component upgrades to change. |

### OrganizationUpgradeExecutionOverrideStatus

OrganizationUpgradeExecutionOverrideStatus is the observed state for an OrganizationUpgradeExecutionOverride.

*Appears in:*
- [OrganizationUpgradeExecutionOverride](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#organizationupgradeexecutionoverride)

| Field | Description |
|---|---|
| `errorStatus` *[ErrorStatus](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#errorstatus)* | ErrorStatus records errors for this OrganizationUpgradeExecutionOverride. |

### OrganizationUpgradeSelector

OrganizationUpgradeSelector matches OrganizationUpgrades.

*Appears in:*
- [OrganizationUpgradeExecutionOverrideSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#organizationupgradeexecutionoverridespec)

| Field | Description |
|---|---|
| `version` *[SemanticVersion](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#semanticversion)* | Version is the version of GDC an Organization is being upgraded to. Sometimes also called the GDC upgrade "target" version. |

### SemanticVersion

Wrapper/alias type for `semver.Version` (Semantic Version).
Extended to support KRM APIs.

*Appears in:*
- [OrganizationUpgradeSelector](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#organizationupgradeselector)

| Field | Description |
|---|---|
| `major` *integer* |   |
| `minor` *integer* |   |
| `patch` *integer* |   |
| `pre` *string* |   |
| `metadata` *string* | Refer to Kubernetes API documentation for fields of `metadata`. |
| `original` *string* |   |

### SubcomponentOverride

SubcomponentOverride changes the upgrade for an Operable Component's Subcomponent.

*Appears in:*
- [ComponentOverride](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#componentoverride)

| Field | Description |
|---|---|
| `name` *string* | Name is the Subcomponent name this override applies to. |
| `upgrade` *[SubcomponentUpgradeOverride](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#subcomponentupgradeoverride)* | Upgrade defines how the upgrade of this subcomponent should be overridden. |

### SubcomponentUpgradeOverride

*Underlying type:* `string`
SubcomponentUpgradeOverride is how the subcomponent upgrade should be overridden.

*Appears in:*
- [SubcomponentOverride](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#subcomponentoverride)

### TaskExecutionOverride

*Underlying type:* `string`
TaskExecutionOverride is how the upgrade task execution should be overridden.

*Appears in:*
- [TaskOverride](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#taskoverride)

### TaskOverride

TaskOverride changes the execution of an upgrade task for an Operable Component.

*Appears in:*
- [ComponentOverride](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#componentoverride)

| Field | Description |
|---|---|
| `name` *string* | Name is the upgrade task's name. |
| `execution` *[TaskExecutionOverride](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#taskexecutionoverride)* | Execution defines how the upgrade task's execution should be changed. |

### TimeWindow

TimeWindow defines a chunk of time.

*Appears in:*
- [MaintenanceWindowSpec](https://docs.cloud.google.com/distributed-cloud/hosted/docs/latest/appliance/apis/service/upgrade/v1/upgrade-v1#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/appliance/apis/service/upgrade/v1/upgrade-v1#maintenancewindowspec)