diff --git a/.changelog/638869f0762a4d27890507107e3989c1.json b/.changelog/638869f0762a4d27890507107e3989c1.json new file mode 100644 index 00000000000..d2fe0d624d2 --- /dev/null +++ b/.changelog/638869f0762a4d27890507107e3989c1.json @@ -0,0 +1,8 @@ +{ + "id": "638869f0-762a-4d27-8905-07107e3989c1", + "type": "documentation", + "description": "Adds support for additional retention periods to Performance Insights.", + "modules": [ + "service/rds" + ] +} \ No newline at end of file diff --git a/.changelog/d385b9c10cc14d3db1e21998db618ef2.json b/.changelog/d385b9c10cc14d3db1e21998db618ef2.json new file mode 100644 index 00000000000..5def7bcd3f3 --- /dev/null +++ b/.changelog/d385b9c10cc14d3db1e21998db618ef2.json @@ -0,0 +1,8 @@ +{ + "id": "d385b9c1-0cc1-4d3d-b1e2-1998db618ef2", + "type": "feature", + "description": "Added new features for AWS DMS version 3.4.7 that includes new endpoint settings for S3, OpenSearch, Postgres, SQLServer and Oracle.", + "modules": [ + "service/databasemigrationservice" + ] +} \ No newline at end of file diff --git a/service/databasemigrationservice/api_op_DescribeFleetAdvisorDatabases.go b/service/databasemigrationservice/api_op_DescribeFleetAdvisorDatabases.go index 664390d35ce..48e7c821cf6 100644 --- a/service/databasemigrationservice/api_op_DescribeFleetAdvisorDatabases.go +++ b/service/databasemigrationservice/api_op_DescribeFleetAdvisorDatabases.go @@ -34,25 +34,23 @@ type DescribeFleetAdvisorDatabasesInput struct { // only those databases that meet the filter criteria: // // * database-id – The ID of - // the database, for example d4610ac5-e323-4ad9-bc50-eaf7249dfe9d. + // the database. // - // * database-name - // – The name of the database. + // * database-name – The name of the database. // - // * database-engine – The name of the database - // engine. + // * database-engine – + // The name of the database engine. // - // * server-ip-address – The IP address of the database server. + // * server-ip-address – The IP address of the + // database server. // - // * - // database-ip-address – The IP address of the database. + // * database-ip-address – The IP address of the database. // - // * collector-name – The - // name of the associated Fleet Advisor collector. + // * + // collector-name – The name of the associated Fleet Advisor collector. // - // An example is: - // describe-fleet-advisor-databases --filter - // Name="database-id",Values="d4610ac5-e323-4ad9-bc50-eaf7249dfe9d" + // An example + // is: describe-fleet-advisor-databases --filter Name="database-id",Values="45" Filters []types.Filter // Sets the maximum number of records returned in the response. diff --git a/service/databasemigrationservice/deserializers.go b/service/databasemigrationservice/deserializers.go index f6ee0e208a0..544a5592369 100644 --- a/service/databasemigrationservice/deserializers.go +++ b/service/databasemigrationservice/deserializers.go @@ -9767,6 +9767,15 @@ func awsAwsjson11_deserializeDocumentElasticsearchSettings(v **types.Elasticsear sv.ServiceAccessRoleArn = ptr.String(jtv) } + case "UseNewMappingType": + if value != nil { + jtv, ok := value.(bool) + if !ok { + return fmt.Errorf("expected BooleanOptional to be of type *bool, got %T instead", value) + } + sv.UseNewMappingType = ptr.Bool(jtv) + } + default: _, _ = key, value @@ -12241,6 +12250,15 @@ func awsAwsjson11_deserializeDocumentMicrosoftSQLServerSettings(v **types.Micros sv.ServerName = ptr.String(jtv) } + case "TrimSpaceInChar": + if value != nil { + jtv, ok := value.(bool) + if !ok { + return fmt.Errorf("expected BooleanOptional to be of type *bool, got %T instead", value) + } + sv.TrimSpaceInChar = ptr.Bool(jtv) + } + case "UseBcpFullLoad": if value != nil { jtv, ok := value.(bool) @@ -13073,6 +13091,15 @@ func awsAwsjson11_deserializeDocumentOracleSettings(v **types.OracleSettings, va sv.StandbyDelayTime = ptr.Int32(int32(i64)) } + case "TrimSpaceInChar": + if value != nil { + jtv, ok := value.(bool) + if !ok { + return fmt.Errorf("expected BooleanOptional to be of type *bool, got %T instead", value) + } + sv.TrimSpaceInChar = ptr.Bool(jtv) + } + case "UseAlternateFolderForOnline": if value != nil { jtv, ok := value.(bool) @@ -13659,6 +13686,15 @@ func awsAwsjson11_deserializeDocumentPostgreSQLSettings(v **types.PostgreSQLSett sv.SlotName = ptr.String(jtv) } + case "TrimSpaceInChar": + if value != nil { + jtv, ok := value.(bool) + if !ok { + return fmt.Errorf("expected BooleanOptional to be of type *bool, got %T instead", value) + } + sv.TrimSpaceInChar = ptr.Bool(jtv) + } + case "Username": if value != nil { jtv, ok := value.(string) @@ -16043,6 +16079,15 @@ func awsAwsjson11_deserializeDocumentS3Settings(v **types.S3Settings, value inte sv.AddColumnName = ptr.Bool(jtv) } + case "AddTrailingPaddingCharacter": + if value != nil { + jtv, ok := value.(bool) + if !ok { + return fmt.Errorf("expected BooleanOptional to be of type *bool, got %T instead", value) + } + sv.AddTrailingPaddingCharacter = ptr.Bool(jtv) + } + case "BucketFolder": if value != nil { jtv, ok := value.(string) @@ -16266,6 +16311,15 @@ func awsAwsjson11_deserializeDocumentS3Settings(v **types.S3Settings, value inte sv.EncryptionMode = types.EncryptionModeValue(jtv) } + case "ExpectedBucketOwner": + if value != nil { + jtv, ok := value.(string) + if !ok { + return fmt.Errorf("expected String to be of type string, got %T instead", value) + } + sv.ExpectedBucketOwner = ptr.String(jtv) + } + case "ExternalTableDefinition": if value != nil { jtv, ok := value.(string) diff --git a/service/databasemigrationservice/serializers.go b/service/databasemigrationservice/serializers.go index dbbd4d21492..4eff441c0fe 100644 --- a/service/databasemigrationservice/serializers.go +++ b/service/databasemigrationservice/serializers.go @@ -3657,6 +3657,11 @@ func awsAwsjson11_serializeDocumentElasticsearchSettings(v *types.ElasticsearchS ok.String(*v.ServiceAccessRoleArn) } + if v.UseNewMappingType != nil { + ok := object.Key("UseNewMappingType") + ok.Boolean(*v.UseNewMappingType) + } + return nil } @@ -4105,6 +4110,11 @@ func awsAwsjson11_serializeDocumentMicrosoftSQLServerSettings(v *types.Microsoft ok.String(*v.ServerName) } + if v.TrimSpaceInChar != nil { + ok := object.Key("TrimSpaceInChar") + ok.Boolean(*v.TrimSpaceInChar) + } + if v.UseBcpFullLoad != nil { ok := object.Key("UseBcpFullLoad") ok.Boolean(*v.UseBcpFullLoad) @@ -4495,6 +4505,11 @@ func awsAwsjson11_serializeDocumentOracleSettings(v *types.OracleSettings, value ok.Integer(*v.StandbyDelayTime) } + if v.TrimSpaceInChar != nil { + ok := object.Key("TrimSpaceInChar") + ok.Boolean(*v.TrimSpaceInChar) + } + if v.UseAlternateFolderForOnline != nil { ok := object.Key("UseAlternateFolderForOnline") ok.Boolean(*v.UseAlternateFolderForOnline) @@ -4617,6 +4632,11 @@ func awsAwsjson11_serializeDocumentPostgreSQLSettings(v *types.PostgreSQLSetting ok.String(*v.SlotName) } + if v.TrimSpaceInChar != nil { + ok := object.Key("TrimSpaceInChar") + ok.Boolean(*v.TrimSpaceInChar) + } + if v.Username != nil { ok := object.Key("Username") ok.String(*v.Username) @@ -4833,6 +4853,11 @@ func awsAwsjson11_serializeDocumentS3Settings(v *types.S3Settings, value smithyj ok.Boolean(*v.AddColumnName) } + if v.AddTrailingPaddingCharacter != nil { + ok := object.Key("AddTrailingPaddingCharacter") + ok.Boolean(*v.AddTrailingPaddingCharacter) + } + if v.BucketFolder != nil { ok := object.Key("BucketFolder") ok.String(*v.BucketFolder) @@ -4948,6 +4973,11 @@ func awsAwsjson11_serializeDocumentS3Settings(v *types.S3Settings, value smithyj ok.String(string(v.EncryptionMode)) } + if v.ExpectedBucketOwner != nil { + ok := object.Key("ExpectedBucketOwner") + ok.String(*v.ExpectedBucketOwner) + } + if v.ExternalTableDefinition != nil { ok := object.Key("ExternalTableDefinition") ok.String(*v.ExternalTableDefinition) diff --git a/service/databasemigrationservice/types/types.go b/service/databasemigrationservice/types/types.go index 1a7eeb73232..f607a64766a 100644 --- a/service/databasemigrationservice/types/types.go +++ b/service/databasemigrationservice/types/types.go @@ -387,6 +387,11 @@ type ElasticsearchSettings struct { // all records fail in the last 10 minutes, the full load operation stops. FullLoadErrorPercentage *int32 + // Set this option to true for DMS to migrate documentation using the documentation + // type _doc. OpenSearch and an Elasticsearch cluster only support the _doc + // documentation type in versions 7. x and later. The default value is false. + UseNewMappingType *bool + noSmithyDocumentSerde } @@ -1086,6 +1091,10 @@ type MicrosoftSQLServerSettings struct { // Fully qualified domain name of the endpoint. ServerName *string + // Use the TrimSpaceInChar source endpoint setting to trim data on CHAR and NCHAR + // data types during migration. The default value is true. + TrimSpaceInChar *bool + // Use this to attribute to transfer data for full-load operations using BCP. When // the target table contains an identity column that does not exist in the source // table, you must disable the use BCP for loading table option. @@ -1542,6 +1551,10 @@ type OracleSettings struct { // need to connect to an active database that might be in production. StandbyDelayTime *int32 + // Use the TrimSpaceInChar source endpoint setting to trim data on CHAR and NCHAR + // data types during migration. The default value is true. + TrimSpaceInChar *bool + // Set this attribute to true in order to use the Binary Reader to capture change // data for an Amazon RDS for Oracle as the source. This tells the DMS instance to // use any specified prefix replacement to access all online redo logs. @@ -1760,6 +1773,10 @@ type PostgreSQLSettings struct { // (https://docs.aws.amazon.com/dms/latest/APIReference/API_ModifyReplicationTask.html). SlotName *string + // Use the TrimSpaceInChar source endpoint setting to trim data on CHAR and NCHAR + // data types during migration. The default value is true. + TrimSpaceInChar *bool + // Endpoint connection user name. Username *string @@ -2357,18 +2374,44 @@ type ReplicationTask struct { // The reason the replication task was stopped. This response parameter can return // one of the following values: // - // * "STOP_REASON_FULL_LOAD_COMPLETED" – Full-load - // migration completed. + // * "Stop Reason NORMAL" + // + // * "Stop Reason + // RECOVERABLE_ERROR" + // + // * "Stop Reason FATAL_ERROR" + // + // * "Stop Reason + // FULL_LOAD_ONLY_FINISHED" + // + // * "Stop Reason STOPPED_AFTER_FULL_LOAD" – Full load + // completed, with cached changes not applied + // + // * "Stop Reason + // STOPPED_AFTER_CACHED_EVENTS" – Full load completed, with cached changes + // applied // - // * "STOP_REASON_CACHED_CHANGES_APPLIED" – Change data - // capture (CDC) load completed. + // * "Stop Reason EXPRESS_LICENSE_LIMITS_REACHED" // - // * "STOP_REASON_CACHED_CHANGES_NOT_APPLIED" – In a - // full-load and CDC migration, the full load stopped as specified before starting - // the CDC migration. + // * "Stop Reason + // STOPPED_AFTER_DDL_APPLY" – User-defined stop task after DDL applied // - // * "STOP_REASON_SERVER_TIME" – The migration stopped at the - // specified server time. + // * "Stop + // Reason STOPPED_DUE_TO_LOW_MEMORY" + // + // * "Stop Reason STOPPED_DUE_TO_LOW_DISK" + // + // * + // "Stop Reason STOPPED_AT_SERVER_TIME" – User-defined server time for stopping + // task + // + // * "Stop Reason STOPPED_AT_COMMIT_TIME" – User-defined commit time for + // stopping task + // + // * "Stop Reason RECONFIGURATION_RESTART" + // + // * "Stop Reason + // RECYCLE_TASK" StopReason *string // Table mappings specified in the task. @@ -2628,6 +2671,10 @@ type S3Settings struct { // values are true, false, y, and n. AddColumnName *bool + // Use the S3 target endpoint setting AddTrailingPaddingCharacter to add padding on + // string data. The default value is false. + AddTrailingPaddingCharacter *bool + // An optional parameter to set a folder name in the S3 bucket. If provided, tables // are created in the path bucketFolder/schema_name/table_name/. If this parameter // isn't specified, then the path used is schema_name/table_name/. @@ -2856,6 +2903,13 @@ type S3Settings struct { // * s3:DeleteBucketPolicy EncryptionMode EncryptionModeValue + // To specify a bucket owner and prevent sniping, you can use the + // ExpectedBucketOwner endpoint setting. Example: + // --s3-settings='{"ExpectedBucketOwner": "AWS_Account_ID"}' When you make a + // request to test a connection or perform a migration, S3 checks the account ID of + // the bucket owner against the specified parameter. + ExpectedBucketOwner *string + // Specifies how tables are defined in the S3 source files only. ExternalTableDefinition *string diff --git a/service/rds/api_op_BacktrackDBCluster.go b/service/rds/api_op_BacktrackDBCluster.go index 90bae796758..b08319c2715 100644 --- a/service/rds/api_op_BacktrackDBCluster.go +++ b/service/rds/api_op_BacktrackDBCluster.go @@ -14,7 +14,7 @@ import ( // Backtracks a DB cluster to a specific time, without creating a new DB cluster. // For more information on backtracking, see Backtracking an Aurora DB Cluster // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Managing.Backtrack.html) -// in the Amazon Aurora User Guide. This action only applies to Aurora MySQL DB +// in the Amazon Aurora User Guide. This action applies only to Aurora MySQL DB // clusters. func (c *Client) BacktrackDBCluster(ctx context.Context, params *BacktrackDBClusterInput, optFns ...func(*Options)) (*BacktrackDBClusterOutput, error) { if params == nil { diff --git a/service/rds/api_op_CopyDBClusterSnapshot.go b/service/rds/api_op_CopyDBClusterSnapshot.go index c4d3e19c638..6039ec55dab 100644 --- a/service/rds/api_op_CopyDBClusterSnapshot.go +++ b/service/rds/api_op_CopyDBClusterSnapshot.go @@ -17,7 +17,7 @@ import ( // manual DB cluster snapshot, SourceDBClusterSnapshotIdentifier must be the Amazon // Resource Name (ARN) of the shared DB cluster snapshot. You can copy an encrypted // DB cluster snapshot from another Amazon Web Services Region. In that case, the -// Amazon Web Services Region where you call the CopyDBClusterSnapshot action is +// Amazon Web Services Region where you call the CopyDBClusterSnapshot operation is // the destination Amazon Web Services Region for the encrypted DB cluster snapshot // to be copied to. To copy an encrypted DB cluster snapshot from another Amazon // Web Services Region, you must provide the following values: @@ -27,60 +27,21 @@ import ( // identifier for the key to use to encrypt the copy of the DB cluster snapshot in // the destination Amazon Web Services Region. // -// * PreSignedUrl - A URL that -// contains a Signature Version 4 signed request for the CopyDBClusterSnapshot -// action to be called in the source Amazon Web Services Region where the DB -// cluster snapshot is copied from. The pre-signed URL must be a valid request for -// the CopyDBClusterSnapshot API action that can be executed in the source Amazon -// Web Services Region that contains the encrypted DB cluster snapshot to be -// copied. The pre-signed URL request must contain the following parameter -// values: +// * TargetDBClusterSnapshotIdentifier +// - The identifier for the new copy of the DB cluster snapshot in the destination +// Amazon Web Services Region. // -// * KmsKeyId - The Amazon Web Services KMS key identifier for the KMS key -// to use to encrypt the copy of the DB cluster snapshot in the destination Amazon -// Web Services Region. This is the same identifier for both the -// CopyDBClusterSnapshot action that is called in the destination Amazon Web -// Services Region, and the action contained in the pre-signed URL. +// * SourceDBClusterSnapshotIdentifier - The DB +// cluster snapshot identifier for the encrypted DB cluster snapshot to be copied. +// This identifier must be in the ARN format for the source Amazon Web Services +// Region and is the same value as the SourceDBClusterSnapshotIdentifier in the +// presigned URL. // -// * -// DestinationRegion - The name of the Amazon Web Services Region that the DB -// cluster snapshot is to be created in. -// -// * SourceDBClusterSnapshotIdentifier - The -// DB cluster snapshot identifier for the encrypted DB cluster snapshot to be -// copied. This identifier must be in the Amazon Resource Name (ARN) format for the -// source Amazon Web Services Region. For example, if you are copying an encrypted -// DB cluster snapshot from the us-west-2 Amazon Web Services Region, then your -// SourceDBClusterSnapshotIdentifier looks like the following example: -// arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115. -// -// To -// learn how to generate a Signature Version 4 signed request, see Authenticating -// Requests: Using Query Parameters (Amazon Web Services Signature Version 4) -// (https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html) -// and Signature Version 4 Signing Process -// (https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html). If you -// are using an Amazon Web Services SDK tool or the CLI, you can specify -// SourceRegion (or --source-region for the CLI) instead of specifying PreSignedUrl -// manually. Specifying SourceRegion autogenerates a pre-signed URL that is a valid -// request for the operation that can be executed in the source Amazon Web Services -// Region. -// -// * TargetDBClusterSnapshotIdentifier - The identifier for the new copy -// of the DB cluster snapshot in the destination Amazon Web Services Region. -// -// * -// SourceDBClusterSnapshotIdentifier - The DB cluster snapshot identifier for the -// encrypted DB cluster snapshot to be copied. This identifier must be in the ARN -// format for the source Amazon Web Services Region and is the same value as the -// SourceDBClusterSnapshotIdentifier in the pre-signed URL. -// -// To cancel the copy -// operation once it is in progress, delete the target DB cluster snapshot -// identified by TargetDBClusterSnapshotIdentifier while that DB cluster snapshot -// is in "copying" status. For more information on copying encrypted Amazon Aurora -// DB cluster snapshots from one Amazon Web Services Region to another, see -// Copying a Snapshot +// To cancel the copy operation once it is in progress, delete the +// target DB cluster snapshot identified by TargetDBClusterSnapshotIdentifier while +// that DB cluster snapshot is in "copying" status. For more information on copying +// encrypted Amazon Aurora DB cluster snapshots from one Amazon Web Services Region +// to another, see Copying a Snapshot // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_CopySnapshot.html) // in the Amazon Aurora User Guide. For more information on Amazon Aurora DB // clusters, see What is Amazon Aurora? @@ -168,33 +129,36 @@ type CopyDBClusterSnapshotInput struct { // value for the KmsKeyId parameter, an error is returned. KmsKeyId *string - // The URL that contains a Signature Version 4 signed request for the - // CopyDBClusterSnapshot API action in the Amazon Web Services Region that contains - // the source DB cluster snapshot to copy. The PreSignedUrl parameter must be used - // when copying an encrypted DB cluster snapshot from another Amazon Web Services - // Region. Don't specify PreSignedUrl when you are copying an encrypted DB cluster - // snapshot in the same Amazon Web Services Region. The pre-signed URL must be a - // valid request for the CopyDBClusterSnapshot API action that can be executed in - // the source Amazon Web Services Region that contains the encrypted DB cluster - // snapshot to be copied. The pre-signed URL request must contain the following - // parameter values: + // When you are copying a DB cluster snapshot from one Amazon Web Services GovCloud + // (US) Region to another, the URL that contains a Signature Version 4 signed + // request for the CopyDBClusterSnapshot API operation in the Amazon Web Services + // Region that contains the source DB cluster snapshot to copy. Use the + // PreSignedUrl parameter when copying an encrypted DB cluster snapshot from + // another Amazon Web Services Region. Don't specify PreSignedUrl when copying an + // encrypted DB cluster snapshot in the same Amazon Web Services Region. This + // setting applies only to Amazon Web Services GovCloud (US) Regions. It's ignored + // in other Amazon Web Services Regions. The presigned URL must be a valid request + // for the CopyDBClusterSnapshot API operation that can run in the source Amazon + // Web Services Region that contains the encrypted DB cluster snapshot to copy. The + // presigned URL request must contain the following parameter values: // - // * KmsKeyId - The Amazon Web Services KMS key identifier for - // the KMS key to use to encrypt the copy of the DB cluster snapshot in the - // destination Amazon Web Services Region. This is the same identifier for both the - // CopyDBClusterSnapshot action that is called in the destination Amazon Web - // Services Region, and the action contained in the pre-signed URL. + // * KmsKeyId - + // The KMS key identifier for the KMS key to use to encrypt the copy of the DB + // cluster snapshot in the destination Amazon Web Services Region. This is the same + // identifier for both the CopyDBClusterSnapshot operation that is called in the + // destination Amazon Web Services Region, and the operation contained in the + // presigned URL. // - // * - // DestinationRegion - The name of the Amazon Web Services Region that the DB - // cluster snapshot is to be created in. + // * DestinationRegion - The name of the Amazon Web Services Region + // that the DB cluster snapshot is to be created in. // - // * SourceDBClusterSnapshotIdentifier - The - // DB cluster snapshot identifier for the encrypted DB cluster snapshot to be - // copied. This identifier must be in the Amazon Resource Name (ARN) format for the - // source Amazon Web Services Region. For example, if you are copying an encrypted - // DB cluster snapshot from the us-west-2 Amazon Web Services Region, then your - // SourceDBClusterSnapshotIdentifier looks like the following example: + // * + // SourceDBClusterSnapshotIdentifier - The DB cluster snapshot identifier for the + // encrypted DB cluster snapshot to be copied. This identifier must be in the + // Amazon Resource Name (ARN) format for the source Amazon Web Services Region. For + // example, if you are copying an encrypted DB cluster snapshot from the us-west-2 + // Amazon Web Services Region, then your SourceDBClusterSnapshotIdentifier looks + // like the following example: // arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115. // // To @@ -205,9 +169,8 @@ type CopyDBClusterSnapshotInput struct { // (https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html). If you // are using an Amazon Web Services SDK tool or the CLI, you can specify // SourceRegion (or --source-region for the CLI) instead of specifying PreSignedUrl - // manually. Specifying SourceRegion autogenerates a pre-signed URL that is a valid - // request for the operation that can be executed in the source Amazon Web Services - // Region. + // manually. Specifying SourceRegion autogenerates a presigned URL that is a valid + // request for the operation that can run in the source Amazon Web Services Region. PreSignedUrl *string // The AWS region the resource is in. The presigned URL will be created with this diff --git a/service/rds/api_op_CopyDBSnapshot.go b/service/rds/api_op_CopyDBSnapshot.go index 47a12b6bfba..5ebf7bd970a 100644 --- a/service/rds/api_op_CopyDBSnapshot.go +++ b/service/rds/api_op_CopyDBSnapshot.go @@ -16,8 +16,8 @@ import ( // Copies the specified DB snapshot. The source DB snapshot must be in the // available state. You can copy a snapshot from one Amazon Web Services Region to // another. In that case, the Amazon Web Services Region where you call the -// CopyDBSnapshot action is the destination Amazon Web Services Region for the DB -// snapshot copy. This command doesn't apply to RDS Custom. For more information +// CopyDBSnapshot operation is the destination Amazon Web Services Region for the +// DB snapshot copy. This command doesn't apply to RDS Custom. For more information // about copying snapshots, see Copying a DB Snapshot // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CopySnapshot.html#USER_CopyDBSnapshot) // in the Amazon RDS User Guide. @@ -48,11 +48,10 @@ type CopyDBSnapshotInput struct { // If you are copying from a shared manual DB snapshot, this parameter must be the // Amazon Resource Name (ARN) of the shared DB snapshot. If you are copying an // encrypted snapshot this parameter must be in the ARN format for the source - // Amazon Web Services Region, and must match the SourceDBSnapshotIdentifier in the - // PreSignedUrl parameter. Constraints: + // Amazon Web Services Region. Constraints: // - // * Must specify a valid system snapshot in - // the "available" state. + // * Must specify a valid system snapshot + // in the "available" state. // // Example: rds:mydb-2012-04-02-00-01 Example: // arn:aws:rds:us-west-2:123456789012:snapshot:mysql-instance1-snapshot-20130805 @@ -109,36 +108,39 @@ type CopyDBSnapshotInput struct { // in the Amazon RDS User Guide. OptionGroupName *string - // The URL that contains a Signature Version 4 signed request for the - // CopyDBSnapshot API action in the source Amazon Web Services Region that contains - // the source DB snapshot to copy. You must specify this parameter when you copy an - // encrypted DB snapshot from another Amazon Web Services Region by using the - // Amazon RDS API. Don't specify PreSignedUrl when you are copying an encrypted DB - // snapshot in the same Amazon Web Services Region. The presigned URL must be a - // valid request for the CopyDBSnapshot API action that can be executed in the - // source Amazon Web Services Region that contains the encrypted DB snapshot to be - // copied. The presigned URL request must contain the following parameter - // values: + // When you are copying a snapshot from one Amazon Web Services GovCloud (US) + // Region to another, the URL that contains a Signature Version 4 signed request + // for the CopyDBSnapshot API operation in the source Amazon Web Services Region + // that contains the source DB snapshot to copy. This setting applies only to + // Amazon Web Services GovCloud (US) Regions. It's ignored in other Amazon Web + // Services Regions. You must specify this parameter when you copy an encrypted DB + // snapshot from another Amazon Web Services Region by using the Amazon RDS API. + // Don't specify PreSignedUrl when you are copying an encrypted DB snapshot in the + // same Amazon Web Services Region. The presigned URL must be a valid request for + // the CopyDBClusterSnapshot API operation that can run in the source Amazon Web + // Services Region that contains the encrypted DB cluster snapshot to copy. The + // presigned URL request must contain the following parameter values: // - // * DestinationRegion - The Amazon Web Services Region that the encrypted - // DB snapshot is copied to. This Amazon Web Services Region is the same one where - // the CopyDBSnapshot action is called that contains this presigned URL. For + // * + // DestinationRegion - The Amazon Web Services Region that the encrypted DB + // snapshot is copied to. This Amazon Web Services Region is the same one where the + // CopyDBSnapshot operation is called that contains this presigned URL. For // example, if you copy an encrypted DB snapshot from the us-west-2 Amazon Web // Services Region to the us-east-1 Amazon Web Services Region, then you call the - // CopyDBSnapshot action in the us-east-1 Amazon Web Services Region and provide a - // presigned URL that contains a call to the CopyDBSnapshot action in the us-west-2 - // Amazon Web Services Region. For this example, the DestinationRegion in the - // presigned URL must be set to the us-east-1 Amazon Web Services Region. + // CopyDBSnapshot operation in the us-east-1 Amazon Web Services Region and provide + // a presigned URL that contains a call to the CopyDBSnapshot operation in the + // us-west-2 Amazon Web Services Region. For this example, the DestinationRegion in + // the presigned URL must be set to the us-east-1 Amazon Web Services Region. // // * - // KmsKeyId - The Amazon Web Services KMS key identifier for the KMS key to use to - // encrypt the copy of the DB snapshot in the destination Amazon Web Services - // Region. This is the same identifier for both the CopyDBSnapshot action that is - // called in the destination Amazon Web Services Region, and the action contained - // in the presigned URL. + // KmsKeyId - The KMS key identifier for the KMS key to use to encrypt the copy of + // the DB snapshot in the destination Amazon Web Services Region. This is the same + // identifier for both the CopyDBSnapshot operation that is called in the + // destination Amazon Web Services Region, and the operation contained in the + // presigned URL. // - // * SourceDBSnapshotIdentifier - The DB snapshot identifier - // for the encrypted snapshot to be copied. This identifier must be in the Amazon + // * SourceDBSnapshotIdentifier - The DB snapshot identifier for + // the encrypted snapshot to be copied. This identifier must be in the Amazon // Resource Name (ARN) format for the source Amazon Web Services Region. For // example, if you are copying an encrypted DB snapshot from the us-west-2 Amazon // Web Services Region, then your SourceDBSnapshotIdentifier looks like the @@ -153,9 +155,8 @@ type CopyDBSnapshotInput struct { // (https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html). If you // are using an Amazon Web Services SDK tool or the CLI, you can specify // SourceRegion (or --source-region for the CLI) instead of specifying PreSignedUrl - // manually. Specifying SourceRegion autogenerates a pre-signed URL that is a valid - // request for the operation that can be executed in the source Amazon Web Services - // Region. + // manually. Specifying SourceRegion autogenerates a presigned URL that is a valid + // request for the operation that can run in the source Amazon Web Services Region. PreSignedUrl *string // The AWS region the resource is in. The presigned URL will be created with this diff --git a/service/rds/api_op_CreateDBCluster.go b/service/rds/api_op_CreateDBCluster.go index efbe3072b4b..b5c71940080 100644 --- a/service/rds/api_op_CreateDBCluster.go +++ b/service/rds/api_op_CreateDBCluster.go @@ -16,9 +16,7 @@ import ( // Creates a new Amazon Aurora DB cluster or Multi-AZ DB cluster. You can use the // ReplicationSourceIdentifier parameter to create an Amazon Aurora DB cluster as a // read replica of another DB cluster or Amazon RDS MySQL or PostgreSQL DB -// instance. For cross-Region replication where the DB cluster identified by -// ReplicationSourceIdentifier is encrypted, also specify the PreSignedUrl -// parameter. For more information on Amazon Aurora, see What is Amazon Aurora? +// instance. For more information on Amazon Aurora, see What is Amazon Aurora? // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) // in the Amazon Aurora User Guide. For more information on Multi-AZ DB clusters, // see Multi-AZ deployments with two readable standby DB instances @@ -213,7 +211,7 @@ type CreateDBClusterInput struct { // and Access Management (IAM) accounts to database accounts. By default, mapping // isn't enabled. For more information, see IAM Database Authentication // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.html) - // in the Amazon Aurora User Guide.. Valid for: Aurora DB clusters only + // in the Amazon Aurora User Guide. Valid for: Aurora DB clusters only EnableIAMDatabaseAuthentication *bool // A value that indicates whether to turn on Performance Insights for the DB @@ -228,7 +226,8 @@ type CreateDBClusterInput struct { // and higher 2.x versions. The global engine mode isn't required for Aurora MySQL // version 1.22 and higher 1.x versions, and global engine mode isn't required for // any 2.x versions. The multimaster engine mode only applies for DB clusters - // created with Aurora MySQL version 5.6.10a. For Aurora PostgreSQL, the global + // created with Aurora MySQL version 5.6.10a. The serverless engine mode only + // applies for Aurora Serverless v1 DB clusters. For Aurora PostgreSQL, the global // engine mode isn't required, and both the parallelquery and the multimaster // engine modes currently aren't supported. Limitations and requirements apply to // some DB engine modes. For more information, see the following sections in the @@ -238,6 +237,10 @@ type CreateDBClusterInput struct { // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html#aurora-serverless.limitations) // // * + // Requirements for Aurora Serverless v2 + // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.requirements.html) + // + // * // Limitations of Parallel Query // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-mysql-parallel-query.html#aurora-mysql-parallel-query-limitations) // @@ -370,8 +373,30 @@ type CreateDBClusterInput struct { // Valid for: Multi-AZ DB clusters only PerformanceInsightsKMSKeyId *string - // The amount of time, in days, to retain Performance Insights data. Valid values - // are 7 or 731 (2 years). Valid for: Multi-AZ DB clusters only + // The number of days to retain Performance Insights data. The default is 7 days. + // The following values are valid: + // + // * 7 + // + // * month * 31, where month is a number of + // months from 1-23 + // + // * 731 + // + // For example, the following values are valid: + // + // * 93 (3 + // months * 31) + // + // * 341 (11 months * 31) + // + // * 589 (19 months * 31) + // + // * 731 + // + // If you + // specify a retention period such as 94, which isn't a valid value, RDS issues an + // error. Valid for: Multi-AZ DB clusters only PerformanceInsightsRetentionPeriod *int32 // The port number on which the instances in the DB cluster accept connections. RDS @@ -380,43 +405,44 @@ type CreateDBClusterInput struct { // for: Aurora DB clusters and Multi-AZ DB clusters Port *int32 - // A URL that contains a Signature Version 4 signed request for the CreateDBCluster - // action to be called in the source Amazon Web Services Region where the DB - // cluster is replicated from. Specify PreSignedUrl only when you are performing - // cross-Region replication from an encrypted DB cluster. The pre-signed URL must - // be a valid request for the CreateDBCluster API action that can be executed in - // the source Amazon Web Services Region that contains the encrypted DB cluster to - // be copied. The pre-signed URL request must contain the following parameter + // When you are replicating a DB cluster from one Amazon Web Services GovCloud (US) + // Region to another, an URL that contains a Signature Version 4 signed request for + // the CreateDBCluster operation to be called in the source Amazon Web Services + // Region where the DB cluster is replicated from. Specify PreSignedUrl only when + // you are performing cross-Region replication from an encrypted DB cluster. The + // presigned URL must be a valid request for the CreateDBCluster API operation that + // can run in the source Amazon Web Services Region that contains the encrypted DB + // cluster to copy. The presigned URL request must contain the following parameter // values: // - // * KmsKeyId - The Amazon Web Services KMS key identifier for the KMS key - // to use to encrypt the copy of the DB cluster in the destination Amazon Web - // Services Region. This should refer to the same KMS key for both the - // CreateDBCluster action that is called in the destination Amazon Web Services - // Region, and the action contained in the pre-signed URL. - // - // * DestinationRegion - - // The name of the Amazon Web Services Region that Aurora read replica will be - // created in. - // - // * ReplicationSourceIdentifier - The DB cluster identifier for the - // encrypted DB cluster to be copied. This identifier must be in the Amazon - // Resource Name (ARN) format for the source Amazon Web Services Region. For - // example, if you are copying an encrypted DB cluster from the us-west-2 Amazon - // Web Services Region, then your ReplicationSourceIdentifier would look like - // Example: arn:aws:rds:us-west-2:123456789012:cluster:aurora-cluster1. - // - // To learn - // how to generate a Signature Version 4 signed request, see Authenticating - // Requests: Using Query Parameters (Amazon Web Services Signature Version 4) + // * KmsKeyId - The KMS key identifier for the KMS key to use to encrypt + // the copy of the DB cluster in the destination Amazon Web Services Region. This + // should refer to the same KMS key for both the CreateDBCluster operation that is + // called in the destination Amazon Web Services Region, and the operation + // contained in the presigned URL. + // + // * DestinationRegion - The name of the Amazon + // Web Services Region that Aurora read replica will be created in. + // + // * + // ReplicationSourceIdentifier - The DB cluster identifier for the encrypted DB + // cluster to be copied. This identifier must be in the Amazon Resource Name (ARN) + // format for the source Amazon Web Services Region. For example, if you are + // copying an encrypted DB cluster from the us-west-2 Amazon Web Services Region, + // then your ReplicationSourceIdentifier would look like Example: + // arn:aws:rds:us-west-2:123456789012:cluster:aurora-cluster1. + // + // To learn how to + // generate a Signature Version 4 signed request, see Authenticating Requests: + // Using Query Parameters (Amazon Web Services Signature Version 4) // (https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html) // and Signature Version 4 Signing Process // (https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html). If you // are using an Amazon Web Services SDK tool or the CLI, you can specify // SourceRegion (or --source-region for the CLI) instead of specifying PreSignedUrl - // manually. Specifying SourceRegion autogenerates a pre-signed URL that is a valid - // request for the operation that can be executed in the source Amazon Web Services - // Region. Valid for: Aurora DB clusters only + // manually. Specifying SourceRegion autogenerates a presigned URL that is a valid + // request for the operation that can run in the source Amazon Web Services Region. + // Valid for: Aurora DB clusters only PreSignedUrl *string // The daily time range during which automated backups are created if automated diff --git a/service/rds/api_op_CreateDBClusterEndpoint.go b/service/rds/api_op_CreateDBClusterEndpoint.go index 4e6b394490e..0b44ba2beb9 100644 --- a/service/rds/api_op_CreateDBClusterEndpoint.go +++ b/service/rds/api_op_CreateDBClusterEndpoint.go @@ -12,7 +12,7 @@ import ( ) // Creates a new custom endpoint and associates it with an Amazon Aurora DB -// cluster. This action only applies to Aurora DB clusters. +// cluster. This action applies only to Aurora DB clusters. func (c *Client) CreateDBClusterEndpoint(ctx context.Context, params *CreateDBClusterEndpointInput, optFns ...func(*Options)) (*CreateDBClusterEndpointOutput, error) { if params == nil { params = &CreateDBClusterEndpointInput{} diff --git a/service/rds/api_op_CreateDBClusterParameterGroup.go b/service/rds/api_op_CreateDBClusterParameterGroup.go index 5b5036a259e..9eaa0c47381 100644 --- a/service/rds/api_op_CreateDBClusterParameterGroup.go +++ b/service/rds/api_op_CreateDBClusterParameterGroup.go @@ -32,7 +32,7 @@ import ( // for a DB cluster, such as the character set for the default database defined by // the character_set_database parameter. You can use the Parameter Groups option of // the Amazon RDS console (https://console.aws.amazon.com/rds/) or the -// DescribeDBClusterParameters action to verify that your DB cluster parameter +// DescribeDBClusterParameters operation to verify that your DB cluster parameter // group has been created or modified. For more information on Amazon Aurora, see // What is Amazon Aurora? // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) diff --git a/service/rds/api_op_CreateDBInstance.go b/service/rds/api_op_CreateDBInstance.go index 2270390b124..03fcc67c6c2 100644 --- a/service/rds/api_op_CreateDBInstance.go +++ b/service/rds/api_op_CreateDBInstance.go @@ -11,7 +11,16 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// Creates a new DB instance. +// Creates a new DB instance. The new DB instance can be an RDS DB instance, or it +// can be a DB instance in an Aurora DB cluster. For an Aurora DB cluster, you can +// call this operation multiple times to add more than one DB instance to the +// cluster. For more information about creating an RDS DB instance, see Creating +// an Amazon RDS DB instance +// (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.html) +// in the Amazon RDS User Guide. For more information about creating a DB instance +// in an Aurora DB cluster, see Creating an Amazon Aurora DB cluster +// (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.CreateInstance.html) +// in the Amazon Aurora User Guide. func (c *Client) CreateDBInstance(ctx context.Context, params *CreateDBInstanceInput, optFns ...func(*Options)) (*CreateDBInstanceOutput, error) { if params == nil { params = &CreateDBInstanceInput{} @@ -30,12 +39,14 @@ func (c *Client) CreateDBInstance(ctx context.Context, params *CreateDBInstanceI // type CreateDBInstanceInput struct { - // The compute and memory capacity of the DB instance, for example db.m4.large. Not + // The compute and memory capacity of the DB instance, for example db.m5.large. Not // all DB instance classes are available in all Amazon Web Services Regions, or for // all database engines. For the full list of DB instance classes, and availability - // for your engine, see DB Instance Class + // for your engine, see DB instance classes // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html) - // in the Amazon RDS User Guide. + // in the Amazon RDS User Guide or Aurora DB instance classes + // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Concepts.DBInstanceClass.html) + // in the Amazon Aurora User Guide. // // This member is required. DBInstanceClass *string @@ -227,8 +238,7 @@ type CreateDBInstanceInput struct { // * Can't be set to 0 if the DB instance is a source // to read replicas // - // * Can't be set to 0 or 35 for an RDS Custom for Oracle DB - // instance + // * Can't be set to 0 for an RDS Custom for Oracle DB instance BackupRetentionPeriod *int32 // Specifies where automated backups and manual snapshots are stored. Possible @@ -375,8 +385,9 @@ type CreateDBInstanceInput struct { // hyphens DBParameterGroupName *string - // A list of DB security groups to associate with this DB instance. Default: The - // default DB security group for the database engine. + // A list of DB security groups to associate with this DB instance. This setting + // applies to the legacy EC2-Classic platform, which is no longer used to create + // new DB instances. Use the VpcSecurityGroupIds setting instead. DBSecurityGroups []string // A DB subnet group to associate with this DB instance. Constraints: Must match @@ -400,11 +411,13 @@ type CreateDBInstanceInput struct { // in an Active Directory Domain. For more information, see Kerberos // Authentication // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html) - // in the Amazon RDS User Guide. This setting doesn't apply to RDS Custom. + // in the Amazon RDS User Guide. This setting doesn't apply to RDS Custom. Amazon + // Aurora Not applicable. The domain is managed by the DB cluster. Domain *string // Specify the name of the IAM role to be used when making API calls to the - // Directory Service. This setting doesn't apply to RDS Custom. + // Directory Service. This setting doesn't apply to RDS Custom. Amazon Aurora Not + // applicable. The domain is managed by the DB cluster. DomainIAMRoleName *string // The list of log types that need to be enabled for exporting to CloudWatch Logs. @@ -435,12 +448,12 @@ type CreateDBInstanceInput struct { // A value that indicates whether to enable mapping of Amazon Web Services Identity // and Access Management (IAM) accounts to database accounts. By default, mapping - // isn't enabled. This setting doesn't apply to RDS Custom or Amazon Aurora. In - // Aurora, mapping Amazon Web Services IAM accounts to database accounts is managed - // by the DB cluster. For more information, see IAM Database Authentication for - // MySQL and PostgreSQL + // isn't enabled. For more information, see IAM Database Authentication for MySQL + // and PostgreSQL // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html) - // in the Amazon RDS User Guide. + // in the Amazon RDS User Guide. This setting doesn't apply to RDS Custom. Amazon + // Aurora Not applicable. Mapping Amazon Web Services IAM accounts to database + // accounts is managed by the DB cluster. EnableIAMDatabaseAuthentication *bool // A value that indicates whether to enable Performance Insights for the DB @@ -450,7 +463,7 @@ type CreateDBInstanceInput struct { EnablePerformanceInsights *bool // The version number of the database engine to use. For a list of valid engine - // versions, use the DescribeDBEngineVersions action. The following are the + // versions, use the DescribeDBEngineVersions operation. The following are the // database engines and links to information about the major and minor versions // that are available with Amazon RDS. Not every database engine is available for // every Amazon Web Services Region. Amazon Aurora Not applicable. The version @@ -489,7 +502,8 @@ type CreateDBInstanceInput struct { // in the Amazon RDS User Guide. Constraints: For MariaDB, MySQL, Oracle, and // PostgreSQL DB instances, must be a multiple between .5 and 50 of the storage // amount for the DB instance. For SQL Server DB instances, must be a multiple - // between 1 and 50 of the storage amount for the DB instance. + // between 1 and 50 of the storage amount for the DB instance. Amazon Aurora Not + // applicable. Storage is managed by the DB cluster. Iops *int32 // The Amazon Web Services KMS key identifier for an encrypted DB instance. The @@ -510,7 +524,7 @@ type CreateDBInstanceInput struct { // License model information for this DB instance. Valid values: license-included | // bring-your-own-license | general-public-license This setting doesn't apply to - // RDS Custom. + // RDS Custom. Amazon Aurora Not applicable. LicenseModel *string // The password for the master user. The password can include any printable ASCII @@ -542,7 +556,8 @@ type CreateDBInstanceInput struct { // including limitations that apply to it, see Managing capacity automatically // with Amazon RDS storage autoscaling // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling) - // in the Amazon RDS User Guide. This setting doesn't apply to RDS Custom. + // in the Amazon RDS User Guide. This setting doesn't apply to RDS Custom. Amazon + // Aurora Not applicable. Storage is managed by the DB cluster. MaxAllocatedStorage *int32 // The interval, in seconds, between points when Enhanced Monitoring metrics are @@ -564,7 +579,8 @@ type CreateDBInstanceInput struct { // A value that indicates whether the DB instance is a Multi-AZ deployment. You // can't set the AvailabilityZone parameter if the DB instance is a Multi-AZ - // deployment. This setting doesn't apply to RDS Custom. + // deployment. This setting doesn't apply to RDS Custom. Amazon Aurora Not + // applicable. DB instance Availability Zones (AZs) are managed by the DB cluster. MultiAZ *bool // The name of the NCHAR character set for the Oracle DB instance. This parameter @@ -589,7 +605,8 @@ type CreateDBInstanceInput struct { // specified option group. Permanent options, such as the TDE option for Oracle // Advanced Security TDE, can't be removed from an option group. Also, that option // group can't be removed from a DB instance after it is associated with a DB - // instance. This setting doesn't apply to RDS Custom. + // instance. This setting doesn't apply to RDS Custom. Amazon Aurora Not + // applicable. OptionGroupName *string // The Amazon Web Services KMS key identifier for encryption of Performance @@ -601,8 +618,30 @@ type CreateDBInstanceInput struct { // This setting doesn't apply to RDS Custom. PerformanceInsightsKMSKeyId *string - // The amount of time, in days, to retain Performance Insights data. Valid values - // are 7 or 731 (2 years). This setting doesn't apply to RDS Custom. + // The number of days to retain Performance Insights data. The default is 7 days. + // The following values are valid: + // + // * 7 + // + // * month * 31, where month is a number of + // months from 1-23 + // + // * 731 + // + // For example, the following values are valid: + // + // * 93 (3 + // months * 31) + // + // * 341 (11 months * 31) + // + // * 589 (19 months * 31) + // + // * 731 + // + // If you + // specify a retention period such as 94, which isn't a valid value, RDS issues an + // error. This setting doesn't apply to RDS Custom. PerformanceInsightsRetentionPeriod *int32 // The port number on which the database accepts connections. MySQL Default: 3306 @@ -643,7 +682,8 @@ type CreateDBInstanceInput struct { PreferredMaintenanceWindow *string // The number of CPU cores and the number of threads per core for the DB instance - // class of the DB instance. This setting doesn't apply to RDS Custom. + // class of the DB instance. This setting doesn't apply to RDS Custom. Amazon + // Aurora Not applicable. ProcessorFeatures []types.ProcessorFeature // A value that specifies the order in which an Aurora Replica is promoted to the @@ -694,13 +734,15 @@ type CreateDBInstanceInput struct { // Specifies the storage type to be associated with the DB instance. Valid values: // standard | gp2 | io1 If you specify io1, you must also include a value for the // Iops parameter. Default: io1 if the Iops parameter is specified, otherwise gp2 + // Amazon Aurora Not applicable. Storage is managed by the DB cluster. StorageType *string // Tags to assign to the DB instance. Tags []types.Tag // The ARN from the key store with which to associate the instance for TDE - // encryption. This setting doesn't apply to RDS Custom. + // encryption. This setting doesn't apply to RDS Custom. Amazon Aurora Not + // applicable. TdeCredentialArn *string // The password for the given ARN from the key store in order to access the device. diff --git a/service/rds/api_op_CreateDBInstanceReadReplica.go b/service/rds/api_op_CreateDBInstanceReadReplica.go index 1769f4155ed..245674f03f4 100644 --- a/service/rds/api_op_CreateDBInstanceReadReplica.go +++ b/service/rds/api_op_CreateDBInstanceReadReplica.go @@ -18,9 +18,9 @@ import ( // MariaDB, Oracle, PostgreSQL, or SQL Server. For more information, see Working // with Read Replicas // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReadRepl.html) in -// the Amazon RDS User Guide. Amazon Aurora doesn't support this action. Call the -// CreateDBInstance action to create a DB instance for an Aurora DB cluster. All -// read replica DB instances are created with backups disabled. All other DB +// the Amazon RDS User Guide. Amazon Aurora doesn't support this operation. Call +// the CreateDBInstance operation to create a DB instance for an Aurora DB cluster. +// All read replica DB instances are created with backups disabled. All other DB // instance attributes (including DB security groups and DB parameter groups) are // inherited from the source DB instance, except as specified. Your source DB // instance must have backup retention enabled. @@ -135,15 +135,16 @@ type CreateDBInstanceReadReplicaInput struct { // DBParameterGroup of source DB instance for a same Region read replica, or the // default DBParameterGroup for the specified DB engine for a cross-Region read // replica. Specifying a parameter group for this operation is only supported for - // Oracle DB instances. It isn't supported for RDS Custom. Constraints: + // MySQL and Oracle DB instances. It isn't supported for RDS Custom. + // Constraints: // - // * Must be - // 1 to 255 letters, numbers, or hyphens. + // * Must be 1 to 255 letters, numbers, or hyphens. // - // * First character must be a letter + // * First + // character must be a letter // - // * - // Can't end with a hyphen or contain two consecutive hyphens + // * Can't end with a hyphen or contain two consecutive + // hyphens DBParameterGroupName *string // Specifies a DB subnet group for the DB instance. The new DB instance is created @@ -295,49 +296,76 @@ type CreateDBInstanceReadReplicaInput struct { // This setting doesn't apply to RDS Custom. PerformanceInsightsKMSKeyId *string - // The amount of time, in days, to retain Performance Insights data. Valid values - // are 7 or 731 (2 years). This setting doesn't apply to RDS Custom. + // The number of days to retain Performance Insights data. The default is 7 days. + // The following values are valid: + // + // * 7 + // + // * month * 31, where month is a number of + // months from 1-23 + // + // * 731 + // + // For example, the following values are valid: + // + // * 93 (3 + // months * 31) + // + // * 341 (11 months * 31) + // + // * 589 (19 months * 31) + // + // * 731 + // + // If you + // specify a retention period such as 94, which isn't a valid value, RDS issues an + // error. This setting doesn't apply to RDS Custom. PerformanceInsightsRetentionPeriod *int32 // The port number that the DB instance uses for connections. Default: Inherits // from the source DB instance Valid Values: 1150-65535 Port *int32 - // The URL that contains a Signature Version 4 signed request for the - // CreateDBInstanceReadReplica API action in the source Amazon Web Services Region - // that contains the source DB instance. You must specify this parameter when you - // create an encrypted read replica from another Amazon Web Services Region by - // using the Amazon RDS API. Don't specify PreSignedUrl when you are creating an - // encrypted read replica in the same Amazon Web Services Region. The presigned URL - // must be a valid request for the CreateDBInstanceReadReplica API action that can - // be executed in the source Amazon Web Services Region that contains the encrypted - // source DB instance. The presigned URL request must contain the following - // parameter values: - // - // * DestinationRegion - The Amazon Web Services Region that the - // encrypted read replica is created in. This Amazon Web Services Region is the - // same one where the CreateDBInstanceReadReplica action is called that contains - // this presigned URL. For example, if you create an encrypted DB instance in the - // us-west-1 Amazon Web Services Region, from a source DB instance in the us-east-2 - // Amazon Web Services Region, then you call the CreateDBInstanceReadReplica action - // in the us-east-1 Amazon Web Services Region and provide a presigned URL that - // contains a call to the CreateDBInstanceReadReplica action in the us-west-2 - // Amazon Web Services Region. For this example, the DestinationRegion in the - // presigned URL must be set to the us-east-1 Amazon Web Services Region. + // When you are creating a read replica from one Amazon Web Services GovCloud (US) + // Region to another or from one China Amazon Web Services Region to another, the + // URL that contains a Signature Version 4 signed request for the + // CreateDBInstanceReadReplica API operation in the source Amazon Web Services + // Region that contains the source DB instance. This setting applies only to Amazon + // Web Services GovCloud (US) Regions and China Amazon Web Services Regions. It's + // ignored in other Amazon Web Services Regions. You must specify this parameter + // when you create an encrypted read replica from another Amazon Web Services + // Region by using the Amazon RDS API. Don't specify PreSignedUrl when you are + // creating an encrypted read replica in the same Amazon Web Services Region. The + // presigned URL must be a valid request for the CreateDBInstanceReadReplica API + // operation that can run in the source Amazon Web Services Region that contains + // the encrypted source DB instance. The presigned URL request must contain the + // following parameter values: + // + // * DestinationRegion - The Amazon Web Services + // Region that the encrypted read replica is created in. This Amazon Web Services + // Region is the same one where the CreateDBInstanceReadReplica operation is called + // that contains this presigned URL. For example, if you create an encrypted DB + // instance in the us-west-1 Amazon Web Services Region, from a source DB instance + // in the us-east-2 Amazon Web Services Region, then you call the + // CreateDBInstanceReadReplica operation in the us-east-1 Amazon Web Services + // Region and provide a presigned URL that contains a call to the + // CreateDBInstanceReadReplica operation in the us-west-2 Amazon Web Services + // Region. For this example, the DestinationRegion in the presigned URL must be set + // to the us-east-1 Amazon Web Services Region. + // + // * KmsKeyId - The KMS key + // identifier for the key to use to encrypt the read replica in the destination + // Amazon Web Services Region. This is the same identifier for both the + // CreateDBInstanceReadReplica operation that is called in the destination Amazon + // Web Services Region, and the operation contained in the presigned URL. // // * - // KmsKeyId - The Amazon Web Services KMS key identifier for the key to use to - // encrypt the read replica in the destination Amazon Web Services Region. This is - // the same identifier for both the CreateDBInstanceReadReplica action that is - // called in the destination Amazon Web Services Region, and the action contained - // in the presigned URL. - // - // * SourceDBInstanceIdentifier - The DB instance identifier - // for the encrypted DB instance to be replicated. This identifier must be in the - // Amazon Resource Name (ARN) format for the source Amazon Web Services Region. For - // example, if you are creating an encrypted read replica from a DB instance in the - // us-west-2 Amazon Web Services Region, then your SourceDBInstanceIdentifier looks - // like the following example: + // SourceDBInstanceIdentifier - The DB instance identifier for the encrypted DB + // instance to be replicated. This identifier must be in the Amazon Resource Name + // (ARN) format for the source Amazon Web Services Region. For example, if you are + // creating an encrypted read replica from a DB instance in the us-west-2 Amazon + // Web Services Region, then your SourceDBInstanceIdentifier looks like the + // following example: // arn:aws:rds:us-west-2:123456789012:instance:mysql-instance1-20161115. // // To learn @@ -349,10 +377,10 @@ type CreateDBInstanceReadReplicaInput struct { // are using an Amazon Web Services SDK tool or the CLI, you can specify // SourceRegion (or --source-region for the CLI) instead of specifying PreSignedUrl // manually. Specifying SourceRegion autogenerates a presigned URL that is a valid - // request for the operation that can be executed in the source Amazon Web Services - // Region. SourceRegion isn't supported for SQL Server, because SQL Server on - // Amazon RDS doesn't support cross-Region read replicas. This setting doesn't - // apply to RDS Custom. + // request for the operation that can run in the source Amazon Web Services Region. + // SourceRegion isn't supported for SQL Server, because Amazon RDS for SQL Server + // doesn't support cross-Region read replicas. This setting doesn't apply to RDS + // Custom. PreSignedUrl *string // The number of CPU cores and the number of threads per core for the DB instance diff --git a/service/rds/api_op_CreateEventSubscription.go b/service/rds/api_op_CreateEventSubscription.go index a5b9d001083..c9a3bc2953d 100644 --- a/service/rds/api_op_CreateEventSubscription.go +++ b/service/rds/api_op_CreateEventSubscription.go @@ -11,7 +11,7 @@ import ( smithyhttp "github.com/aws/smithy-go/transport/http" ) -// Creates an RDS event notification subscription. This action requires a topic +// Creates an RDS event notification subscription. This operation requires a topic // Amazon Resource Name (ARN) created by either the RDS console, the SNS console, // or the SNS API. To obtain an ARN with SNS, you must create a topic in Amazon SNS // and subscribe to the topic. The ARN is displayed in the SNS console. You can diff --git a/service/rds/api_op_CreateGlobalCluster.go b/service/rds/api_op_CreateGlobalCluster.go index 69e9fa56f4d..68ef360f1ae 100644 --- a/service/rds/api_op_CreateGlobalCluster.go +++ b/service/rds/api_op_CreateGlobalCluster.go @@ -18,7 +18,7 @@ import ( // subsystem. You can create a global database that is initially empty, and then // add a primary cluster and a secondary cluster to it. Or you can specify an // existing Aurora cluster during the create operation, and this cluster becomes -// the primary cluster of the global database. This action only applies to Aurora +// the primary cluster of the global database. This action applies only to Aurora // DB clusters. func (c *Client) CreateGlobalCluster(ctx context.Context, params *CreateGlobalClusterInput, optFns ...func(*Options)) (*CreateGlobalClusterOutput, error) { if params == nil { @@ -37,7 +37,7 @@ func (c *Client) CreateGlobalCluster(ctx context.Context, params *CreateGlobalCl type CreateGlobalClusterInput struct { - // The name for your database of up to 64 alpha-numeric characters. If you do not + // The name for your database of up to 64 alphanumeric characters. If you do not // provide a name, Amazon Aurora will not create a database in the global database // cluster you are creating. DatabaseName *string diff --git a/service/rds/api_op_DescribeEvents.go b/service/rds/api_op_DescribeEvents.go index abf457c25a7..ccdae4e5eb2 100644 --- a/service/rds/api_op_DescribeEvents.go +++ b/service/rds/api_op_DescribeEvents.go @@ -17,8 +17,13 @@ import ( // security groups, DB snapshots, DB cluster snapshots, and RDS Proxies for the // past 14 days. Events specific to a particular DB instance, DB cluster, DB // parameter group, DB security group, DB snapshot, DB cluster snapshot group, or -// RDS Proxy can be obtained by providing the name as a parameter. By default, RDS -// returns events that were generated in the past hour. +// RDS Proxy can be obtained by providing the name as a parameter. For more +// information on working with events, see Monitoring Amazon RDS events +// (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/working-with-events.html) +// in the Amazon RDS User Guide and Monitoring Amazon Aurora events +// (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/working-with-events.html) +// in the Amazon Aurora User Guide. By default, RDS returns events that were +// generated in the past hour. func (c *Client) DescribeEvents(ctx context.Context, params *DescribeEventsInput, optFns ...func(*Options)) (*DescribeEventsOutput, error) { if params == nil { params = &DescribeEventsInput{} diff --git a/service/rds/api_op_FailoverDBCluster.go b/service/rds/api_op_FailoverDBCluster.go index f7cfe0e47e7..e894b2fc5ea 100644 --- a/service/rds/api_op_FailoverDBCluster.go +++ b/service/rds/api_op_FailoverDBCluster.go @@ -18,7 +18,7 @@ import ( // instances (read-only instances) in the DB cluster to be the primary DB instance // (the cluster writer). An Amazon Aurora DB cluster automatically fails over to an // Aurora Replica, if one exists, when the primary DB instance fails. A Multi-AZ DB -// cluster automatically fails over to a readbable standby DB instance when the +// cluster automatically fails over to a readable standby DB instance when the // primary DB instance fails. To simulate a failure of a primary instance for // testing, you can force a failover. Because each instance in a DB cluster has its // own endpoint address, make sure to clean up and re-establish any existing diff --git a/service/rds/api_op_ModifyDBCluster.go b/service/rds/api_op_ModifyDBCluster.go index 20c794eea18..4ee78268470 100644 --- a/service/rds/api_op_ModifyDBCluster.go +++ b/service/rds/api_op_ModifyDBCluster.go @@ -274,8 +274,30 @@ type ModifyDBClusterInput struct { // Valid for: Multi-AZ DB clusters only PerformanceInsightsKMSKeyId *string - // The amount of time, in days, to retain Performance Insights data. Valid values - // are 7 or 731 (2 years). Valid for: Multi-AZ DB clusters only + // The number of days to retain Performance Insights data. The default is 7 days. + // The following values are valid: + // + // * 7 + // + // * month * 31, where month is a number of + // months from 1-23 + // + // * 731 + // + // For example, the following values are valid: + // + // * 93 (3 + // months * 31) + // + // * 341 (11 months * 31) + // + // * 589 (19 months * 31) + // + // * 731 + // + // If you + // specify a retention period such as 94, which isn't a valid value, RDS issues an + // error. Valid for: Multi-AZ DB clusters only PerformanceInsightsRetentionPeriod *int32 // The port number on which the DB cluster accepts connections. Constraints: Value diff --git a/service/rds/api_op_ModifyDBClusterParameterGroup.go b/service/rds/api_op_ModifyDBClusterParameterGroup.go index d8b56f9c096..6b81d6db2d0 100644 --- a/service/rds/api_op_ModifyDBClusterParameterGroup.go +++ b/service/rds/api_op_ModifyDBClusterParameterGroup.go @@ -22,14 +22,14 @@ import ( // when creating the default database for a DB cluster, such as the character set // for the default database defined by the character_set_database parameter. You // can use the Parameter Groups option of the Amazon RDS console -// (https://console.aws.amazon.com/rds/) or the DescribeDBClusterParameters action -// to verify that your DB cluster parameter group has been created or modified. If -// the modified DB cluster parameter group is used by an Aurora Serverless v1 -// cluster, Aurora applies the update immediately. The cluster restart might -// interrupt your workload. In that case, your application must reopen any -// connections and retry any transactions that were active when the parameter -// changes took effect. For more information on Amazon Aurora DB clusters, see -// What is Amazon Aurora? +// (https://console.aws.amazon.com/rds/) or the DescribeDBClusterParameters +// operation to verify that your DB cluster parameter group has been created or +// modified. If the modified DB cluster parameter group is used by an Aurora +// Serverless v1 cluster, Aurora applies the update immediately. The cluster +// restart might interrupt your workload. In that case, your application must +// reopen any connections and retry any transactions that were active when the +// parameter changes took effect. For more information on Amazon Aurora DB +// clusters, see What is Amazon Aurora? // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) // in the Amazon Aurora User Guide. For more information on Multi-AZ DB clusters, // see Multi-AZ deployments with two readable standby DB instances diff --git a/service/rds/api_op_ModifyDBClusterSnapshotAttribute.go b/service/rds/api_op_ModifyDBClusterSnapshotAttribute.go index 2568033c870..a84a672b8c1 100644 --- a/service/rds/api_op_ModifyDBClusterSnapshotAttribute.go +++ b/service/rds/api_op_ModifyDBClusterSnapshotAttribute.go @@ -25,7 +25,7 @@ import ( // as a value for that parameter in this case. To view which Amazon Web Services // accounts have access to copy or restore a manual DB cluster snapshot, or whether // a manual DB cluster snapshot is public or private, use the -// DescribeDBClusterSnapshotAttributes API action. The accounts are returned as +// DescribeDBClusterSnapshotAttributes API operation. The accounts are returned as // values for the restore attribute. func (c *Client) ModifyDBClusterSnapshotAttribute(ctx context.Context, params *ModifyDBClusterSnapshotAttributeInput, optFns ...func(*Options)) (*ModifyDBClusterSnapshotAttributeOutput, error) { if params == nil { @@ -48,7 +48,7 @@ type ModifyDBClusterSnapshotAttributeInput struct { // The name of the DB cluster snapshot attribute to modify. To manage authorization // for other Amazon Web Services accounts to copy or restore a manual DB cluster // snapshot, set this value to restore. To view the list of attributes available to - // modify, use the DescribeDBClusterSnapshotAttributes API action. + // modify, use the DescribeDBClusterSnapshotAttributes API operation. // // This member is required. AttributeName *string diff --git a/service/rds/api_op_ModifyDBInstance.go b/service/rds/api_op_ModifyDBInstance.go index 4ff5d28d5e7..cb44f3f0d11 100644 --- a/service/rds/api_op_ModifyDBInstance.go +++ b/service/rds/api_op_ModifyDBInstance.go @@ -111,14 +111,14 @@ type ModifyDBInstanceInput struct { // setting Constraints: // // * It must be a value from 0 to 35. It can't be set to 0 if - // the DB instance is a source to read replicas. It can't be set to 0 or 35 for an - // RDS Custom for Oracle DB instance. + // the DB instance is a source to read replicas. It can't be set to 0 for an RDS + // Custom for Oracle DB instance. // - // * It can be specified for a MySQL read - // replica only if the source is running MySQL 5.6 or later. + // * It can be specified for a MySQL read replica + // only if the source is running MySQL 5.6 or later. // - // * It can be specified - // for a PostgreSQL read replica only if the source is running PostgreSQL 9.3.5. + // * It can be specified for a + // PostgreSQL read replica only if the source is running PostgreSQL 9.3.5. BackupRetentionPeriod *int32 // Specifies the certificate to associate with the DB instance. This setting @@ -161,12 +161,14 @@ type ModifyDBInstanceInput struct { // more information, see ModifyDBCluster. CopyTagsToSnapshot *bool - // The new compute and memory capacity of the DB instance, for example db.m4.large. + // The new compute and memory capacity of the DB instance, for example db.m5.large. // Not all DB instance classes are available in all Amazon Web Services Regions, or // for all database engines. For the full list of DB instance classes, and - // availability for your engine, see DB Instance Class + // availability for your engine, see DB instance classes // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html) - // in the Amazon RDS User Guide. If you modify the DB instance class, an outage + // in the Amazon RDS User Guide or Aurora DB instance classes + // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Concepts.DBInstanceClass.html) + // in the Amazon Aurora User Guide. If you modify the DB instance class, an outage // occurs during the change. The change is applied during the next maintenance // window, unless ApplyImmediately is enabled for this request. This setting // doesn't apply to RDS Custom for Oracle. Default: Uses existing setting @@ -263,7 +265,7 @@ type ModifyDBInstanceInput struct { // A value that indicates whether to enable Performance Insights for the DB // instance. For more information, see Using Amazon Performance Insights // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html) - // in the Amazon RDS User Guide.. This setting doesn't apply to RDS Custom. + // in the Amazon RDS User Guide. This setting doesn't apply to RDS Custom. EnablePerformanceInsights *bool // The version number of the database engine to upgrade to. Changing this parameter @@ -320,8 +322,8 @@ type ModifyDBInstanceInput struct { // Constraints: Must contain from 8 to 128 characters. MySQL Constraints: Must // contain from 8 to 41 characters. Oracle Constraints: Must contain from 8 to 30 // characters. PostgreSQL Constraints: Must contain from 8 to 128 characters. - // Amazon RDS API actions never return the password, so this action provides a way - // to regain access to a primary instance user if the password is lost. This + // Amazon RDS API operations never return the password, so this action provides a + // way to regain access to a primary instance user if the password is lost. This // includes restoring privileges that might have been accidentally revoked. MasterUserPassword *string @@ -408,8 +410,30 @@ type ModifyDBInstanceInput struct { // This setting doesn't apply to RDS Custom. PerformanceInsightsKMSKeyId *string - // The amount of time, in days, to retain Performance Insights data. Valid values - // are 7 or 731 (2 years). This setting doesn't apply to RDS Custom. + // The number of days to retain Performance Insights data. The default is 7 days. + // The following values are valid: + // + // * 7 + // + // * month * 31, where month is a number of + // months from 1-23 + // + // * 731 + // + // For example, the following values are valid: + // + // * 93 (3 + // months * 31) + // + // * 341 (11 months * 31) + // + // * 589 (19 months * 31) + // + // * 731 + // + // If you + // specify a retention period such as 94, which isn't a valid value, RDS issues an + // error. This setting doesn't apply to RDS Custom. PerformanceInsightsRetentionPeriod *int32 // The daily time range during which automated backups are created if automated diff --git a/service/rds/api_op_ModifyDBProxyTargetGroup.go b/service/rds/api_op_ModifyDBProxyTargetGroup.go index 9b7924a61a4..91e5ce6655d 100644 --- a/service/rds/api_op_ModifyDBProxyTargetGroup.go +++ b/service/rds/api_op_ModifyDBProxyTargetGroup.go @@ -29,12 +29,12 @@ func (c *Client) ModifyDBProxyTargetGroup(ctx context.Context, params *ModifyDBP type ModifyDBProxyTargetGroupInput struct { - // The name of the new proxy to which to assign the target group. + // The name of the proxy. // // This member is required. DBProxyName *string - // The name of the new target group to assign to the proxy. + // The name of the target group to modify. // // This member is required. TargetGroupName *string diff --git a/service/rds/api_op_ModifyDBSnapshotAttribute.go b/service/rds/api_op_ModifyDBSnapshotAttribute.go index 43b7b0bb135..1c9b4e5e5c5 100644 --- a/service/rds/api_op_ModifyDBSnapshotAttribute.go +++ b/service/rds/api_op_ModifyDBSnapshotAttribute.go @@ -24,8 +24,8 @@ import ( // ValuesToAdd parameter. You can't use all as a value for that parameter in this // case. To view which Amazon Web Services accounts have access to copy or restore // a manual DB snapshot, or whether a manual DB snapshot public or private, use the -// DescribeDBSnapshotAttributes API action. The accounts are returned as values for -// the restore attribute. +// DescribeDBSnapshotAttributes API operation. The accounts are returned as values +// for the restore attribute. func (c *Client) ModifyDBSnapshotAttribute(ctx context.Context, params *ModifyDBSnapshotAttributeInput, optFns ...func(*Options)) (*ModifyDBSnapshotAttributeOutput, error) { if params == nil { params = &ModifyDBSnapshotAttributeInput{} @@ -47,7 +47,7 @@ type ModifyDBSnapshotAttributeInput struct { // The name of the DB snapshot attribute to modify. To manage authorization for // other Amazon Web Services accounts to copy or restore a manual DB snapshot, set // this value to restore. To view the list of attributes available to modify, use - // the DescribeDBSnapshotAttributes API action. + // the DescribeDBSnapshotAttributes API operation. // // This member is required. AttributeName *string diff --git a/service/rds/api_op_RestoreDBClusterFromS3.go b/service/rds/api_op_RestoreDBClusterFromS3.go index aa140078a18..c3180036508 100644 --- a/service/rds/api_op_RestoreDBClusterFromS3.go +++ b/service/rds/api_op_RestoreDBClusterFromS3.go @@ -61,8 +61,8 @@ type RestoreDBClusterFromS3Input struct { DBClusterIdentifier *string // The name of the database engine to be used for this DB cluster. Valid Values: - // aurora (for MySQL 5.6-compatible Aurora), aurora-mysql (for MySQL 5.7-compatible - // and MySQL 8.0-compatible Aurora), and aurora-postgresql + // aurora (for MySQL 5.6-compatible Aurora) and aurora-mysql (for MySQL + // 5.7-compatible and MySQL 8.0-compatible Aurora) // // This member is required. Engine *string @@ -193,12 +193,8 @@ type RestoreDBClusterFromS3Input struct { // "DBEngineVersions[].EngineVersion" To list all of the available engine versions // for aurora-mysql (for MySQL 5.7-compatible and MySQL 8.0-compatible Aurora), use // the following command: aws rds describe-db-engine-versions --engine aurora-mysql - // --query "DBEngineVersions[].EngineVersion" To list all of the available engine - // versions for aurora-postgresql, use the following command: aws rds - // describe-db-engine-versions --engine aurora-postgresql --query - // "DBEngineVersions[].EngineVersion" Aurora MySQL Example: 5.6.10a, - // 5.6.mysql_aurora.1.19.2, 5.7.12, 5.7.mysql_aurora.2.04.5, - // 8.0.mysql_aurora.3.01.0 Aurora PostgreSQL Example: 9.6.3, 10.7 + // --query "DBEngineVersions[].EngineVersion" Aurora MySQL Example: 5.6.10a, + // 5.6.mysql_aurora.1.19.2, 5.7.mysql_aurora.2.07.1, 8.0.mysql_aurora.3.02.0 EngineVersion *string // The Amazon Web Services KMS key identifier for an encrypted DB cluster. The diff --git a/service/rds/api_op_RestoreDBClusterFromSnapshot.go b/service/rds/api_op_RestoreDBClusterFromSnapshot.go index 2e5596c0521..a86c7734639 100644 --- a/service/rds/api_op_RestoreDBClusterFromSnapshot.go +++ b/service/rds/api_op_RestoreDBClusterFromSnapshot.go @@ -162,7 +162,7 @@ type RestoreDBClusterFromSnapshotInput struct { // For more information about exporting CloudWatch Logs for Amazon RDS, see // Publishing Database Logs to Amazon CloudWatch Logs // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch) - // in the Amazon RDS User Guide.. For more information about exporting CloudWatch + // in the Amazon RDS User Guide. For more information about exporting CloudWatch // Logs for Amazon Aurora, see Publishing Database Logs to Amazon CloudWatch Logs // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch) // in the Amazon Aurora User Guide. Valid for: Aurora DB clusters and Multi-AZ DB diff --git a/service/rds/api_op_RestoreDBClusterToPointInTime.go b/service/rds/api_op_RestoreDBClusterToPointInTime.go index 3d033478e9f..cafa62beaa3 100644 --- a/service/rds/api_op_RestoreDBClusterToPointInTime.go +++ b/service/rds/api_op_RestoreDBClusterToPointInTime.go @@ -146,7 +146,7 @@ type RestoreDBClusterToPointInTimeInput struct { // For more information about exporting CloudWatch Logs for Amazon RDS, see // Publishing Database Logs to Amazon CloudWatch Logs // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch) - // in the Amazon RDS User Guide.. For more information about exporting CloudWatch + // in the Amazon RDS User Guide. For more information about exporting CloudWatch // Logs for Amazon Aurora, see Publishing Database Logs to Amazon CloudWatch Logs // (https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch) // in the Amazon Aurora User Guide. Valid for: Aurora DB clusters and Multi-AZ DB diff --git a/service/rds/api_op_RestoreDBInstanceFromS3.go b/service/rds/api_op_RestoreDBInstanceFromS3.go index 3c5b9d26f61..7dd75ce9c84 100644 --- a/service/rds/api_op_RestoreDBInstanceFromS3.go +++ b/service/rds/api_op_RestoreDBInstanceFromS3.go @@ -163,7 +163,7 @@ type RestoreDBInstanceFromS3Input struct { // A value that indicates whether to enable Performance Insights for the DB // instance. For more information, see Using Amazon Performance Insights // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PerfInsights.html) - // in the Amazon RDS User Guide.. + // in the Amazon RDS User Guide. EnablePerformanceInsights *bool // The version number of the database engine to use. Choose the latest minor @@ -262,8 +262,30 @@ type RestoreDBInstanceFromS3Input struct { // account has a different default KMS key for each Amazon Web Services Region. PerformanceInsightsKMSKeyId *string - // The amount of time, in days, to retain Performance Insights data. Valid values - // are 7 or 731 (2 years). + // The number of days to retain Performance Insights data. The default is 7 days. + // The following values are valid: + // + // * 7 + // + // * month * 31, where month is a number of + // months from 1-23 + // + // * 731 + // + // For example, the following values are valid: + // + // * 93 (3 + // months * 31) + // + // * 341 (11 months * 31) + // + // * 589 (19 months * 31) + // + // * 731 + // + // If you + // specify a retention period such as 94, which isn't a valid value, RDS issues an + // error. PerformanceInsightsRetentionPeriod *int32 // The port number on which the database accepts connections. Type: Integer Valid diff --git a/service/rds/api_op_StartDBInstanceAutomatedBackupsReplication.go b/service/rds/api_op_StartDBInstanceAutomatedBackupsReplication.go index ae7b4c34f3d..26cdf698b40 100644 --- a/service/rds/api_op_StartDBInstanceAutomatedBackupsReplication.go +++ b/service/rds/api_op_StartDBInstanceAutomatedBackupsReplication.go @@ -49,12 +49,23 @@ type StartDBInstanceAutomatedBackupsReplicationInput struct { // arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE. KmsKeyId *string - // A URL that contains a Signature Version 4 signed request for the - // StartDBInstanceAutomatedBackupsReplication action to be called in the Amazon Web - // Services Region of the source DB instance. The presigned URL must be a valid - // request for the StartDBInstanceAutomatedBackupsReplication API action that can - // be executed in the Amazon Web Services Region that contains the source DB - // instance. + // In an Amazon Web Services GovCloud (US) Region, an URL that contains a Signature + // Version 4 signed request for the StartDBInstanceAutomatedBackupsReplication + // operation to call in the Amazon Web Services Region of the source DB instance. + // The presigned URL must be a valid request for the + // StartDBInstanceAutomatedBackupsReplication API operation that can run in the + // Amazon Web Services Region that contains the source DB instance. This setting + // applies only to Amazon Web Services GovCloud (US) Regions. It's ignored in other + // Amazon Web Services Regions. To learn how to generate a Signature Version 4 + // signed request, see Authenticating Requests: Using Query Parameters (Amazon Web + // Services Signature Version 4) + // (https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html) + // and Signature Version 4 Signing Process + // (https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html). If you + // are using an Amazon Web Services SDK tool or the CLI, you can specify + // SourceRegion (or --source-region for the CLI) instead of specifying PreSignedUrl + // manually. Specifying SourceRegion autogenerates a presigned URL that is a valid + // request for the operation that can run in the source Amazon Web Services Region. PreSignedUrl *string noSmithyDocumentSerde diff --git a/service/rds/api_op_StopDBInstanceAutomatedBackupsReplication.go b/service/rds/api_op_StopDBInstanceAutomatedBackupsReplication.go index 21a9fc27718..d6ae4480304 100644 --- a/service/rds/api_op_StopDBInstanceAutomatedBackupsReplication.go +++ b/service/rds/api_op_StopDBInstanceAutomatedBackupsReplication.go @@ -12,8 +12,8 @@ import ( ) // Stops automated backup replication for a DB instance. This command doesn't apply -// to RDS Custom. For more information, see Replicating Automated Backups to -// Another Amazon Web Services Region +// to RDS Custom, Aurora MySQL, and Aurora PostgreSQL. For more information, see +// Replicating Automated Backups to Another Amazon Web Services Region // (https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html) // in the Amazon RDS User Guide. func (c *Client) StopDBInstanceAutomatedBackupsReplication(ctx context.Context, params *StopDBInstanceAutomatedBackupsReplicationInput, optFns ...func(*Options)) (*StopDBInstanceAutomatedBackupsReplicationOutput, error) { diff --git a/service/rds/types/types.go b/service/rds/types/types.go index 4514f5dda29..f73374be3c7 100644 --- a/service/rds/types/types.go +++ b/service/rds/types/types.go @@ -554,9 +554,29 @@ type DBCluster struct { // non-Aurora Multi-AZ DB clusters. PerformanceInsightsKMSKeyId *string - // The amount of time, in days, to retain Performance Insights data. Valid values - // are 7 or 731 (2 years). This setting is only for non-Aurora Multi-AZ DB - // clusters. + // The number of days to retain Performance Insights data. The default is 7 days. + // The following values are valid: + // + // * 7 + // + // * month * 31, where month is a number of + // months from 1-23 + // + // * 731 + // + // For example, the following values are valid: + // + // * 93 (3 + // months * 31) + // + // * 341 (11 months * 31) + // + // * 589 (19 months * 31) + // + // * 731 + // + // This + // setting is only for non-Aurora Multi-AZ DB clusters. PerformanceInsightsRetentionPeriod *int32 // Specifies the port that the database engine is listening on. @@ -1337,8 +1357,26 @@ type DBInstance struct { // ID, alias ARN, or alias name for the KMS key. PerformanceInsightsKMSKeyId *string - // The amount of time, in days, to retain Performance Insights data. Valid values - // are 7 or 731 (2 years). + // The number of days to retain Performance Insights data. The default is 7 days. + // The following values are valid: + // + // * 7 + // + // * month * 31, where month is a number of + // months from 1-23 + // + // * 731 + // + // For example, the following values are valid: + // + // * 93 (3 + // months * 31) + // + // * 341 (11 months * 31) + // + // * 589 (19 months * 31) + // + // * 731 PerformanceInsightsRetentionPeriod *int32 // Specifies the daily time range during which automated backups are created if @@ -2225,7 +2263,9 @@ type EngineDefaults struct { noSmithyDocumentSerde } -// This data type is used as a response element in the DescribeEvents action. +// This data type is used as a response element in the DescribeEvents +// (https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeEvents.html) +// action. type Event struct { // Specifies the date and time of the event. @@ -2250,6 +2290,7 @@ type Event struct { } // Contains the results of a successful invocation of the DescribeEventCategories +// (https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DescribeEventCategories.html) // operation. type EventCategoriesMap struct { @@ -3656,7 +3697,8 @@ type ValidStorageOptions struct { // membership. type VpcSecurityGroupMembership struct { - // The status of the VPC security group. + // The membership status of the VPC security group. Currently, the only valid + // status is active. Status *string // The name of the VPC security group.