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