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) 13 14// Describes your account's Reserved Instance listings in the Reserved Instance 15// Marketplace. The Reserved Instance Marketplace matches sellers who want to 16// resell Reserved Instance capacity that they no longer need with buyers who want 17// to purchase additional capacity. Reserved Instances bought and sold through the 18// Reserved Instance Marketplace work like any other Reserved Instances. As a 19// seller, you choose to list some or all of your Reserved Instances, and you 20// specify the upfront price to receive for them. Your Reserved Instances are then 21// listed in the Reserved Instance Marketplace and are available for purchase. As a 22// buyer, you specify the configuration of the Reserved Instance to purchase, and 23// the Marketplace matches what you're searching for with what's available. The 24// Marketplace first sells the lowest priced Reserved Instances to you, and 25// continues to sell available Reserved Instance listings to you until your demand 26// is met. You are charged based on the total price of all of the listings that you 27// purchase. For more information, see Reserved Instance Marketplace 28// (https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ri-market-general.html) in 29// the Amazon EC2 User Guide. 30func (c *Client) DescribeReservedInstancesListings(ctx context.Context, params *DescribeReservedInstancesListingsInput, optFns ...func(*Options)) (*DescribeReservedInstancesListingsOutput, error) { 31 if params == nil { 32 params = &DescribeReservedInstancesListingsInput{} 33 } 34 35 result, metadata, err := c.invokeOperation(ctx, "DescribeReservedInstancesListings", params, optFns, addOperationDescribeReservedInstancesListingsMiddlewares) 36 if err != nil { 37 return nil, err 38 } 39 40 out := result.(*DescribeReservedInstancesListingsOutput) 41 out.ResultMetadata = metadata 42 return out, nil 43} 44 45// Contains the parameters for DescribeReservedInstancesListings. 46type DescribeReservedInstancesListingsInput struct { 47 48 // One or more filters. 49 // 50 // * reserved-instances-id - The ID of the Reserved 51 // Instances. 52 // 53 // * reserved-instances-listing-id - The ID of the Reserved Instances 54 // listing. 55 // 56 // * status - The status of the Reserved Instance listing (pending | 57 // active | cancelled | closed). 58 // 59 // * status-message - The reason for the status. 60 Filters []types.Filter 61 62 // One or more Reserved Instance IDs. 63 ReservedInstancesId *string 64 65 // One or more Reserved Instance listing IDs. 66 ReservedInstancesListingId *string 67} 68 69// Contains the output of DescribeReservedInstancesListings. 70type DescribeReservedInstancesListingsOutput struct { 71 72 // Information about the Reserved Instance listing. 73 ReservedInstancesListings []types.ReservedInstancesListing 74 75 // Metadata pertaining to the operation's result. 76 ResultMetadata middleware.Metadata 77} 78 79func addOperationDescribeReservedInstancesListingsMiddlewares(stack *middleware.Stack, options Options) (err error) { 80 err = stack.Serialize.Add(&awsEc2query_serializeOpDescribeReservedInstancesListings{}, middleware.After) 81 if err != nil { 82 return err 83 } 84 err = stack.Deserialize.Add(&awsEc2query_deserializeOpDescribeReservedInstancesListings{}, middleware.After) 85 if err != nil { 86 return err 87 } 88 if err = addSetLoggerMiddleware(stack, options); err != nil { 89 return err 90 } 91 if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil { 92 return err 93 } 94 if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil { 95 return err 96 } 97 if err = addResolveEndpointMiddleware(stack, options); err != nil { 98 return err 99 } 100 if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil { 101 return err 102 } 103 if err = addRetryMiddlewares(stack, options); err != nil { 104 return err 105 } 106 if err = addHTTPSignerV4Middleware(stack, options); err != nil { 107 return err 108 } 109 if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil { 110 return err 111 } 112 if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil { 113 return err 114 } 115 if err = addClientUserAgent(stack); err != nil { 116 return err 117 } 118 if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil { 119 return err 120 } 121 if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil { 122 return err 123 } 124 if err = stack.Initialize.Add(newServiceMetadataMiddleware_opDescribeReservedInstancesListings(options.Region), middleware.Before); err != nil { 125 return err 126 } 127 if err = addRequestIDRetrieverMiddleware(stack); err != nil { 128 return err 129 } 130 if err = addResponseErrorMiddleware(stack); err != nil { 131 return err 132 } 133 if err = addRequestResponseLogging(stack, options); err != nil { 134 return err 135 } 136 return nil 137} 138 139func newServiceMetadataMiddleware_opDescribeReservedInstancesListings(region string) *awsmiddleware.RegisterServiceMetadata { 140 return &awsmiddleware.RegisterServiceMetadata{ 141 Region: region, 142 ServiceID: ServiceID, 143 SigningName: "ec2", 144 OperationName: "DescribeReservedInstancesListings", 145 } 146} 147