Skip to content

Create Reservation

redshiftserverless_create_reservation R Documentation

Creates an Amazon Redshift Serverless reservation, which gives you the option to commit to a specified number of Redshift Processing Units (RPUs) for a year at a discount from Serverless on-demand (OD) rates

Description

Creates an Amazon Redshift Serverless reservation, which gives you the option to commit to a specified number of Redshift Processing Units (RPUs) for a year at a discount from Serverless on-demand (OD) rates.

Usage

redshiftserverless_create_reservation(capacity, clientToken, offeringId)

Arguments

capacity

[required] The number of Redshift Processing Units (RPUs) to reserve.

clientToken

A unique, case-sensitive identifier that you provide to ensure the idempotency of the request. If not provided, the Amazon Web Services SDK populates this field. This token must be a valid UUIDv4 value. For more information about idempotency, see Making retries safe with idempotent APIs .

offeringId

[required] The ID of the offering associated with the reservation. The offering determines the payment schedule for the reservation.

Value

A list with the following syntax:

list(
  reservation = list(
    capacity = 123,
    endDate = as.POSIXct(
      "2015-01-01"
    ),
    offering = list(
      currencyCode = "string",
      duration = 123,
      hourlyCharge = 123.0,
      offeringId = "string",
      offeringType = "ALL_UPFRONT"|"NO_UPFRONT",
      upfrontCharge = 123.0
    ),
    reservationArn = "string",
    reservationId = "string",
    startDate = as.POSIXct(
      "2015-01-01"
    ),
    status = "string"
  )
)

Request syntax

svc$create_reservation(
  capacity = 123,
  clientToken = "string",
  offeringId = "string"
)