- Navigation GuideYou are on a Command (operation) page with structural examples. Use the navigation breadcrumb if you would like to return to the Client landing page.
AcceptReservedNodeExchangeCommand
Exchanges a DC1 Reserved Node for a DC2 Reserved Node with no changes to the configuration (term, payment type, or number of nodes) and no additional costs.
Example Syntax
Use a bare-bones client and the command you need to make an API call.
import { RedshiftClient, AcceptReservedNodeExchangeCommand } from "@aws-sdk/client-redshift"; // ES Modules import
// const { RedshiftClient, AcceptReservedNodeExchangeCommand } = require("@aws-sdk/client-redshift"); // CommonJS import
const client = new RedshiftClient(config);
const input = { // AcceptReservedNodeExchangeInputMessage
ReservedNodeId: "STRING_VALUE", // required
TargetReservedNodeOfferingId: "STRING_VALUE", // required
};
const command = new AcceptReservedNodeExchangeCommand(input);
const response = await client.send(command);
// { // AcceptReservedNodeExchangeOutputMessage
// ExchangedReservedNode: { // ReservedNode
// ReservedNodeId: "STRING_VALUE",
// ReservedNodeOfferingId: "STRING_VALUE",
// NodeType: "STRING_VALUE",
// StartTime: new Date("TIMESTAMP"),
// Duration: Number("int"),
// FixedPrice: Number("double"),
// UsagePrice: Number("double"),
// CurrencyCode: "STRING_VALUE",
// NodeCount: Number("int"),
// State: "STRING_VALUE",
// OfferingType: "STRING_VALUE",
// RecurringCharges: [ // RecurringChargeList
// { // RecurringCharge
// RecurringChargeAmount: Number("double"),
// RecurringChargeFrequency: "STRING_VALUE",
// },
// ],
// ReservedNodeOfferingType: "Regular" || "Upgradable",
// },
// };
AcceptReservedNodeExchangeCommand Input
Parameter | Type | Description |
|---|
Parameter | Type | Description |
|---|---|---|
ReservedNodeIdRequired | string | undefined | A string representing the node identifier of the DC1 Reserved Node to be exchanged. |
TargetReservedNodeOfferingIdRequired | string | undefined | The unique identifier of the DC2 Reserved Node offering to be used for the exchange. You can obtain the value for the parameter by calling GetReservedNodeExchangeOfferings |
AcceptReservedNodeExchangeCommand Output
Parameter | Type | Description |
|---|
Parameter | Type | Description |
|---|---|---|
$metadataRequired | ResponseMetadata | Metadata pertaining to this request. |
ExchangedReservedNode | ReservedNode | undefined |
Throws
Name | Fault | Details |
|---|
Name | Fault | Details |
|---|---|---|
| DependentServiceUnavailableFault | client | Your request cannot be completed because a dependent internal service is temporarily unavailable. Wait 30 to 60 seconds and try again. |
| InvalidReservedNodeStateFault | client | Indicates that the Reserved Node being exchanged is not in an active state. |
| ReservedNodeAlreadyExistsFault | client | User already has a reservation with the given identifier. |
| ReservedNodeAlreadyMigratedFault | client | Indicates that the reserved node has already been exchanged. |
| ReservedNodeNotFoundFault | client | The specified reserved compute node not found. |
| ReservedNodeOfferingNotFoundFault | client | Specified offering does not exist. |
| UnsupportedOperationFault | client | The requested operation isn't supported. |
| RedshiftServiceException | Base exception class for all service exceptions from Redshift service. |