Skip to content

Describe Capacity Block Extension History

ec2_describe_capacity_block_extension_history R Documentation

Describes the events for the specified Capacity Block extension during the specified time

Description

Describes the events for the specified Capacity Block extension during the specified time.

Usage

ec2_describe_capacity_block_extension_history(CapacityReservationIds,
  NextToken, MaxResults, Filters, DryRun)

Arguments

CapacityReservationIds

The IDs of Capacity Block reservations that you want to display the history for.

NextToken

The token to use to retrieve the next page of results.

MaxResults

The maximum number of items to return for this request. To get the next page of items, make another request with the token returned in the output. For more information, see Pagination.

Filters

One or more filters

  • availability-zone - The Availability Zone of the extension.

  • availability-zone-id - The Availability Zone ID of the extension.

  • capacity-block-extension-offering-id - The ID of the extension offering.

  • capacity-block-extension-status - The status of the extension (payment-pending | payment-failed | payment-succeeded).

  • capacity-reservation-id - The reservation ID of the extension.

  • instance-type - The instance type of the extension.

DryRun

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

Value

A list with the following syntax: 

list(
  CapacityBlockExtensions = list(
    list(
      CapacityReservationId = "string",
      InstanceType = "string",
      InstanceCount = 123,
      AvailabilityZone = "string",
      AvailabilityZoneId = "string",
      CapacityBlockExtensionOfferingId = "string",
      CapacityBlockExtensionDurationHours = 123,
      CapacityBlockExtensionStatus = "payment-pending"|"payment-failed"|"payment-succeeded",
      CapacityBlockExtensionPurchaseDate = as.POSIXct(
        "2015-01-01"
      ),
      CapacityBlockExtensionStartDate = as.POSIXct(
        "2015-01-01"
      ),
      CapacityBlockExtensionEndDate = as.POSIXct(
        "2015-01-01"
      ),
      UpfrontFee = "string",
      CurrencyCode = "string"
    )
  ),
  NextToken = "string"
)

Request syntax

svc$describe_capacity_block_extension_history(
  CapacityReservationIds = list(
    "string"
  ),
  NextToken = "string",
  MaxResults = 123,
  Filters = list(
    list(
      Name = "string",
      Values = list(
        "string"
      )
    )
  ),
  DryRun = TRUE|FALSE
)