File Coverage

blib/lib/Paws/RDS/CreateDBInstance.pm
Criterion Covered Total %
statement 6 6 100.0
branch n/a
condition n/a
subroutine 2 2 100.0
pod n/a
total 8 8 100.0


line stmt bran cond sub pod time code
1              
2             package Paws::RDS::CreateDBInstance;
3 1     1   342 use Moose;
  1         2  
  1         5  
4             has AllocatedStorage => (is => 'ro', isa => 'Int');
5             has AutoMinorVersionUpgrade => (is => 'ro', isa => 'Bool');
6             has AvailabilityZone => (is => 'ro', isa => 'Str');
7             has BackupRetentionPeriod => (is => 'ro', isa => 'Int');
8             has CharacterSetName => (is => 'ro', isa => 'Str');
9             has CopyTagsToSnapshot => (is => 'ro', isa => 'Bool');
10             has DBClusterIdentifier => (is => 'ro', isa => 'Str');
11             has DBInstanceClass => (is => 'ro', isa => 'Str', required => 1);
12             has DBInstanceIdentifier => (is => 'ro', isa => 'Str', required => 1);
13             has DBName => (is => 'ro', isa => 'Str');
14             has DBParameterGroupName => (is => 'ro', isa => 'Str');
15             has DBSecurityGroups => (is => 'ro', isa => 'ArrayRef[Str|Undef]');
16             has DBSubnetGroupName => (is => 'ro', isa => 'Str');
17             has Domain => (is => 'ro', isa => 'Str');
18             has DomainIAMRoleName => (is => 'ro', isa => 'Str');
19             has EnableIAMDatabaseAuthentication => (is => 'ro', isa => 'Bool');
20             has EnablePerformanceInsights => (is => 'ro', isa => 'Bool');
21             has Engine => (is => 'ro', isa => 'Str', required => 1);
22             has EngineVersion => (is => 'ro', isa => 'Str');
23             has Iops => (is => 'ro', isa => 'Int');
24             has KmsKeyId => (is => 'ro', isa => 'Str');
25             has LicenseModel => (is => 'ro', isa => 'Str');
26             has MasterUsername => (is => 'ro', isa => 'Str');
27             has MasterUserPassword => (is => 'ro', isa => 'Str');
28             has MonitoringInterval => (is => 'ro', isa => 'Int');
29             has MonitoringRoleArn => (is => 'ro', isa => 'Str');
30             has MultiAZ => (is => 'ro', isa => 'Bool');
31             has OptionGroupName => (is => 'ro', isa => 'Str');
32             has PerformanceInsightsKMSKeyId => (is => 'ro', isa => 'Str');
33             has Port => (is => 'ro', isa => 'Int');
34             has PreferredBackupWindow => (is => 'ro', isa => 'Str');
35             has PreferredMaintenanceWindow => (is => 'ro', isa => 'Str');
36             has PromotionTier => (is => 'ro', isa => 'Int');
37             has PubliclyAccessible => (is => 'ro', isa => 'Bool');
38             has StorageEncrypted => (is => 'ro', isa => 'Bool');
39             has StorageType => (is => 'ro', isa => 'Str');
40             has Tags => (is => 'ro', isa => 'ArrayRef[Paws::RDS::Tag]');
41             has TdeCredentialArn => (is => 'ro', isa => 'Str');
42             has TdeCredentialPassword => (is => 'ro', isa => 'Str');
43             has Timezone => (is => 'ro', isa => 'Str');
44             has VpcSecurityGroupIds => (is => 'ro', isa => 'ArrayRef[Str|Undef]');
45              
46 1     1   5583 use MooseX::ClassAttribute;
  1         4  
  1         8  
47              
48             class_has _api_call => (isa => 'Str', is => 'ro', default => 'CreateDBInstance');
49             class_has _returns => (isa => 'Str', is => 'ro', default => 'Paws::RDS::CreateDBInstanceResult');
50             class_has _result_key => (isa => 'Str', is => 'ro', default => 'CreateDBInstanceResult');
51             1;
52              
53             ### main pod documentation begin ###
54              
55             =head1 NAME
56              
57             Paws::RDS::CreateDBInstance - Arguments for method CreateDBInstance on Paws::RDS
58              
59             =head1 DESCRIPTION
60              
61             This class represents the parameters used for calling the method CreateDBInstance on the
62             Amazon Relational Database Service service. Use the attributes of this class
63             as arguments to method CreateDBInstance.
64              
65             You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to CreateDBInstance.
66              
67             As an example:
68              
69             $service_obj->CreateDBInstance(Att1 => $value1, Att2 => $value2, ...);
70              
71             Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object.
72              
73             =head1 ATTRIBUTES
74              
75              
76             =head2 AllocatedStorage => Int
77              
78             The amount of storage (in gigabytes) to be initially allocated for the
79             database instance.
80              
81             Type: Integer
82              
83             B<Amazon Aurora>
84              
85             Not applicable. Aurora cluster volumes automatically grow as the amount
86             of data in your database increases, though you are only charged for the
87             space that you use in an Aurora cluster volume.
88              
89             B<MySQL>
90              
91             Constraints to the amount of storage for each storage type are the
92             following:
93              
94             =over
95              
96             =item *
97              
98             General Purpose (SSD) storage (gp2): Must be an integer from 5 to 6144.
99              
100             =item *
101              
102             Provisioned IOPS storage (io1): Must be an integer from 100 to 6144.
103              
104             =item *
105              
106             Magnetic storage (standard): Must be an integer from 5 to 3072.
107              
108             =back
109              
110             B<MariaDB>
111              
112             Constraints to the amount of storage for each storage type are the
113             following:
114              
115             =over
116              
117             =item *
118              
119             General Purpose (SSD) storage (gp2): Must be an integer from 5 to 6144.
120              
121             =item *
122              
123             Provisioned IOPS storage (io1): Must be an integer from 100 to 6144.
124              
125             =item *
126              
127             Magnetic storage (standard): Must be an integer from 5 to 3072.
128              
129             =back
130              
131             B<PostgreSQL>
132              
133             Constraints to the amount of storage for each storage type are the
134             following:
135              
136             =over
137              
138             =item *
139              
140             General Purpose (SSD) storage (gp2): Must be an integer from 5 to 6144.
141              
142             =item *
143              
144             Provisioned IOPS storage (io1): Must be an integer from 100 to 6144.
145              
146             =item *
147              
148             Magnetic storage (standard): Must be an integer from 5 to 3072.
149              
150             =back
151              
152             B<Oracle>
153              
154             Constraints to the amount of storage for each storage type are the
155             following:
156              
157             =over
158              
159             =item *
160              
161             General Purpose (SSD) storage (gp2): Must be an integer from 10 to
162             6144.
163              
164             =item *
165              
166             Provisioned IOPS storage (io1): Must be an integer from 100 to 6144.
167              
168             =item *
169              
170             Magnetic storage (standard): Must be an integer from 10 to 3072.
171              
172             =back
173              
174             B<SQL Server>
175              
176             Constraints to the amount of storage for each storage type are the
177             following:
178              
179             =over
180              
181             =item *
182              
183             General Purpose (SSD) storage (gp2):
184              
185             =over
186              
187             =item *
188              
189             Enterprise and Standard editions: Must be an integer from 200 to 16384.
190              
191             =item *
192              
193             Web and Express editions: Must be an integer from 20 to 16384.
194              
195             =back
196              
197             =item *
198              
199             Provisioned IOPS storage (io1):
200              
201             =over
202              
203             =item *
204              
205             Enterprise and Standard editions: Must be an integer from 200 to 16384.
206              
207             =item *
208              
209             Web and Express editions: Must be an integer from 100 to 16384.
210              
211             =back
212              
213             =item *
214              
215             Magnetic storage (standard):
216              
217             =over
218              
219             =item *
220              
221             Enterprise and Standard editions: Must be an integer from 200 to 1024.
222              
223             =item *
224              
225             Web and Express editions: Must be an integer from 20 to 1024.
226              
227             =back
228              
229             =back
230              
231              
232              
233              
234             =head2 AutoMinorVersionUpgrade => Bool
235              
236             Indicates that minor engine upgrades will be applied automatically to
237             the DB instance during the maintenance window.
238              
239             Default: C<true>
240              
241              
242              
243             =head2 AvailabilityZone => Str
244              
245             The EC2 Availability Zone that the database instance will be created
246             in. For information on regions and Availability Zones, see Regions and
247             Availability Zones.
248              
249             Default: A random, system-chosen Availability Zone in the endpoint's
250             AWS Region.
251              
252             Example: C<us-east-1d>
253              
254             Constraint: The AvailabilityZone parameter cannot be specified if the
255             MultiAZ parameter is set to C<true>. The specified Availability Zone
256             must be in the same AWS Region as the current endpoint.
257              
258              
259              
260             =head2 BackupRetentionPeriod => Int
261              
262             The number of days for which automated backups are retained. Setting
263             this parameter to a positive number enables backups. Setting this
264             parameter to 0 disables automated backups.
265              
266             B<Amazon Aurora>
267              
268             Not applicable. The retention period for automated backups is managed
269             by the DB cluster. For more information, see CreateDBCluster.
270              
271             Default: 1
272              
273             Constraints:
274              
275             =over
276              
277             =item *
278              
279             Must be a value from 0 to 35
280              
281             =item *
282              
283             Cannot be set to 0 if the DB instance is a source to Read Replicas
284              
285             =back
286              
287              
288              
289              
290             =head2 CharacterSetName => Str
291              
292             For supported engines, indicates that the DB instance should be
293             associated with the specified CharacterSet.
294              
295             B<Amazon Aurora>
296              
297             Not applicable. The character set is managed by the DB cluster. For
298             more information, see CreateDBCluster.
299              
300              
301              
302             =head2 CopyTagsToSnapshot => Bool
303              
304             True to copy all tags from the DB instance to snapshots of the DB
305             instance; otherwise false. The default is false.
306              
307              
308              
309             =head2 DBClusterIdentifier => Str
310              
311             The identifier of the DB cluster that the instance will belong to.
312              
313             For information on creating a DB cluster, see CreateDBCluster.
314              
315             Type: String
316              
317              
318              
319             =head2 B<REQUIRED> DBInstanceClass => Str
320              
321             The compute and memory capacity of the DB instance. Note that not all
322             instance classes are available in all regions for all DB engines.
323              
324             Valid Values: C<db.t1.micro | db.m1.small | db.m1.medium | db.m1.large
325             | db.m1.xlarge | db.m2.xlarge |db.m2.2xlarge | db.m2.4xlarge |
326             db.m3.medium | db.m3.large | db.m3.xlarge | db.m3.2xlarge | db.m4.large
327             | db.m4.xlarge | db.m4.2xlarge | db.m4.4xlarge | db.m4.10xlarge |
328             db.r3.large | db.r3.xlarge | db.r3.2xlarge | db.r3.4xlarge |
329             db.r3.8xlarge | db.t2.micro | db.t2.small | db.t2.medium | db.t2.large>
330              
331              
332              
333             =head2 B<REQUIRED> DBInstanceIdentifier => Str
334              
335             The DB instance identifier. This parameter is stored as a lowercase
336             string.
337              
338             Constraints:
339              
340             =over
341              
342             =item *
343              
344             Must contain from 1 to 63 alphanumeric characters or hyphens.
345              
346             =item *
347              
348             First character must be a letter.
349              
350             =item *
351              
352             Cannot end with a hyphen or contain two consecutive hyphens.
353              
354             =back
355              
356             Example: C<mydbinstance>
357              
358              
359              
360             =head2 DBName => Str
361              
362             The meaning of this parameter differs according to the database engine
363             you use.
364              
365             Type: String
366              
367             B<MySQL>
368              
369             The name of the database to create when the DB instance is created. If
370             this parameter is not specified, no database is created in the DB
371             instance.
372              
373             Constraints:
374              
375             =over
376              
377             =item *
378              
379             Must contain 1 to 64 alphanumeric characters
380              
381             =item *
382              
383             Cannot be a word reserved by the specified database engine
384              
385             =back
386              
387             B<MariaDB>
388              
389             The name of the database to create when the DB instance is created. If
390             this parameter is not specified, no database is created in the DB
391             instance.
392              
393             Constraints:
394              
395             =over
396              
397             =item *
398              
399             Must contain 1 to 64 alphanumeric characters
400              
401             =item *
402              
403             Cannot be a word reserved by the specified database engine
404              
405             =back
406              
407             B<PostgreSQL>
408              
409             The name of the database to create when the DB instance is created. If
410             this parameter is not specified, the default "postgres" database is
411             created in the DB instance.
412              
413             Constraints:
414              
415             =over
416              
417             =item *
418              
419             Must contain 1 to 63 alphanumeric characters
420              
421             =item *
422              
423             Must begin with a letter or an underscore. Subsequent characters can be
424             letters, underscores, or digits (0-9).
425              
426             =item *
427              
428             Cannot be a word reserved by the specified database engine
429              
430             =back
431              
432             B<Oracle>
433              
434             The Oracle System ID (SID) of the created DB instance. If you specify
435             C<null>, the default value C<ORCL> is used. You can't specify the
436             string NULL, or any other reserved word, for C<DBName>.
437              
438             Default: C<ORCL>
439              
440             Constraints:
441              
442             =over
443              
444             =item *
445              
446             Cannot be longer than 8 characters
447              
448             =back
449              
450             B<SQL Server>
451              
452             Not applicable. Must be null.
453              
454             B<Amazon Aurora>
455              
456             The name of the database to create when the primary instance of the DB
457             cluster is created. If this parameter is not specified, no database is
458             created in the DB instance.
459              
460             Constraints:
461              
462             =over
463              
464             =item *
465              
466             Must contain 1 to 64 alphanumeric characters
467              
468             =item *
469              
470             Cannot be a word reserved by the specified database engine
471              
472             =back
473              
474              
475              
476              
477             =head2 DBParameterGroupName => Str
478              
479             The name of the DB parameter group to associate with this DB instance.
480             If this argument is omitted, the default DBParameterGroup for the
481             specified engine will be used.
482              
483             Constraints:
484              
485             =over
486              
487             =item *
488              
489             Must be 1 to 255 alphanumeric characters
490              
491             =item *
492              
493             First character must be a letter
494              
495             =item *
496              
497             Cannot end with a hyphen or contain two consecutive hyphens
498              
499             =back
500              
501              
502              
503              
504             =head2 DBSecurityGroups => ArrayRef[Str|Undef]
505              
506             A list of DB security groups to associate with this DB instance.
507              
508             Default: The default DB security group for the database engine.
509              
510              
511              
512             =head2 DBSubnetGroupName => Str
513              
514             A DB subnet group to associate with this DB instance.
515              
516             If there is no DB subnet group, then it is a non-VPC DB instance.
517              
518              
519              
520             =head2 Domain => Str
521              
522             Specify the Active Directory Domain to create the instance in.
523              
524              
525              
526             =head2 DomainIAMRoleName => Str
527              
528             Specify the name of the IAM role to be used when making API calls to
529             the Directory Service.
530              
531              
532              
533             =head2 EnableIAMDatabaseAuthentication => Bool
534              
535             True to enable mapping of AWS Identity and Access Management (IAM)
536             accounts to database accounts; otherwise false.
537              
538             You can enable IAM database authentication for the following database
539             engines:
540              
541             B<Amazon Aurora>
542              
543             Not applicable. Mapping AWS IAM accounts to database accounts is
544             managed by the DB cluster. For more information, see CreateDBCluster.
545              
546             B<MySQL>
547              
548             =over
549              
550             =item *
551              
552             For MySQL 5.6, minor version 5.6.34 or higher
553              
554             =item *
555              
556             For MySQL 5.7, minor version 5.7.16 or higher
557              
558             =back
559              
560             Default: C<false>
561              
562              
563              
564             =head2 EnablePerformanceInsights => Bool
565              
566              
567              
568              
569              
570             =head2 B<REQUIRED> Engine => Str
571              
572             The name of the database engine to be used for this instance.
573              
574             Not every database engine is available for every AWS Region.
575              
576             Valid Values:
577              
578             =over
579              
580             =item *
581              
582             C<aurora>
583              
584             =item *
585              
586             C<mariadb>
587              
588             =item *
589              
590             C<mysql>
591              
592             =item *
593              
594             C<oracle-ee>
595              
596             =item *
597              
598             C<oracle-se2>
599              
600             =item *
601              
602             C<oracle-se1>
603              
604             =item *
605              
606             C<oracle-se>
607              
608             =item *
609              
610             C<postgres>
611              
612             =item *
613              
614             C<sqlserver-ee>
615              
616             =item *
617              
618             C<sqlserver-se>
619              
620             =item *
621              
622             C<sqlserver-ex>
623              
624             =item *
625              
626             C<sqlserver-web>
627              
628             =back
629              
630              
631              
632              
633             =head2 EngineVersion => Str
634              
635             The version number of the database engine to use.
636              
637             The following are the database engines and major and minor versions
638             that are available with Amazon RDS. Not every database engine is
639             available for every AWS Region.
640              
641             B<Amazon Aurora>
642              
643             Not applicable. The version number of the database engine to be used by
644             the DB instance is managed by the DB cluster. For more information, see
645             CreateDBCluster.
646              
647             B<MariaDB>
648              
649             =over
650              
651             =item *
652              
653             C<10.1.23> (supported in all AWS regions)
654              
655             =item *
656              
657             C<10.1.19> (supported in all AWS regions)
658              
659             =item *
660              
661             C<10.1.14> (supported in all regions except us-east-2)
662              
663             =back
664              
665             =over
666              
667             =item *
668              
669             C<10.0.31> (supported in all AWS regions)
670              
671             =item *
672              
673             C<10.0.28> (supported in all AWS regions)
674              
675             =item *
676              
677             C<10.0.24> (supported in all AWS regions)
678              
679             =item *
680              
681             C<10.0.17> (supported in all regions except us-east-2, ca-central-1,
682             eu-west-2)
683              
684             =back
685              
686             B<Microsoft SQL Server 2016>
687              
688             =over
689              
690             =item *
691              
692             C<13.00.4422.0.v1> (supported for all editions, and all AWS regions)
693              
694             =item *
695              
696             C<13.00.2164.0.v1> (supported for all editions, and all AWS regions)
697              
698             =back
699              
700             B<Microsoft SQL Server 2014>
701              
702             =over
703              
704             =item *
705              
706             C<12.00.5546.0.v1> (supported for all editions, and all AWS regions)
707              
708             =item *
709              
710             C<12.00.5000.0.v1> (supported for all editions, and all AWS regions)
711              
712             =item *
713              
714             C<12.00.4422.0.v1> (supported for all editions except Enterprise
715             Edition, and all AWS regions except ca-central-1 and eu-west-2)
716              
717             =back
718              
719             B<Microsoft SQL Server 2012>
720              
721             =over
722              
723             =item *
724              
725             C<11.00.6594.0.v1> (supported for all editions, and all AWS regions)
726              
727             =item *
728              
729             C<11.00.6020.0.v1> (supported for all editions, and all AWS regions)
730              
731             =item *
732              
733             C<11.00.5058.0.v1> (supported for all editions, and all AWS regions
734             except us-east-2, ca-central-1, and eu-west-2)
735              
736             =item *
737              
738             C<11.00.2100.60.v1> (supported for all editions, and all AWS regions
739             except us-east-2, ca-central-1, and eu-west-2)
740              
741             =back
742              
743             B<Microsoft SQL Server 2008 R2>
744              
745             =over
746              
747             =item *
748              
749             C<10.50.6529.0.v1> (supported for all editions, and all AWS regions
750             except us-east-2, ca-central-1, and eu-west-2)
751              
752             =item *
753              
754             C<10.50.6000.34.v1> (supported for all editions, and all AWS regions
755             except us-east-2, ca-central-1, and eu-west-2)
756              
757             =item *
758              
759             C<10.50.2789.0.v1> (supported for all editions, and all AWS regions
760             except us-east-2, ca-central-1, and eu-west-2)
761              
762             =back
763              
764             B<MySQL>
765              
766             =over
767              
768             =item *
769              
770             C<5.7.17> (supported in all AWS regions)
771              
772             =item *
773              
774             C<5.7.16> (supported in all AWS regions)
775              
776             =item *
777              
778             C<5.7.11> (supported in all AWS regions)
779              
780             =back
781              
782             =over
783              
784             =item *
785              
786             C<5.6.35> (supported in all AWS regions)
787              
788             =item *
789              
790             C<5.6.34> (supported in all AWS regions)
791              
792             =item *
793              
794             C<5.6.29> (supported in all AWS regions)
795              
796             =item *
797              
798             C<5.6.27> (supported in all regions except us-east-2, ca-central-1,
799             eu-west-2)
800              
801             =back
802              
803             =over
804              
805             =item *
806              
807             C<5.5.54> (supported in all AWS regions)
808              
809             =item *
810              
811             C<5.5.53> (supported in all AWS regions)
812              
813             =item *
814              
815             C<5.5.46> (supported in all AWS regions)
816              
817             =back
818              
819             B<Oracle 12c>
820              
821             =over
822              
823             =item *
824              
825             C<12.1.0.2.v8> (supported for EE in all AWS regions, and SE2 in all AWS
826             regions except us-gov-west-1)
827              
828             =item *
829              
830             C<12.1.0.2.v7> (supported for EE in all AWS regions, and SE2 in all AWS
831             regions except us-gov-west-1)
832              
833             =item *
834              
835             C<12.1.0.2.v6> (supported for EE in all AWS regions, and SE2 in all AWS
836             regions except us-gov-west-1)
837              
838             =item *
839              
840             C<12.1.0.2.v5> (supported for EE in all AWS regions, and SE2 in all AWS
841             regions except us-gov-west-1)
842              
843             =item *
844              
845             C<12.1.0.2.v4> (supported for EE in all AWS regions, and SE2 in all AWS
846             regions except us-gov-west-1)
847              
848             =item *
849              
850             C<12.1.0.2.v3> (supported for EE in all AWS regions, and SE2 in all AWS
851             regions except us-gov-west-1)
852              
853             =item *
854              
855             C<12.1.0.2.v2> (supported for EE in all AWS regions, and SE2 in all AWS
856             regions except us-gov-west-1)
857              
858             =item *
859              
860             C<12.1.0.2.v1> (supported for EE in all AWS regions, and SE2 in all AWS
861             regions except us-gov-west-1)
862              
863             =back
864              
865             B<Oracle 11g>
866              
867             =over
868              
869             =item *
870              
871             C<11.2.0.4.v12> (supported for EE, SE1, and SE, in all AWS regions)
872              
873             =item *
874              
875             C<11.2.0.4.v11> (supported for EE, SE1, and SE, in all AWS regions)
876              
877             =item *
878              
879             C<11.2.0.4.v10> (supported for EE, SE1, and SE, in all AWS regions)
880              
881             =item *
882              
883             C<11.2.0.4.v9> (supported for EE, SE1, and SE, in all AWS regions)
884              
885             =item *
886              
887             C<11.2.0.4.v8> (supported for EE, SE1, and SE, in all AWS regions)
888              
889             =item *
890              
891             C<11.2.0.4.v7> (supported for EE, SE1, and SE, in all AWS regions)
892              
893             =item *
894              
895             C<11.2.0.4.v6> (supported for EE, SE1, and SE, in all AWS regions)
896              
897             =item *
898              
899             C<11.2.0.4.v5> (supported for EE, SE1, and SE, in all AWS regions)
900              
901             =item *
902              
903             C<11.2.0.4.v4> (supported for EE, SE1, and SE, in all AWS regions)
904              
905             =item *
906              
907             C<11.2.0.4.v3> (supported for EE, SE1, and SE, in all AWS regions)
908              
909             =item *
910              
911             C<11.2.0.4.v1> (supported for EE, SE1, and SE, in all AWS regions)
912              
913             =back
914              
915             B<PostgreSQL>
916              
917             =over
918              
919             =item *
920              
921             B<Version 9.6.x:> C< 9.6.1 | 9.6.2 | 9.6.3>
922              
923             =item *
924              
925             B<Version 9.5.x:> C<9.5.6 | 9.5.4 | 9.5.2>
926              
927             =item *
928              
929             B<Version 9.4.x:> C<9.4.11 | 9.4.9 | 9.4.7>
930              
931             =item *
932              
933             B<Version 9.3.x:> C<9.3.16 | 9.3.14 | 9.3.12>
934              
935             =back
936              
937              
938              
939              
940             =head2 Iops => Int
941              
942             The amount of Provisioned IOPS (input/output operations per second) to
943             be initially allocated for the DB instance.
944              
945             Constraints: Must be a multiple between 3 and 10 of the storage amount
946             for the DB instance. Must also be an integer multiple of 1000. For
947             example, if the size of your DB instance is 500 GB, then your C<Iops>
948             value can be 2000, 3000, 4000, or 5000.
949              
950              
951              
952             =head2 KmsKeyId => Str
953              
954             The KMS key identifier for an encrypted DB instance.
955              
956             The KMS key identifier is the Amazon Resource Name (ARN) for the KMS
957             encryption key. If you are creating a DB instance with the same AWS
958             account that owns the KMS encryption key used to encrypt the new DB
959             instance, then you can use the KMS key alias instead of the ARN for the
960             KM encryption key.
961              
962             B<Amazon Aurora>
963              
964             Not applicable. The KMS key identifier is managed by the DB cluster.
965             For more information, see CreateDBCluster.
966              
967             If the C<StorageEncrypted> parameter is true, and you do not specify a
968             value for the C<KmsKeyId> parameter, then Amazon RDS will use your
969             default encryption key. AWS KMS creates the default encryption key for
970             your AWS account. Your AWS account has a different default encryption
971             key for each AWS Region.
972              
973              
974              
975             =head2 LicenseModel => Str
976              
977             License model information for this DB instance.
978              
979             Valid values: C<license-included> | C<bring-your-own-license> |
980             C<general-public-license>
981              
982              
983              
984             =head2 MasterUsername => Str
985              
986             The name for the master user.
987              
988             B<Amazon Aurora>
989              
990             Not applicable. The name for the master user is managed by the DB
991             cluster. For more information, see CreateDBCluster.
992              
993             B<MariaDB>
994              
995             Constraints:
996              
997             =over
998              
999             =item *
1000              
1001             Must be 1 to 16 alphanumeric characters.
1002              
1003             =item *
1004              
1005             Cannot be a reserved word for the chosen database engine.
1006              
1007             =back
1008              
1009             B<Microsoft SQL Server>
1010              
1011             Constraints:
1012              
1013             =over
1014              
1015             =item *
1016              
1017             Must be 1 to 128 alphanumeric characters.
1018              
1019             =item *
1020              
1021             First character must be a letter.
1022              
1023             =item *
1024              
1025             Cannot be a reserved word for the chosen database engine.
1026              
1027             =back
1028              
1029             B<MySQL>
1030              
1031             Constraints:
1032              
1033             =over
1034              
1035             =item *
1036              
1037             Must be 1 to 16 alphanumeric characters.
1038              
1039             =item *
1040              
1041             First character must be a letter.
1042              
1043             =item *
1044              
1045             Cannot be a reserved word for the chosen database engine.
1046              
1047             =back
1048              
1049             B<Oracle>
1050              
1051             Constraints:
1052              
1053             =over
1054              
1055             =item *
1056              
1057             Must be 1 to 30 alphanumeric characters.
1058              
1059             =item *
1060              
1061             First character must be a letter.
1062              
1063             =item *
1064              
1065             Cannot be a reserved word for the chosen database engine.
1066              
1067             =back
1068              
1069             B<PostgreSQL>
1070              
1071             Constraints:
1072              
1073             =over
1074              
1075             =item *
1076              
1077             Must be 1 to 63 alphanumeric characters.
1078              
1079             =item *
1080              
1081             First character must be a letter.
1082              
1083             =item *
1084              
1085             Cannot be a reserved word for the chosen database engine.
1086              
1087             =back
1088              
1089              
1090              
1091              
1092             =head2 MasterUserPassword => Str
1093              
1094             The password for the master user. Can be any printable ASCII character
1095             except "/", """, or "@".
1096              
1097             B<Amazon Aurora>
1098              
1099             Not applicable. The password for the master user is managed by the DB
1100             cluster. For more information, see CreateDBCluster.
1101              
1102             B<MariaDB>
1103              
1104             Constraints: Must contain from 8 to 41 characters.
1105              
1106             B<Microsoft SQL Server>
1107              
1108             Constraints: Must contain from 8 to 128 characters.
1109              
1110             B<MySQL>
1111              
1112             Constraints: Must contain from 8 to 41 characters.
1113              
1114             B<Oracle>
1115              
1116             Constraints: Must contain from 8 to 30 characters.
1117              
1118             B<PostgreSQL>
1119              
1120             Constraints: Must contain from 8 to 128 characters.
1121              
1122              
1123              
1124             =head2 MonitoringInterval => Int
1125              
1126             The interval, in seconds, between points when Enhanced Monitoring
1127             metrics are collected for the DB instance. To disable collecting
1128             Enhanced Monitoring metrics, specify 0. The default is 0.
1129              
1130             If C<MonitoringRoleArn> is specified, then you must also set
1131             C<MonitoringInterval> to a value other than 0.
1132              
1133             Valid Values: C<0, 1, 5, 10, 15, 30, 60>
1134              
1135              
1136              
1137             =head2 MonitoringRoleArn => Str
1138              
1139             The ARN for the IAM role that permits RDS to send enhanced monitoring
1140             metrics to CloudWatch Logs. For example,
1141             C<arn:aws:iam:123456789012:role/emaccess>. For information on creating
1142             a monitoring role, go to Setting Up and Enabling Enhanced Monitoring.
1143              
1144             If C<MonitoringInterval> is set to a value other than 0, then you must
1145             supply a C<MonitoringRoleArn> value.
1146              
1147              
1148              
1149             =head2 MultiAZ => Bool
1150              
1151             Specifies if the DB instance is a Multi-AZ deployment. You cannot set
1152             the AvailabilityZone parameter if the MultiAZ parameter is set to true.
1153              
1154              
1155              
1156             =head2 OptionGroupName => Str
1157              
1158             Indicates that the DB instance should be associated with the specified
1159             option group.
1160              
1161             Permanent options, such as the TDE option for Oracle Advanced Security
1162             TDE, cannot be removed from an option group, and that option group
1163             cannot be removed from a DB instance once it is associated with a DB
1164             instance
1165              
1166              
1167              
1168             =head2 PerformanceInsightsKMSKeyId => Str
1169              
1170              
1171              
1172              
1173              
1174             =head2 Port => Int
1175              
1176             The port number on which the database accepts connections.
1177              
1178             B<MySQL>
1179              
1180             Default: C<3306>
1181              
1182             Valid Values: C<1150-65535>
1183              
1184             Type: Integer
1185              
1186             B<MariaDB>
1187              
1188             Default: C<3306>
1189              
1190             Valid Values: C<1150-65535>
1191              
1192             Type: Integer
1193              
1194             B<PostgreSQL>
1195              
1196             Default: C<5432>
1197              
1198             Valid Values: C<1150-65535>
1199              
1200             Type: Integer
1201              
1202             B<Oracle>
1203              
1204             Default: C<1521>
1205              
1206             Valid Values: C<1150-65535>
1207              
1208             B<SQL Server>
1209              
1210             Default: C<1433>
1211              
1212             Valid Values: C<1150-65535> except for C<1434>, C<3389>, C<47001>,
1213             C<49152>, and C<49152> through C<49156>.
1214              
1215             B<Amazon Aurora>
1216              
1217             Default: C<3306>
1218              
1219             Valid Values: C<1150-65535>
1220              
1221             Type: Integer
1222              
1223              
1224              
1225             =head2 PreferredBackupWindow => Str
1226              
1227             The daily time range during which automated backups are created if
1228             automated backups are enabled, using the C<BackupRetentionPeriod>
1229             parameter. For more information, see DB Instance Backups.
1230              
1231             B<Amazon Aurora>
1232              
1233             Not applicable. The daily time range for creating automated backups is
1234             managed by the DB cluster. For more information, see CreateDBCluster.
1235              
1236             Default: A 30-minute window selected at random from an 8-hour block of
1237             time per AWS Region. To see the time blocks available, see Adjusting
1238             the Preferred DB Instance Maintenance Window.
1239              
1240             Constraints:
1241              
1242             =over
1243              
1244             =item *
1245              
1246             Must be in the format C<hh24:mi-hh24:mi>.
1247              
1248             =item *
1249              
1250             Times should be in Universal Coordinated Time (UTC).
1251              
1252             =item *
1253              
1254             Must not conflict with the preferred maintenance window.
1255              
1256             =item *
1257              
1258             Must be at least 30 minutes.
1259              
1260             =back
1261              
1262              
1263              
1264              
1265             =head2 PreferredMaintenanceWindow => Str
1266              
1267             The weekly time range during which system maintenance can occur, in
1268             Universal Coordinated Time (UTC). For more information, see DB Instance
1269             Maintenance.
1270              
1271             Format: C<ddd:hh24:mi-ddd:hh24:mi>
1272              
1273             Default: A 30-minute window selected at random from an 8-hour block of
1274             time per AWS Region, occurring on a random day of the week. To see the
1275             time blocks available, see Adjusting the Preferred Maintenance Window
1276             in the I<Amazon RDS User Guide.>
1277              
1278             Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun
1279              
1280             Constraints: Minimum 30-minute window.
1281              
1282              
1283              
1284             =head2 PromotionTier => Int
1285              
1286             A value that specifies the order in which an Aurora Replica is promoted
1287             to the primary instance after a failure of the existing primary
1288             instance. For more information, see Fault Tolerance for an Aurora DB
1289             Cluster.
1290              
1291             Default: 1
1292              
1293             Valid Values: 0 - 15
1294              
1295              
1296              
1297             =head2 PubliclyAccessible => Bool
1298              
1299             Specifies the accessibility options for the DB instance. A value of
1300             true specifies an Internet-facing instance with a publicly resolvable
1301             DNS name, which resolves to a public IP address. A value of false
1302             specifies an internal instance with a DNS name that resolves to a
1303             private IP address.
1304              
1305             Default: The default behavior varies depending on whether a VPC has
1306             been requested or not. The following list shows the default behavior in
1307             each case.
1308              
1309             =over
1310              
1311             =item *
1312              
1313             B<Default VPC:> true
1314              
1315             =item *
1316              
1317             B<VPC:> false
1318              
1319             =back
1320              
1321             If no DB subnet group has been specified as part of the request and the
1322             PubliclyAccessible value has not been set, the DB instance will be
1323             publicly accessible. If a specific DB subnet group has been specified
1324             as part of the request and the PubliclyAccessible value has not been
1325             set, the DB instance will be private.
1326              
1327              
1328              
1329             =head2 StorageEncrypted => Bool
1330              
1331             Specifies whether the DB instance is encrypted.
1332              
1333             B<Amazon Aurora>
1334              
1335             Not applicable. The encryption for DB instances is managed by the DB
1336             cluster. For more information, see CreateDBCluster.
1337              
1338             Default: false
1339              
1340              
1341              
1342             =head2 StorageType => Str
1343              
1344             Specifies the storage type to be associated with the DB instance.
1345              
1346             Valid values: C<standard | gp2 | io1>
1347              
1348             If you specify C<io1>, you must also include a value for the C<Iops>
1349             parameter.
1350              
1351             Default: C<io1> if the C<Iops> parameter is specified; otherwise
1352             C<standard>
1353              
1354              
1355              
1356             =head2 Tags => ArrayRef[L<Paws::RDS::Tag>]
1357              
1358              
1359              
1360              
1361              
1362             =head2 TdeCredentialArn => Str
1363              
1364             The ARN from the Key Store with which to associate the instance for TDE
1365             encryption.
1366              
1367              
1368              
1369             =head2 TdeCredentialPassword => Str
1370              
1371             The password for the given ARN from the Key Store in order to access
1372             the device.
1373              
1374              
1375              
1376             =head2 Timezone => Str
1377              
1378             The time zone of the DB instance. The time zone parameter is currently
1379             supported only by Microsoft SQL Server.
1380              
1381              
1382              
1383             =head2 VpcSecurityGroupIds => ArrayRef[Str|Undef]
1384              
1385             A list of EC2 VPC security groups to associate with this DB instance.
1386              
1387             B<Amazon Aurora>
1388              
1389             Not applicable. The associated list of EC2 VPC security groups is
1390             managed by the DB cluster. For more information, see CreateDBCluster.
1391              
1392             Default: The default EC2 VPC security group for the DB subnet group's
1393             VPC.
1394              
1395              
1396              
1397              
1398             =head1 SEE ALSO
1399              
1400             This class forms part of L<Paws>, documenting arguments for method CreateDBInstance in L<Paws::RDS>
1401              
1402             =head1 BUGS and CONTRIBUTIONS
1403              
1404             The source code is located here: https://github.com/pplu/aws-sdk-perl
1405              
1406             Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues
1407              
1408             =cut
1409