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

# GET /#Action=RestoreDBClusterFromS3

`GET /#Action=RestoreDBClusterFromS3`

Creates an Amazon Aurora DB cluster from MySQL data stored in an Amazon S3 bucket. Amazon RDS must be authorized to access the Amazon S3 bucket and the data must be created using the Percona XtraBackup utility as described in [Migrating Data from MySQL by Using an Amazon S3 Bucket](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraMySQL.Migrating.ExtMySQL.html#AuroraMySQL.Migrating.ExtMySQL.S3) in the _Amazon Aurora User Guide_.

This action only restores the DB cluster, not the DB instances for that DB cluster. You must invoke the `CreateDBInstance` action to create DB instances for the restored DB cluster, specifying the identifier of the restored DB cluster in `DBClusterIdentifier`. You can create DB instances only after the `RestoreDBClusterFromS3` action has completed and the DB cluster is available.

For more information on Amazon Aurora, see [What is Amazon Aurora?](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html) in the _Amazon Aurora User Guide_.

This action only applies to Aurora DB clusters. The source DB engine must be MySQL.

## Query parameters

- `AvailabilityZones` string[]
- `BackupRetentionPeriod` integer
- `CharacterSetName` string
- `DatabaseName` string
- `DBClusterIdentifier` string, required
- `DBClusterParameterGroupName` string
- `VpcSecurityGroupIds` string[]
- `DBSubnetGroupName` string
- `Engine` string, required
- `EngineVersion` string
- `Port` integer
- `MasterUsername` string, required
- `MasterUserPassword` string
- `OptionGroupName` string
- `PreferredBackupWindow` string
- `PreferredMaintenanceWindow` string
- `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}_.:/=+\\-@]*)$").
- `StorageEncrypted` boolean
- `KmsKeyId` string
- `EnableIAMDatabaseAuthentication` boolean
- `SourceEngine` string, required
- `SourceEngineVersion` string, required
- `S3BucketName` string, required
- `S3Prefix` string
- `S3IngestionRoleArn` string, required
- `BacktrackWindow` integer
- `EnableCloudwatchLogsExports` String[]
- `DeletionProtection` boolean
- `CopyTagsToSnapshot` boolean
- `Domain` string
- `DomainIAMRoleName` string
- `ServerlessV2ScalingConfiguration` object — <p>Contains the scaling configuration of an Aurora Serverless v2 DB cluster.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.html">Using Amazon Aurora Serverless v2</a> in the <i>Amazon Aurora User Guide</i>.</p>
  - `MinCapacity` number, double — The minimum number of Aurora capacity units (ACUs) for a DB instance in an Aurora Serverless v2 cluster. You can specify ACU values in half-step increments, such as 8, 8.5, 9, and so on. The smallest value that you can use is 0.5.
  - `MaxCapacity` number, double — The maximum number of Aurora capacity units (ACUs) for a DB instance in an Aurora Serverless v2 cluster. You can specify ACU values in half-step increments, such as 40, 40.5, 41, and so on. The largest value that you can use is 128.
- `NetworkType` string
- `ManageMasterUserPassword` boolean
- `MasterUserSecretKmsKeyId` string
- `Action` 'RestoreDBClusterFromS3', required
- `Version` '2014-10-31', required

## Response `200`

Success

## Other responses

- `480` — DBClusterAlreadyExistsFault
- `481` — DBClusterQuotaExceededFault
- `482` — StorageQuotaExceededFault
- `483` — DBSubnetGroupNotFoundFault
- `484` — InvalidVPCNetworkStateFault
- `485` — InvalidDBClusterStateFault
- `486` — InvalidDBSubnetGroupStateFault
- `487` — InvalidSubnet
- `488` — InvalidS3BucketFault
- `489` — DBClusterParameterGroupNotFoundFault
- `490` — KMSKeyNotAccessibleFault
- `491` — DBClusterNotFoundFault
- `492` — DomainNotFoundFault
- `493` — InsufficientStorageClusterCapacityFault

---

[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)