AWS SDK Version 2 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

.NET Framework 4.5
 
Creates a new DB instance from a DB snapshot. The target database is created from the source database restore point with the most of original configuration with the default security group and the default DB parameter group. By default, the new DB instance is created as a single-AZ deployment except when the instance is a SQL Server instance that has an option group that is associated with mirroring; in this case, the instance becomes a mirrored AZ deployment and not a single-AZ deployment.

If your intent is to replace your original DB instance with the new, restored DB instance, then rename your original DB instance before you call the RestoreDBInstanceFromDBSnapshot action. RDS does not allow two DB instances with the same name. Once you have renamed your original DB instance with a different identifier, then you can pass the original name of the DB instance as the DBInstanceIdentifier in the call to the RestoreDBInstanceFromDBSnapshot action. The result is that you will replace the original DB instance with the DB instance created from the snapshot.

If you are restoring from a shared manual DB snapshot, the DBSnapshotIdentifier must be the ARN of the shared DB snapshot.

Namespace: Amazon.RDS
Assembly: AWSSDK.dll
Version: (assembly version)

Syntax

C#
public virtual RestoreDBInstanceFromDBSnapshotResponse RestoreDBInstanceFromDBSnapshot(
         RestoreDBInstanceFromDBSnapshotRequest request
)

Parameters

request
Type: Amazon.RDS.Model.RestoreDBInstanceFromDBSnapshotRequest

Container for the necessary parameters to execute the RestoreDBInstanceFromDBSnapshot service method.

Return Value
Type: Amazon.RDS.Model.RestoreDBInstanceFromDBSnapshotResponse
The response from the RestoreDBInstanceFromDBSnapshot service method, as returned by RDS.

Exceptions

ExceptionCondition
AuthorizationNotFoundException Specified CIDRIP or EC2 security group is not authorized for the specified DB security group. RDS may not also be authorized via IAM to perform necessary actions on your behalf.
DBInstanceAlreadyExistsException User already has a DB instance with the given identifier.
DBSecurityGroupNotFoundException DBSecurityGroupName does not refer to an existing DB security group.
DBSnapshotNotFoundException DBSnapshotIdentifier does not refer to an existing DB snapshot.
DBSubnetGroupDoesNotCoverEnoughAZsException Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone.
DBSubnetGroupNotFoundException DBSubnetGroupName does not refer to an existing DB subnet group.
InstanceQuotaExceededException Request would result in user exceeding the allowed number of DB instances.
InsufficientDBInstanceCapacityException Specified DB instance class is not available in the specified Availability Zone.
InvalidDBSnapshotStateException The state of the DB snapshot does not allow deletion.
InvalidRestoreException Cannot restore from vpc backup to non-vpc DB instance.
InvalidSubnetException The requested subnet is invalid, or multiple subnets were requested that are not all in a common VPC.
InvalidVPCNetworkStateException DB subnet group does not cover all Availability Zones after it is created because users' change.
KMSKeyNotAccessibleException Error accessing KMS key.
OptionGroupNotFoundException The specified option group could not be found.
ProvisionedIopsNotAvailableInAZException Provisioned IOPS not available in the specified Availability Zone.
StorageQuotaExceededException Request would result in user exceeding the allowed amount of storage available across all DB instances.
StorageTypeNotSupportedException StorageType specified cannot be associated with the DB Instance.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5