1// Code generated by smithy-go-codegen DO NOT EDIT. 2 3package health 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/health/types" 11 "github.com/aws/smithy-go/middleware" 12 smithyhttp "github.com/aws/smithy-go/transport/http" 13) 14 15// Returns the event types that meet the specified filter criteria. If no filter 16// criteria are specified, all event types are returned, in no particular order. 17// This API operation uses pagination. Specify the nextToken parameter in the next 18// request to return more results. 19func (c *Client) DescribeEventTypes(ctx context.Context, params *DescribeEventTypesInput, optFns ...func(*Options)) (*DescribeEventTypesOutput, error) { 20 if params == nil { 21 params = &DescribeEventTypesInput{} 22 } 23 24 result, metadata, err := c.invokeOperation(ctx, "DescribeEventTypes", params, optFns, addOperationDescribeEventTypesMiddlewares) 25 if err != nil { 26 return nil, err 27 } 28 29 out := result.(*DescribeEventTypesOutput) 30 out.ResultMetadata = metadata 31 return out, nil 32} 33 34type DescribeEventTypesInput struct { 35 36 // Values to narrow the results returned. 37 Filter *types.EventTypeFilter 38 39 // The locale (language) to return information in. English (en) is the default and 40 // the only supported value at this time. 41 Locale *string 42 43 // The maximum number of items to return in one batch, between 10 and 100, 44 // inclusive. 45 MaxResults *int32 46 47 // If the results of a search are large, only a portion of the results are 48 // returned, and a nextToken pagination token is returned in the response. To 49 // retrieve the next batch of results, reissue the search request and include the 50 // returned token. When all results have been returned, the response does not 51 // contain a pagination token value. 52 NextToken *string 53} 54 55type DescribeEventTypesOutput struct { 56 57 // A list of event types that match the filter criteria. Event types have a 58 // category (issue, accountNotification, or scheduledChange), a service (for 59 // example, EC2, RDS, DATAPIPELINE, BILLING), and a code (in the format 60 // AWS_SERVICE_DESCRIPTION ; for example, AWS_EC2_SYSTEM_MAINTENANCE_EVENT). 61 EventTypes []types.EventType 62 63 // If the results of a search are large, only a portion of the results are 64 // returned, and a nextToken pagination token is returned in the response. To 65 // retrieve the next batch of results, reissue the search request and include the 66 // returned token. When all results have been returned, the response does not 67 // contain a pagination token value. 68 NextToken *string 69 70 // Metadata pertaining to the operation's result. 71 ResultMetadata middleware.Metadata 72} 73 74func addOperationDescribeEventTypesMiddlewares(stack *middleware.Stack, options Options) (err error) { 75 err = stack.Serialize.Add(&awsAwsjson11_serializeOpDescribeEventTypes{}, middleware.After) 76 if err != nil { 77 return err 78 } 79 err = stack.Deserialize.Add(&awsAwsjson11_deserializeOpDescribeEventTypes{}, middleware.After) 80 if err != nil { 81 return err 82 } 83 if err = addSetLoggerMiddleware(stack, options); err != nil { 84 return err 85 } 86 if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil { 87 return err 88 } 89 if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil { 90 return err 91 } 92 if err = addResolveEndpointMiddleware(stack, options); err != nil { 93 return err 94 } 95 if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil { 96 return err 97 } 98 if err = addRetryMiddlewares(stack, options); err != nil { 99 return err 100 } 101 if err = addHTTPSignerV4Middleware(stack, options); err != nil { 102 return err 103 } 104 if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil { 105 return err 106 } 107 if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil { 108 return err 109 } 110 if err = addClientUserAgent(stack); err != nil { 111 return err 112 } 113 if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil { 114 return err 115 } 116 if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil { 117 return err 118 } 119 if err = stack.Initialize.Add(newServiceMetadataMiddleware_opDescribeEventTypes(options.Region), middleware.Before); err != nil { 120 return err 121 } 122 if err = addRequestIDRetrieverMiddleware(stack); err != nil { 123 return err 124 } 125 if err = addResponseErrorMiddleware(stack); err != nil { 126 return err 127 } 128 if err = addRequestResponseLogging(stack, options); err != nil { 129 return err 130 } 131 return nil 132} 133 134// DescribeEventTypesAPIClient is a client that implements the DescribeEventTypes 135// operation. 136type DescribeEventTypesAPIClient interface { 137 DescribeEventTypes(context.Context, *DescribeEventTypesInput, ...func(*Options)) (*DescribeEventTypesOutput, error) 138} 139 140var _ DescribeEventTypesAPIClient = (*Client)(nil) 141 142// DescribeEventTypesPaginatorOptions is the paginator options for 143// DescribeEventTypes 144type DescribeEventTypesPaginatorOptions struct { 145 // The maximum number of items to return in one batch, between 10 and 100, 146 // inclusive. 147 Limit int32 148 149 // Set to true if pagination should stop if the service returns a pagination token 150 // that matches the most recent token provided to the service. 151 StopOnDuplicateToken bool 152} 153 154// DescribeEventTypesPaginator is a paginator for DescribeEventTypes 155type DescribeEventTypesPaginator struct { 156 options DescribeEventTypesPaginatorOptions 157 client DescribeEventTypesAPIClient 158 params *DescribeEventTypesInput 159 nextToken *string 160 firstPage bool 161} 162 163// NewDescribeEventTypesPaginator returns a new DescribeEventTypesPaginator 164func NewDescribeEventTypesPaginator(client DescribeEventTypesAPIClient, params *DescribeEventTypesInput, optFns ...func(*DescribeEventTypesPaginatorOptions)) *DescribeEventTypesPaginator { 165 options := DescribeEventTypesPaginatorOptions{} 166 if params.MaxResults != nil { 167 options.Limit = *params.MaxResults 168 } 169 170 for _, fn := range optFns { 171 fn(&options) 172 } 173 174 if params == nil { 175 params = &DescribeEventTypesInput{} 176 } 177 178 return &DescribeEventTypesPaginator{ 179 options: options, 180 client: client, 181 params: params, 182 firstPage: true, 183 } 184} 185 186// HasMorePages returns a boolean indicating whether more pages are available 187func (p *DescribeEventTypesPaginator) HasMorePages() bool { 188 return p.firstPage || p.nextToken != nil 189} 190 191// NextPage retrieves the next DescribeEventTypes page. 192func (p *DescribeEventTypesPaginator) NextPage(ctx context.Context, optFns ...func(*Options)) (*DescribeEventTypesOutput, error) { 193 if !p.HasMorePages() { 194 return nil, fmt.Errorf("no more pages available") 195 } 196 197 params := *p.params 198 params.NextToken = p.nextToken 199 200 var limit *int32 201 if p.options.Limit > 0 { 202 limit = &p.options.Limit 203 } 204 params.MaxResults = limit 205 206 result, err := p.client.DescribeEventTypes(ctx, ¶ms, optFns...) 207 if err != nil { 208 return nil, err 209 } 210 p.firstPage = false 211 212 prevToken := p.nextToken 213 p.nextToken = result.NextToken 214 215 if p.options.StopOnDuplicateToken && prevToken != nil && p.nextToken != nil && *prevToken == *p.nextToken { 216 p.nextToken = nil 217 } 218 219 return result, nil 220} 221 222func newServiceMetadataMiddleware_opDescribeEventTypes(region string) *awsmiddleware.RegisterServiceMetadata { 223 return &awsmiddleware.RegisterServiceMetadata{ 224 Region: region, 225 ServiceID: ServiceID, 226 SigningName: "health", 227 OperationName: "DescribeEventTypes", 228 } 229} 230