Skip to content

Commit 02407f8

Browse files
author
awstools
committed
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.
1 parent 13d1e18 commit 02407f8

File tree

6 files changed

+294
-9
lines changed

6 files changed

+294
-9
lines changed

clients/client-rds/src/commands/RestoreDBClusterFromSnapshotCommand.ts

+5
Original file line numberDiff line numberDiff line change
@@ -110,6 +110,11 @@ export interface RestoreDBClusterFromSnapshotCommandOutput
110110
* TransitGatewayMulticastDomainId: "STRING_VALUE",
111111
* ReplicaMode: "open-read-only" || "mounted",
112112
* },
113+
* MonitoringInterval: Number("int"),
114+
* MonitoringRoleArn: "STRING_VALUE",
115+
* EnablePerformanceInsights: true || false,
116+
* PerformanceInsightsKMSKeyId: "STRING_VALUE",
117+
* PerformanceInsightsRetentionPeriod: Number("int"),
113118
* EngineLifecycleSupport: "STRING_VALUE",
114119
* };
115120
* const command = new RestoreDBClusterFromSnapshotCommand(input);

clients/client-rds/src/commands/RestoreDBClusterToPointInTimeCommand.ts

+5
Original file line numberDiff line numberDiff line change
@@ -112,6 +112,11 @@ export interface RestoreDBClusterToPointInTimeCommandOutput
112112
* TransitGatewayMulticastDomainId: "STRING_VALUE",
113113
* ReplicaMode: "open-read-only" || "mounted",
114114
* },
115+
* MonitoringInterval: Number("int"),
116+
* MonitoringRoleArn: "STRING_VALUE",
117+
* EnablePerformanceInsights: true || false,
118+
* PerformanceInsightsKMSKeyId: "STRING_VALUE",
119+
* PerformanceInsightsRetentionPeriod: Number("int"),
115120
* EngineLifecycleSupport: "STRING_VALUE",
116121
* };
117122
* const command = new RestoreDBClusterToPointInTimeCommand(input);

clients/client-rds/src/models/models_0.ts

+65-5
Original file line numberDiff line numberDiff line change
@@ -771,9 +771,37 @@ export interface ApplyPendingMaintenanceActionMessage {
771771

772772
/**
773773
* <p>The pending maintenance action to apply to this resource.</p>
774-
* <p>Valid Values: <code>system-update</code>, <code>db-upgrade</code>,
775-
* <code>hardware-maintenance</code>, <code>ca-certificate-rotation</code>
776-
* </p>
774+
* <p>Valid Values:</p>
775+
* <ul>
776+
* <li>
777+
* <p>
778+
* <code>ca-certificate-rotation</code>
779+
* </p>
780+
* </li>
781+
* <li>
782+
* <p>
783+
* <code>db-upgrade</code>
784+
* </p>
785+
* </li>
786+
* <li>
787+
* <p>
788+
* <code>hardware-maintenance</code>
789+
* </p>
790+
* </li>
791+
* <li>
792+
* <p>
793+
* <code>os-upgrade</code>
794+
* </p>
795+
* </li>
796+
* <li>
797+
* <p>
798+
* <code>system-update</code>
799+
* </p>
800+
* </li>
801+
* </ul>
802+
* <p>For more information about these actions, see
803+
* <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#maintenance-actions-aurora">Maintenance actions for Amazon Aurora</a> or
804+
* <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#maintenance-actions-rds">Maintenance actions for Amazon RDS</a>.</p>
777805
* @public
778806
*/
779807
ApplyAction: string | undefined;
@@ -811,8 +839,37 @@ export interface PendingMaintenanceAction {
811839
/**
812840
* <p>The type of pending maintenance action that is available for the resource. </p>
813841
* <p>For more information about maintenance actions, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html">Maintaining a DB instance</a>.</p>
814-
* <p>Valid Values:<code> system-update | db-upgrade | hardware-maintenance | ca-certificate-rotation</code>
815-
* </p>
842+
* <p>Valid Values:</p>
843+
* <ul>
844+
* <li>
845+
* <p>
846+
* <code>ca-certificate-rotation</code>
847+
* </p>
848+
* </li>
849+
* <li>
850+
* <p>
851+
* <code>db-upgrade</code>
852+
* </p>
853+
* </li>
854+
* <li>
855+
* <p>
856+
* <code>hardware-maintenance</code>
857+
* </p>
858+
* </li>
859+
* <li>
860+
* <p>
861+
* <code>os-upgrade</code>
862+
* </p>
863+
* </li>
864+
* <li>
865+
* <p>
866+
* <code>system-update</code>
867+
* </p>
868+
* </li>
869+
* </ul>
870+
* <p>For more information about these actions, see
871+
* <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_UpgradeDBInstance.Maintenance.html#maintenance-actions-aurora">Maintenance actions for Amazon Aurora</a> or
872+
* <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_UpgradeDBInstance.Maintenance.html#maintenance-actions-rds">Maintenance actions for Amazon RDS</a>.</p>
816873
* @public
817874
*/
818875
Action?: string;
@@ -5153,6 +5210,9 @@ export interface CreateDBClusterMessage {
51535210
/**
51545211
* <p>Specifies whether to enable Aurora Limitless Database. You must enable Aurora Limitless Database to create a DB shard group.</p>
51555212
* <p>Valid for: Aurora DB clusters only</p>
5213+
* <note>
5214+
* <p>This setting is no longer used. Instead use the <code>ClusterScalabilityType</code> setting.</p>
5215+
* </note>
51565216
* @public
51575217
*/
51585218
EnableLimitlessDatabase?: boolean;

clients/client-rds/src/models/models_1.ts

+125
Original file line numberDiff line numberDiff line change
@@ -7994,6 +7994,9 @@ export interface ModifyDBClusterMessage {
79947994
/**
79957995
* <p>Specifies whether to enable Aurora Limitless Database. You must enable Aurora Limitless Database to create a DB shard group.</p>
79967996
* <p>Valid for: Aurora DB clusters only</p>
7997+
* <note>
7998+
* <p>This setting is no longer used. Instead use the <code>ClusterScalabilityType</code> setting when you create your Aurora Limitless Database DB cluster.</p>
7999+
* </note>
79978000
* @public
79988001
*/
79998002
EnableLimitlessDatabase?: boolean;
@@ -11879,6 +11882,67 @@ export interface RestoreDBClusterFromSnapshotMessage {
1187911882
*/
1188011883
RdsCustomClusterConfiguration?: RdsCustomClusterConfiguration;
1188111884

11885+
/**
11886+
* <p>The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster. To turn off
11887+
* collecting Enhanced Monitoring metrics, specify <code>0</code>.</p>
11888+
* <p>If <code>MonitoringRoleArn</code> is specified, also set <code>MonitoringInterval</code> to a value other than <code>0</code>.</p>
11889+
* <p>Valid Values: <code>0 | 1 | 5 | 10 | 15 | 30 | 60</code>
11890+
* </p>
11891+
* <p>Default: <code>0</code>
11892+
* </p>
11893+
* @public
11894+
*/
11895+
MonitoringInterval?: number;
11896+
11897+
/**
11898+
* <p>The Amazon Resource Name (ARN) for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs.
11899+
* An example is <code>arn:aws:iam:123456789012:role/emaccess</code>.</p>
11900+
* <p>If <code>MonitoringInterval</code> is set to a value other than <code>0</code>, supply a <code>MonitoringRoleArn</code> value.</p>
11901+
* @public
11902+
*/
11903+
MonitoringRoleArn?: string;
11904+
11905+
/**
11906+
* <p>Specifies whether to turn on Performance Insights for the DB cluster.</p>
11907+
* @public
11908+
*/
11909+
EnablePerformanceInsights?: boolean;
11910+
11911+
/**
11912+
* <p>The Amazon Web Services KMS key identifier for encryption of Performance Insights data.</p>
11913+
* <p>The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.</p>
11914+
* <p>If you don't specify a value for <code>PerformanceInsightsKMSKeyId</code>, then Amazon RDS uses your default KMS key.
11915+
* 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.</p>
11916+
* @public
11917+
*/
11918+
PerformanceInsightsKMSKeyId?: string;
11919+
11920+
/**
11921+
* <p>The number of days to retain Performance Insights data.</p>
11922+
* <p>Valid Values:</p>
11923+
* <ul>
11924+
* <li>
11925+
* <p>
11926+
* <code>7</code>
11927+
* </p>
11928+
* </li>
11929+
* <li>
11930+
* <p>
11931+
* <i>month</i> * 31, where <i>month</i> is a number of months from 1-23.
11932+
* Examples: <code>93</code> (3 months * 31), <code>341</code> (11 months * 31), <code>589</code> (19 months * 31)</p>
11933+
* </li>
11934+
* <li>
11935+
* <p>
11936+
* <code>731</code>
11937+
* </p>
11938+
* </li>
11939+
* </ul>
11940+
* <p>Default: <code>7</code> days</p>
11941+
* <p>If you specify a retention period that isn't valid, such as <code>94</code>, Amazon RDS issues an error.</p>
11942+
* @public
11943+
*/
11944+
PerformanceInsightsRetentionPeriod?: number;
11945+
1188211946
/**
1188311947
* <p>The life cycle type for this DB cluster.</p>
1188411948
* <note>
@@ -12340,6 +12404,67 @@ export interface RestoreDBClusterToPointInTimeMessage {
1234012404
*/
1234112405
RdsCustomClusterConfiguration?: RdsCustomClusterConfiguration;
1234212406

12407+
/**
12408+
* <p>The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB cluster. To turn off
12409+
* collecting Enhanced Monitoring metrics, specify <code>0</code>.</p>
12410+
* <p>If <code>MonitoringRoleArn</code> is specified, also set <code>MonitoringInterval</code> to a value other than <code>0</code>.</p>
12411+
* <p>Valid Values: <code>0 | 1 | 5 | 10 | 15 | 30 | 60</code>
12412+
* </p>
12413+
* <p>Default: <code>0</code>
12414+
* </p>
12415+
* @public
12416+
*/
12417+
MonitoringInterval?: number;
12418+
12419+
/**
12420+
* <p>The Amazon Resource Name (ARN) for the IAM role that permits RDS to send Enhanced Monitoring metrics to Amazon CloudWatch Logs.
12421+
* An example is <code>arn:aws:iam:123456789012:role/emaccess</code>.</p>
12422+
* <p>If <code>MonitoringInterval</code> is set to a value other than <code>0</code>, supply a <code>MonitoringRoleArn</code> value.</p>
12423+
* @public
12424+
*/
12425+
MonitoringRoleArn?: string;
12426+
12427+
/**
12428+
* <p>Specifies whether to turn on Performance Insights for the DB cluster.</p>
12429+
* @public
12430+
*/
12431+
EnablePerformanceInsights?: boolean;
12432+
12433+
/**
12434+
* <p>The Amazon Web Services KMS key identifier for encryption of Performance Insights data.</p>
12435+
* <p>The Amazon Web Services KMS key identifier is the key ARN, key ID, alias ARN, or alias name for the KMS key.</p>
12436+
* <p>If you don't specify a value for <code>PerformanceInsightsKMSKeyId</code>, then Amazon RDS uses your default KMS key.
12437+
* 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.</p>
12438+
* @public
12439+
*/
12440+
PerformanceInsightsKMSKeyId?: string;
12441+
12442+
/**
12443+
* <p>The number of days to retain Performance Insights data.</p>
12444+
* <p>Valid Values:</p>
12445+
* <ul>
12446+
* <li>
12447+
* <p>
12448+
* <code>7</code>
12449+
* </p>
12450+
* </li>
12451+
* <li>
12452+
* <p>
12453+
* <i>month</i> * 31, where <i>month</i> is a number of months from 1-23.
12454+
* Examples: <code>93</code> (3 months * 31), <code>341</code> (11 months * 31), <code>589</code> (19 months * 31)</p>
12455+
* </li>
12456+
* <li>
12457+
* <p>
12458+
* <code>731</code>
12459+
* </p>
12460+
* </li>
12461+
* </ul>
12462+
* <p>Default: <code>7</code> days</p>
12463+
* <p>If you specify a retention period that isn't valid, such as <code>94</code>, Amazon RDS issues an error.</p>
12464+
* @public
12465+
*/
12466+
PerformanceInsightsRetentionPeriod?: number;
12467+
1234312468
/**
1234412469
* <p>The life cycle type for this DB cluster.</p>
1234512470
* <note>

clients/client-rds/src/protocols/Aws_query.ts

+30
Original file line numberDiff line numberDiff line change
@@ -15221,6 +15221,21 @@ const se_RestoreDBClusterFromSnapshotMessage = (
1522115221
entries[loc] = value;
1522215222
});
1522315223
}
15224+
if (input[_MIo] != null) {
15225+
entries[_MIo] = input[_MIo];
15226+
}
15227+
if (input[_MRA] != null) {
15228+
entries[_MRA] = input[_MRA];
15229+
}
15230+
if (input[_EPI] != null) {
15231+
entries[_EPI] = input[_EPI];
15232+
}
15233+
if (input[_PIKMSKI] != null) {
15234+
entries[_PIKMSKI] = input[_PIKMSKI];
15235+
}
15236+
if (input[_PIRP] != null) {
15237+
entries[_PIRP] = input[_PIRP];
15238+
}
1522415239
if (input[_ELS] != null) {
1522515240
entries[_ELS] = input[_ELS];
1522615241
}
@@ -15355,6 +15370,21 @@ const se_RestoreDBClusterToPointInTimeMessage = (
1535515370
entries[loc] = value;
1535615371
});
1535715372
}
15373+
if (input[_MIo] != null) {
15374+
entries[_MIo] = input[_MIo];
15375+
}
15376+
if (input[_MRA] != null) {
15377+
entries[_MRA] = input[_MRA];
15378+
}
15379+
if (input[_EPI] != null) {
15380+
entries[_EPI] = input[_EPI];
15381+
}
15382+
if (input[_PIKMSKI] != null) {
15383+
entries[_PIKMSKI] = input[_PIKMSKI];
15384+
}
15385+
if (input[_PIRP] != null) {
15386+
entries[_PIRP] = input[_PIRP];
15387+
}
1535815388
if (input[_ELS] != null) {
1535915389
entries[_ELS] = input[_ELS];
1536015390
}

0 commit comments

Comments
 (0)