aws-sdk-rds 1.0.0.rc1 → 1.0.0.rc2

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.
@@ -669,6 +669,7 @@ module Aws
669
669
  DBCluster.add_member(:earliest_restorable_time, Shapes::ShapeRef.new(shape: TStamp, location_name: "EarliestRestorableTime"))
670
670
  DBCluster.add_member(:endpoint, Shapes::ShapeRef.new(shape: String, location_name: "Endpoint"))
671
671
  DBCluster.add_member(:reader_endpoint, Shapes::ShapeRef.new(shape: String, location_name: "ReaderEndpoint"))
672
+ DBCluster.add_member(:multi_az, Shapes::ShapeRef.new(shape: Boolean, location_name: "MultiAZ"))
672
673
  DBCluster.add_member(:engine, Shapes::ShapeRef.new(shape: String, location_name: "Engine"))
673
674
  DBCluster.add_member(:engine_version, Shapes::ShapeRef.new(shape: String, location_name: "EngineVersion"))
674
675
  DBCluster.add_member(:latest_restorable_time, Shapes::ShapeRef.new(shape: TStamp, location_name: "LatestRestorableTime"))
@@ -687,6 +688,7 @@ module Aws
687
688
  DBCluster.add_member(:db_cluster_resource_id, Shapes::ShapeRef.new(shape: String, location_name: "DbClusterResourceId"))
688
689
  DBCluster.add_member(:db_cluster_arn, Shapes::ShapeRef.new(shape: String, location_name: "DBClusterArn"))
689
690
  DBCluster.add_member(:associated_roles, Shapes::ShapeRef.new(shape: DBClusterRoles, location_name: "AssociatedRoles"))
691
+ DBCluster.add_member(:cluster_create_time, Shapes::ShapeRef.new(shape: TStamp, location_name: "ClusterCreateTime"))
690
692
  DBCluster.struct_class = Types::DBCluster
691
693
 
692
694
  DBClusterList.member = Shapes::ShapeRef.new(shape: DBCluster, location_name: "DBCluster")
@@ -1939,6 +1941,7 @@ module Aws
1939
1941
  o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
1940
1942
  o.errors << Shapes::ShapeRef.new(shape: DBInstanceNotFoundFault)
1941
1943
  o.errors << Shapes::ShapeRef.new(shape: DBSnapshotNotFoundFault)
1944
+ o.errors << Shapes::ShapeRef.new(shape: DBClusterNotFoundFault)
1942
1945
  end)
1943
1946
 
1944
1947
  api.add_operation(:apply_pending_maintenance_action, Seahorse::Model::Operation.new.tap do |o|
@@ -2037,6 +2040,7 @@ module Aws
2037
2040
  o.errors << Shapes::ShapeRef.new(shape: InvalidDBClusterStateFault)
2038
2041
  o.errors << Shapes::ShapeRef.new(shape: InvalidDBSubnetGroupStateFault)
2039
2042
  o.errors << Shapes::ShapeRef.new(shape: InvalidSubnet)
2043
+ o.errors << Shapes::ShapeRef.new(shape: InvalidDBInstanceStateFault)
2040
2044
  o.errors << Shapes::ShapeRef.new(shape: DBClusterParameterGroupNotFoundFault)
2041
2045
  o.errors << Shapes::ShapeRef.new(shape: KMSKeyNotAccessibleFault)
2042
2046
  o.errors << Shapes::ShapeRef.new(shape: DBClusterNotFoundFault)
@@ -2670,6 +2674,7 @@ module Aws
2670
2674
  o.output = Shapes::ShapeRef.new(shape: TagListMessage)
2671
2675
  o.errors << Shapes::ShapeRef.new(shape: DBInstanceNotFoundFault)
2672
2676
  o.errors << Shapes::ShapeRef.new(shape: DBSnapshotNotFoundFault)
2677
+ o.errors << Shapes::ShapeRef.new(shape: DBClusterNotFoundFault)
2673
2678
  end)
2674
2679
 
2675
2680
  api.add_operation(:modify_db_cluster, Seahorse::Model::Operation.new.tap do |o|
@@ -2864,6 +2869,7 @@ module Aws
2864
2869
  o.output = Shapes::ShapeRef.new(shape: Shapes::StructureShape.new(struct_class: Aws::EmptyStructure))
2865
2870
  o.errors << Shapes::ShapeRef.new(shape: DBInstanceNotFoundFault)
2866
2871
  o.errors << Shapes::ShapeRef.new(shape: DBSnapshotNotFoundFault)
2872
+ o.errors << Shapes::ShapeRef.new(shape: DBClusterNotFoundFault)
2867
2873
  end)
2868
2874
 
2869
2875
  api.add_operation(:reset_db_cluster_parameter_group, Seahorse::Model::Operation.new.tap do |o|
@@ -125,6 +125,13 @@ module Aws
125
125
  data.reader_endpoint
126
126
  end
127
127
 
128
+ # Specifies whether the DB cluster has instances in multiple
129
+ # Availability Zones.
130
+ # @return [Boolean]
131
+ def multi_az
132
+ data.multi_az
133
+ end
134
+
128
135
  # Provides the name of the database engine to be used for this DB
129
136
  # cluster.
130
137
  # @return [String]
@@ -247,6 +254,13 @@ module Aws
247
254
  data.associated_roles
248
255
  end
249
256
 
257
+ # Specifies the time when the DB cluster was created, in Universal
258
+ # Coordinated Time (UTC).
259
+ # @return [Time]
260
+ def cluster_create_time
261
+ data.cluster_create_time
262
+ end
263
+
250
264
  # @!endgroup
251
265
 
252
266
  # @return [Client]
@@ -825,25 +825,77 @@ module Aws
825
825
  #
826
826
  # * **Version 5.6 (available in these AWS regions: ap-northeast-1,
827
827
  # ap-northeast-2, ap-south-1, ap-southeast-2, eu-west-1, us-east-1,
828
- # us-west-2):** ` 5.6.10a`
828
+ # us-east-2, us-west-2):** ` 5.6.10a`
829
829
  #
830
830
  # ^
831
831
  #
832
832
  # **MariaDB**
833
833
  #
834
+ # * **Version 10.1 (available in these AWS regions: us-east-2):** `
835
+ # 10.1.16`
836
+ #
834
837
  # * **Version 10.1 (available in these AWS regions: ap-northeast-1,
835
838
  # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
836
839
  # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
837
840
  # us-west-2):** ` 10.1.14`
838
841
  #
839
- # * **Version 10.0 (available in all AWS regions):** ` 10.0.17 |
840
- # 10.0.24`
842
+ # * **Version 10.0 (available in all AWS regions):** ` 10.0.24`
843
+ #
844
+ # * **Version 10.0 (available in these AWS regions: ap-northeast-1,
845
+ # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
846
+ # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-gov-west-1,
847
+ # us-west-1, us-west-2):** ` 10.0.17`
848
+ #
849
+ # **Microsoft SQL Server 2016**
850
+ #
851
+ # * `13.00.2164.0.v1` (supported for all editions, and all AWS regions
852
+ # except sa-east-1)
853
+ #
854
+ # ^
855
+ #
856
+ # **Microsoft SQL Server 2014**
857
+ #
858
+ # * `12.00.5000.0.v1` (supported for all editions, and all AWS regions)
859
+ #
860
+ # * `12.00.4422.0.v1` (supported for all editions except Enterprise
861
+ # Edition, and all AWS regions except us-east-2)
862
+ #
863
+ # **Microsoft SQL Server 2012**
864
+ #
865
+ # * `11.00.6020.0.v1` (supported for all editions, and all AWS regions)
866
+ #
867
+ # * `11.00.5058.0.v1` (supported for all editions, and all AWS regions
868
+ # except us-east-2)
869
+ #
870
+ # * `11.00.2100.60.v1` (supported for all editions, and all AWS regions
871
+ # except us-east-2)
872
+ #
873
+ # **Microsoft SQL Server 2008 R2**
874
+ #
875
+ # * `10.50.6529.0.v1` (supported for all editions, and all AWS regions
876
+ # except us-east-2)
877
+ #
878
+ # * `10.50.6000.34.v1` (supported for all editions, and all AWS regions
879
+ # except us-east-2)
880
+ #
881
+ # * `10.50.2789.0.v1` (supported for all editions, and all AWS regions
882
+ # except us-east-2)
841
883
  #
842
884
  # **MySQL**
843
885
  #
844
- # * **Version 5.7 (available in all AWS regions):** ` 5.7.10 | 5.7.11`
886
+ # * **Version 5.7 (available in all AWS regions):** ` 5.7.11`
845
887
  #
846
- # * **Version 5.6 (available in all AWS regions):** ` 5.6.27 | 5.6.29`
888
+ # * **Version 5.7 (available in these AWS regions: ap-northeast-1,
889
+ # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
890
+ # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-gov-west-1,
891
+ # us-west-1, us-west-2):** ` 5.7.10`
892
+ #
893
+ # * **Version 5.6 (available in all AWS regions):** ` 5.6.29`
894
+ #
895
+ # * **Version 5.6 (available in these AWS regions: ap-northeast-1,
896
+ # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
897
+ # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-gov-west-1,
898
+ # us-west-1, us-west-2):** ` 5.6.27`
847
899
  #
848
900
  # * **Version 5.6 (available in these AWS regions: ap-northeast-1,
849
901
  # ap-northeast-2, ap-southeast-1, ap-southeast-2, eu-central-1,
@@ -871,114 +923,96 @@ module Aws
871
923
  # ap-southeast-1, ap-southeast-2, eu-west-1, sa-east-1, us-east-1,
872
924
  # us-gov-west-1, us-west-1, us-west-2):** ` 5.5.40 | 5.5.40a`
873
925
  #
874
- # **Oracle Database Enterprise Edition (oracle-ee)**
875
926
  #
876
- # * **Version 12.1.0.2 (available in these AWS regions: ap-northeast-1,
877
- # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
878
- # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
879
- # us-west-2):** ` 12.1.0.2.v5`
880
927
  #
881
- # * **Version 12.1.0.2 (available in all AWS regions):** ` 12.1.0.2.v1 |
882
- # 12.1.0.2.v2 | 12.1.0.2.v3 | 12.1.0.2.v4`
928
+ # **Oracle 12c**
883
929
  #
884
- # * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
885
- # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
886
- # us-east-1, us-west-1, us-west-2):** ` 12.1.0.1.v6`
930
+ # * `12.1.0.2.v5` (supported for EE in all AWS regions, and SE2 in all
931
+ # AWS regions except us-gov-west-1)
887
932
  #
888
- # * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
889
- # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
890
- # us-east-1, us-gov-west-1, us-west-1, us-west-2):** ` 12.1.0.1.v3 |
891
- # 12.1.0.1.v4 | 12.1.0.1.v5`
933
+ # * `12.1.0.2.v4` (supported for EE in all AWS regions, and SE2 in all
934
+ # AWS regions except us-gov-west-1)
892
935
  #
893
- # * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
894
- # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
895
- # us-east-1, us-gov-west-1, us-gov-west-1, us-west-1, us-west-2):** `
896
- # 12.1.0.1.v1 | 12.1.0.1.v2`
936
+ # * `12.1.0.2.v3` (supported for EE in all AWS regions, and SE2 in all
937
+ # AWS regions except us-gov-west-1)
897
938
  #
898
- # * **Version 11.2.0.4 (available in these AWS regions: ap-northeast-1,
899
- # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
900
- # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
901
- # us-west-2):** ` 11.2.0.4.v6 | 11.2.0.4.v9`
939
+ # * `12.1.0.2.v2` (supported for EE in all AWS regions, and SE2 in all
940
+ # AWS regions except us-gov-west-1)
902
941
  #
903
- # * **Version 11.2.0.4 (available in all AWS regions):** ` 11.2.0.4.v1 |
904
- # 11.2.0.4.v3 | 11.2.0.4.v4 | 11.2.0.4.v5 | 11.2.0.4.v7 | 11.2.0.4.v8`
942
+ # * `12.1.0.2.v1` (supported for EE in all AWS regions, and SE2 in all
943
+ # AWS regions except us-gov-west-1)
905
944
  #
906
- # **Oracle Database Standard Edition Two (oracle-se2)**
907
945
  #
908
- # * **Version 12.1.0.2 (available in these AWS regions: ap-northeast-1,
909
- # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
910
- # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
911
- # us-west-2):** ` 12.1.0.2.v5`
912
946
  #
913
- # * **Version 12.1.0.2 (available in all AWS regions):** ` 12.1.0.2.v2 |
914
- # 12.1.0.2.v3 | 12.1.0.2.v4`
947
+ # * `12.1.0.1.v6` (supported for EE, SE1, and SE, in all AWS regions
948
+ # except ap-south-1, ap-northeast-2)
915
949
  #
916
- # **Oracle Database Standard Edition One (oracle-se1)**
950
+ # * `12.1.0.1.v5` (supported for EE, SE1, and SE, in all AWS regions
951
+ # except ap-south-1, ap-northeast-2)
917
952
  #
918
- # * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
919
- # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
920
- # us-east-1, us-west-1, us-west-2):** ` 12.1.0.1.v6`
953
+ # * `12.1.0.1.v4` (supported for EE, SE1, and SE, in all AWS regions
954
+ # except ap-south-1, ap-northeast-2)
921
955
  #
922
- # * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
923
- # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
924
- # us-east-1, us-gov-west-1, us-west-1, us-west-2):** ` 12.1.0.1.v3 |
925
- # 12.1.0.1.v4 | 12.1.0.1.v5`
956
+ # * `12.1.0.1.v3` (supported for EE, SE1, and SE, in all AWS regions
957
+ # except ap-south-1, ap-northeast-2)
926
958
  #
927
- # * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
928
- # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
929
- # us-east-1, us-gov-west-1, us-gov-west-1, us-west-1, us-west-2):** `
930
- # 12.1.0.1.v1 | 12.1.0.1.v2`
959
+ # * `12.1.0.1.v2` (supported for EE, SE1, and SE, in all AWS regions
960
+ # except ap-south-1, ap-northeast-2)
931
961
  #
932
- # * **Version 11.2.0.4 (available in these AWS regions: ap-northeast-1,
933
- # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
934
- # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
935
- # us-west-2):** ` 11.2.0.4.v6 | 11.2.0.4.v9`
962
+ # * `12.1.0.1.v1` (supported for EE, SE1, and SE, in all AWS regions
963
+ # except ap-south-1, ap-northeast-2)
936
964
  #
937
- # * **Version 11.2.0.4 (available in all AWS regions):** ` 11.2.0.4.v1 |
938
- # 11.2.0.4.v3 | 11.2.0.4.v4 | 11.2.0.4.v5 | 11.2.0.4.v7 | 11.2.0.4.v8`
965
+ # **Oracle 11g**
939
966
  #
940
- # **Oracle Database Standard Edition (oracle-se)**
967
+ # * `11.2.0.4.v9` (supported for EE, SE1, and SE, in all AWS regions)
941
968
  #
942
- # * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
943
- # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
944
- # us-east-1, us-west-1, us-west-2):** ` 12.1.0.1.v6`
969
+ # * `11.2.0.4.v8` (supported for EE, SE1, and SE, in all AWS regions)
945
970
  #
946
- # * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
947
- # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
948
- # us-east-1, us-gov-west-1, us-west-1, us-west-2):** ` 12.1.0.1.v3 |
949
- # 12.1.0.1.v4 | 12.1.0.1.v5`
971
+ # * `11.2.0.4.v7` (supported for EE, SE1, and SE, in all AWS regions)
950
972
  #
951
- # * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
952
- # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
953
- # us-east-1, us-gov-west-1, us-gov-west-1, us-west-1, us-west-2):** `
954
- # 12.1.0.1.v1 | 12.1.0.1.v2`
973
+ # * `11.2.0.4.v6` (supported for EE, SE1, and SE, in all AWS regions)
955
974
  #
956
- # * **Version 11.2.0.4 (available in these AWS regions: ap-northeast-1,
957
- # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
958
- # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
959
- # us-west-2):** ` 11.2.0.4.v6 | 11.2.0.4.v9`
975
+ # * `11.2.0.4.v5` (supported for EE, SE1, and SE, in all AWS regions)
976
+ #
977
+ # * `11.2.0.4.v4` (supported for EE, SE1, and SE, in all AWS regions)
960
978
  #
961
- # * **Version 11.2.0.4 (available in all AWS regions):** ` 11.2.0.4.v1 |
962
- # 11.2.0.4.v3 | 11.2.0.4.v4 | 11.2.0.4.v5 | 11.2.0.4.v7 | 11.2.0.4.v8`
979
+ # * `11.2.0.4.v3` (supported for EE, SE1, and SE, in all AWS regions)
980
+ #
981
+ # * `11.2.0.4.v1` (supported for EE, SE1, and SE, in all AWS regions)
963
982
  #
964
983
  # **PostgreSQL**
965
984
  #
966
985
  # * **Version 9.5 (available in these AWS regions: ap-northeast-1,
967
986
  # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
968
987
  # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
969
- # us-west-2):** ` 9.5.2 | 9.5.4`
988
+ # us-west-2):** ` 9.5.4`
989
+ #
990
+ # * **Version 9.5 (available in these AWS regions: ap-northeast-1,
991
+ # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
992
+ # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-east-2, us-west-1,
993
+ # us-west-2):** ` 9.5.2`
970
994
  #
971
995
  # * **Version 9.4 (available in these AWS regions: ap-northeast-1,
972
996
  # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
973
997
  # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
974
- # us-west-2):** ` 9.4.7 | 9.4.9`
998
+ # us-west-2):** ` 9.4.9`
999
+ #
1000
+ # * **Version 9.4 (available in these AWS regions: ap-northeast-1,
1001
+ # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
1002
+ # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-east-2, us-west-1,
1003
+ # us-west-2):** ` 9.4.7`
975
1004
  #
976
1005
  # * **Version 9.4 (available in all AWS regions):** ` 9.4.5`
977
1006
  #
978
1007
  # * **Version 9.4 (available in these AWS regions: ap-northeast-1,
979
1008
  # ap-northeast-2, ap-southeast-1, ap-southeast-2, eu-central-1,
980
1009
  # eu-west-1, sa-east-1, us-east-1, us-gov-west-1, us-west-1,
981
- # us-west-2):** ` 9.4.1 | 9.4.4`
1010
+ # us-west-2):** ` 9.4.4`
1011
+ #
1012
+ # * **Version 9.4 (available in these AWS regions: ap-northeast-1,
1013
+ # ap-northeast-2, ap-southeast-1, ap-southeast-2, eu-central-1,
1014
+ # eu-west-1, sa-east-1, us-east-1, us-east-2, us-gov-west-1,
1015
+ # us-west-1, us-west-2):** ` 9.4.1`
982
1016
  #
983
1017
  # * **Version 9.3 (available in these AWS regions: ap-northeast-1,
984
1018
  # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
@@ -992,44 +1026,6 @@ module Aws
992
1026
  # * **Version 9.3 (available in these AWS regions: ap-northeast-1,
993
1027
  # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
994
1028
  # us-east-1, us-west-1, us-west-2):** ` 9.3.12 | 9.3.14`
995
- #
996
- # **Microsoft SQL Server Enterprise Edition (sqlserver-ee)**
997
- #
998
- # * **Version 11.00 (available in all AWS regions):** ` 11.00.2100.60.v1
999
- # | 11.00.5058.0.v1 | 11.00.6020.0.v1`
1000
- #
1001
- # * **Version 10.50 (available in all AWS regions):** ` 10.50.2789.0.v1
1002
- # | 10.50.6000.34.v1 | 10.50.6529.0.v1`
1003
- #
1004
- # **Microsoft SQL Server Express Edition (sqlserver-ex)**
1005
- #
1006
- # * **Version 12.00 (available in all AWS regions):** ` 12.00.4422.0.v1`
1007
- #
1008
- # * **Version 11.00 (available in all AWS regions):** ` 11.00.2100.60.v1
1009
- # | 11.00.5058.0.v1 | 11.00.6020.0.v1`
1010
- #
1011
- # * **Version 10.50 (available in all AWS regions):** ` 10.50.2789.0.v1
1012
- # | 10.50.6000.34.v1 | 10.50.6529.0.v1`
1013
- #
1014
- # **Microsoft SQL Server Standard Edition (sqlserver-se)**
1015
- #
1016
- # * **Version 12.00 (available in all AWS regions):** ` 12.00.4422.0.v1`
1017
- #
1018
- # * **Version 11.00 (available in all AWS regions):** ` 11.00.2100.60.v1
1019
- # | 11.00.5058.0.v1 | 11.00.6020.0.v1`
1020
- #
1021
- # * **Version 10.50 (available in all AWS regions):** ` 10.50.2789.0.v1
1022
- # | 10.50.6000.34.v1 | 10.50.6529.0.v1`
1023
- #
1024
- # **Microsoft SQL Server Web Edition (sqlserver-web)**
1025
- #
1026
- # * **Version 12.00 (available in all AWS regions):** ` 12.00.4422.0.v1`
1027
- #
1028
- # * **Version 11.00 (available in all AWS regions):** ` 11.00.2100.60.v1
1029
- # | 11.00.5058.0.v1 | 11.00.6020.0.v1`
1030
- #
1031
- # * **Version 10.50 (available in all AWS regions):** ` 10.50.2789.0.v1
1032
- # | 10.50.6000.34.v1 | 10.50.6529.0.v1`
1033
1029
  # @option options [Boolean] :auto_minor_version_upgrade
1034
1030
  # Indicates that minor engine upgrades will be applied automatically to
1035
1031
  # the DB instance during the maintenance window.
@@ -2468,12 +2464,14 @@ module Aws
2468
2464
  #
2469
2465
  # Supported filters:
2470
2466
  #
2471
- # * `db-instance-id` - Accepts DB instance identifiers and DB instance
2467
+ # * `db-cluster-id` - Accepts DB cluster identifiers and DB cluster
2472
2468
  # Amazon Resource Names (ARNs). The results list will only include
2473
- # pending maintenance actions for the DB instances identified by these
2469
+ # pending maintenance actions for the DB clusters identified by these
2474
2470
  # ARNs.
2475
2471
  #
2476
- # ^
2472
+ # * `db-instance-id` - Accepts DB instance identifiers and DB instance
2473
+ # ARNs. The results list will only include pending maintenance actions
2474
+ # for the DB instances identified by these ARNs.
2477
2475
  # @option options [String] :marker
2478
2476
  # An optional pagination token provided by a previous
2479
2477
  # `DescribePendingMaintenanceActions` request. If this parameter is
@@ -284,9 +284,9 @@ module Aws
284
284
  #
285
285
  # Example: `my-db-snapshot`
286
286
  # @option options [String] :kms_key_id
287
- # The AWS Key Management Service (AWS KMS) key identifier for an
288
- # encrypted DB snapshot. The KMS key identifier is the Amazon Resource
289
- # Name (ARN) or the KMS key alias for the KMS encryption key.
287
+ # The AWS KMS key ID for an encrypted DB snapshot. The KMS key ID is the
288
+ # Amazon Resource Name (ARN), KMS key identifier, or the KMS key alias
289
+ # for the KMS encryption key.
290
290
  #
291
291
  # If you copy an unencrypted DB snapshot and specify a value for the
292
292
  # `KmsKeyId` parameter, Amazon RDS encrypts the target DB snapshot using
@@ -294,7 +294,7 @@ module Aws
294
294
  #
295
295
  # If you copy an encrypted DB snapshot from your AWS account, you can
296
296
  # specify a value for `KmsKeyId` to encrypt the copy with a new KMS
297
- # encryption key. If you don't specify a value for `KmsKeyId` then the
297
+ # encryption key. If you don't specify a value for `KmsKeyId`, then the
298
298
  # copy of the DB snapshot is encrypted with the same KMS key as the
299
299
  # source DB snapshot.
300
300
  #
@@ -687,25 +687,77 @@ module Aws
687
687
  #
688
688
  # * **Version 5.6 (available in these AWS regions: ap-northeast-1,
689
689
  # ap-northeast-2, ap-south-1, ap-southeast-2, eu-west-1, us-east-1,
690
- # us-west-2):** ` 5.6.10a`
690
+ # us-east-2, us-west-2):** ` 5.6.10a`
691
691
  #
692
692
  # ^
693
693
  #
694
694
  # **MariaDB**
695
695
  #
696
+ # * **Version 10.1 (available in these AWS regions: us-east-2):** `
697
+ # 10.1.16`
698
+ #
696
699
  # * **Version 10.1 (available in these AWS regions: ap-northeast-1,
697
700
  # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
698
701
  # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
699
702
  # us-west-2):** ` 10.1.14`
700
703
  #
701
- # * **Version 10.0 (available in all AWS regions):** ` 10.0.17 |
702
- # 10.0.24`
704
+ # * **Version 10.0 (available in all AWS regions):** ` 10.0.24`
705
+ #
706
+ # * **Version 10.0 (available in these AWS regions: ap-northeast-1,
707
+ # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
708
+ # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-gov-west-1,
709
+ # us-west-1, us-west-2):** ` 10.0.17`
710
+ #
711
+ # **Microsoft SQL Server 2016**
712
+ #
713
+ # * `13.00.2164.0.v1` (supported for all editions, and all AWS regions
714
+ # except sa-east-1)
715
+ #
716
+ # ^
717
+ #
718
+ # **Microsoft SQL Server 2014**
719
+ #
720
+ # * `12.00.5000.0.v1` (supported for all editions, and all AWS regions)
721
+ #
722
+ # * `12.00.4422.0.v1` (supported for all editions except Enterprise
723
+ # Edition, and all AWS regions except us-east-2)
724
+ #
725
+ # **Microsoft SQL Server 2012**
726
+ #
727
+ # * `11.00.6020.0.v1` (supported for all editions, and all AWS regions)
728
+ #
729
+ # * `11.00.5058.0.v1` (supported for all editions, and all AWS regions
730
+ # except us-east-2)
731
+ #
732
+ # * `11.00.2100.60.v1` (supported for all editions, and all AWS regions
733
+ # except us-east-2)
734
+ #
735
+ # **Microsoft SQL Server 2008 R2**
736
+ #
737
+ # * `10.50.6529.0.v1` (supported for all editions, and all AWS regions
738
+ # except us-east-2)
739
+ #
740
+ # * `10.50.6000.34.v1` (supported for all editions, and all AWS regions
741
+ # except us-east-2)
742
+ #
743
+ # * `10.50.2789.0.v1` (supported for all editions, and all AWS regions
744
+ # except us-east-2)
703
745
  #
704
746
  # **MySQL**
705
747
  #
706
- # * **Version 5.7 (available in all AWS regions):** ` 5.7.10 | 5.7.11`
748
+ # * **Version 5.7 (available in all AWS regions):** ` 5.7.11`
749
+ #
750
+ # * **Version 5.7 (available in these AWS regions: ap-northeast-1,
751
+ # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
752
+ # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-gov-west-1,
753
+ # us-west-1, us-west-2):** ` 5.7.10`
707
754
  #
708
- # * **Version 5.6 (available in all AWS regions):** ` 5.6.27 | 5.6.29`
755
+ # * **Version 5.6 (available in all AWS regions):** ` 5.6.29`
756
+ #
757
+ # * **Version 5.6 (available in these AWS regions: ap-northeast-1,
758
+ # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
759
+ # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-gov-west-1,
760
+ # us-west-1, us-west-2):** ` 5.6.27`
709
761
  #
710
762
  # * **Version 5.6 (available in these AWS regions: ap-northeast-1,
711
763
  # ap-northeast-2, ap-southeast-1, ap-southeast-2, eu-central-1,
@@ -733,114 +785,96 @@ module Aws
733
785
  # ap-southeast-1, ap-southeast-2, eu-west-1, sa-east-1, us-east-1,
734
786
  # us-gov-west-1, us-west-1, us-west-2):** ` 5.5.40 | 5.5.40a`
735
787
  #
736
- # **Oracle Database Enterprise Edition (oracle-ee)**
737
788
  #
738
- # * **Version 12.1.0.2 (available in these AWS regions: ap-northeast-1,
739
- # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
740
- # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
741
- # us-west-2):** ` 12.1.0.2.v5`
742
789
  #
743
- # * **Version 12.1.0.2 (available in all AWS regions):** ` 12.1.0.2.v1 |
744
- # 12.1.0.2.v2 | 12.1.0.2.v3 | 12.1.0.2.v4`
790
+ # **Oracle 12c**
745
791
  #
746
- # * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
747
- # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
748
- # us-east-1, us-west-1, us-west-2):** ` 12.1.0.1.v6`
792
+ # * `12.1.0.2.v5` (supported for EE in all AWS regions, and SE2 in all
793
+ # AWS regions except us-gov-west-1)
749
794
  #
750
- # * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
751
- # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
752
- # us-east-1, us-gov-west-1, us-west-1, us-west-2):** ` 12.1.0.1.v3 |
753
- # 12.1.0.1.v4 | 12.1.0.1.v5`
795
+ # * `12.1.0.2.v4` (supported for EE in all AWS regions, and SE2 in all
796
+ # AWS regions except us-gov-west-1)
754
797
  #
755
- # * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
756
- # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
757
- # us-east-1, us-gov-west-1, us-gov-west-1, us-west-1, us-west-2):** `
758
- # 12.1.0.1.v1 | 12.1.0.1.v2`
798
+ # * `12.1.0.2.v3` (supported for EE in all AWS regions, and SE2 in all
799
+ # AWS regions except us-gov-west-1)
759
800
  #
760
- # * **Version 11.2.0.4 (available in these AWS regions: ap-northeast-1,
761
- # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
762
- # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
763
- # us-west-2):** ` 11.2.0.4.v6 | 11.2.0.4.v9`
801
+ # * `12.1.0.2.v2` (supported for EE in all AWS regions, and SE2 in all
802
+ # AWS regions except us-gov-west-1)
764
803
  #
765
- # * **Version 11.2.0.4 (available in all AWS regions):** ` 11.2.0.4.v1 |
766
- # 11.2.0.4.v3 | 11.2.0.4.v4 | 11.2.0.4.v5 | 11.2.0.4.v7 | 11.2.0.4.v8`
804
+ # * `12.1.0.2.v1` (supported for EE in all AWS regions, and SE2 in all
805
+ # AWS regions except us-gov-west-1)
767
806
  #
768
- # **Oracle Database Standard Edition Two (oracle-se2)**
769
807
  #
770
- # * **Version 12.1.0.2 (available in these AWS regions: ap-northeast-1,
771
- # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
772
- # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
773
- # us-west-2):** ` 12.1.0.2.v5`
774
808
  #
775
- # * **Version 12.1.0.2 (available in all AWS regions):** ` 12.1.0.2.v2 |
776
- # 12.1.0.2.v3 | 12.1.0.2.v4`
809
+ # * `12.1.0.1.v6` (supported for EE, SE1, and SE, in all AWS regions
810
+ # except ap-south-1, ap-northeast-2)
777
811
  #
778
- # **Oracle Database Standard Edition One (oracle-se1)**
812
+ # * `12.1.0.1.v5` (supported for EE, SE1, and SE, in all AWS regions
813
+ # except ap-south-1, ap-northeast-2)
779
814
  #
780
- # * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
781
- # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
782
- # us-east-1, us-west-1, us-west-2):** ` 12.1.0.1.v6`
815
+ # * `12.1.0.1.v4` (supported for EE, SE1, and SE, in all AWS regions
816
+ # except ap-south-1, ap-northeast-2)
783
817
  #
784
- # * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
785
- # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
786
- # us-east-1, us-gov-west-1, us-west-1, us-west-2):** ` 12.1.0.1.v3 |
787
- # 12.1.0.1.v4 | 12.1.0.1.v5`
818
+ # * `12.1.0.1.v3` (supported for EE, SE1, and SE, in all AWS regions
819
+ # except ap-south-1, ap-northeast-2)
788
820
  #
789
- # * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
790
- # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
791
- # us-east-1, us-gov-west-1, us-gov-west-1, us-west-1, us-west-2):** `
792
- # 12.1.0.1.v1 | 12.1.0.1.v2`
821
+ # * `12.1.0.1.v2` (supported for EE, SE1, and SE, in all AWS regions
822
+ # except ap-south-1, ap-northeast-2)
793
823
  #
794
- # * **Version 11.2.0.4 (available in these AWS regions: ap-northeast-1,
795
- # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
796
- # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
797
- # us-west-2):** ` 11.2.0.4.v6 | 11.2.0.4.v9`
824
+ # * `12.1.0.1.v1` (supported for EE, SE1, and SE, in all AWS regions
825
+ # except ap-south-1, ap-northeast-2)
798
826
  #
799
- # * **Version 11.2.0.4 (available in all AWS regions):** ` 11.2.0.4.v1 |
800
- # 11.2.0.4.v3 | 11.2.0.4.v4 | 11.2.0.4.v5 | 11.2.0.4.v7 | 11.2.0.4.v8`
827
+ # **Oracle 11g**
801
828
  #
802
- # **Oracle Database Standard Edition (oracle-se)**
829
+ # * `11.2.0.4.v9` (supported for EE, SE1, and SE, in all AWS regions)
803
830
  #
804
- # * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
805
- # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
806
- # us-east-1, us-west-1, us-west-2):** ` 12.1.0.1.v6`
831
+ # * `11.2.0.4.v8` (supported for EE, SE1, and SE, in all AWS regions)
807
832
  #
808
- # * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
809
- # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
810
- # us-east-1, us-gov-west-1, us-west-1, us-west-2):** ` 12.1.0.1.v3 |
811
- # 12.1.0.1.v4 | 12.1.0.1.v5`
833
+ # * `11.2.0.4.v7` (supported for EE, SE1, and SE, in all AWS regions)
812
834
  #
813
- # * **Version 12.1.0.1 (available in these AWS regions: ap-northeast-1,
814
- # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
815
- # us-east-1, us-gov-west-1, us-gov-west-1, us-west-1, us-west-2):** `
816
- # 12.1.0.1.v1 | 12.1.0.1.v2`
835
+ # * `11.2.0.4.v6` (supported for EE, SE1, and SE, in all AWS regions)
817
836
  #
818
- # * **Version 11.2.0.4 (available in these AWS regions: ap-northeast-1,
819
- # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
820
- # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
821
- # us-west-2):** ` 11.2.0.4.v6 | 11.2.0.4.v9`
837
+ # * `11.2.0.4.v5` (supported for EE, SE1, and SE, in all AWS regions)
838
+ #
839
+ # * `11.2.0.4.v4` (supported for EE, SE1, and SE, in all AWS regions)
822
840
  #
823
- # * **Version 11.2.0.4 (available in all AWS regions):** ` 11.2.0.4.v1 |
824
- # 11.2.0.4.v3 | 11.2.0.4.v4 | 11.2.0.4.v5 | 11.2.0.4.v7 | 11.2.0.4.v8`
841
+ # * `11.2.0.4.v3` (supported for EE, SE1, and SE, in all AWS regions)
842
+ #
843
+ # * `11.2.0.4.v1` (supported for EE, SE1, and SE, in all AWS regions)
825
844
  #
826
845
  # **PostgreSQL**
827
846
  #
828
847
  # * **Version 9.5 (available in these AWS regions: ap-northeast-1,
829
848
  # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
830
849
  # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
831
- # us-west-2):** ` 9.5.2 | 9.5.4`
850
+ # us-west-2):** ` 9.5.4`
851
+ #
852
+ # * **Version 9.5 (available in these AWS regions: ap-northeast-1,
853
+ # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
854
+ # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-east-2, us-west-1,
855
+ # us-west-2):** ` 9.5.2`
832
856
  #
833
857
  # * **Version 9.4 (available in these AWS regions: ap-northeast-1,
834
858
  # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
835
859
  # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-west-1,
836
- # us-west-2):** ` 9.4.7 | 9.4.9`
860
+ # us-west-2):** ` 9.4.9`
861
+ #
862
+ # * **Version 9.4 (available in these AWS regions: ap-northeast-1,
863
+ # ap-northeast-2, ap-south-1, ap-southeast-1, ap-southeast-2,
864
+ # eu-central-1, eu-west-1, sa-east-1, us-east-1, us-east-2, us-west-1,
865
+ # us-west-2):** ` 9.4.7`
837
866
  #
838
867
  # * **Version 9.4 (available in all AWS regions):** ` 9.4.5`
839
868
  #
840
869
  # * **Version 9.4 (available in these AWS regions: ap-northeast-1,
841
870
  # ap-northeast-2, ap-southeast-1, ap-southeast-2, eu-central-1,
842
871
  # eu-west-1, sa-east-1, us-east-1, us-gov-west-1, us-west-1,
843
- # us-west-2):** ` 9.4.1 | 9.4.4`
872
+ # us-west-2):** ` 9.4.4`
873
+ #
874
+ # * **Version 9.4 (available in these AWS regions: ap-northeast-1,
875
+ # ap-northeast-2, ap-southeast-1, ap-southeast-2, eu-central-1,
876
+ # eu-west-1, sa-east-1, us-east-1, us-east-2, us-gov-west-1,
877
+ # us-west-1, us-west-2):** ` 9.4.1`
844
878
  #
845
879
  # * **Version 9.3 (available in these AWS regions: ap-northeast-1,
846
880
  # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
@@ -854,44 +888,6 @@ module Aws
854
888
  # * **Version 9.3 (available in these AWS regions: ap-northeast-1,
855
889
  # ap-southeast-1, ap-southeast-2, eu-central-1, eu-west-1, sa-east-1,
856
890
  # us-east-1, us-west-1, us-west-2):** ` 9.3.12 | 9.3.14`
857
- #
858
- # **Microsoft SQL Server Enterprise Edition (sqlserver-ee)**
859
- #
860
- # * **Version 11.00 (available in all AWS regions):** ` 11.00.2100.60.v1
861
- # | 11.00.5058.0.v1 | 11.00.6020.0.v1`
862
- #
863
- # * **Version 10.50 (available in all AWS regions):** ` 10.50.2789.0.v1
864
- # | 10.50.6000.34.v1 | 10.50.6529.0.v1`
865
- #
866
- # **Microsoft SQL Server Express Edition (sqlserver-ex)**
867
- #
868
- # * **Version 12.00 (available in all AWS regions):** ` 12.00.4422.0.v1`
869
- #
870
- # * **Version 11.00 (available in all AWS regions):** ` 11.00.2100.60.v1
871
- # | 11.00.5058.0.v1 | 11.00.6020.0.v1`
872
- #
873
- # * **Version 10.50 (available in all AWS regions):** ` 10.50.2789.0.v1
874
- # | 10.50.6000.34.v1 | 10.50.6529.0.v1`
875
- #
876
- # **Microsoft SQL Server Standard Edition (sqlserver-se)**
877
- #
878
- # * **Version 12.00 (available in all AWS regions):** ` 12.00.4422.0.v1`
879
- #
880
- # * **Version 11.00 (available in all AWS regions):** ` 11.00.2100.60.v1
881
- # | 11.00.5058.0.v1 | 11.00.6020.0.v1`
882
- #
883
- # * **Version 10.50 (available in all AWS regions):** ` 10.50.2789.0.v1
884
- # | 10.50.6000.34.v1 | 10.50.6529.0.v1`
885
- #
886
- # **Microsoft SQL Server Web Edition (sqlserver-web)**
887
- #
888
- # * **Version 12.00 (available in all AWS regions):** ` 12.00.4422.0.v1`
889
- #
890
- # * **Version 11.00 (available in all AWS regions):** ` 11.00.2100.60.v1
891
- # | 11.00.5058.0.v1 | 11.00.6020.0.v1`
892
- #
893
- # * **Version 10.50 (available in all AWS regions):** ` 10.50.2789.0.v1
894
- # | 10.50.6000.34.v1 | 10.50.6529.0.v1`
895
891
  # @option options [Boolean] :auto_minor_version_upgrade
896
892
  # Indicates that minor engine upgrades will be applied automatically to
897
893
  # the DB instance during the maintenance window.
@@ -1490,7 +1486,15 @@ module Aws
1490
1486
  #
1491
1487
  # * Cannot end with a hyphen or contain two consecutive hyphens
1492
1488
  # @option options [Array<Types::Filter>] :filters
1493
- # This parameter is not currently supported.
1489
+ # A filter that specifies one or more DB clusters to describe.
1490
+ #
1491
+ # Supported filters:
1492
+ #
1493
+ # * `db-cluster-id` - Accepts DB cluster identifiers and DB cluster
1494
+ # Amazon Resource Names (ARNs). The results list will only include
1495
+ # information about the DB clusters identified by these ARNs.
1496
+ #
1497
+ # ^
1494
1498
  # @option options [Integer] :max_records
1495
1499
  # The maximum number of records to include in the response. If more
1496
1500
  # records exist than the specified `MaxRecords` value, a pagination
@@ -1642,7 +1646,15 @@ module Aws
1642
1646
  #
1643
1647
  # * Cannot end with a hyphen or contain two consecutive hyphens
1644
1648
  # @option options [Array<Types::Filter>] :filters
1645
- # This parameter is not currently supported.
1649
+ # A filter that specifies one or more DB instances to describe.
1650
+ #
1651
+ # Supported filters:
1652
+ #
1653
+ # * `db-instance-id` - Accepts DB instance identifiers and DB instance
1654
+ # Amazon Resource Names (ARNs). The results list will only include
1655
+ # information about the DB instances identified by these ARNs.
1656
+ #
1657
+ # ^
1646
1658
  # @return [DBInstance::Collection]
1647
1659
  def db_instances(options = {})
1648
1660
  batches = Enumerator.new do |y|
@@ -2342,12 +2354,14 @@ module Aws
2342
2354
  #
2343
2355
  # Supported filters:
2344
2356
  #
2345
- # * `db-instance-id` - Accepts DB instance identifiers and DB instance
2357
+ # * `db-cluster-id` - Accepts DB cluster identifiers and DB cluster
2346
2358
  # Amazon Resource Names (ARNs). The results list will only include
2347
- # pending maintenance actions for the DB instances identified by these
2359
+ # pending maintenance actions for the DB clusters identified by these
2348
2360
  # ARNs.
2349
2361
  #
2350
- # ^
2362
+ # * `db-instance-id` - Accepts DB instance identifiers and DB instance
2363
+ # ARNs. The results list will only include pending maintenance actions
2364
+ # for the DB instances identified by these ARNs.
2351
2365
  # @option options [String] :marker
2352
2366
  # An optional pagination token provided by a previous
2353
2367
  # `DescribePendingMaintenanceActions` request. If this parameter is