> **Experimental**
>
> `@aws-cdk/aws-imagebuilder-alpha` is an [**experimental**](/stability) (alpha) package: its API may change in any release, without a major version bump.
# OSVersion

Represents an OS version for an EC2 Image Builder image.

Obtainable from: OSVersion.AMAZON_LINUX, OSVersion.AMAZON_LINUX_2, OSVersion.AMAZON_LINUX_2023, OSVersion.LINUX, OSVersion.MAC_OS, OSVersion.MAC_OS_14, OSVersion.MAC_OS_15, OSVersion.REDHAT_ENTERPRISE_LINUX, OSVersion.REDHAT_ENTERPRISE_LINUX_10, OSVersion.REDHAT_ENTERPRISE_LINUX_8, OSVersion.REDHAT_ENTERPRISE_LINUX_9, OSVersion.SLES, OSVersion.SLES_15, OSVersion.UBUNTU, OSVersion.UBUNTU_22_04, OSVersion.UBUNTU_24_04, OSVersion.WINDOWS, OSVersion.WINDOWS_SERVER, OSVersion.WINDOWS_SERVER_2016, OSVersion.WINDOWS_SERVER_2019, OSVersion.WINDOWS_SERVER_2022, OSVersion.WINDOWS_SERVER_2025, OSVersion.custom

- Stability: [Experimental](/cdk/api/stability.html)
- Source: [`lib/os-version.ts`](https://github.com/aws/aws-cdk/blob/v2.277.0/packages/@aws-cdk/aws-imagebuilder-alpha/lib/os-version.ts#L24)

## Example

TypeScript:

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as imagebuilder_alpha from '@aws-cdk/aws-imagebuilder-alpha';
const oSVersion = imagebuilder_alpha.OSVersion.AMAZON_LINUX;
```

Python:

```python
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk.aws_imagebuilder_alpha as imagebuilder_alpha

o_s_version = imagebuilder_alpha.OSVersion.AMAZON_LINUX
```

Java:

```java
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.services.imagebuilder.alpha.*;

OSVersion oSVersion = OSVersion.AMAZON_LINUX;
```

C# / .NET:

```csharp
// Install: dotnet add package Amazon.CDK.AWS.ImageBuilder.Alpha
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.ImageBuilder.Alpha;

var oSVersion = OSVersion.AMAZON_LINUX;
```

Golang:

```go
// Install: go get github.com/aws/aws-cdk-go/awsimagebuilderalpha/v2
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import imagebuilder_alpha "github.com/aws/aws-cdk-go/awsimagebuilderalpha"

oSVersion := imagebuilder_alpha.OSVersion_AMAZON_LINUX()
```

## Properties

- `AMAZON_LINUX`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for all Amazon Linux images.

- `AMAZON_LINUX_2`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for Amazon Linux 2.

- `AMAZON_LINUX_2023`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for Amazon Linux 2023.

- `LINUX`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for all Linux images.

- `MAC_OS`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for all macOS images.

- `MAC_OS_14`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for macOS 14.

- `MAC_OS_15`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for macOS 15.

- `osVersion`: string — The OS version name.

- `platform`: [Platform](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.Platform.html) — The Platform of the OS version.

- `REDHAT_ENTERPRISE_LINUX`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for all Red Hat Enterprise Linux images.

- `REDHAT_ENTERPRISE_LINUX_10`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for Red Hat Enterprise Linux 10.

- `REDHAT_ENTERPRISE_LINUX_8`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for Red Hat Enterprise Linux 8.

- `REDHAT_ENTERPRISE_LINUX_9`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for Red Hat Enterprise Linux 9.

- `SLES`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for all SLES images.

- `SLES_15`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for SLES 15.

- `UBUNTU`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for all Ubuntu images.

- `UBUNTU_22_04`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for Ubuntu 22.04.

- `UBUNTU_24_04`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for Ubuntu 24.04.

- `WINDOWS`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for all Windows images.

- `WINDOWS_SERVER`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for all Windows server images.

- `WINDOWS_SERVER_2016`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for Windows Server 2016.

- `WINDOWS_SERVER_2019`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for Windows Server 2019.

- `WINDOWS_SERVER_2022`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for Windows Server 2022.

- `WINDOWS_SERVER_2025`: [OSVersion](/cdk/api/v2/docs/@aws-cdk_aws-imagebuilder-alpha.OSVersion.html) (static) — OS version for Windows Server 2025.

## Methods

- `custom(platform: Platform, osVersion?: string): OSVersion // chainable` (static) — Constructs an OS version with a custom name.

  **Parameters**

  - `platform` — The platform of the OS version.
  - `osVersion` — The custom OS version to use.
