# REST Resource: admin.projects.locations.reservations

- [Resource: Reservation](https://docs.cloud.google.com/pubsub/lite/docs/reference/rest/v1/admin.projects.locations.reservations#Reservation)
  - [JSON representation](https://docs.cloud.google.com/pubsub/lite/docs/reference/rest/v1/admin.projects.locations.reservations#Reservation.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/pubsub/lite/docs/reference/rest/v1/admin.projects.locations.reservations#METHODS_SUMMARY)

## Resource: Reservation

Metadata about a reservation resource.

| JSON representation |
|---|
| ``` { "name": string, "throughputCapacity": string } ``` |

| Fields ||
|---|---|
| `name` | `string` The name of the reservation. Structured like: projects/{project_number}/locations/{location}/reservations/{reservationId} |
| `throughputCapacity` | `string (https://developers.google.com/discovery/v1/type-format format)` The reserved throughput capacity. Every unit of throughput capacity is equivalent to 1 MiB/s of published messages or 2 MiB/s of subscribed messages. Any topics which are declared as using capacity from a Reservation will consume resources from this reservation instead of being charged individually. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/pubsub/lite/docs/reference/rest/v1/admin.projects.locations.reservations/create` | Creates a new reservation. |
| ### `https://docs.cloud.google.com/pubsub/lite/docs/reference/rest/v1/admin.projects.locations.reservations/delete` | Deletes the specified reservation. |
| ### `https://docs.cloud.google.com/pubsub/lite/docs/reference/rest/v1/admin.projects.locations.reservations/get` | Returns the reservation configuration. |
| ### `https://docs.cloud.google.com/pubsub/lite/docs/reference/rest/v1/admin.projects.locations.reservations/list` | Returns the list of reservations for the given project. |
| ### `https://docs.cloud.google.com/pubsub/lite/docs/reference/rest/v1/admin.projects.locations.reservations/patch` | Updates properties of the specified reservation. |