github.com/deanMdreon/kafka-go@v0.4.32/incrementalalterconfigs.go (about)

     1  package kafka
     2  
     3  import (
     4  	"context"
     5  	"net"
     6  
     7  	"github.com/deanMdreon/kafka-go/protocol/incrementalalterconfigs"
     8  )
     9  
    10  type ConfigOperation int8
    11  
    12  const (
    13  	ConfigOperationSet      ConfigOperation = 0
    14  	ConfigOperationDelete   ConfigOperation = 1
    15  	ConfigOperationAppend   ConfigOperation = 2
    16  	ConfigOperationSubtract ConfigOperation = 3
    17  )
    18  
    19  // IncrementalAlterConfigsRequest is a request to the IncrementalAlterConfigs API.
    20  type IncrementalAlterConfigsRequest struct {
    21  	// Addr is the address of the kafka broker to send the request to.
    22  	Addr net.Addr
    23  
    24  	// Resources contains the list of resources to update configs for.
    25  	Resources []IncrementalAlterConfigsRequestResource
    26  
    27  	// ValidateOnly indicates whether Kafka should validate the changes without actually
    28  	// applying them.
    29  	ValidateOnly bool
    30  }
    31  
    32  // IncrementalAlterConfigsRequestResource contains the details of a single resource type whose
    33  // configs should be altered.
    34  type IncrementalAlterConfigsRequestResource struct {
    35  	// ResourceType is the type of resource to update.
    36  	ResourceType ResourceType
    37  
    38  	// ResourceName is the name of the resource to update (i.e., topic name or broker ID).
    39  	ResourceName string
    40  
    41  	// Configs contains the list of config key/values to update.
    42  	Configs []IncrementalAlterConfigsRequestConfig
    43  }
    44  
    45  // IncrementalAlterConfigsRequestConfig describes a single config key/value pair that should
    46  // be altered.
    47  type IncrementalAlterConfigsRequestConfig struct {
    48  	// Name is the name of the config.
    49  	Name string
    50  
    51  	// Value is the value to set for this config.
    52  	Value string
    53  
    54  	// ConfigOperation indicates how this config should be updated (e.g., add, delete, etc.).
    55  	ConfigOperation ConfigOperation
    56  }
    57  
    58  // IncrementalAlterConfigsResponse is a response from the IncrementalAlterConfigs API.
    59  type IncrementalAlterConfigsResponse struct {
    60  	// Resources contains details of each resource config that was updated.
    61  	Resources []IncrementalAlterConfigsResponseResource
    62  }
    63  
    64  // IncrementalAlterConfigsResponseResource contains the response details for a single resource
    65  // whose configs were updated.
    66  type IncrementalAlterConfigsResponseResource struct {
    67  	// Error is set to a non-nil value if an error occurred while updating this specific
    68  	// config.
    69  	Error error
    70  
    71  	// ResourceType is the type of resource that was updated.
    72  	ResourceType ResourceType
    73  
    74  	// ResourceName is the name of the resource that was updated.
    75  	ResourceName string
    76  }
    77  
    78  func (c *Client) IncrementalAlterConfigs(
    79  	ctx context.Context,
    80  	req *IncrementalAlterConfigsRequest,
    81  ) (*IncrementalAlterConfigsResponse, error) {
    82  	apiReq := &incrementalalterconfigs.Request{
    83  		ValidateOnly: req.ValidateOnly,
    84  	}
    85  
    86  	for _, res := range req.Resources {
    87  		apiRes := incrementalalterconfigs.RequestResource{
    88  			ResourceType: int8(res.ResourceType),
    89  			ResourceName: res.ResourceName,
    90  		}
    91  
    92  		for _, config := range res.Configs {
    93  			apiRes.Configs = append(
    94  				apiRes.Configs,
    95  				incrementalalterconfigs.RequestConfig{
    96  					Name:            config.Name,
    97  					Value:           config.Value,
    98  					ConfigOperation: int8(config.ConfigOperation),
    99  				},
   100  			)
   101  		}
   102  
   103  		apiReq.Resources = append(
   104  			apiReq.Resources,
   105  			apiRes,
   106  		)
   107  	}
   108  
   109  	protoResp, err := c.roundTrip(
   110  		ctx,
   111  		req.Addr,
   112  		apiReq,
   113  	)
   114  	if err != nil {
   115  		return nil, err
   116  	}
   117  
   118  	resp := &IncrementalAlterConfigsResponse{}
   119  
   120  	apiResp := protoResp.(*incrementalalterconfigs.Response)
   121  	for _, res := range apiResp.Responses {
   122  		resp.Resources = append(
   123  			resp.Resources,
   124  			IncrementalAlterConfigsResponseResource{
   125  				Error:        makeError(res.ErrorCode, res.ErrorMessage),
   126  				ResourceType: ResourceType(res.ResourceType),
   127  				ResourceName: res.ResourceName,
   128  			},
   129  		)
   130  	}
   131  
   132  	return resp, nil
   133  }