1// Code generated by smithy-go-codegen DO NOT EDIT. 2 3package ec2 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/ec2/types" 11 "github.com/aws/smithy-go/middleware" 12 smithyhttp "github.com/aws/smithy-go/transport/http" 13) 14 15// Describes one or more of your internet gateways. 16func (c *Client) DescribeInternetGateways(ctx context.Context, params *DescribeInternetGatewaysInput, optFns ...func(*Options)) (*DescribeInternetGatewaysOutput, error) { 17 if params == nil { 18 params = &DescribeInternetGatewaysInput{} 19 } 20 21 result, metadata, err := c.invokeOperation(ctx, "DescribeInternetGateways", params, optFns, addOperationDescribeInternetGatewaysMiddlewares) 22 if err != nil { 23 return nil, err 24 } 25 26 out := result.(*DescribeInternetGatewaysOutput) 27 out.ResultMetadata = metadata 28 return out, nil 29} 30 31type DescribeInternetGatewaysInput struct { 32 33 // Checks whether you have the required permissions for the action, without 34 // actually making the request, and provides an error response. If you have the 35 // required permissions, the error response is DryRunOperation. Otherwise, it is 36 // UnauthorizedOperation. 37 DryRun bool 38 39 // One or more filters. 40 // 41 // * attachment.state - The current state of the attachment 42 // between the gateway and the VPC (available). Present only if a VPC is 43 // attached. 44 // 45 // * attachment.vpc-id - The ID of an attached VPC. 46 // 47 // * 48 // internet-gateway-id - The ID of the Internet gateway. 49 // 50 // * owner-id - The ID of 51 // the AWS account that owns the internet gateway. 52 // 53 // * tag: - The key/value 54 // combination of a tag assigned to the resource. Use the tag key in the filter 55 // name and the tag value as the filter value. For example, to find all resources 56 // that have a tag with the key Owner and the value TeamA, specify tag:Owner for 57 // the filter name and TeamA for the filter value. 58 // 59 // * tag-key - The key of a tag 60 // assigned to the resource. Use this filter to find all resources assigned a tag 61 // with a specific key, regardless of the tag value. 62 Filters []types.Filter 63 64 // One or more internet gateway IDs. Default: Describes all your internet gateways. 65 InternetGatewayIds []string 66 67 // The maximum number of results to return with a single call. To retrieve the 68 // remaining results, make another call with the returned nextToken value. 69 MaxResults int32 70 71 // The token for the next page of results. 72 NextToken *string 73} 74 75type DescribeInternetGatewaysOutput struct { 76 77 // Information about one or more internet gateways. 78 InternetGateways []types.InternetGateway 79 80 // The token to use to retrieve the next page of results. This value is null when 81 // there are no more results to return. 82 NextToken *string 83 84 // Metadata pertaining to the operation's result. 85 ResultMetadata middleware.Metadata 86} 87 88func addOperationDescribeInternetGatewaysMiddlewares(stack *middleware.Stack, options Options) (err error) { 89 err = stack.Serialize.Add(&awsEc2query_serializeOpDescribeInternetGateways{}, middleware.After) 90 if err != nil { 91 return err 92 } 93 err = stack.Deserialize.Add(&awsEc2query_deserializeOpDescribeInternetGateways{}, middleware.After) 94 if err != nil { 95 return err 96 } 97 if err = addSetLoggerMiddleware(stack, options); err != nil { 98 return err 99 } 100 if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil { 101 return err 102 } 103 if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil { 104 return err 105 } 106 if err = addResolveEndpointMiddleware(stack, options); err != nil { 107 return err 108 } 109 if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil { 110 return err 111 } 112 if err = addRetryMiddlewares(stack, options); err != nil { 113 return err 114 } 115 if err = addHTTPSignerV4Middleware(stack, options); err != nil { 116 return err 117 } 118 if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil { 119 return err 120 } 121 if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil { 122 return err 123 } 124 if err = addClientUserAgent(stack); err != nil { 125 return err 126 } 127 if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil { 128 return err 129 } 130 if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil { 131 return err 132 } 133 if err = stack.Initialize.Add(newServiceMetadataMiddleware_opDescribeInternetGateways(options.Region), middleware.Before); err != nil { 134 return err 135 } 136 if err = addRequestIDRetrieverMiddleware(stack); err != nil { 137 return err 138 } 139 if err = addResponseErrorMiddleware(stack); err != nil { 140 return err 141 } 142 if err = addRequestResponseLogging(stack, options); err != nil { 143 return err 144 } 145 return nil 146} 147 148// DescribeInternetGatewaysAPIClient is a client that implements the 149// DescribeInternetGateways operation. 150type DescribeInternetGatewaysAPIClient interface { 151 DescribeInternetGateways(context.Context, *DescribeInternetGatewaysInput, ...func(*Options)) (*DescribeInternetGatewaysOutput, error) 152} 153 154var _ DescribeInternetGatewaysAPIClient = (*Client)(nil) 155 156// DescribeInternetGatewaysPaginatorOptions is the paginator options for 157// DescribeInternetGateways 158type DescribeInternetGatewaysPaginatorOptions struct { 159 // The maximum number of results to return with a single call. To retrieve the 160 // remaining results, make another call with the returned nextToken value. 161 Limit int32 162 163 // Set to true if pagination should stop if the service returns a pagination token 164 // that matches the most recent token provided to the service. 165 StopOnDuplicateToken bool 166} 167 168// DescribeInternetGatewaysPaginator is a paginator for DescribeInternetGateways 169type DescribeInternetGatewaysPaginator struct { 170 options DescribeInternetGatewaysPaginatorOptions 171 client DescribeInternetGatewaysAPIClient 172 params *DescribeInternetGatewaysInput 173 nextToken *string 174 firstPage bool 175} 176 177// NewDescribeInternetGatewaysPaginator returns a new 178// DescribeInternetGatewaysPaginator 179func NewDescribeInternetGatewaysPaginator(client DescribeInternetGatewaysAPIClient, params *DescribeInternetGatewaysInput, optFns ...func(*DescribeInternetGatewaysPaginatorOptions)) *DescribeInternetGatewaysPaginator { 180 options := DescribeInternetGatewaysPaginatorOptions{} 181 if params.MaxResults != 0 { 182 options.Limit = params.MaxResults 183 } 184 185 for _, fn := range optFns { 186 fn(&options) 187 } 188 189 if params == nil { 190 params = &DescribeInternetGatewaysInput{} 191 } 192 193 return &DescribeInternetGatewaysPaginator{ 194 options: options, 195 client: client, 196 params: params, 197 firstPage: true, 198 } 199} 200 201// HasMorePages returns a boolean indicating whether more pages are available 202func (p *DescribeInternetGatewaysPaginator) HasMorePages() bool { 203 return p.firstPage || p.nextToken != nil 204} 205 206// NextPage retrieves the next DescribeInternetGateways page. 207func (p *DescribeInternetGatewaysPaginator) NextPage(ctx context.Context, optFns ...func(*Options)) (*DescribeInternetGatewaysOutput, error) { 208 if !p.HasMorePages() { 209 return nil, fmt.Errorf("no more pages available") 210 } 211 212 params := *p.params 213 params.NextToken = p.nextToken 214 215 params.MaxResults = p.options.Limit 216 217 result, err := p.client.DescribeInternetGateways(ctx, ¶ms, optFns...) 218 if err != nil { 219 return nil, err 220 } 221 p.firstPage = false 222 223 prevToken := p.nextToken 224 p.nextToken = result.NextToken 225 226 if p.options.StopOnDuplicateToken && prevToken != nil && p.nextToken != nil && *prevToken == *p.nextToken { 227 p.nextToken = nil 228 } 229 230 return result, nil 231} 232 233func newServiceMetadataMiddleware_opDescribeInternetGateways(region string) *awsmiddleware.RegisterServiceMetadata { 234 return &awsmiddleware.RegisterServiceMetadata{ 235 Region: region, 236 ServiceID: ServiceID, 237 SigningName: "ec2", 238 OperationName: "DescribeInternetGateways", 239 } 240} 241