---
title: "GET /#Action=RestoreDBInstanceFromS3"
method: GET
path: "/#Action=RestoreDBInstanceFromS3"
---

# GET /#Action=RestoreDBInstanceFromS3

`GET /#Action=RestoreDBInstanceFromS3`

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](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/MySQL.Procedural.Importing.html) in the _Amazon RDS User Guide._

This command doesn't apply to RDS Custom.

## Query parameters

- `DBName` string
- `DBInstanceIdentifier` string, required
- `AllocatedStorage` integer
- `DBInstanceClass` string, required
- `Engine` string, required
- `MasterUsername` string
- `MasterUserPassword` string
- `DBSecurityGroups` string[]
- `VpcSecurityGroupIds` string[]
- `AvailabilityZone` string
- `DBSubnetGroupName` string
- `PreferredMaintenanceWindow` string
- `DBParameterGroupName` string
- `BackupRetentionPeriod` integer
- `PreferredBackupWindow` string
- `Port` integer
- `MultiAZ` boolean
- `EngineVersion` string
- `AutoMinorVersionUpgrade` boolean
- `LicenseModel` string
- `Iops` integer
- `OptionGroupName` string
- `PubliclyAccessible` boolean
- `Tags` object[] — A list of tags. For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_Tagging.html">Tagging Amazon RDS Resources</a> in the <i>Amazon RDS User Guide.</i>
  - `Key` string — A key is the required name of the tag. The string value can be from 1 to 128 Unicode characters in length and can't be prefixed with <code>aws:</code> or <code>rds:</code>. The string can only contain only the set of Unicode letters, digits, white-space, '_', '.', ':', '/', '=', '+', '-', '@' (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$").
  - `Value` string — A value is the optional value of the tag. The string value can be from 1 to 256 Unicode characters in length and can't be prefixed with <code>aws:</code> or <code>rds:</code>. The string can only contain only the set of Unicode letters, digits, white-space, '_', '.', ':', '/', '=', '+', '-', '@' (Java regex: "^([\\p{L}\\p{Z}\\p{N}_.:/=+\\-@]*)$").
- `StorageType` string
- `StorageEncrypted` boolean
- `KmsKeyId` string
- `CopyTagsToSnapshot` boolean
- `MonitoringInterval` integer
- `MonitoringRoleArn` string
- `EnableIAMDatabaseAuthentication` boolean
- `SourceEngine` string, required
- `SourceEngineVersion` string, required
- `S3BucketName` string, required
- `S3Prefix` string
- `S3IngestionRoleArn` string, required
- `EnablePerformanceInsights` boolean
- `PerformanceInsightsKMSKeyId` string
- `PerformanceInsightsRetentionPeriod` integer
- `EnableCloudwatchLogsExports` String[]
- `ProcessorFeatures` object[]
  - `Name` string — The name of the processor feature. Valid names are <code>coreCount</code> and <code>threadsPerCore</code>.
  - `Value` string — The value of a processor feature name.
- `UseDefaultProcessorFeatures` boolean
- `DeletionProtection` boolean
- `MaxAllocatedStorage` integer
- `NetworkType` string
- `StorageThroughput` integer
- `ManageMasterUserPassword` boolean
- `MasterUserSecretKmsKeyId` string
- `Action` 'RestoreDBInstanceFromS3', required
- `Version` '2014-10-31', required

## Response `200`

Success

## Other responses

- `480` — DBInstanceAlreadyExistsFault
- `481` — InsufficientDBInstanceCapacityFault
- `482` — DBParameterGroupNotFoundFault
- `483` — DBSecurityGroupNotFoundFault
- `484` — InstanceQuotaExceededFault
- `485` — StorageQuotaExceededFault
- `486` — DBSubnetGroupNotFoundFault
- `487` — DBSubnetGroupDoesNotCoverEnoughAZs
- `488` — InvalidSubnet
- `489` — InvalidVPCNetworkStateFault
- `490` — InvalidS3BucketFault
- `491` — ProvisionedIopsNotAvailableInAZFault
- `492` — OptionGroupNotFoundFault
- `493` — StorageTypeNotSupportedFault
- `494` — AuthorizationNotFoundFault
- `495` — KMSKeyNotAccessibleFault
- `496` — BackupPolicyNotFoundFault
- `497` — NetworkTypeNotSupported

---

[API](https://skmtc.net/aws/apis/rds.md) · [All operations](https://skmtc.net/aws/apis/rds/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/rds/versions/e6b3ad7df19b/schema)