1// Code generated by smithy-go-codegen DO NOT EDIT. 2 3package managedblockchain 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/managedblockchain/types" 11 "github.com/aws/smithy-go/middleware" 12 smithyhttp "github.com/aws/smithy-go/transport/http" 13) 14 15// Returns information about the nodes within a network. Applies to Hyperledger 16// Fabric and Ethereum. 17func (c *Client) ListNodes(ctx context.Context, params *ListNodesInput, optFns ...func(*Options)) (*ListNodesOutput, error) { 18 if params == nil { 19 params = &ListNodesInput{} 20 } 21 22 result, metadata, err := c.invokeOperation(ctx, "ListNodes", params, optFns, c.addOperationListNodesMiddlewares) 23 if err != nil { 24 return nil, err 25 } 26 27 out := result.(*ListNodesOutput) 28 out.ResultMetadata = metadata 29 return out, nil 30} 31 32type ListNodesInput struct { 33 34 // The unique identifier of the network for which to list nodes. 35 // 36 // This member is required. 37 NetworkId *string 38 39 // The maximum number of nodes to list. 40 MaxResults *int32 41 42 // The unique identifier of the member who owns the nodes to list. Applies only to 43 // Hyperledger Fabric and is required for Hyperledger Fabric. 44 MemberId *string 45 46 // The pagination token that indicates the next set of results to retrieve. 47 NextToken *string 48 49 // An optional status specifier. If provided, only nodes currently in this status 50 // are listed. 51 Status types.NodeStatus 52 53 noSmithyDocumentSerde 54} 55 56type ListNodesOutput struct { 57 58 // The pagination token that indicates the next set of results to retrieve. 59 NextToken *string 60 61 // An array of NodeSummary objects that contain configuration properties for each 62 // node. 63 Nodes []types.NodeSummary 64 65 // Metadata pertaining to the operation's result. 66 ResultMetadata middleware.Metadata 67 68 noSmithyDocumentSerde 69} 70 71func (c *Client) addOperationListNodesMiddlewares(stack *middleware.Stack, options Options) (err error) { 72 err = stack.Serialize.Add(&awsRestjson1_serializeOpListNodes{}, middleware.After) 73 if err != nil { 74 return err 75 } 76 err = stack.Deserialize.Add(&awsRestjson1_deserializeOpListNodes{}, middleware.After) 77 if err != nil { 78 return err 79 } 80 if err = addSetLoggerMiddleware(stack, options); err != nil { 81 return err 82 } 83 if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil { 84 return err 85 } 86 if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil { 87 return err 88 } 89 if err = addResolveEndpointMiddleware(stack, options); err != nil { 90 return err 91 } 92 if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil { 93 return err 94 } 95 if err = addRetryMiddlewares(stack, options); err != nil { 96 return err 97 } 98 if err = addHTTPSignerV4Middleware(stack, options); err != nil { 99 return err 100 } 101 if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil { 102 return err 103 } 104 if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil { 105 return err 106 } 107 if err = addClientUserAgent(stack); err != nil { 108 return err 109 } 110 if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil { 111 return err 112 } 113 if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil { 114 return err 115 } 116 if err = addOpListNodesValidationMiddleware(stack); err != nil { 117 return err 118 } 119 if err = stack.Initialize.Add(newServiceMetadataMiddleware_opListNodes(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// ListNodesAPIClient is a client that implements the ListNodes operation. 135type ListNodesAPIClient interface { 136 ListNodes(context.Context, *ListNodesInput, ...func(*Options)) (*ListNodesOutput, error) 137} 138 139var _ ListNodesAPIClient = (*Client)(nil) 140 141// ListNodesPaginatorOptions is the paginator options for ListNodes 142type ListNodesPaginatorOptions struct { 143 // The maximum number of nodes to list. 144 Limit int32 145 146 // Set to true if pagination should stop if the service returns a pagination token 147 // that matches the most recent token provided to the service. 148 StopOnDuplicateToken bool 149} 150 151// ListNodesPaginator is a paginator for ListNodes 152type ListNodesPaginator struct { 153 options ListNodesPaginatorOptions 154 client ListNodesAPIClient 155 params *ListNodesInput 156 nextToken *string 157 firstPage bool 158} 159 160// NewListNodesPaginator returns a new ListNodesPaginator 161func NewListNodesPaginator(client ListNodesAPIClient, params *ListNodesInput, optFns ...func(*ListNodesPaginatorOptions)) *ListNodesPaginator { 162 if params == nil { 163 params = &ListNodesInput{} 164 } 165 166 options := ListNodesPaginatorOptions{} 167 if params.MaxResults != nil { 168 options.Limit = *params.MaxResults 169 } 170 171 for _, fn := range optFns { 172 fn(&options) 173 } 174 175 return &ListNodesPaginator{ 176 options: options, 177 client: client, 178 params: params, 179 firstPage: true, 180 } 181} 182 183// HasMorePages returns a boolean indicating whether more pages are available 184func (p *ListNodesPaginator) HasMorePages() bool { 185 return p.firstPage || p.nextToken != nil 186} 187 188// NextPage retrieves the next ListNodes page. 189func (p *ListNodesPaginator) NextPage(ctx context.Context, optFns ...func(*Options)) (*ListNodesOutput, error) { 190 if !p.HasMorePages() { 191 return nil, fmt.Errorf("no more pages available") 192 } 193 194 params := *p.params 195 params.NextToken = p.nextToken 196 197 var limit *int32 198 if p.options.Limit > 0 { 199 limit = &p.options.Limit 200 } 201 params.MaxResults = limit 202 203 result, err := p.client.ListNodes(ctx, ¶ms, optFns...) 204 if err != nil { 205 return nil, err 206 } 207 p.firstPage = false 208 209 prevToken := p.nextToken 210 p.nextToken = result.NextToken 211 212 if p.options.StopOnDuplicateToken && prevToken != nil && p.nextToken != nil && *prevToken == *p.nextToken { 213 p.nextToken = nil 214 } 215 216 return result, nil 217} 218 219func newServiceMetadataMiddleware_opListNodes(region string) *awsmiddleware.RegisterServiceMetadata { 220 return &awsmiddleware.RegisterServiceMetadata{ 221 Region: region, 222 ServiceID: ServiceID, 223 SigningName: "managedblockchain", 224 OperationName: "ListNodes", 225 } 226} 227