1// Code generated by smithy-go-codegen DO NOT EDIT. 2 3package rds 4 5import ( 6 "context" 7 awsmiddleware "github.com/aws/aws-sdk-go-v2/aws/middleware" 8 "github.com/aws/aws-sdk-go-v2/aws/signer/v4" 9 "github.com/aws/aws-sdk-go-v2/service/rds/types" 10 "github.com/aws/smithy-go/middleware" 11 smithyhttp "github.com/aws/smithy-go/transport/http" 12) 13 14// Modifies the parameters of a DB cluster parameter group. To modify more than one 15// parameter, submit a list of the following: ParameterName, ParameterValue, and 16// ApplyMethod. A maximum of 20 parameters can be modified in a single request. For 17// more information on Amazon Aurora, see What Is Amazon Aurora? 18// (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) 19// in the Amazon Aurora User Guide. Changes to dynamic parameters are applied 20// immediately. Changes to static parameters require a reboot without failover to 21// the DB cluster associated with the parameter group before the change can take 22// effect. After you create a DB cluster parameter group, you should wait at least 23// 5 minutes before creating your first DB cluster that uses that DB cluster 24// parameter group as the default parameter group. This allows Amazon RDS to fully 25// complete the create action before the parameter group is used as the default for 26// a new DB cluster. This is especially important for parameters that are critical 27// when creating the default database for a DB cluster, such as the character set 28// for the default database defined by the character_set_database parameter. You 29// can use the Parameter Groups option of the Amazon RDS console 30// (https://console.aws.amazon.com/rds/) or the DescribeDBClusterParameters action 31// to verify that your DB cluster parameter group has been created or modified. If 32// the modified DB cluster parameter group is used by an Aurora Serverless cluster, 33// Aurora applies the update immediately. The cluster restart might interrupt your 34// workload. In that case, your application must reopen any connections and retry 35// any transactions that were active when the parameter changes took effect. This 36// action only applies to Aurora DB clusters. 37func (c *Client) ModifyDBClusterParameterGroup(ctx context.Context, params *ModifyDBClusterParameterGroupInput, optFns ...func(*Options)) (*ModifyDBClusterParameterGroupOutput, error) { 38 if params == nil { 39 params = &ModifyDBClusterParameterGroupInput{} 40 } 41 42 result, metadata, err := c.invokeOperation(ctx, "ModifyDBClusterParameterGroup", params, optFns, addOperationModifyDBClusterParameterGroupMiddlewares) 43 if err != nil { 44 return nil, err 45 } 46 47 out := result.(*ModifyDBClusterParameterGroupOutput) 48 out.ResultMetadata = metadata 49 return out, nil 50} 51 52// 53type ModifyDBClusterParameterGroupInput struct { 54 55 // The name of the DB cluster parameter group to modify. 56 // 57 // This member is required. 58 DBClusterParameterGroupName *string 59 60 // A list of parameters in the DB cluster parameter group to modify. 61 // 62 // This member is required. 63 Parameters []types.Parameter 64} 65 66// 67type ModifyDBClusterParameterGroupOutput struct { 68 69 // The name of the DB cluster parameter group. Constraints: 70 // 71 // * Must be 1 to 255 72 // letters or numbers. 73 // 74 // * First character must be a letter 75 // 76 // * Can't end with a 77 // hyphen or contain two consecutive hyphens 78 // 79 // This value is stored as a lowercase 80 // string. 81 DBClusterParameterGroupName *string 82 83 // Metadata pertaining to the operation's result. 84 ResultMetadata middleware.Metadata 85} 86 87func addOperationModifyDBClusterParameterGroupMiddlewares(stack *middleware.Stack, options Options) (err error) { 88 err = stack.Serialize.Add(&awsAwsquery_serializeOpModifyDBClusterParameterGroup{}, middleware.After) 89 if err != nil { 90 return err 91 } 92 err = stack.Deserialize.Add(&awsAwsquery_deserializeOpModifyDBClusterParameterGroup{}, middleware.After) 93 if err != nil { 94 return err 95 } 96 if err = addSetLoggerMiddleware(stack, options); err != nil { 97 return err 98 } 99 if err = awsmiddleware.AddClientRequestIDMiddleware(stack); err != nil { 100 return err 101 } 102 if err = smithyhttp.AddComputeContentLengthMiddleware(stack); err != nil { 103 return err 104 } 105 if err = addResolveEndpointMiddleware(stack, options); err != nil { 106 return err 107 } 108 if err = v4.AddComputePayloadSHA256Middleware(stack); err != nil { 109 return err 110 } 111 if err = addRetryMiddlewares(stack, options); err != nil { 112 return err 113 } 114 if err = addHTTPSignerV4Middleware(stack, options); err != nil { 115 return err 116 } 117 if err = awsmiddleware.AddRawResponseToMetadata(stack); err != nil { 118 return err 119 } 120 if err = awsmiddleware.AddRecordResponseTiming(stack); err != nil { 121 return err 122 } 123 if err = addClientUserAgent(stack); err != nil { 124 return err 125 } 126 if err = smithyhttp.AddErrorCloseResponseBodyMiddleware(stack); err != nil { 127 return err 128 } 129 if err = smithyhttp.AddCloseResponseBodyMiddleware(stack); err != nil { 130 return err 131 } 132 if err = addOpModifyDBClusterParameterGroupValidationMiddleware(stack); err != nil { 133 return err 134 } 135 if err = stack.Initialize.Add(newServiceMetadataMiddleware_opModifyDBClusterParameterGroup(options.Region), middleware.Before); err != nil { 136 return err 137 } 138 if err = addRequestIDRetrieverMiddleware(stack); err != nil { 139 return err 140 } 141 if err = addResponseErrorMiddleware(stack); err != nil { 142 return err 143 } 144 if err = addRequestResponseLogging(stack, options); err != nil { 145 return err 146 } 147 return nil 148} 149 150func newServiceMetadataMiddleware_opModifyDBClusterParameterGroup(region string) *awsmiddleware.RegisterServiceMetadata { 151 return &awsmiddleware.RegisterServiceMetadata{ 152 Region: region, 153 ServiceID: ServiceID, 154 SigningName: "rds", 155 OperationName: "ModifyDBClusterParameterGroup", 156 } 157} 158