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.
Restores a DB instance to an arbitrary point in time. You can restore to any point
in time before the time identified by the LatestRestorableTime
property. You
can restore to a point up to the number of days specified by the BackupRetentionPeriod
property.
The target database is created with most of the original configuration, but in a system-selected Availability Zone, with the default security group, the default subnet 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 deployment and not a single-AZ deployment.
This operation doesn't apply to Aurora MySQL and Aurora PostgreSQL. For Aurora, use
RestoreDBClusterToPointInTime
.
For .NET Core this operation is only available in asynchronous form. Please refer to RestoreDBInstanceToPointInTimeAsync.
Namespace: Amazon.RDS
Assembly: AWSSDK.RDS.dll
Version: 3.x.y.z
public virtual RestoreDBInstanceToPointInTimeResponse RestoreDBInstanceToPointInTime( RestoreDBInstanceToPointInTimeRequest request )
Container for the necessary parameters to execute the RestoreDBInstanceToPointInTime service method.
Exception | Condition |
---|---|
AuthorizationNotFoundException | The specified CIDR IP range or Amazon EC2 security group might not be authorized for the specified DB security group. Or, RDS might not be authorized to perform necessary actions using IAM on your behalf. |
BackupPolicyNotFoundException | |
CertificateNotFoundException | CertificateIdentifier doesn't refer to an existing certificate. |
DBInstanceAlreadyExistsException | The user already has a DB instance with the given identifier. |
DBInstanceAutomatedBackupNotFoundException | No automated backup for this DB instance was found. |
DBInstanceNotFoundException | DBInstanceIdentifier doesn't refer to an existing DB instance. |
DBParameterGroupNotFoundException | DBParameterGroupName doesn't refer to an existing DB parameter group. |
DBSecurityGroupNotFoundException | DBSecurityGroupName doesn't refer to an existing DB security group. |
DBSubnetGroupDoesNotCoverEnoughAZsException | Subnets in the DB subnet group should cover at least two Availability Zones unless there is only one Availability Zone. |
DBSubnetGroupNotFoundException | DBSubnetGroupName doesn't refer to an existing DB subnet group. |
DomainNotFoundException | Domain doesn't refer to an existing Active Directory domain. |
InstanceQuotaExceededException | The request would result in the user exceeding the allowed number of DB instances. |
InsufficientDBInstanceCapacityException | The specified DB instance class isn't available in the specified Availability Zone. |
InvalidDBInstanceStateException | The DB instance isn't in a valid state. |
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 | The DB subnet group doesn't cover all Availability Zones after it's created because of users' change. |
KMSKeyNotAccessibleException | An error occurred accessing an Amazon Web Services KMS key. |
NetworkTypeNotSupportedException | The network type is invalid for the DB instance. Valid nework type values are IPV4 and DUAL. |
OptionGroupNotFoundException | The specified option group could not be found. |
PointInTimeRestoreNotEnabledException | SourceDBInstanceIdentifier refers to a DB instance with BackupRetentionPeriod equal to 0. |
ProvisionedIopsNotAvailableInAZException | Provisioned IOPS not available in the specified Availability Zone. |
StorageQuotaExceededException | The request would result in the user exceeding the allowed amount of storage available across all DB instances. |
StorageTypeNotSupportedException | The specified StorageType can't be associated with the DB instance. |
TenantDatabaseQuotaExceededException | You attempted to create more tenant databases than are permitted in your Amazon Web Services account. |
.NET Framework:
Supported in: 4.5, 4.0, 3.5