aws-sdk-rds 1.317.0 → 1.319.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-rds/client.rb +276 -20
- data/lib/aws-sdk-rds/client_api.rb +21 -2
- data/lib/aws-sdk-rds/db_cluster.rb +56 -2
- data/lib/aws-sdk-rds/db_cluster_snapshot.rb +16 -1
- data/lib/aws-sdk-rds/db_instance.rb +29 -6
- data/lib/aws-sdk-rds/db_snapshot.rb +3 -3
- data/lib/aws-sdk-rds/resource.rb +18 -4
- data/lib/aws-sdk-rds/types.rb +144 -22
- data/lib/aws-sdk-rds.rb +1 -1
- data/sig/client.rbs +30 -4
- data/sig/db_cluster.rbs +15 -2
- data/sig/db_cluster_snapshot.rbs +7 -1
- data/sig/db_instance.rbs +2 -1
- data/sig/resource.rbs +6 -0
- data/sig/types.rbs +12 -0
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: eff1c3033ca31c7f383a9cbb825bf5e20d093e06520d3d1e7dab4d7368141fc8
|
|
4
|
+
data.tar.gz: 4d8c5b23edda5ae3e8eab57c400fdffdb290fdea4e9107de471d959c2d1f900d
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: ab76c3dcd501a30c377bc1d86bea27ceefdea44cd99013e4e5e2c5bcb18b875bfdc9ee867b7e9510d22cda4ee0b17d39b03402ec6732f4eaf0cff48c3a2e518d
|
|
7
|
+
data.tar.gz: 853dfa1c4768cfa7eabd55e314115c77910a3a674defd3f2f7e29ead58042e2f591b1e54ae2ef093f7c8f9df2d83d1827d2f958b6620cce58542285fe7d4256f
|
data/CHANGELOG.md
CHANGED
|
@@ -1,6 +1,16 @@
|
|
|
1
1
|
Unreleased Changes
|
|
2
2
|
------------------
|
|
3
3
|
|
|
4
|
+
1.319.0 (2026-07-17)
|
|
5
|
+
------------------
|
|
6
|
+
|
|
7
|
+
* Feature - Adds the AssociatedRoles parameter to CreateDBCluster, RestoreDBClusterFromSnapshot, RestoreDBClusterToPointInTime, and RestoreDBClusterFromS3, letting customers associate IAM roles with an Aurora DB cluster at create or restore time instead of calling AddRoleToDBCluster afterward.
|
|
8
|
+
|
|
9
|
+
1.318.0 (2026-07-15)
|
|
10
|
+
------------------
|
|
11
|
+
|
|
12
|
+
* Feature - Adds support for modifying EngineLifecycleSupport on DB instances and DB clusters through ModifyDBInstance and ModifyDBCluster.
|
|
13
|
+
|
|
4
14
|
1.317.0 (2026-07-09)
|
|
5
15
|
------------------
|
|
6
16
|
|
data/VERSION
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.319.0
|
data/lib/aws-sdk-rds/client.rb
CHANGED
|
@@ -508,7 +508,7 @@ module Aws::RDS
|
|
|
508
508
|
#
|
|
509
509
|
# resp = client.add_role_to_db_cluster({
|
|
510
510
|
# db_cluster_identifier: "String", # required
|
|
511
|
-
# role_arn: "
|
|
511
|
+
# role_arn: "IAMRoleArn", # required
|
|
512
512
|
# feature_name: "String",
|
|
513
513
|
# })
|
|
514
514
|
#
|
|
@@ -2754,6 +2754,13 @@ module Aws::RDS
|
|
|
2754
2754
|
# instance and feature specific values set to all other input parameters
|
|
2755
2755
|
# of this API.
|
|
2756
2756
|
#
|
|
2757
|
+
# You can use the `AssociatedRoles` parameter to associate one or more
|
|
2758
|
+
# Amazon Web Services Identity and Access Management (IAM) roles with an
|
|
2759
|
+
# Aurora DB cluster. Each associated role lets the DB cluster access
|
|
2760
|
+
# other Amazon Web Services on your behalf, such as Amazon S3 for data
|
|
2761
|
+
# import and export, or Amazon Web Services Lambda for invoking
|
|
2762
|
+
# functions.
|
|
2763
|
+
#
|
|
2757
2764
|
#
|
|
2758
2765
|
#
|
|
2759
2766
|
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBInstance.html
|
|
@@ -3645,7 +3652,7 @@ module Aws::RDS
|
|
|
3645
3652
|
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html
|
|
3646
3653
|
#
|
|
3647
3654
|
# @option params [String] :engine_lifecycle_support
|
|
3648
|
-
# The
|
|
3655
|
+
# The lifecycle type for this DB cluster.
|
|
3649
3656
|
#
|
|
3650
3657
|
# <note markdown="1"> By default, this value is set to `open-source-rds-extended-support`,
|
|
3651
3658
|
# which enrolls your DB cluster into Amazon RDS Extended Support. At the
|
|
@@ -3713,6 +3720,15 @@ module Aws::RDS
|
|
|
3713
3720
|
#
|
|
3714
3721
|
# Valid for Cluster Type: Aurora DB clusters
|
|
3715
3722
|
#
|
|
3723
|
+
# @option params [Array<Types::DBClusterAssociatedRole>] :associated_roles
|
|
3724
|
+
# A list of Amazon Web Services Identity and Access Management (IAM)
|
|
3725
|
+
# roles to associate with the DB cluster. Each role grants the DB
|
|
3726
|
+
# cluster permission to access other Amazon Web Services on your behalf.
|
|
3727
|
+
# For each role, specify a role ARN and, optionally, the feature name
|
|
3728
|
+
# (such as `s3Import`, `s3Export`, or `Lambda`).
|
|
3729
|
+
#
|
|
3730
|
+
# Valid for Cluster Type: Aurora DB clusters only
|
|
3731
|
+
#
|
|
3716
3732
|
# @option params [String] :source_region
|
|
3717
3733
|
# The source region of the snapshot. This is only needed when the
|
|
3718
3734
|
# shapshot is encrypted and in a different region.
|
|
@@ -3921,6 +3937,73 @@ module Aws::RDS
|
|
|
3921
3937
|
# },
|
|
3922
3938
|
# }
|
|
3923
3939
|
#
|
|
3940
|
+
# @example Example: To create an Aurora DB cluster with an associated IAM role for Amazon S3 import
|
|
3941
|
+
#
|
|
3942
|
+
# # The following example creates an Aurora PostgreSQL-compatible DB cluster and associates an IAM role for Amazon S3 import
|
|
3943
|
+
# # in a single call.
|
|
3944
|
+
#
|
|
3945
|
+
# resp = client.create_db_cluster({
|
|
3946
|
+
# associated_roles: [
|
|
3947
|
+
# {
|
|
3948
|
+
# feature_name: "s3Import",
|
|
3949
|
+
# role_arn: "arn:aws:iam::123456789012:role/RDSLoadFromS3",
|
|
3950
|
+
# },
|
|
3951
|
+
# ],
|
|
3952
|
+
# db_cluster_identifier: "sample-cluster",
|
|
3953
|
+
# engine: "aurora-postgresql",
|
|
3954
|
+
# master_user_password: "mypassword",
|
|
3955
|
+
# master_username: "admin",
|
|
3956
|
+
# })
|
|
3957
|
+
#
|
|
3958
|
+
# resp.to_h outputs the following:
|
|
3959
|
+
# {
|
|
3960
|
+
# db_cluster: {
|
|
3961
|
+
# allocated_storage: 1,
|
|
3962
|
+
# associated_roles: [
|
|
3963
|
+
# {
|
|
3964
|
+
# feature_name: "s3Import",
|
|
3965
|
+
# role_arn: "arn:aws:iam::123456789012:role/RDSLoadFromS3",
|
|
3966
|
+
# status: "ACTIVE",
|
|
3967
|
+
# },
|
|
3968
|
+
# ],
|
|
3969
|
+
# availability_zones: [
|
|
3970
|
+
# "us-east-1a",
|
|
3971
|
+
# "us-east-1b",
|
|
3972
|
+
# "us-east-1c",
|
|
3973
|
+
# ],
|
|
3974
|
+
# backup_retention_period: 1,
|
|
3975
|
+
# cluster_create_time: Time.parse("2024-06-07T23:26:08.371Z"),
|
|
3976
|
+
# copy_tags_to_snapshot: false,
|
|
3977
|
+
# db_cluster_arn: "arn:aws:rds:us-east-1:123456789012:cluster:sample-cluster",
|
|
3978
|
+
# db_cluster_identifier: "sample-cluster",
|
|
3979
|
+
# db_cluster_members: [
|
|
3980
|
+
# ],
|
|
3981
|
+
# db_cluster_parameter_group: "default.aurora-postgresql17",
|
|
3982
|
+
# db_subnet_group: "default",
|
|
3983
|
+
# db_cluster_resource_id: "cluster-ANPAJ4AE5446DAEXAMPLE",
|
|
3984
|
+
# deletion_protection: false,
|
|
3985
|
+
# endpoint: "sample-cluster.cluster-cnpexample.us-east-1.rds.amazonaws.com",
|
|
3986
|
+
# engine: "aurora-postgresql",
|
|
3987
|
+
# engine_mode: "provisioned",
|
|
3988
|
+
# engine_version: "17.7",
|
|
3989
|
+
# hosted_zone_id: "Z2R2ITUGPM61AM",
|
|
3990
|
+
# http_endpoint_enabled: false,
|
|
3991
|
+
# iam_database_authentication_enabled: false,
|
|
3992
|
+
# master_username: "admin",
|
|
3993
|
+
# multi_az: false,
|
|
3994
|
+
# port: 5432,
|
|
3995
|
+
# preferred_backup_window: "09:56-10:26",
|
|
3996
|
+
# preferred_maintenance_window: "wed:03:33-wed:04:03",
|
|
3997
|
+
# read_replica_identifiers: [
|
|
3998
|
+
# ],
|
|
3999
|
+
# reader_endpoint: "sample-cluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
|
|
4000
|
+
# status: "creating",
|
|
4001
|
+
# storage_encrypted: false,
|
|
4002
|
+
# vpc_security_groups: [
|
|
4003
|
+
# ],
|
|
4004
|
+
# },
|
|
4005
|
+
# }
|
|
4006
|
+
#
|
|
3924
4007
|
# @example Request syntax with placeholder values
|
|
3925
4008
|
#
|
|
3926
4009
|
# resp = client.create_db_cluster({
|
|
@@ -4013,6 +4096,12 @@ module Aws::RDS
|
|
|
4013
4096
|
# ],
|
|
4014
4097
|
# master_user_authentication_type: "password", # accepts password, iam-db-auth
|
|
4015
4098
|
# with_express_configuration: false,
|
|
4099
|
+
# associated_roles: [
|
|
4100
|
+
# {
|
|
4101
|
+
# role_arn: "IAMRoleArn", # required
|
|
4102
|
+
# feature_name: "String",
|
|
4103
|
+
# },
|
|
4104
|
+
# ],
|
|
4016
4105
|
# source_region: "String",
|
|
4017
4106
|
# })
|
|
4018
4107
|
#
|
|
@@ -5901,7 +5990,7 @@ module Aws::RDS
|
|
|
5901
5990
|
# enabled.
|
|
5902
5991
|
#
|
|
5903
5992
|
# @option params [String] :engine_lifecycle_support
|
|
5904
|
-
# The
|
|
5993
|
+
# The lifecycle type for this DB instance.
|
|
5905
5994
|
#
|
|
5906
5995
|
# <note markdown="1"> By default, this value is set to `open-source-rds-extended-support`,
|
|
5907
5996
|
# which enrolls your DB instance into Amazon RDS Extended Support. At
|
|
@@ -5914,8 +6003,8 @@ module Aws::RDS
|
|
|
5914
6003
|
# </note>
|
|
5915
6004
|
#
|
|
5916
6005
|
# This setting applies only to RDS for MySQL and RDS for PostgreSQL. For
|
|
5917
|
-
# Amazon Aurora DB instances, the
|
|
5918
|
-
# cluster.
|
|
6006
|
+
# Amazon Aurora DB instances, the engine lifecycle support is managed by
|
|
6007
|
+
# the DB cluster.
|
|
5919
6008
|
#
|
|
5920
6009
|
# You can use this setting to enroll your DB instance into Amazon RDS
|
|
5921
6010
|
# Extended Support. With RDS Extended Support, you can run the selected
|
|
@@ -8649,7 +8738,7 @@ module Aws::RDS
|
|
|
8649
8738
|
# ^
|
|
8650
8739
|
#
|
|
8651
8740
|
# @option params [String] :engine_lifecycle_support
|
|
8652
|
-
# The
|
|
8741
|
+
# The lifecycle type for this global database cluster.
|
|
8653
8742
|
#
|
|
8654
8743
|
# <note markdown="1"> By default, this value is set to `open-source-rds-extended-support`,
|
|
8655
8744
|
# which enrolls your global cluster into Amazon RDS Extended Support. At
|
|
@@ -20671,6 +20760,31 @@ module Aws::RDS
|
|
|
20671
20760
|
# This option is only valid for RDS for PostgreSQL and Aurora PostgreSQL
|
|
20672
20761
|
# engines.
|
|
20673
20762
|
#
|
|
20763
|
+
# @option params [String] :engine_lifecycle_support
|
|
20764
|
+
# The lifecycle type for this DB cluster.
|
|
20765
|
+
#
|
|
20766
|
+
# You can use this setting to enroll your DB cluster into Amazon RDS
|
|
20767
|
+
# Extended Support or to opt out. With RDS Extended Support, you can run
|
|
20768
|
+
# the selected major engine version on your DB cluster past the end of
|
|
20769
|
+
# standard support for that engine version. For more information, see
|
|
20770
|
+
# the following sections:
|
|
20771
|
+
#
|
|
20772
|
+
# * Amazon Aurora - [Amazon RDS Extended Support with Amazon Aurora][1]
|
|
20773
|
+
# in the *Amazon Aurora User Guide*
|
|
20774
|
+
#
|
|
20775
|
+
# * Amazon RDS - [Amazon RDS Extended Support with Amazon RDS][2] in the
|
|
20776
|
+
# *Amazon RDS User Guide*
|
|
20777
|
+
#
|
|
20778
|
+
# Valid for Cluster Type: Aurora DB clusters and Multi-AZ DB clusters
|
|
20779
|
+
#
|
|
20780
|
+
# Valid Values: `open-source-rds-extended-support |
|
|
20781
|
+
# open-source-rds-extended-support-disabled`
|
|
20782
|
+
#
|
|
20783
|
+
#
|
|
20784
|
+
#
|
|
20785
|
+
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/extended-support.html
|
|
20786
|
+
# [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/extended-support.html
|
|
20787
|
+
#
|
|
20674
20788
|
# @return [Types::ModifyDBClusterResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
20675
20789
|
#
|
|
20676
20790
|
# * {Types::ModifyDBClusterResult#db_cluster #db_cluster} => Types::DBCluster
|
|
@@ -20814,6 +20928,7 @@ module Aws::RDS
|
|
|
20814
20928
|
# enable_limitless_database: false,
|
|
20815
20929
|
# ca_certificate_identifier: "String",
|
|
20816
20930
|
# master_user_authentication_type: "password", # accepts password, iam-db-auth
|
|
20931
|
+
# engine_lifecycle_support: "String",
|
|
20817
20932
|
# })
|
|
20818
20933
|
#
|
|
20819
20934
|
# @example Response structure
|
|
@@ -22503,6 +22618,29 @@ module Aws::RDS
|
|
|
22503
22618
|
# This option is only valid for RDS for PostgreSQL and Aurora PostgreSQL
|
|
22504
22619
|
# engines.
|
|
22505
22620
|
#
|
|
22621
|
+
# @option params [String] :engine_lifecycle_support
|
|
22622
|
+
# The lifecycle type for this DB instance.
|
|
22623
|
+
#
|
|
22624
|
+
# This setting applies only to RDS for MySQL and RDS for PostgreSQL. For
|
|
22625
|
+
# Amazon Aurora DB instances, the engine lifecycle support is managed by
|
|
22626
|
+
# the DB cluster.
|
|
22627
|
+
#
|
|
22628
|
+
# You can use this setting to enroll your DB instance into Amazon RDS
|
|
22629
|
+
# Extended Support or to opt out. With RDS Extended Support, you can run
|
|
22630
|
+
# the selected major engine version on your DB instance past the end of
|
|
22631
|
+
# standard support for that engine version. For more information, see
|
|
22632
|
+
# [Amazon RDS Extended Support with Amazon RDS][1] in the *Amazon RDS
|
|
22633
|
+
# User Guide*.
|
|
22634
|
+
#
|
|
22635
|
+
# Valid Values: `open-source-rds-extended-support |
|
|
22636
|
+
# open-source-rds-extended-support-disabled`
|
|
22637
|
+
#
|
|
22638
|
+
# This setting doesn't apply to RDS Custom DB instances.
|
|
22639
|
+
#
|
|
22640
|
+
#
|
|
22641
|
+
#
|
|
22642
|
+
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/extended-support.html
|
|
22643
|
+
#
|
|
22506
22644
|
# @return [Types::ModifyDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
22507
22645
|
#
|
|
22508
22646
|
# * {Types::ModifyDBInstanceResult#db_instance #db_instance} => Types::DBInstance
|
|
@@ -22653,6 +22791,7 @@ module Aws::RDS
|
|
|
22653
22791
|
# },
|
|
22654
22792
|
# ],
|
|
22655
22793
|
# master_user_authentication_type: "password", # accepts password, iam-db-auth
|
|
22794
|
+
# engine_lifecycle_support: "String",
|
|
22656
22795
|
# })
|
|
22657
22796
|
#
|
|
22658
22797
|
# @example Response structure
|
|
@@ -25858,7 +25997,7 @@ module Aws::RDS
|
|
|
25858
25997
|
#
|
|
25859
25998
|
# resp = client.remove_role_from_db_cluster({
|
|
25860
25999
|
# db_cluster_identifier: "String", # required
|
|
25861
|
-
# role_arn: "
|
|
26000
|
+
# role_arn: "IAMRoleArn", # required
|
|
25862
26001
|
# feature_name: "String",
|
|
25863
26002
|
# })
|
|
25864
26003
|
#
|
|
@@ -26257,6 +26396,10 @@ module Aws::RDS
|
|
|
26257
26396
|
#
|
|
26258
26397
|
# </note>
|
|
26259
26398
|
#
|
|
26399
|
+
# You can use the `AssociatedRoles` parameter to associate one or more
|
|
26400
|
+
# Amazon Web Services Identity and Access Management (IAM) roles with
|
|
26401
|
+
# the Aurora DB cluster when you restore it from Amazon S3.
|
|
26402
|
+
#
|
|
26260
26403
|
#
|
|
26261
26404
|
#
|
|
26262
26405
|
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Migrating.ExtMySQL.html#AuroraMySQL.Migrating.ExtMySQL.S3
|
|
@@ -26645,7 +26788,7 @@ module Aws::RDS
|
|
|
26645
26788
|
# Amazon Web Services Region.
|
|
26646
26789
|
#
|
|
26647
26790
|
# @option params [String] :engine_lifecycle_support
|
|
26648
|
-
# The
|
|
26791
|
+
# The lifecycle type for this DB cluster.
|
|
26649
26792
|
#
|
|
26650
26793
|
# <note markdown="1"> By default, this value is set to `open-source-rds-extended-support`,
|
|
26651
26794
|
# which enrolls your DB cluster into Amazon RDS Extended Support. At the
|
|
@@ -26690,6 +26833,14 @@ module Aws::RDS
|
|
|
26690
26833
|
#
|
|
26691
26834
|
# ^
|
|
26692
26835
|
#
|
|
26836
|
+
# @option params [Array<Types::DBClusterAssociatedRole>] :associated_roles
|
|
26837
|
+
# A list of Amazon Web Services Identity and Access Management (IAM)
|
|
26838
|
+
# roles to associate with the DB cluster when it's restored from Amazon
|
|
26839
|
+
# S3. Each role grants the DB cluster permission to access other Amazon
|
|
26840
|
+
# Web Services on your behalf. For each role, specify a role ARN and,
|
|
26841
|
+
# optionally, the feature name (such as `s3Import`, `s3Export`, or
|
|
26842
|
+
# `Lambda`).
|
|
26843
|
+
#
|
|
26693
26844
|
# @return [Types::RestoreDBClusterFromS3Result] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
26694
26845
|
#
|
|
26695
26846
|
# * {Types::RestoreDBClusterFromS3Result#db_cluster #db_cluster} => Types::DBCluster
|
|
@@ -26823,6 +26974,12 @@ module Aws::RDS
|
|
|
26823
26974
|
# ],
|
|
26824
26975
|
# },
|
|
26825
26976
|
# ],
|
|
26977
|
+
# associated_roles: [
|
|
26978
|
+
# {
|
|
26979
|
+
# role_arn: "IAMRoleArn", # required
|
|
26980
|
+
# feature_name: "String",
|
|
26981
|
+
# },
|
|
26982
|
+
# ],
|
|
26826
26983
|
# })
|
|
26827
26984
|
#
|
|
26828
26985
|
# @example Response structure
|
|
@@ -27001,6 +27158,10 @@ module Aws::RDS
|
|
|
27001
27158
|
# need to modify the DB cluster to update `MasterUserAuthenticationType`
|
|
27002
27159
|
# to `iam-db-auth`.
|
|
27003
27160
|
#
|
|
27161
|
+
# You can use the `AssociatedRoles` parameter to associate one or more
|
|
27162
|
+
# Amazon Web Services Identity and Access Management (IAM) roles with an
|
|
27163
|
+
# Aurora DB cluster when you restore it from a snapshot.
|
|
27164
|
+
#
|
|
27004
27165
|
# <note markdown="1"> This operation only restores the DB cluster, not the DB instances for
|
|
27005
27166
|
# that DB cluster. You must invoke the `CreateDBInstance` operation to
|
|
27006
27167
|
# create DB instances for the restored DB cluster, specifying the
|
|
@@ -27541,7 +27702,7 @@ module Aws::RDS
|
|
|
27541
27702
|
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Managing.Backups.html#Aurora.Managing.Backups.BackupWindow
|
|
27542
27703
|
#
|
|
27543
27704
|
# @option params [String] :engine_lifecycle_support
|
|
27544
|
-
# The
|
|
27705
|
+
# The lifecycle type for this DB cluster.
|
|
27545
27706
|
#
|
|
27546
27707
|
# <note markdown="1"> By default, this value is set to `open-source-rds-extended-support`,
|
|
27547
27708
|
# which enrolls your DB cluster into Amazon RDS Extended Support. At the
|
|
@@ -27610,6 +27771,16 @@ module Aws::RDS
|
|
|
27610
27771
|
#
|
|
27611
27772
|
# Valid for Cluster Type: Aurora PostgreSQL clusters
|
|
27612
27773
|
#
|
|
27774
|
+
# @option params [Array<Types::DBClusterAssociatedRole>] :associated_roles
|
|
27775
|
+
# A list of Amazon Web Services Identity and Access Management (IAM)
|
|
27776
|
+
# roles to associate with the DB cluster when it's restored from a
|
|
27777
|
+
# snapshot. Each role grants the DB cluster permission to access other
|
|
27778
|
+
# Amazon Web Services on your behalf. For each role, specify a role ARN
|
|
27779
|
+
# and, optionally, the feature name (such as `s3Import`, `s3Export`, or
|
|
27780
|
+
# `Lambda`).
|
|
27781
|
+
#
|
|
27782
|
+
# Valid for Cluster Type: Aurora DB clusters only
|
|
27783
|
+
#
|
|
27613
27784
|
# @return [Types::RestoreDBClusterFromSnapshotResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
27614
27785
|
#
|
|
27615
27786
|
# * {Types::RestoreDBClusterFromSnapshotResult#db_cluster #db_cluster} => Types::DBCluster
|
|
@@ -27740,6 +27911,65 @@ module Aws::RDS
|
|
|
27740
27911
|
# },
|
|
27741
27912
|
# }
|
|
27742
27913
|
#
|
|
27914
|
+
# @example Example: To restore a DB cluster from a snapshot with an associated IAM role
|
|
27915
|
+
#
|
|
27916
|
+
# # The following example restores an Aurora PostgreSQL DB cluster from a snapshot and associates an IAM role for Amazon S3
|
|
27917
|
+
# # import in a single call.
|
|
27918
|
+
#
|
|
27919
|
+
# resp = client.restore_db_cluster_from_snapshot({
|
|
27920
|
+
# associated_roles: [
|
|
27921
|
+
# {
|
|
27922
|
+
# feature_name: "s3Import",
|
|
27923
|
+
# role_arn: "arn:aws:iam::123456789012:role/RDSLoadFromS3",
|
|
27924
|
+
# },
|
|
27925
|
+
# ],
|
|
27926
|
+
# db_cluster_identifier: "restored-cluster",
|
|
27927
|
+
# engine: "aurora-postgresql",
|
|
27928
|
+
# snapshot_identifier: "test-instance-snapshot",
|
|
27929
|
+
# })
|
|
27930
|
+
#
|
|
27931
|
+
# resp.to_h outputs the following:
|
|
27932
|
+
# {
|
|
27933
|
+
# db_cluster: {
|
|
27934
|
+
# associated_roles: [
|
|
27935
|
+
# {
|
|
27936
|
+
# feature_name: "s3Import",
|
|
27937
|
+
# role_arn: "arn:aws:iam::123456789012:role/RDSLoadFromS3",
|
|
27938
|
+
# status: "ACTIVE",
|
|
27939
|
+
# },
|
|
27940
|
+
# ],
|
|
27941
|
+
# cluster_create_time: Time.parse("2024-06-05T15:06:58.634Z"),
|
|
27942
|
+
# copy_tags_to_snapshot: false,
|
|
27943
|
+
# cross_account_clone: false,
|
|
27944
|
+
# db_cluster_arn: "arn:aws:rds:us-west-2:123456789012:cluster:restored-cluster",
|
|
27945
|
+
# db_cluster_identifier: "restored-cluster",
|
|
27946
|
+
# db_cluster_members: [
|
|
27947
|
+
# ],
|
|
27948
|
+
# db_cluster_parameter_group: "default.aurora-postgresql17",
|
|
27949
|
+
# database_name: "",
|
|
27950
|
+
# db_cluster_resource_id: "cluster-5DSB5IFQDDUVAWOUWM1EXAMPLE",
|
|
27951
|
+
# deletion_protection: false,
|
|
27952
|
+
# domain_memberships: [
|
|
27953
|
+
# ],
|
|
27954
|
+
# engine: "aurora-postgresql",
|
|
27955
|
+
# engine_mode: "provisioned",
|
|
27956
|
+
# engine_version: "17.7",
|
|
27957
|
+
# http_endpoint_enabled: false,
|
|
27958
|
+
# iam_database_authentication_enabled: true,
|
|
27959
|
+
# master_username: "postgres",
|
|
27960
|
+
# multi_az: false,
|
|
27961
|
+
# port: 5432,
|
|
27962
|
+
# preferred_backup_window: "09:33-10:03",
|
|
27963
|
+
# preferred_maintenance_window: "sun:12:22-sun:12:52",
|
|
27964
|
+
# read_replica_identifiers: [
|
|
27965
|
+
# ],
|
|
27966
|
+
# status: "creating",
|
|
27967
|
+
# storage_encrypted: false,
|
|
27968
|
+
# vpc_security_groups: [
|
|
27969
|
+
# ],
|
|
27970
|
+
# },
|
|
27971
|
+
# }
|
|
27972
|
+
#
|
|
27743
27973
|
# @example Request syntax with placeholder values
|
|
27744
27974
|
#
|
|
27745
27975
|
# resp = client.restore_db_cluster_from_snapshot({
|
|
@@ -27813,6 +28043,12 @@ module Aws::RDS
|
|
|
27813
28043
|
# ],
|
|
27814
28044
|
# enable_vpc_networking: false,
|
|
27815
28045
|
# enable_internet_access_gateway: false,
|
|
28046
|
+
# associated_roles: [
|
|
28047
|
+
# {
|
|
28048
|
+
# role_arn: "IAMRoleArn", # required
|
|
28049
|
+
# feature_name: "String",
|
|
28050
|
+
# },
|
|
28051
|
+
# ],
|
|
27816
28052
|
# })
|
|
27817
28053
|
#
|
|
27818
28054
|
# @example Response structure
|
|
@@ -27995,6 +28231,10 @@ module Aws::RDS
|
|
|
27995
28231
|
# need to modify the DB cluster to update `MasterUserAuthenticationType`
|
|
27996
28232
|
# to `iam-db-auth`.
|
|
27997
28233
|
#
|
|
28234
|
+
# You can use the `AssociatedRoles` parameter to associate one or more
|
|
28235
|
+
# Amazon Web Services Identity and Access Management (IAM) roles with an
|
|
28236
|
+
# Aurora DB cluster when you restore it to a point in time.
|
|
28237
|
+
#
|
|
27998
28238
|
# <note markdown="1"> For Aurora, this operation only restores the DB cluster, not the DB
|
|
27999
28239
|
# instances for that DB cluster. You must invoke the `CreateDBInstance`
|
|
28000
28240
|
# operation to create DB instances for the restored DB cluster,
|
|
@@ -28515,7 +28755,7 @@ module Aws::RDS
|
|
|
28515
28755
|
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Managing.Backups.html#Aurora.Managing.Backups.BackupWindow
|
|
28516
28756
|
#
|
|
28517
28757
|
# @option params [String] :engine_lifecycle_support
|
|
28518
|
-
# The
|
|
28758
|
+
# The lifecycle type for this DB cluster.
|
|
28519
28759
|
#
|
|
28520
28760
|
# <note markdown="1"> By default, this value is set to `open-source-rds-extended-support`,
|
|
28521
28761
|
# which enrolls your DB cluster into Amazon RDS Extended Support. At the
|
|
@@ -28584,6 +28824,16 @@ module Aws::RDS
|
|
|
28584
28824
|
#
|
|
28585
28825
|
# Valid for Cluster Type: Aurora PostgreSQL clusters
|
|
28586
28826
|
#
|
|
28827
|
+
# @option params [Array<Types::DBClusterAssociatedRole>] :associated_roles
|
|
28828
|
+
# A list of Amazon Web Services Identity and Access Management (IAM)
|
|
28829
|
+
# roles to associate with the DB cluster when it's restored to a point
|
|
28830
|
+
# in time. Each role grants the DB cluster permission to access other
|
|
28831
|
+
# Amazon Web Services on your behalf. For each role, specify a role ARN
|
|
28832
|
+
# and, optionally, the feature name (such as `s3Import`, `s3Export`, or
|
|
28833
|
+
# `Lambda`).
|
|
28834
|
+
#
|
|
28835
|
+
# Valid for Cluster Type: Aurora DB clusters only
|
|
28836
|
+
#
|
|
28587
28837
|
# @return [Types::RestoreDBClusterToPointInTimeResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
28588
28838
|
#
|
|
28589
28839
|
# * {Types::RestoreDBClusterToPointInTimeResult#db_cluster #db_cluster} => Types::DBCluster
|
|
@@ -28785,6 +29035,12 @@ module Aws::RDS
|
|
|
28785
29035
|
# ],
|
|
28786
29036
|
# enable_vpc_networking: false,
|
|
28787
29037
|
# enable_internet_access_gateway: false,
|
|
29038
|
+
# associated_roles: [
|
|
29039
|
+
# {
|
|
29040
|
+
# role_arn: "IAMRoleArn", # required
|
|
29041
|
+
# feature_name: "String",
|
|
29042
|
+
# },
|
|
29043
|
+
# ],
|
|
28788
29044
|
# })
|
|
28789
29045
|
#
|
|
28790
29046
|
# @example Response structure
|
|
@@ -29597,7 +29853,7 @@ module Aws::RDS
|
|
|
29597
29853
|
# [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL.html
|
|
29598
29854
|
#
|
|
29599
29855
|
# @option params [String] :engine_lifecycle_support
|
|
29600
|
-
# The
|
|
29856
|
+
# The lifecycle type for this DB instance.
|
|
29601
29857
|
#
|
|
29602
29858
|
# <note markdown="1"> By default, this value is set to `open-source-rds-extended-support`,
|
|
29603
29859
|
# which enrolls your DB instance into Amazon RDS Extended Support. At
|
|
@@ -29617,8 +29873,8 @@ module Aws::RDS
|
|
|
29617
29873
|
# Extended Support with Amazon RDS][1] in the *Amazon RDS User Guide*.
|
|
29618
29874
|
#
|
|
29619
29875
|
# This setting applies only to RDS for MySQL and RDS for PostgreSQL. For
|
|
29620
|
-
# Amazon Aurora DB instances, the
|
|
29621
|
-
# cluster.
|
|
29876
|
+
# Amazon Aurora DB instances, the engine lifecycle support is managed by
|
|
29877
|
+
# the DB cluster.
|
|
29622
29878
|
#
|
|
29623
29879
|
# Valid Values: `open-source-rds-extended-support |
|
|
29624
29880
|
# open-source-rds-extended-support-disabled`
|
|
@@ -30542,7 +30798,7 @@ module Aws::RDS
|
|
|
30542
30798
|
# [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL.html
|
|
30543
30799
|
#
|
|
30544
30800
|
# @option params [String] :engine_lifecycle_support
|
|
30545
|
-
# The
|
|
30801
|
+
# The lifecycle type for this DB instance.
|
|
30546
30802
|
#
|
|
30547
30803
|
# <note markdown="1"> By default, this value is set to `open-source-rds-extended-support`,
|
|
30548
30804
|
# which enrolls your DB instance into Amazon RDS Extended Support. At
|
|
@@ -30562,8 +30818,8 @@ module Aws::RDS
|
|
|
30562
30818
|
# Extended Support Amazon RDS][1] in the *Amazon RDS User Guide*.
|
|
30563
30819
|
#
|
|
30564
30820
|
# This setting applies only to RDS for MySQL and RDS for PostgreSQL. For
|
|
30565
|
-
# Amazon Aurora DB instances, the
|
|
30566
|
-
# cluster.
|
|
30821
|
+
# Amazon Aurora DB instances, the engine lifecycle support is managed by
|
|
30822
|
+
# the DB cluster.
|
|
30567
30823
|
#
|
|
30568
30824
|
# Valid Values: `open-source-rds-extended-support |
|
|
30569
30825
|
# open-source-rds-extended-support-disabled`
|
|
@@ -31530,7 +31786,7 @@ module Aws::RDS
|
|
|
31530
31786
|
# [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL.html
|
|
31531
31787
|
#
|
|
31532
31788
|
# @option params [String] :engine_lifecycle_support
|
|
31533
|
-
# The
|
|
31789
|
+
# The lifecycle type for this DB instance.
|
|
31534
31790
|
#
|
|
31535
31791
|
# <note markdown="1"> By default, this value is set to `open-source-rds-extended-support`,
|
|
31536
31792
|
# which enrolls your DB instance into Amazon RDS Extended Support. At
|
|
@@ -31550,8 +31806,8 @@ module Aws::RDS
|
|
|
31550
31806
|
# Extended Support with Amazon RDS][1] in the *Amazon RDS User Guide*.
|
|
31551
31807
|
#
|
|
31552
31808
|
# This setting applies only to RDS for MySQL and RDS for PostgreSQL. For
|
|
31553
|
-
# Amazon Aurora DB instances, the
|
|
31554
|
-
# cluster.
|
|
31809
|
+
# Amazon Aurora DB instances, the engine lifecycle support is managed by
|
|
31810
|
+
# the DB cluster.
|
|
31555
31811
|
#
|
|
31556
31812
|
# Valid Values: `open-source-rds-extended-support |
|
|
31557
31813
|
# open-source-rds-extended-support-disabled`
|
|
@@ -34187,7 +34443,7 @@ module Aws::RDS
|
|
|
34187
34443
|
tracer: tracer
|
|
34188
34444
|
)
|
|
34189
34445
|
context[:gem_name] = 'aws-sdk-rds'
|
|
34190
|
-
context[:gem_version] = '1.
|
|
34446
|
+
context[:gem_version] = '1.319.0'
|
|
34191
34447
|
Seahorse::Client::Request.new(handlers, context)
|
|
34192
34448
|
end
|
|
34193
34449
|
|