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

# GET /#Action=RestoreDBClusterFromSnapshot

`GET /#Action=RestoreDBClusterFromSnapshot`

Creates a new DB cluster from a DB snapshot or DB cluster snapshot.

The target DB cluster is created from the source snapshot with a default configuration. If you don't specify a security group, the new DB cluster is associated with the default security group.

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 `RestoreDBClusterFromSnapshot` action has completed and the DB cluster is available.

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

For more information on Multi-AZ DB clusters, see [Multi-AZ DB cluster deployments](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html) in the _Amazon RDS User Guide._

## Query parameters

- `AvailabilityZones` string[]
- `DBClusterIdentifier` string, required
- `SnapshotIdentifier` string, required
- `Engine` string, required
- `EngineVersion` string
- `Port` integer
- `DBSubnetGroupName` string
- `DatabaseName` string
- `OptionGroupName` string
- `VpcSecurityGroupIds` 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}_.:/=+\\-@]*)$").
- `KmsKeyId` string
- `EnableIAMDatabaseAuthentication` boolean
- `BacktrackWindow` integer
- `EnableCloudwatchLogsExports` String[]
- `EngineMode` string
- `ScalingConfiguration` object — <p>Contains the scaling configuration of an Aurora Serverless v1 DB cluster.</p> <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html">Using Amazon Aurora Serverless v1</a> in the <i>Amazon Aurora User Guide</i>.</p>
  - `MinCapacity` integer — <p>The minimum capacity for an Aurora DB cluster in <code>serverless</code> DB engine mode.</p> <p>For Aurora MySQL, valid capacity values are <code>1</code>, <code>2</code>, <code>4</code>, <code>8</code>, <code>16</code>, <code>32</code>, <code>64</code>, <code>128</code>, and <code>256</code>.</p> <p>For Aurora PostgreSQL, valid capacity values are <code>2</code>, <code>4</code>, <code>8</code>, <code>16</code>, <code>32</code>, <code>64</code>, <code>192</code>, and <code>384</code>.</p> <p>The minimum capacity must be less than or equal to the maximum capacity.</p>
  - `MaxCapacity` integer — <p>The maximum capacity for an Aurora DB cluster in <code>serverless</code> DB engine mode.</p> <p>For Aurora MySQL, valid capacity values are <code>1</code>, <code>2</code>, <code>4</code>, <code>8</code>, <code>16</code>, <code>32</code>, <code>64</code>, <code>128</code>, and <code>256</code>.</p> <p>For Aurora PostgreSQL, valid capacity values are <code>2</code>, <code>4</code>, <code>8</code>, <code>16</code>, <code>32</code>, <code>64</code>, <code>192</code>, and <code>384</code>.</p> <p>The maximum capacity must be greater than or equal to the minimum capacity.</p>
  - `AutoPause` boolean — <p>A value that indicates whether to allow or disallow automatic pause for an Aurora DB cluster in <code>serverless</code> DB engine mode. A DB cluster can be paused only when it's idle (it has no connections).</p> <note> <p>If a DB cluster is paused for more than seven days, the DB cluster might be backed up with a snapshot. In this case, the DB cluster is restored when there is a request to connect to it.</p> </note>
  - `SecondsUntilAutoPause` integer — <p>The time, in seconds, before an Aurora DB cluster in <code>serverless</code> mode is paused.</p> <p>Specify a value between 300 and 86,400 seconds.</p>
  - `TimeoutAction` string — <p>The action to take when the timeout is reached, either <code>ForceApplyCapacityChange</code> or <code>RollbackCapacityChange</code>.</p> <p> <code>ForceApplyCapacityChange</code> sets the capacity to the specified value as soon as possible.</p> <p> <code>RollbackCapacityChange</code>, the default, ignores the capacity change if a scaling point isn't found in the timeout period.</p> <important> <p>If you specify <code>ForceApplyCapacityChange</code>, connections that prevent Aurora Serverless v1 from finding a scaling point might be dropped.</p> </important> <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.how-it-works.html#aurora-serverless.how-it-works.auto-scaling"> Autoscaling for Aurora Serverless v1</a> in the <i>Amazon Aurora User Guide</i>.</p>
  - `SecondsBeforeTimeout` integer — <p>The amount of time, in seconds, that Aurora Serverless v1 tries to find a scaling point to perform seamless scaling before enforcing the timeout action. The default is 300.</p> <p>Specify a value between 60 and 600 seconds.</p>
- `DBClusterParameterGroupName` string
- `DeletionProtection` boolean
- `CopyTagsToSnapshot` boolean
- `Domain` string
- `DomainIAMRoleName` string
- `DBClusterInstanceClass` string
- `StorageType` string
- `Iops` integer
- `PubliclyAccessible` boolean
- `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
- `Action` 'RestoreDBClusterFromSnapshot', required
- `Version` '2014-10-31', required

## Response `200`

Success

## Other responses

- `480` — DBClusterAlreadyExistsFault
- `481` — DBClusterQuotaExceededFault
- `482` — StorageQuotaExceededFault
- `483` — DBSubnetGroupNotFoundFault
- `484` — DBSnapshotNotFoundFault
- `485` — DBClusterSnapshotNotFoundFault
- `486` — InsufficientDBClusterCapacityFault
- `487` — InsufficientStorageClusterCapacityFault
- `488` — InvalidDBSnapshotStateFault
- `489` — InvalidDBClusterSnapshotStateFault
- `490` — StorageQuotaExceededFault
- `491` — InvalidVPCNetworkStateFault
- `492` — InvalidRestoreFault
- `493` — DBSubnetGroupNotFoundFault
- `494` — InvalidSubnet
- `495` — OptionGroupNotFoundFault
- `496` — KMSKeyNotAccessibleFault
- `497` — DomainNotFoundFault
- `498` — DBClusterParameterGroupNotFoundFault
- `499` — InvalidDBInstanceStateFault

---

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