AWS SDK Version 3 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.

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 in the Amazon RDS User Guide.

This operation doesn't apply to RDS Custom.

Note:

This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginRestoreDBInstanceFromS3 and EndRestoreDBInstanceFromS3.

Namespace: Amazon.RDS
Assembly: AWSSDK.RDS.dll
Version: 3.x.y.z

Syntax

C#
public virtual Task<RestoreDBInstanceFromS3Response> RestoreDBInstanceFromS3Async(
         RestoreDBInstanceFromS3Request request,
         CancellationToken cancellationToken
)

Parameters

request
Type: Amazon.RDS.Model.RestoreDBInstanceFromS3Request

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

cancellationToken
Type: System.Threading.CancellationToken

A cancellation token that can be used by other objects or threads to receive notice of cancellation.

Return Value


The response from the RestoreDBInstanceFromS3 service method, as returned by RDS.

Exceptions

ExceptionCondition
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.
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.
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.
InvalidS3BucketException The specified Amazon S3 bucket name can't be found or Amazon RDS isn't authorized to access the specified Amazon S3 bucket. Verify the SourceS3BucketName and S3IngestionRoleArn values and try again.
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.
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.

Version Information

.NET Core App:
Supported in: 3.1

.NET Standard:
Supported in: 2.0

.NET Framework:
Supported in: 4.5

See Also