# Capacity Reservation Status

Capacity Reservation Status indicates whether the [*charge*](#glossary:charge) represents either the consumption of the [*capacity reservation*](#glossary:capacity-reservation) identified in the CapacityReservationId column or when the *capacity reservation* is unused.

## Requirements

CapacityReservationStatus MUST adhere to the following requirements:

* CapacityReservationStatus MUST be of type String.
* CapacityReservationStatus MUST adhere to the following nullability requirements:
  * CapacityReservationStatus MUST be null when CapacityReservationId is null.
  * CapacityReservationStatus MUST NOT be null when CapacityReservationId is not null and [ChargeCategory](#datasets.costandusage.chargecategory) is "Usage".
* When CapacityReservationStatus is not null, CapacityReservationStatus MUST adhere to the following requirements:
  * CapacityReservationStatus MUST be one of the allowed values.
  * CapacityReservationStatus MUST be "Unused" when the *charge* represents the unused portion of a *capacity reservation*.
  * CapacityReservationStatus MUST be "Used" when the *charge* represents the used portion of a *capacity reservation*.

## Allowed Values

| Value  | Description                                                                 |
| :----- | :-------------------------------------------------------------------------- |
| Used   | *Charges* that utilized a specific amount of a *capacity reservation*. |
| Unused | *Charges* that represent the unused portion of a *capacity reservation*. |

## Column ID

CapacityReservationStatus

## Display Name

Capacity Reservation Status

## Description

Indicates whether the *charge* represents either the consumption of a *capacity reservation* or when a *capacity reservation* is unused.

## Content Constraints

| Constraint      | Value                                                |
| :-------------- | :--------------------------------------------------- |
| Dataset         | [Cost and Usage](#datasets.costandusage)             |
| Column type     | Dimension                                            |
| Feature level   | Conditional                                          |
| Allows nulls    | True                                                 |
| Data type       | String                                               |
| Value format    | Allowed values                                       |

## Version Introduced

1.1