Copyright | (c) 2013-2018 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay <brendan.g.hay+amazonka@gmail.com> |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | None |
Language | Haskell2010 |
Amazon Relational Database Service (Amazon RDS) supports importing MySQL databases by using backup files. You can create a backup of your on-premises database, store it on Amazon Simple Storage Service (Amazon S3), and then restore the backup file onto a new Amazon RDS DB instance running MySQL. For more information, see Importing Data into an Amazon RDS MySQL DB Instance .
- restoreDBInstanceFromS3 :: Text -> Text -> Text -> Text -> Text -> Text -> Text -> RestoreDBInstanceFromS3
- data RestoreDBInstanceFromS3
- rdifsEngineVersion :: Lens' RestoreDBInstanceFromS3 (Maybe Text)
- rdifsDBSecurityGroups :: Lens' RestoreDBInstanceFromS3 [Text]
- rdifsStorageEncrypted :: Lens' RestoreDBInstanceFromS3 (Maybe Bool)
- rdifsMasterUserPassword :: Lens' RestoreDBInstanceFromS3 (Maybe Text)
- rdifsPubliclyAccessible :: Lens' RestoreDBInstanceFromS3 (Maybe Bool)
- rdifsAutoMinorVersionUpgrade :: Lens' RestoreDBInstanceFromS3 (Maybe Bool)
- rdifsMasterUsername :: Lens' RestoreDBInstanceFromS3 (Maybe Text)
- rdifsDBSubnetGroupName :: Lens' RestoreDBInstanceFromS3 (Maybe Text)
- rdifsMonitoringRoleARN :: Lens' RestoreDBInstanceFromS3 (Maybe Text)
- rdifsIOPS :: Lens' RestoreDBInstanceFromS3 (Maybe Int)
- rdifsMonitoringInterval :: Lens' RestoreDBInstanceFromS3 (Maybe Int)
- rdifsLicenseModel :: Lens' RestoreDBInstanceFromS3 (Maybe Text)
- rdifsPreferredMaintenanceWindow :: Lens' RestoreDBInstanceFromS3 (Maybe Text)
- rdifsEnablePerformanceInsights :: Lens' RestoreDBInstanceFromS3 (Maybe Bool)
- rdifsKMSKeyId :: Lens' RestoreDBInstanceFromS3 (Maybe Text)
- rdifsDBParameterGroupName :: Lens' RestoreDBInstanceFromS3 (Maybe Text)
- rdifsPreferredBackupWindow :: Lens' RestoreDBInstanceFromS3 (Maybe Text)
- rdifsAvailabilityZone :: Lens' RestoreDBInstanceFromS3 (Maybe Text)
- rdifsBackupRetentionPeriod :: Lens' RestoreDBInstanceFromS3 (Maybe Int)
- rdifsPerformanceInsightsKMSKeyId :: Lens' RestoreDBInstanceFromS3 (Maybe Text)
- rdifsVPCSecurityGroupIds :: Lens' RestoreDBInstanceFromS3 [Text]
- rdifsMultiAZ :: Lens' RestoreDBInstanceFromS3 (Maybe Bool)
- rdifsS3Prefix :: Lens' RestoreDBInstanceFromS3 (Maybe Text)
- rdifsAllocatedStorage :: Lens' RestoreDBInstanceFromS3 (Maybe Int)
- rdifsOptionGroupName :: Lens' RestoreDBInstanceFromS3 (Maybe Text)
- rdifsCopyTagsToSnapshot :: Lens' RestoreDBInstanceFromS3 (Maybe Bool)
- rdifsTags :: Lens' RestoreDBInstanceFromS3 [Tag]
- rdifsPort :: Lens' RestoreDBInstanceFromS3 (Maybe Int)
- rdifsEnableIAMDatabaseAuthentication :: Lens' RestoreDBInstanceFromS3 (Maybe Bool)
- rdifsStorageType :: Lens' RestoreDBInstanceFromS3 (Maybe Text)
- rdifsEnableCloudwatchLogsExports :: Lens' RestoreDBInstanceFromS3 [Text]
- rdifsDBName :: Lens' RestoreDBInstanceFromS3 (Maybe Text)
- rdifsDBInstanceIdentifier :: Lens' RestoreDBInstanceFromS3 Text
- rdifsDBInstanceClass :: Lens' RestoreDBInstanceFromS3 Text
- rdifsEngine :: Lens' RestoreDBInstanceFromS3 Text
- rdifsSourceEngine :: Lens' RestoreDBInstanceFromS3 Text
- rdifsSourceEngineVersion :: Lens' RestoreDBInstanceFromS3 Text
- rdifsS3BucketName :: Lens' RestoreDBInstanceFromS3 Text
- rdifsS3IngestionRoleARN :: Lens' RestoreDBInstanceFromS3 Text
- restoreDBInstanceFromS3Response :: Int -> RestoreDBInstanceFromS3Response
- data RestoreDBInstanceFromS3Response
- rdifsrsDBInstance :: Lens' RestoreDBInstanceFromS3Response (Maybe DBInstance)
- rdifsrsResponseStatus :: Lens' RestoreDBInstanceFromS3Response Int
Creating a Request
restoreDBInstanceFromS3 Source #
Creates a value of RestoreDBInstanceFromS3
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
rdifsEngineVersion
- The version number of the database engine to use. Choose the latest minor version of your database engine as specified inCreateDBInstance
.rdifsDBSecurityGroups
- A list of DB security groups to associate with this DB instance. Default: The default DB security group for the database engine.rdifsStorageEncrypted
- Specifies whether the new DB instance is encrypted or not.rdifsMasterUserPassword
- The password for the master user. The password can include any printable ASCII character except "/", """, or "@". Constraints: Must contain from 8 to 41 characters.rdifsPubliclyAccessible
- Specifies whether the DB instance is publicly accessible or not. For more information, seeCreateDBInstance
.rdifsAutoMinorVersionUpgrade
- True to indicate that minor engine upgrades are applied automatically to the DB instance during the maintenance window, and otherwise false. Default:true
rdifsMasterUsername
- The name for the master user. Constraints: * Must be 1 to 16 letters or numbers. * First character must be a letter. * Cannot be a reserved word for the chosen database engine.rdifsDBSubnetGroupName
- A DB subnet group to associate with this DB instance.rdifsMonitoringRoleARN
- The ARN for the IAM role that permits RDS to send enhanced monitoring metrics to Amazon CloudWatch Logs. For example,arn:aws:iam:123456789012:role/emaccess
. For information on creating a monitoring role, see Setting Up and Enabling Enhanced Monitoring . IfMonitoringInterval
is set to a value other than 0, then you must supply aMonitoringRoleArn
value.rdifsIOPS
- The amount of Provisioned IOPS (inputoutput operations per second) to allocate initially for the DB instance. For information about valid Iops values, see see <http:docs.aws.amazon.comAmazonRDSlatestUserGuide/CHAP_Storage.html#USER_PIOPS Amazon RDS Provisioned IOPS Storage to Improve Performance> .rdifsMonitoringInterval
- The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance. To disable collecting Enhanced Monitoring metrics, specify 0. IfMonitoringRoleArn
is specified, then you must also setMonitoringInterval
to a value other than 0. Valid Values: 0, 1, 5, 10, 15, 30, 60 Default:0
rdifsLicenseModel
- The license model for this DB instance. Usegeneral-public-license
.rdifsPreferredMaintenanceWindow
- The time range each week during which system maintenance can occur, in Universal Coordinated Time (UTC). For more information, see Amazon RDS Maintenance Window . Constraints: * Must be in the formatddd:hh24:mi-ddd:hh24:mi
. * Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun. * Must be in Universal Coordinated Time (UTC). * Must not conflict with the preferred backup window. * Must be at least 30 minutes.rdifsEnablePerformanceInsights
- True to enable Performance Insights for the DB instance, and otherwise false.rdifsKMSKeyId
- The AWS KMS key identifier for an encrypted DB instance. The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are creating a DB instance with the same AWS account that owns the KMS encryption key used to encrypt the new DB instance, then you can use the KMS key alias instead of the ARN for the KM encryption key. If theStorageEncrypted
parameter is true, and you do not specify a value for theKmsKeyId
parameter, then Amazon RDS will use your default encryption key. AWS KMS creates the default encryption key for your AWS account. Your AWS account has a different default encryption key for each AWS Region.rdifsDBParameterGroupName
- The name of the DB parameter group to associate with this DB instance. If this argument is omitted, the default parameter group for the specified engine is used.rdifsPreferredBackupWindow
- The time range each day during which automated backups are created if automated backups are enabled. For more information, see The Backup Window . Constraints: * Must be in the formathh24:mi-hh24:mi
. * Must be in Universal Coordinated Time (UTC). * Must not conflict with the preferred maintenance window. * Must be at least 30 minutes.rdifsAvailabilityZone
- The Availability Zone that the DB instance is created in. For information about AWS Regions and Availability Zones, see Regions and Availability Zones . Default: A random, system-chosen Availability Zone in the endpoint's AWS Region. Example:us-east-1d
Constraint: The AvailabilityZone parameter can't be specified if the MultiAZ parameter is set totrue
. The specified Availability Zone must be in the same AWS Region as the current endpoint.rdifsBackupRetentionPeriod
- The number of days for which automated backups are retained. Setting this parameter to a positive number enables backups. For more information, seeCreateDBInstance
.rdifsPerformanceInsightsKMSKeyId
- The AWS KMS key identifier for encryption of Performance Insights data. The KMS key ID is the Amazon Resource Name (ARN), the KMS key identifier, or the KMS key alias for the KMS encryption key.rdifsVPCSecurityGroupIds
- A list of VPC security groups to associate with this DB instance.rdifsMultiAZ
- Specifies whether the DB instance is a Multi-AZ deployment. If MultiAZ is set totrue
, you can't set the AvailabilityZone parameter.rdifsS3Prefix
- The prefix of your Amazon S3 bucket.rdifsAllocatedStorage
- The amount of storage (in gigabytes) to allocate initially for the DB instance. Follow the allocation rules specified inCreateDBInstance
.rdifsOptionGroupName
- The name of the option group to associate with this DB instance. If this argument is omitted, the default option group for the specified engine is used.rdifsCopyTagsToSnapshot
- True to copy all tags from the DB instance to snapshots of the DB instance, and otherwise false. Default: false.rdifsTags
- A list of tags to associate with this DB instance. For more information, see Tagging Amazon RDS Resources .rdifsPort
- The port number on which the database accepts connections. Type: Integer Valid Values:1150
-65535
Default:3306
rdifsEnableIAMDatabaseAuthentication
- True to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts, and otherwise false. Default:false
rdifsStorageType
- Specifies the storage type to be associated with the DB instance. Valid values:standard
|gp2
|io1
If you specifyio1
, you must also include a value for theIops
parameter. Default:io1
if theIops
parameter is specified; otherwisestandard
rdifsEnableCloudwatchLogsExports
- The list of logs that the restored DB instance is to export to CloudWatch Logs.rdifsDBName
- The name of the database to create when the DB instance is created. Follow the naming rules specified inCreateDBInstance
.rdifsDBInstanceIdentifier
- The DB instance identifier. This parameter is stored as a lowercase string. Constraints: * Must contain from 1 to 63 letters, numbers, or hyphens. * First character must be a letter. * Cannot end with a hyphen or contain two consecutive hyphens. Example:mydbinstance
rdifsDBInstanceClass
- The compute and memory capacity of the DB instance, for example,db.m4.large
. Not all DB instance classes are available in all AWS Regions, or for all database engines. For the full list of DB instance classes, and availability for your engine, see DB Instance Class in the Amazon RDS User Guide. Importing from Amazon S3 is not supported on the db.t2.micro DB instance class.rdifsEngine
- The name of the database engine to be used for this instance. Valid Values:mysql
rdifsSourceEngine
- The name of the engine of your source database. Valid Values:mysql
rdifsSourceEngineVersion
- The engine version of your source database. Valid Values:5.6
rdifsS3BucketName
- The name of your Amazon S3 bucket that contains your database backup file.rdifsS3IngestionRoleARN
- An AWS Identity and Access Management (IAM) role to allow Amazon RDS to access your Amazon S3 bucket.
data RestoreDBInstanceFromS3 Source #
See: restoreDBInstanceFromS3
smart constructor.
Request Lenses
rdifsEngineVersion :: Lens' RestoreDBInstanceFromS3 (Maybe Text) Source #
The version number of the database engine to use. Choose the latest minor version of your database engine as specified in CreateDBInstance
.
rdifsDBSecurityGroups :: Lens' RestoreDBInstanceFromS3 [Text] Source #
A list of DB security groups to associate with this DB instance. Default: The default DB security group for the database engine.
rdifsStorageEncrypted :: Lens' RestoreDBInstanceFromS3 (Maybe Bool) Source #
Specifies whether the new DB instance is encrypted or not.
rdifsMasterUserPassword :: Lens' RestoreDBInstanceFromS3 (Maybe Text) Source #
The password for the master user. The password can include any printable ASCII character except "/", """, or "@". Constraints: Must contain from 8 to 41 characters.
rdifsPubliclyAccessible :: Lens' RestoreDBInstanceFromS3 (Maybe Bool) Source #
Specifies whether the DB instance is publicly accessible or not. For more information, see CreateDBInstance
.
rdifsAutoMinorVersionUpgrade :: Lens' RestoreDBInstanceFromS3 (Maybe Bool) Source #
True to indicate that minor engine upgrades are applied automatically to the DB instance during the maintenance window, and otherwise false. Default: true
rdifsMasterUsername :: Lens' RestoreDBInstanceFromS3 (Maybe Text) Source #
The name for the master user. Constraints: * Must be 1 to 16 letters or numbers. * First character must be a letter. * Cannot be a reserved word for the chosen database engine.
rdifsDBSubnetGroupName :: Lens' RestoreDBInstanceFromS3 (Maybe Text) Source #
A DB subnet group to associate with this DB instance.
rdifsMonitoringRoleARN :: Lens' RestoreDBInstanceFromS3 (Maybe Text) Source #
The ARN for the IAM role that permits RDS to send enhanced monitoring metrics to Amazon CloudWatch Logs. For example, arn:aws:iam:123456789012:role/emaccess
. For information on creating a monitoring role, see Setting Up and Enabling Enhanced Monitoring . If MonitoringInterval
is set to a value other than 0, then you must supply a MonitoringRoleArn
value.
rdifsIOPS :: Lens' RestoreDBInstanceFromS3 (Maybe Int) Source #
The amount of Provisioned IOPS (inputoutput operations per second) to allocate initially for the DB instance. For information about valid Iops values, see see <http:docs.aws.amazon.comAmazonRDSlatestUserGuide/CHAP_Storage.html#USER_PIOPS Amazon RDS Provisioned IOPS Storage to Improve Performance> .
rdifsMonitoringInterval :: Lens' RestoreDBInstanceFromS3 (Maybe Int) Source #
The interval, in seconds, between points when Enhanced Monitoring metrics are collected for the DB instance. To disable collecting Enhanced Monitoring metrics, specify 0. If MonitoringRoleArn
is specified, then you must also set MonitoringInterval
to a value other than 0. Valid Values: 0, 1, 5, 10, 15, 30, 60 Default: 0
rdifsLicenseModel :: Lens' RestoreDBInstanceFromS3 (Maybe Text) Source #
The license model for this DB instance. Use general-public-license
.
rdifsPreferredMaintenanceWindow :: Lens' RestoreDBInstanceFromS3 (Maybe Text) Source #
The time range each week during which system maintenance can occur, in Universal Coordinated Time (UTC). For more information, see Amazon RDS Maintenance Window . Constraints: * Must be in the format ddd:hh24:mi-ddd:hh24:mi
. * Valid Days: Mon, Tue, Wed, Thu, Fri, Sat, Sun. * Must be in Universal Coordinated Time (UTC). * Must not conflict with the preferred backup window. * Must be at least 30 minutes.
rdifsEnablePerformanceInsights :: Lens' RestoreDBInstanceFromS3 (Maybe Bool) Source #
True to enable Performance Insights for the DB instance, and otherwise false.
rdifsKMSKeyId :: Lens' RestoreDBInstanceFromS3 (Maybe Text) Source #
The AWS KMS key identifier for an encrypted DB instance. The KMS key identifier is the Amazon Resource Name (ARN) for the KMS encryption key. If you are creating a DB instance with the same AWS account that owns the KMS encryption key used to encrypt the new DB instance, then you can use the KMS key alias instead of the ARN for the KM encryption key. If the StorageEncrypted
parameter is true, and you do not specify a value for the KmsKeyId
parameter, then Amazon RDS will use your default encryption key. AWS KMS creates the default encryption key for your AWS account. Your AWS account has a different default encryption key for each AWS Region.
rdifsDBParameterGroupName :: Lens' RestoreDBInstanceFromS3 (Maybe Text) Source #
The name of the DB parameter group to associate with this DB instance. If this argument is omitted, the default parameter group for the specified engine is used.
rdifsPreferredBackupWindow :: Lens' RestoreDBInstanceFromS3 (Maybe Text) Source #
The time range each day during which automated backups are created if automated backups are enabled. For more information, see The Backup Window . Constraints: * Must be in the format hh24:mi-hh24:mi
. * Must be in Universal Coordinated Time (UTC). * Must not conflict with the preferred maintenance window. * Must be at least 30 minutes.
rdifsAvailabilityZone :: Lens' RestoreDBInstanceFromS3 (Maybe Text) Source #
The Availability Zone that the DB instance is created in. For information about AWS Regions and Availability Zones, see Regions and Availability Zones . Default: A random, system-chosen Availability Zone in the endpoint's AWS Region. Example: us-east-1d
Constraint: The AvailabilityZone parameter can't be specified if the MultiAZ parameter is set to true
. The specified Availability Zone must be in the same AWS Region as the current endpoint.
rdifsBackupRetentionPeriod :: Lens' RestoreDBInstanceFromS3 (Maybe Int) Source #
The number of days for which automated backups are retained. Setting this parameter to a positive number enables backups. For more information, see CreateDBInstance
.
rdifsPerformanceInsightsKMSKeyId :: Lens' RestoreDBInstanceFromS3 (Maybe Text) Source #
The AWS KMS key identifier for encryption of Performance Insights data. The KMS key ID is the Amazon Resource Name (ARN), the KMS key identifier, or the KMS key alias for the KMS encryption key.
rdifsVPCSecurityGroupIds :: Lens' RestoreDBInstanceFromS3 [Text] Source #
A list of VPC security groups to associate with this DB instance.
rdifsMultiAZ :: Lens' RestoreDBInstanceFromS3 (Maybe Bool) Source #
Specifies whether the DB instance is a Multi-AZ deployment. If MultiAZ is set to true
, you can't set the AvailabilityZone parameter.
rdifsS3Prefix :: Lens' RestoreDBInstanceFromS3 (Maybe Text) Source #
The prefix of your Amazon S3 bucket.
rdifsAllocatedStorage :: Lens' RestoreDBInstanceFromS3 (Maybe Int) Source #
The amount of storage (in gigabytes) to allocate initially for the DB instance. Follow the allocation rules specified in CreateDBInstance
.
rdifsOptionGroupName :: Lens' RestoreDBInstanceFromS3 (Maybe Text) Source #
The name of the option group to associate with this DB instance. If this argument is omitted, the default option group for the specified engine is used.
rdifsCopyTagsToSnapshot :: Lens' RestoreDBInstanceFromS3 (Maybe Bool) Source #
True to copy all tags from the DB instance to snapshots of the DB instance, and otherwise false. Default: false.
rdifsTags :: Lens' RestoreDBInstanceFromS3 [Tag] Source #
A list of tags to associate with this DB instance. For more information, see Tagging Amazon RDS Resources .
rdifsPort :: Lens' RestoreDBInstanceFromS3 (Maybe Int) Source #
The port number on which the database accepts connections. Type: Integer Valid Values: 1150
-65535
Default: 3306
rdifsEnableIAMDatabaseAuthentication :: Lens' RestoreDBInstanceFromS3 (Maybe Bool) Source #
True to enable mapping of AWS Identity and Access Management (IAM) accounts to database accounts, and otherwise false. Default: false
rdifsStorageType :: Lens' RestoreDBInstanceFromS3 (Maybe Text) Source #
Specifies the storage type to be associated with the DB instance. Valid values: standard
| gp2
| io1
If you specify io1
, you must also include a value for the Iops
parameter. Default: io1
if the Iops
parameter is specified; otherwise standard
rdifsEnableCloudwatchLogsExports :: Lens' RestoreDBInstanceFromS3 [Text] Source #
The list of logs that the restored DB instance is to export to CloudWatch Logs.
rdifsDBName :: Lens' RestoreDBInstanceFromS3 (Maybe Text) Source #
The name of the database to create when the DB instance is created. Follow the naming rules specified in CreateDBInstance
.
rdifsDBInstanceIdentifier :: Lens' RestoreDBInstanceFromS3 Text Source #
The DB instance identifier. This parameter is stored as a lowercase string. Constraints: * Must contain from 1 to 63 letters, numbers, or hyphens. * First character must be a letter. * Cannot end with a hyphen or contain two consecutive hyphens. Example: mydbinstance
rdifsDBInstanceClass :: Lens' RestoreDBInstanceFromS3 Text Source #
The compute and memory capacity of the DB instance, for example, db.m4.large
. Not all DB instance classes are available in all AWS Regions, or for all database engines. For the full list of DB instance classes, and availability for your engine, see DB Instance Class in the Amazon RDS User Guide. Importing from Amazon S3 is not supported on the db.t2.micro DB instance class.
rdifsEngine :: Lens' RestoreDBInstanceFromS3 Text Source #
The name of the database engine to be used for this instance. Valid Values: mysql
rdifsSourceEngine :: Lens' RestoreDBInstanceFromS3 Text Source #
The name of the engine of your source database. Valid Values: mysql
rdifsSourceEngineVersion :: Lens' RestoreDBInstanceFromS3 Text Source #
The engine version of your source database. Valid Values: 5.6
rdifsS3BucketName :: Lens' RestoreDBInstanceFromS3 Text Source #
The name of your Amazon S3 bucket that contains your database backup file.
rdifsS3IngestionRoleARN :: Lens' RestoreDBInstanceFromS3 Text Source #
An AWS Identity and Access Management (IAM) role to allow Amazon RDS to access your Amazon S3 bucket.
Destructuring the Response
restoreDBInstanceFromS3Response Source #
Creates a value of RestoreDBInstanceFromS3Response
with the minimum fields required to make a request.
Use one of the following lenses to modify other fields as desired:
rdifsrsDBInstance
- Undocumented member.rdifsrsResponseStatus
- -- | The response status code.
data RestoreDBInstanceFromS3Response Source #
See: restoreDBInstanceFromS3Response
smart constructor.
Response Lenses
rdifsrsDBInstance :: Lens' RestoreDBInstanceFromS3Response (Maybe DBInstance) Source #
Undocumented member.
rdifsrsResponseStatus :: Lens' RestoreDBInstanceFromS3Response Int Source #
- - | The response status code.