1// Code generated by smithy-go-codegen DO NOT EDIT. 2 3package ec2 4 5import ( 6 "context" 7 awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware" 8 "github.com/aws/aws-sdk-go-v2/aws/signer/v4" 9 "github.com/aws/aws-sdk-go-v2/service/ec2/types" 10 "github.com/aws/smithy-go/middleware" 11 smithyhttp "github.com/aws/smithy-go/transport/http" 12 "time" 13) 14 15// Purchases a Reserved Instance for use with your account. With Reserved 16// Instances, you pay a lower hourly rate compared to On-Demand instance pricing. 17// Use DescribeReservedInstancesOfferings to get a list of Reserved Instance 18// offerings that match your specifications. After you've purchased a Reserved 19// Instance, you can check for your new Reserved Instance with 20// DescribeReservedInstances. To queue a purchase for a future date and time, 21// specify a purchase time. If you do not specify a purchase time, the default is 22// the current time. For more information, see Reserved Instances 23// (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/concepts-on-demand-reserved-instances.html) 24// and Reserved Instance Marketplace 25// (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ri-market-general.html) in 26// the Amazon EC2 User Guide. 27func (c *Client) PurchaseReservedInstancesOffering(ctx context.Context, params *PurchaseReservedInstancesOfferingInput, optFns ...func(*Options)) (*PurchaseReservedInstancesOfferingOutput, error) { 28 if params == nil { 29 params = &PurchaseReservedInstancesOfferingInput{} 30 } 31 32 result, metadata, err := c.invokeOperation(ctx, "PurchaseReservedInstancesOffering", params, optFns, addOperationPurchaseReservedInstancesOfferingMiddlewares) 33 if err != nil { 34 return nil, err 35 } 36 37 out := result.(*PurchaseReservedInstancesOfferingOutput) 38 out.ResultMetadata = metadata 39 return out, nil 40} 41 42// Contains the parameters for PurchaseReservedInstancesOffering. 43type PurchaseReservedInstancesOfferingInput struct { 44 45 // The number of Reserved Instances to purchase. 46 // 47 // This member is required. 48 InstanceCount int32 49 50 // The ID of the Reserved Instance offering to purchase. 51 // 52 // This member is required. 53 ReservedInstancesOfferingId *string 54 55 // Checks whether you have the required permissions for the action, without 56 // actually making the request, and provides an error response. If you have the 57 // required permissions, the error response is DryRunOperation. Otherwise, it is 58 // UnauthorizedOperation. 59 DryRun bool 60 61 // Specified for Reserved Instance Marketplace offerings to limit the total order 62 // and ensure that the Reserved Instances are not purchased at unexpected prices. 63 LimitPrice *types.ReservedInstanceLimitPrice 64 65 // The time at which to purchase the Reserved Instance, in UTC format (for example, 66 // YYYY-MM-DDTHH:MM:SSZ). 67 PurchaseTime *time.Time 68} 69 70// Contains the output of PurchaseReservedInstancesOffering. 71type PurchaseReservedInstancesOfferingOutput struct { 72 73 // The IDs of the purchased Reserved Instances. 74 ReservedInstancesId *string 75 76 // Metadata pertaining to the operation's result. 77 ResultMetadata middleware.Metadata 78} 79 80func addOperationPurchaseReservedInstancesOfferingMiddlewares(stack *middleware.Stack, options Options) (err error) { 81 err = stack.Serialize.Add(&awsEc2query_serializeOpPurchaseReservedInstancesOffering{}, middleware.After) 82 if err != nil { 83 return err 84 } 85 err = stack.Deserialize.Add(&awsEc2query_deserializeOpPurchaseReservedInstancesOffering{}, middleware.After) 86 if err != nil { 87 return err 88 } 89 if err = addSetLoggerMiddleware(stack, options); err != nil { 90 return err 91 } 92 if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil { 93 return err 94 } 95 if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil { 96 return err 97 } 98 if err = addResolveEndpointMiddleware(stack, options); err != nil { 99 return err 100 } 101 if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil { 102 return err 103 } 104 if err = addRetryMiddlewares(stack, options); err != nil { 105 return err 106 } 107 if err = addHTTPSignerV4Middleware(stack, options); err != nil { 108 return err 109 } 110 if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil { 111 return err 112 } 113 if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil { 114 return err 115 } 116 if err = addClientUserAgent(stack); err != nil { 117 return err 118 } 119 if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil { 120 return err 121 } 122 if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil { 123 return err 124 } 125 if err = addOpPurchaseReservedInstancesOfferingValidationMiddleware(stack); err != nil { 126 return err 127 } 128 if err = stack.Initialize.Add(newServiceMetadataMiddleware_opPurchaseReservedInstancesOffering(options.Region), middleware.Before); err != nil { 129 return err 130 } 131 if err = addRequestIDRetrieverMiddleware(stack); err != nil { 132 return err 133 } 134 if err = addResponseErrorMiddleware(stack); err != nil { 135 return err 136 } 137 if err = addRequestResponseLogging(stack, options); err != nil { 138 return err 139 } 140 return nil 141} 142 143func newServiceMetadataMiddleware_opPurchaseReservedInstancesOffering(region string) *awsmiddleware.RegisterServiceMetadata { 144 return &awsmiddleware.RegisterServiceMetadata{ 145 Region: region, 146 ServiceID: ServiceID, 147 SigningName: "ec2", 148 OperationName: "PurchaseReservedInstancesOffering", 149 } 150} 151