From 02407f89d0477ba7a33583675881df2eb9607ba6 Mon Sep 17 00:00:00 2001 From: awstools Date: Mon, 28 Oct 2024 18:15:46 +0000 Subject: [PATCH] feat(client-rds): This release adds support for Enhanced Monitoring and Performance Insights when restoring Aurora Limitless Database DB clusters. It also adds support for the os-upgrade pending maintenance action. --- .../RestoreDBClusterFromSnapshotCommand.ts | 5 + .../RestoreDBClusterToPointInTimeCommand.ts | 5 + clients/client-rds/src/models/models_0.ts | 70 +++++++++- clients/client-rds/src/models/models_1.ts | 125 ++++++++++++++++++ clients/client-rds/src/protocols/Aws_query.ts | 30 +++++ codegen/sdk-codegen/aws-models/rds.json | 68 +++++++++- 6 files changed, 294 insertions(+), 9 deletions(-) diff --git a/clients/client-rds/src/commands/RestoreDBClusterFromSnapshotCommand.ts b/clients/client-rds/src/commands/RestoreDBClusterFromSnapshotCommand.ts index 7798465f94d1..5e451136e444 100644 --- a/clients/client-rds/src/commands/RestoreDBClusterFromSnapshotCommand.ts +++ b/clients/client-rds/src/commands/RestoreDBClusterFromSnapshotCommand.ts @@ -110,6 +110,11 @@ export interface RestoreDBClusterFromSnapshotCommandOutput * TransitGatewayMulticastDomainId: "STRING_VALUE", * ReplicaMode: "open-read-only" || "mounted", * }, + * MonitoringInterval: Number("int"), + * MonitoringRoleArn: "STRING_VALUE", + * EnablePerformanceInsights: true || false, + * PerformanceInsightsKMSKeyId: "STRING_VALUE", + * PerformanceInsightsRetentionPeriod: Number("int"), * EngineLifecycleSupport: "STRING_VALUE", * }; * const command = new RestoreDBClusterFromSnapshotCommand(input); diff --git a/clients/client-rds/src/commands/RestoreDBClusterToPointInTimeCommand.ts b/clients/client-rds/src/commands/RestoreDBClusterToPointInTimeCommand.ts index ac83e9ea3924..be2c7be12c2e 100644 --- a/clients/client-rds/src/commands/RestoreDBClusterToPointInTimeCommand.ts +++ b/clients/client-rds/src/commands/RestoreDBClusterToPointInTimeCommand.ts @@ -112,6 +112,11 @@ export interface RestoreDBClusterToPointInTimeCommandOutput * TransitGatewayMulticastDomainId: "STRING_VALUE", * ReplicaMode: "open-read-only" || "mounted", * }, + * MonitoringInterval: Number("int"), + * MonitoringRoleArn: "STRING_VALUE", + * EnablePerformanceInsights: true || false, + * PerformanceInsightsKMSKeyId: "STRING_VALUE", + * PerformanceInsightsRetentionPeriod: Number("int"), * EngineLifecycleSupport: "STRING_VALUE", * }; * const command = new RestoreDBClusterToPointInTimeCommand(input); diff --git a/clients/client-rds/src/models/models_0.ts b/clients/client-rds/src/models/models_0.ts index 8c638833d1b7..d8d2b662e51d 100644 --- a/clients/client-rds/src/models/models_0.ts +++ b/clients/client-rds/src/models/models_0.ts @@ -771,9 +771,37 @@ export interface ApplyPendingMaintenanceActionMessage { /** *

The pending maintenance action to apply to this resource.

- *

Valid Values: system-update, db-upgrade, - * hardware-maintenance, ca-certificate-rotation - *

+ *

Valid Values:

+ * + *

For more information about these actions, see + * Maintenance actions for Amazon Aurora or + * Maintenance actions for Amazon RDS.

* @public */ ApplyAction: string | undefined; @@ -811,8 +839,37 @@ export interface PendingMaintenanceAction { /** *

The type of pending maintenance action that is available for the resource.

*

For more information about maintenance actions, see Maintaining a DB instance.

- *

Valid Values: system-update | db-upgrade | hardware-maintenance | ca-certificate-rotation - *

+ *

Valid Values:

+ * + *

For more information about these actions, see + * Maintenance actions for Amazon Aurora or + * Maintenance actions for Amazon RDS.

* @public */ Action?: string; @@ -5153,6 +5210,9 @@ export interface CreateDBClusterMessage { /** *

Specifies whether to enable Aurora Limitless Database. You must enable Aurora Limitless Database to create a DB shard group.

*

Valid for: Aurora DB clusters only

+ * + *

This setting is no longer used. Instead use the ClusterScalabilityType setting.

+ * * @public */ EnableLimitlessDatabase?: boolean; diff --git a/clients/client-rds/src/models/models_1.ts b/clients/client-rds/src/models/models_1.ts index 8920882580bc..774fa0600723 100644 --- a/clients/client-rds/src/models/models_1.ts +++ b/clients/client-rds/src/models/models_1.ts @@ -7994,6 +7994,9 @@ export interface ModifyDBClusterMessage { /** *

Specifies whether to enable Aurora Limitless Database. You must enable Aurora Limitless Database to create a DB shard group.

*

Valid for: Aurora DB clusters only

+ * + *

This setting is no longer used. Instead use the ClusterScalabilityType setting when you create your Aurora Limitless Database DB cluster.

+ * * @public */ EnableLimitlessDatabase?: boolean; @@ -11879,6 +11882,67 @@ export interface RestoreDBClusterFromSnapshotMessage { */ RdsCustomClusterConfiguration?: RdsCustomClusterConfiguration; + /** + *

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster. To turn off + * collecting Enhanced Monitoring metrics, specify 0.

+ *

If MonitoringRoleArn is specified, also set MonitoringInterval to a value other than 0.

+ *

Valid Values: 0 | 1 | 5 | 10 | 15 | 30 | 60 + *

+ *

Default: 0 + *

+ * @public + */ + MonitoringInterval?: number; + + /** + *

The Amazon Resource Name (ARN) for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs. + * An example is arn:aws:iam:123456789012:role/emaccess.

+ *

If MonitoringInterval is set to a value other than 0, supply a MonitoringRoleArn value.

+ * @public + */ + MonitoringRoleArn?: string; + + /** + *

Specifies whether to turn on Performance Insights for the DB cluster.

+ * @public + */ + EnablePerformanceInsights?: boolean; + + /** + *

The Amazon Web Services KMS key identifier for encryption of Performance Insights data.

+ *

The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.

+ *

If you don't specify a value for PerformanceInsightsKMSKeyId, then Amazon RDS uses your default KMS key. + * There is a default KMS key for your Amazon Web Services account. Your Amazon Web Services account has a different default KMS key for each Amazon Web Services Region.

+ * @public + */ + PerformanceInsightsKMSKeyId?: string; + + /** + *

The number of days to retain Performance Insights data.

+ *

Valid Values:

+ * + *

Default: 7 days

+ *

If you specify a retention period that isn't valid, such as 94, Amazon RDS issues an error.

+ * @public + */ + PerformanceInsightsRetentionPeriod?: number; + /** *

The life cycle type for this DB cluster.

* @@ -12340,6 +12404,67 @@ export interface RestoreDBClusterToPointInTimeMessage { */ RdsCustomClusterConfiguration?: RdsCustomClusterConfiguration; + /** + *

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster. To turn off + * collecting Enhanced Monitoring metrics, specify 0.

+ *

If MonitoringRoleArn is specified, also set MonitoringInterval to a value other than 0.

+ *

Valid Values: 0 | 1 | 5 | 10 | 15 | 30 | 60 + *

+ *

Default: 0 + *

+ * @public + */ + MonitoringInterval?: number; + + /** + *

The Amazon Resource Name (ARN) for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs. + * An example is arn:aws:iam:123456789012:role/emaccess.

+ *

If MonitoringInterval is set to a value other than 0, supply a MonitoringRoleArn value.

+ * @public + */ + MonitoringRoleArn?: string; + + /** + *

Specifies whether to turn on Performance Insights for the DB cluster.

+ * @public + */ + EnablePerformanceInsights?: boolean; + + /** + *

The Amazon Web Services KMS key identifier for encryption of Performance Insights data.

+ *

The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.

+ *

If you don't specify a value for PerformanceInsightsKMSKeyId, then Amazon RDS uses your default KMS key. + * There is a default KMS key for your Amazon Web Services account. Your Amazon Web Services account has a different default KMS key for each Amazon Web Services Region.

+ * @public + */ + PerformanceInsightsKMSKeyId?: string; + + /** + *

The number of days to retain Performance Insights data.

+ *

Valid Values:

+ * + *

Default: 7 days

+ *

If you specify a retention period that isn't valid, such as 94, Amazon RDS issues an error.

+ * @public + */ + PerformanceInsightsRetentionPeriod?: number; + /** *

The life cycle type for this DB cluster.

* diff --git a/clients/client-rds/src/protocols/Aws_query.ts b/clients/client-rds/src/protocols/Aws_query.ts index 3f1c6611328c..11aff8eba2bb 100644 --- a/clients/client-rds/src/protocols/Aws_query.ts +++ b/clients/client-rds/src/protocols/Aws_query.ts @@ -15221,6 +15221,21 @@ const se_RestoreDBClusterFromSnapshotMessage = ( entries[loc] = value; }); } + if (input[_MIo] != null) { + entries[_MIo] = input[_MIo]; + } + if (input[_MRA] != null) { + entries[_MRA] = input[_MRA]; + } + if (input[_EPI] != null) { + entries[_EPI] = input[_EPI]; + } + if (input[_PIKMSKI] != null) { + entries[_PIKMSKI] = input[_PIKMSKI]; + } + if (input[_PIRP] != null) { + entries[_PIRP] = input[_PIRP]; + } if (input[_ELS] != null) { entries[_ELS] = input[_ELS]; } @@ -15355,6 +15370,21 @@ const se_RestoreDBClusterToPointInTimeMessage = ( entries[loc] = value; }); } + if (input[_MIo] != null) { + entries[_MIo] = input[_MIo]; + } + if (input[_MRA] != null) { + entries[_MRA] = input[_MRA]; + } + if (input[_EPI] != null) { + entries[_EPI] = input[_EPI]; + } + if (input[_PIKMSKI] != null) { + entries[_PIKMSKI] = input[_PIKMSKI]; + } + if (input[_PIRP] != null) { + entries[_PIRP] = input[_PIRP]; + } if (input[_ELS] != null) { entries[_ELS] = input[_ELS]; } diff --git a/codegen/sdk-codegen/aws-models/rds.json b/codegen/sdk-codegen/aws-models/rds.json index 7e0083400c8b..dfcef1e30931 100644 --- a/codegen/sdk-codegen/aws-models/rds.json +++ b/codegen/sdk-codegen/aws-models/rds.json @@ -2075,7 +2075,7 @@ "target": "com.amazonaws.rds#String", "traits": { "smithy.api#clientOptional": {}, - "smithy.api#documentation": "

The pending maintenance action to apply to this resource.

\n

Valid Values: system-update, db-upgrade, \n hardware-maintenance, ca-certificate-rotation\n

", + "smithy.api#documentation": "

The pending maintenance action to apply to this resource.

\n

Valid Values:

\n
    \n
  • \n

    \n ca-certificate-rotation\n

    \n
    • \n
  • \n

    \n db-upgrade\n

    \n
    • \n
  • \n

    \n hardware-maintenance\n

    \n
    • \n
  • \n

    \n os-upgrade\n

    \n
    • \n
  • \n

    \n system-update\n

    \n
    • \n
\n

For more information about these actions, see \n Maintenance actions for Amazon Aurora or \n Maintenance actions for Amazon RDS.

", "smithy.api#required": {} } }, @@ -4440,7 +4440,7 @@ "EnableLimitlessDatabase": { "target": "com.amazonaws.rds#BooleanOptional", "traits": { - "smithy.api#documentation": "

Specifies whether to enable Aurora Limitless Database. You must enable Aurora Limitless Database to create a DB shard group.

\n

Valid for: Aurora DB clusters only

" + "smithy.api#documentation": "

Specifies whether to enable Aurora Limitless Database. You must enable Aurora Limitless Database to create a DB shard group.

\n

Valid for: Aurora DB clusters only

\n \n

This setting is no longer used. Instead use the ClusterScalabilityType setting.

\n " } }, "ServerlessV2ScalingConfiguration": { @@ -21728,7 +21728,7 @@ "EnableLimitlessDatabase": { "target": "com.amazonaws.rds#BooleanOptional", "traits": { - "smithy.api#documentation": "

Specifies whether to enable Aurora Limitless Database. You must enable Aurora Limitless Database to create a DB shard group.

\n

Valid for: Aurora DB clusters only

" + "smithy.api#documentation": "

Specifies whether to enable Aurora Limitless Database. You must enable Aurora Limitless Database to create a DB shard group.

\n

Valid for: Aurora DB clusters only

\n \n

This setting is no longer used. Instead use the ClusterScalabilityType setting when you create your Aurora Limitless Database DB cluster.

\n " } }, "CACertificateIdentifier": { @@ -24639,7 +24639,7 @@ "Action": { "target": "com.amazonaws.rds#String", "traits": { - "smithy.api#documentation": "

The type of pending maintenance action that is available for the resource.

\n

For more information about maintenance actions, see Maintaining a DB instance.

\n

Valid Values: system-update | db-upgrade | hardware-maintenance | ca-certificate-rotation\n

" + "smithy.api#documentation": "

The type of pending maintenance action that is available for the resource.

\n

For more information about maintenance actions, see Maintaining a DB instance.

\n

Valid Values:

\n
    \n
  • \n

    \n ca-certificate-rotation\n

    \n
    • \n
  • \n

    \n db-upgrade\n

    \n
    • \n
  • \n

    \n hardware-maintenance\n

    \n
    • \n
  • \n

    \n os-upgrade\n

    \n
    • \n
  • \n

    \n system-update\n

    \n
    • \n
\n

For more information about these actions, see \n Maintenance actions for Amazon Aurora or \n Maintenance actions for Amazon RDS.

" } }, "AutoAppliedAfterDate": { @@ -27248,6 +27248,36 @@ "smithy.api#documentation": "

Reserved for future use.

" } }, + "MonitoringInterval": { + "target": "com.amazonaws.rds#IntegerOptional", + "traits": { + "smithy.api#documentation": "

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster. To turn off \n collecting Enhanced Monitoring metrics, specify 0.

\n

If MonitoringRoleArn is specified, also set MonitoringInterval to a value other than 0.

\n

Valid Values: 0 | 1 | 5 | 10 | 15 | 30 | 60\n

\n

Default: 0\n

" + } + }, + "MonitoringRoleArn": { + "target": "com.amazonaws.rds#String", + "traits": { + "smithy.api#documentation": "

The Amazon Resource Name (ARN) for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs. \n An example is arn:aws:iam:123456789012:role/emaccess.

\n

If MonitoringInterval is set to a value other than 0, supply a MonitoringRoleArn value.

" + } + }, + "EnablePerformanceInsights": { + "target": "com.amazonaws.rds#BooleanOptional", + "traits": { + "smithy.api#documentation": "

Specifies whether to turn on Performance Insights for the DB cluster.

" + } + }, + "PerformanceInsightsKMSKeyId": { + "target": "com.amazonaws.rds#String", + "traits": { + "smithy.api#documentation": "

The Amazon Web Services KMS key identifier for encryption of Performance Insights data.

\n

The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.

\n

If you don't specify a value for PerformanceInsightsKMSKeyId, then Amazon RDS uses your default KMS key. \n There is a default KMS key for your Amazon Web Services account. Your Amazon Web Services account has a different default KMS key for each Amazon Web Services Region.

" + } + }, + "PerformanceInsightsRetentionPeriod": { + "target": "com.amazonaws.rds#IntegerOptional", + "traits": { + "smithy.api#documentation": "

The number of days to retain Performance Insights data.

\n

Valid Values:

\n
    \n
  • \n

    \n 7\n

    \n
    • \n
  • \n

    \n month * 31, where month is a number of months from 1-23. \n Examples: 93 (3 months * 31), 341 (11 months * 31), 589 (19 months * 31)

    \n
    • \n
  • \n

    \n 731\n

    \n
    • \n
\n

Default: 7 days

\n

If you specify a retention period that isn't valid, such as 94, Amazon RDS issues an error.

" + } + }, "EngineLifecycleSupport": { "target": "com.amazonaws.rds#String", "traits": { @@ -27573,6 +27603,36 @@ "smithy.api#documentation": "

Reserved for future use.

" } }, + "MonitoringInterval": { + "target": "com.amazonaws.rds#IntegerOptional", + "traits": { + "smithy.api#documentation": "

The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster. To turn off \n collecting Enhanced Monitoring metrics, specify 0.

\n

If MonitoringRoleArn is specified, also set MonitoringInterval to a value other than 0.

\n

Valid Values: 0 | 1 | 5 | 10 | 15 | 30 | 60\n

\n

Default: 0\n

" + } + }, + "MonitoringRoleArn": { + "target": "com.amazonaws.rds#String", + "traits": { + "smithy.api#documentation": "

The Amazon Resource Name (ARN) for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs. \n An example is arn:aws:iam:123456789012:role/emaccess.

\n

If MonitoringInterval is set to a value other than 0, supply a MonitoringRoleArn value.

" + } + }, + "EnablePerformanceInsights": { + "target": "com.amazonaws.rds#BooleanOptional", + "traits": { + "smithy.api#documentation": "

Specifies whether to turn on Performance Insights for the DB cluster.

" + } + }, + "PerformanceInsightsKMSKeyId": { + "target": "com.amazonaws.rds#String", + "traits": { + "smithy.api#documentation": "

The Amazon Web Services KMS key identifier for encryption of Performance Insights data.

\n

The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.

\n

If you don't specify a value for PerformanceInsightsKMSKeyId, then Amazon RDS uses your default KMS key. \n There is a default KMS key for your Amazon Web Services account. Your Amazon Web Services account has a different default KMS key for each Amazon Web Services Region.

" + } + }, + "PerformanceInsightsRetentionPeriod": { + "target": "com.amazonaws.rds#IntegerOptional", + "traits": { + "smithy.api#documentation": "

The number of days to retain Performance Insights data.

\n

Valid Values:

\n
    \n
  • \n

    \n 7\n

    \n
    • \n
  • \n

    \n month * 31, where month is a number of months from 1-23. \n Examples: 93 (3 months * 31), 341 (11 months * 31), 589 (19 months * 31)

    \n
    • \n
  • \n

    \n 731\n

    \n
    • \n
\n

Default: 7 days

\n

If you specify a retention period that isn't valid, such as 94, Amazon RDS issues an error.

" + } + }, "EngineLifecycleSupport": { "target": "com.amazonaws.rds#String", "traits": {