1// Code generated by smithy-go-codegen DO NOT EDIT. 2 3package redshift 4 5import ( 6 "context" 7 "fmt" 8 awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware" 9 "github.com/aws/aws-sdk-go-v2/aws/signer/v4" 10 "github.com/aws/aws-sdk-go-v2/service/redshift/types" 11 "github.com/aws/smithy-go/middleware" 12 smithyhttp "github.com/aws/smithy-go/transport/http" 13) 14 15// Returns a list of all the available maintenance tracks. 16func (c *Client) DescribeClusterTracks(ctx context.Context, params *DescribeClusterTracksInput, optFns ...func(*Options)) (*DescribeClusterTracksOutput, error) { 17 if params == nil { 18 params = &DescribeClusterTracksInput{} 19 } 20 21 result, metadata, err := c.invokeOperation(ctx, "DescribeClusterTracks", params, optFns, addOperationDescribeClusterTracksMiddlewares) 22 if err != nil { 23 return nil, err 24 } 25 26 out := result.(*DescribeClusterTracksOutput) 27 out.ResultMetadata = metadata 28 return out, nil 29} 30 31type DescribeClusterTracksInput struct { 32 33 // The name of the maintenance track. 34 MaintenanceTrackName *string 35 36 // An optional parameter that specifies the starting point to return a set of 37 // response records. When the results of a DescribeClusterTracks request exceed the 38 // value specified in MaxRecords, Amazon Redshift returns a value in the Marker 39 // field of the response. You can retrieve the next set of response records by 40 // providing the returned marker value in the Marker parameter and retrying the 41 // request. 42 Marker *string 43 44 // An integer value for the maximum number of maintenance tracks to return. 45 MaxRecords *int32 46} 47 48type DescribeClusterTracksOutput struct { 49 50 // A list of maintenance tracks output by the DescribeClusterTracks operation. 51 MaintenanceTracks []types.MaintenanceTrack 52 53 // The starting point to return a set of response tracklist records. You can 54 // retrieve the next set of response records by providing the returned marker value 55 // in the Marker parameter and retrying the request. 56 Marker *string 57 58 // Metadata pertaining to the operation's result. 59 ResultMetadata middleware.Metadata 60} 61 62func addOperationDescribeClusterTracksMiddlewares(stack *middleware.Stack, options Options) (err error) { 63 err = stack.Serialize.Add(&awsAwsquery_serializeOpDescribeClusterTracks{}, middleware.After) 64 if err != nil { 65 return err 66 } 67 err = stack.Deserialize.Add(&awsAwsquery_deserializeOpDescribeClusterTracks{}, middleware.After) 68 if err != nil { 69 return err 70 } 71 if err = addSetLoggerMiddleware(stack, options); err != nil { 72 return err 73 } 74 if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil { 75 return err 76 } 77 if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil { 78 return err 79 } 80 if err = addResolveEndpointMiddleware(stack, options); err != nil { 81 return err 82 } 83 if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil { 84 return err 85 } 86 if err = addRetryMiddlewares(stack, options); err != nil { 87 return err 88 } 89 if err = addHTTPSignerV4Middleware(stack, options); err != nil { 90 return err 91 } 92 if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil { 93 return err 94 } 95 if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil { 96 return err 97 } 98 if err = addClientUserAgent(stack); err != nil { 99 return err 100 } 101 if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil { 102 return err 103 } 104 if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil { 105 return err 106 } 107 if err = stack.Initialize.Add(newServiceMetadataMiddleware_opDescribeClusterTracks(options.Region), middleware.Before); err != nil { 108 return err 109 } 110 if err = addRequestIDRetrieverMiddleware(stack); err != nil { 111 return err 112 } 113 if err = addResponseErrorMiddleware(stack); err != nil { 114 return err 115 } 116 if err = addRequestResponseLogging(stack, options); err != nil { 117 return err 118 } 119 return nil 120} 121 122// DescribeClusterTracksAPIClient is a client that implements the 123// DescribeClusterTracks operation. 124type DescribeClusterTracksAPIClient interface { 125 DescribeClusterTracks(context.Context, *DescribeClusterTracksInput, ...func(*Options)) (*DescribeClusterTracksOutput, error) 126} 127 128var _ DescribeClusterTracksAPIClient = (*Client)(nil) 129 130// DescribeClusterTracksPaginatorOptions is the paginator options for 131// DescribeClusterTracks 132type DescribeClusterTracksPaginatorOptions struct { 133 // An integer value for the maximum number of maintenance tracks to return. 134 Limit int32 135 136 // Set to true if pagination should stop if the service returns a pagination token 137 // that matches the most recent token provided to the service. 138 StopOnDuplicateToken bool 139} 140 141// DescribeClusterTracksPaginator is a paginator for DescribeClusterTracks 142type DescribeClusterTracksPaginator struct { 143 options DescribeClusterTracksPaginatorOptions 144 client DescribeClusterTracksAPIClient 145 params *DescribeClusterTracksInput 146 nextToken *string 147 firstPage bool 148} 149 150// NewDescribeClusterTracksPaginator returns a new DescribeClusterTracksPaginator 151func NewDescribeClusterTracksPaginator(client DescribeClusterTracksAPIClient, params *DescribeClusterTracksInput, optFns ...func(*DescribeClusterTracksPaginatorOptions)) *DescribeClusterTracksPaginator { 152 if params == nil { 153 params = &DescribeClusterTracksInput{} 154 } 155 156 options := DescribeClusterTracksPaginatorOptions{} 157 if params.MaxRecords != nil { 158 options.Limit = *params.MaxRecords 159 } 160 161 for _, fn := range optFns { 162 fn(&options) 163 } 164 165 return &DescribeClusterTracksPaginator{ 166 options: options, 167 client: client, 168 params: params, 169 firstPage: true, 170 } 171} 172 173// HasMorePages returns a boolean indicating whether more pages are available 174func (p *DescribeClusterTracksPaginator) HasMorePages() bool { 175 return p.firstPage || p.nextToken != nil 176} 177 178// NextPage retrieves the next DescribeClusterTracks page. 179func (p *DescribeClusterTracksPaginator) NextPage(ctx context.Context, optFns ...func(*Options)) (*DescribeClusterTracksOutput, error) { 180 if !p.HasMorePages() { 181 return nil, fmt.Errorf("no more pages available") 182 } 183 184 params := *p.params 185 params.Marker = p.nextToken 186 187 var limit *int32 188 if p.options.Limit > 0 { 189 limit = &p.options.Limit 190 } 191 params.MaxRecords = limit 192 193 result, err := p.client.DescribeClusterTracks(ctx, ¶ms, optFns...) 194 if err != nil { 195 return nil, err 196 } 197 p.firstPage = false 198 199 prevToken := p.nextToken 200 p.nextToken = result.Marker 201 202 if p.options.StopOnDuplicateToken && prevToken != nil && p.nextToken != nil && *prevToken == *p.nextToken { 203 p.nextToken = nil 204 } 205 206 return result, nil 207} 208 209func newServiceMetadataMiddleware_opDescribeClusterTracks(region string) *awsmiddleware.RegisterServiceMetadata { 210 return &awsmiddleware.RegisterServiceMetadata{ 211 Region: region, 212 ServiceID: ServiceID, 213 SigningName: "redshift", 214 OperationName: "DescribeClusterTracks", 215 } 216} 217