1// Code generated by smithy-go-codegen DO NOT EDIT. 2 3package auditmanager 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/auditmanager/types" 11 "github.com/aws/smithy-go/middleware" 12 smithyhttp "github.com/aws/smithy-go/transport/http" 13) 14 15// Returns a list of controls from AWS Audit Manager. 16func (c *Client) ListControls(ctx context.Context, params *ListControlsInput, optFns ...func(*Options)) (*ListControlsOutput, error) { 17 if params == nil { 18 params = &ListControlsInput{} 19 } 20 21 result, metadata, err := c.invokeOperation(ctx, "ListControls", params, optFns, addOperationListControlsMiddlewares) 22 if err != nil { 23 return nil, err 24 } 25 26 out := result.(*ListControlsOutput) 27 out.ResultMetadata = metadata 28 return out, nil 29} 30 31type ListControlsInput struct { 32 33 // The type of control, such as standard or custom. 34 // 35 // This member is required. 36 ControlType types.ControlType 37 38 // Represents the maximum number of results per page, or per API request call. 39 MaxResults *int32 40 41 // The pagination token used to fetch the next set of results. 42 NextToken *string 43} 44 45type ListControlsOutput struct { 46 47 // The list of control metadata objects returned by the ListControls API. 48 ControlMetadataList []types.ControlMetadata 49 50 // The pagination token used to fetch the next set of results. 51 NextToken *string 52 53 // Metadata pertaining to the operation's result. 54 ResultMetadata middleware.Metadata 55} 56 57func addOperationListControlsMiddlewares(stack *middleware.Stack, options Options) (err error) { 58 err = stack.Serialize.Add(&awsRestjson1_serializeOpListControls{}, middleware.After) 59 if err != nil { 60 return err 61 } 62 err = stack.Deserialize.Add(&awsRestjson1_deserializeOpListControls{}, middleware.After) 63 if err != nil { 64 return err 65 } 66 if err = addSetLoggerMiddleware(stack, options); err != nil { 67 return err 68 } 69 if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil { 70 return err 71 } 72 if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil { 73 return err 74 } 75 if err = addResolveEndpointMiddleware(stack, options); err != nil { 76 return err 77 } 78 if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil { 79 return err 80 } 81 if err = addRetryMiddlewares(stack, options); err != nil { 82 return err 83 } 84 if err = addHTTPSignerV4Middleware(stack, options); err != nil { 85 return err 86 } 87 if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil { 88 return err 89 } 90 if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil { 91 return err 92 } 93 if err = addClientUserAgent(stack); err != nil { 94 return err 95 } 96 if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil { 97 return err 98 } 99 if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil { 100 return err 101 } 102 if err = addOpListControlsValidationMiddleware(stack); err != nil { 103 return err 104 } 105 if err = stack.Initialize.Add(newServiceMetadataMiddleware_opListControls(options.Region), middleware.Before); err != nil { 106 return err 107 } 108 if err = addRequestIDRetrieverMiddleware(stack); err != nil { 109 return err 110 } 111 if err = addResponseErrorMiddleware(stack); err != nil { 112 return err 113 } 114 if err = addRequestResponseLogging(stack, options); err != nil { 115 return err 116 } 117 return nil 118} 119 120// ListControlsAPIClient is a client that implements the ListControls operation. 121type ListControlsAPIClient interface { 122 ListControls(context.Context, *ListControlsInput, ...func(*Options)) (*ListControlsOutput, error) 123} 124 125var _ ListControlsAPIClient = (*Client)(nil) 126 127// ListControlsPaginatorOptions is the paginator options for ListControls 128type ListControlsPaginatorOptions struct { 129 // Represents the maximum number of results per page, or per API request call. 130 Limit int32 131 132 // Set to true if pagination should stop if the service returns a pagination token 133 // that matches the most recent token provided to the service. 134 StopOnDuplicateToken bool 135} 136 137// ListControlsPaginator is a paginator for ListControls 138type ListControlsPaginator struct { 139 options ListControlsPaginatorOptions 140 client ListControlsAPIClient 141 params *ListControlsInput 142 nextToken *string 143 firstPage bool 144} 145 146// NewListControlsPaginator returns a new ListControlsPaginator 147func NewListControlsPaginator(client ListControlsAPIClient, params *ListControlsInput, optFns ...func(*ListControlsPaginatorOptions)) *ListControlsPaginator { 148 if params == nil { 149 params = &ListControlsInput{} 150 } 151 152 options := ListControlsPaginatorOptions{} 153 if params.MaxResults != nil { 154 options.Limit = *params.MaxResults 155 } 156 157 for _, fn := range optFns { 158 fn(&options) 159 } 160 161 return &ListControlsPaginator{ 162 options: options, 163 client: client, 164 params: params, 165 firstPage: true, 166 } 167} 168 169// HasMorePages returns a boolean indicating whether more pages are available 170func (p *ListControlsPaginator) HasMorePages() bool { 171 return p.firstPage || p.nextToken != nil 172} 173 174// NextPage retrieves the next ListControls page. 175func (p *ListControlsPaginator) NextPage(ctx context.Context, optFns ...func(*Options)) (*ListControlsOutput, error) { 176 if !p.HasMorePages() { 177 return nil, fmt.Errorf("no more pages available") 178 } 179 180 params := *p.params 181 params.NextToken = p.nextToken 182 183 var limit *int32 184 if p.options.Limit > 0 { 185 limit = &p.options.Limit 186 } 187 params.MaxResults = limit 188 189 result, err := p.client.ListControls(ctx, ¶ms, optFns...) 190 if err != nil { 191 return nil, err 192 } 193 p.firstPage = false 194 195 prevToken := p.nextToken 196 p.nextToken = result.NextToken 197 198 if p.options.StopOnDuplicateToken && prevToken != nil && p.nextToken != nil && *prevToken == *p.nextToken { 199 p.nextToken = nil 200 } 201 202 return result, nil 203} 204 205func newServiceMetadataMiddleware_opListControls(region string) *awsmiddleware.RegisterServiceMetadata { 206 return &awsmiddleware.RegisterServiceMetadata{ 207 Region: region, 208 ServiceID: ServiceID, 209 SigningName: "auditmanager", 210 OperationName: "ListControls", 211 } 212} 213