/// <summary>
/// <para> Restores a DB Instance to an arbitrary point-in-time. Users can restore to any point in time before the latestRestorableTime for up
/// to backupRetentionPeriod days. The target database is created from the source database with the same configuration as the original database
/// except that the DB instance is created with the default DB security group. </para>
/// </summary>
///
/// <param name="restoreDBInstanceFromDBSnapshotRequest">Container for the necessary parameters to execute the RestoreDBInstanceFromDBSnapshot
/// service method on AmazonRDS.</param>
///
/// <returns>The response from the RestoreDBInstanceFromDBSnapshot service method, as returned by AmazonRDS.</returns>
///
/// <exception cref="InstanceQuotaExceededException"/>
/// <exception cref="DBInstanceAlreadyExistsException"/>
/// <exception cref="StorageQuotaExceededException"/>
/// <exception cref="InvalidDBSnapshotStateException"/>
/// <exception cref="InsufficientDBInstanceCapacityException"/>
/// <exception cref="DBSnapshotNotFoundException"/>
public RestoreDBInstanceFromDBSnapshotResponse RestoreDBInstanceFromDBSnapshot(RestoreDBInstanceFromDBSnapshotRequest restoreDBInstanceFromDBSnapshotRequest)
{
IRequest <RestoreDBInstanceFromDBSnapshotRequest> request = new RestoreDBInstanceFromDBSnapshotRequestMarshaller().Marshall(restoreDBInstanceFromDBSnapshotRequest);
RestoreDBInstanceFromDBSnapshotResponse response = Invoke <RestoreDBInstanceFromDBSnapshotRequest, RestoreDBInstanceFromDBSnapshotResponse> (request, this.signer, RestoreDBInstanceFromDBSnapshotResponseUnmarshaller.GetInstance());
return(response);
}
IAsyncResult invokeRestoreDBInstanceFromDBSnapshot(RestoreDBInstanceFromDBSnapshotRequest restoreDBInstanceFromDBSnapshotRequest, AsyncCallback callback, object state, bool synchronized)
{
IRequest irequest = new RestoreDBInstanceFromDBSnapshotRequestMarshaller().Marshall(restoreDBInstanceFromDBSnapshotRequest);
var unmarshaller = RestoreDBInstanceFromDBSnapshotResponseUnmarshaller.GetInstance();
AsyncResult result = new AsyncResult(irequest, callback, state, synchronized, signer, unmarshaller);
Invoke(result);
return result;
}
/// <summary>
/// Initiates the asynchronous execution of the RestoreDBInstanceFromDBSnapshot operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the RestoreDBInstanceFromDBSnapshot operation.</param>
/// <param name="cancellationToken">
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
/// </param>
/// <returns>The task object representing the asynchronous operation.</returns>
public Task<RestoreDBInstanceFromDBSnapshotResponse> RestoreDBInstanceFromDBSnapshotAsync(RestoreDBInstanceFromDBSnapshotRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken))
{
var marshaller = new RestoreDBInstanceFromDBSnapshotRequestMarshaller();
var unmarshaller = RestoreDBInstanceFromDBSnapshotResponseUnmarshaller.Instance;
return InvokeAsync<RestoreDBInstanceFromDBSnapshotRequest,RestoreDBInstanceFromDBSnapshotResponse>(request, marshaller,
unmarshaller, cancellationToken);
}
/// <summary>
/// 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, but in
/// a system chosen 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 AZ deployment and not a single-AZ deployment.
///
///
/// <para>
/// 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.
/// </para>
///
/// <para>
/// If you are restoring from a shared manual DB snapshot, the <code>DBSnapshotIdentifier</code>
/// must be the ARN of the shared DB snapshot.
/// </para>
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the RestoreDBInstanceFromDBSnapshot service method.</param>
///
/// <returns>The response from the RestoreDBInstanceFromDBSnapshot service method, as returned by RDS.</returns>
/// <exception cref="Amazon.RDS.Model.AuthorizationNotFoundException">
/// Specified CIDRIP or EC2 security group is not authorized for the specified DB security
/// group.
///
///
/// <para>
/// RDS may not also be authorized via IAM to perform necessary actions on your behalf.
/// </para>
/// </exception>
/// <exception cref="Amazon.RDS.Model.DBInstanceAlreadyExistsException">
/// User already has a DB instance with the given identifier.
/// </exception>
/// <exception cref="Amazon.RDS.Model.DBSecurityGroupNotFoundException">
/// <i>DBSecurityGroupName</i> does not refer to an existing DB security group.
/// </exception>
/// <exception cref="Amazon.RDS.Model.DBSnapshotNotFoundException">
/// <i>DBSnapshotIdentifier</i> does not refer to an existing DB snapshot.
/// </exception>
/// <exception cref="Amazon.RDS.Model.DBSubnetGroupDoesNotCoverEnoughAZsException">
/// Subnets in the DB subnet group should cover at least two Availability Zones unless
/// there is only one Availability Zone.
/// </exception>
/// <exception cref="Amazon.RDS.Model.DBSubnetGroupNotFoundException">
/// <i>DBSubnetGroupName</i> does not refer to an existing DB subnet group.
/// </exception>
/// <exception cref="Amazon.RDS.Model.InstanceQuotaExceededException">
/// Request would result in user exceeding the allowed number of DB instances.
/// </exception>
/// <exception cref="Amazon.RDS.Model.InsufficientDBInstanceCapacityException">
/// Specified DB instance class is not available in the specified Availability Zone.
/// </exception>
/// <exception cref="Amazon.RDS.Model.InvalidDBSnapshotStateException">
/// The state of the DB snapshot does not allow deletion.
/// </exception>
/// <exception cref="Amazon.RDS.Model.InvalidRestoreException">
/// Cannot restore from vpc backup to non-vpc DB instance.
/// </exception>
/// <exception cref="Amazon.RDS.Model.InvalidSubnetException">
/// The requested subnet is invalid, or multiple subnets were requested that are not
/// all in a common VPC.
/// </exception>
/// <exception cref="Amazon.RDS.Model.InvalidVPCNetworkStateException">
/// DB subnet group does not cover all Availability Zones after it is created because
/// users' change.
/// </exception>
/// <exception cref="Amazon.RDS.Model.KMSKeyNotAccessibleException">
/// Error accessing KMS key.
/// </exception>
/// <exception cref="Amazon.RDS.Model.OptionGroupNotFoundException">
/// The specified option group could not be found.
/// </exception>
/// <exception cref="Amazon.RDS.Model.ProvisionedIopsNotAvailableInAZException">
/// Provisioned IOPS not available in the specified Availability Zone.
/// </exception>
/// <exception cref="Amazon.RDS.Model.StorageQuotaExceededException">
/// Request would result in user exceeding the allowed amount of storage available across
/// all DB instances.
/// </exception>
/// <exception cref="Amazon.RDS.Model.StorageTypeNotSupportedException">
/// <i>StorageType</i> specified cannot be associated with the DB Instance.
/// </exception>
public RestoreDBInstanceFromDBSnapshotResponse RestoreDBInstanceFromDBSnapshot(RestoreDBInstanceFromDBSnapshotRequest request)
{
var marshaller = new RestoreDBInstanceFromDBSnapshotRequestMarshaller();
var unmarshaller = RestoreDBInstanceFromDBSnapshotResponseUnmarshaller.Instance;
return Invoke<RestoreDBInstanceFromDBSnapshotRequest,RestoreDBInstanceFromDBSnapshotResponse>(request, marshaller, unmarshaller);
}
/// <summary>
/// Initiates the asynchronous execution of the RestoreDBInstanceFromDBSnapshot operation.
/// <seealso cref="Amazon.RDS.IAmazonRDS.RestoreDBInstanceFromDBSnapshot"/>
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the RestoreDBInstanceFromDBSnapshot operation.</param>
/// <param name="cancellationToken">
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
/// </param>
/// <returns>The task object representing the asynchronous operation.</returns>
public Task<RestoreDBInstanceFromDBSnapshotResponse> RestoreDBInstanceFromDBSnapshotAsync(RestoreDBInstanceFromDBSnapshotRequest request, CancellationToken cancellationToken = default(CancellationToken))
{
var marshaller = new RestoreDBInstanceFromDBSnapshotRequestMarshaller();
var unmarshaller = RestoreDBInstanceFromDBSnapshotResponseUnmarshaller.GetInstance();
return Invoke<IRequest, RestoreDBInstanceFromDBSnapshotRequest, RestoreDBInstanceFromDBSnapshotResponse>(request, marshaller, unmarshaller, signer, cancellationToken);
}
public void RestoreDBInstanceFromDBSnapshotMarshallTest()
{
var operation = service_model.FindOperation("RestoreDBInstanceFromDBSnapshot");
var request = InstantiateClassGenerator.Execute<RestoreDBInstanceFromDBSnapshotRequest>();
var marshaller = new RestoreDBInstanceFromDBSnapshotRequestMarshaller();
var internalRequest = marshaller.Marshall(request);
var validator = new AWSQueryValidator(internalRequest.Parameters, request, service_model, operation);
validator.Validate();
var payloadResponse = new XmlSampleGenerator(service_model, operation).Execute();
var context = new XmlUnmarshallerContext(Utils.CreateStreamFromString(payloadResponse), false, null);
var response = RestoreDBInstanceFromDBSnapshotResponseUnmarshaller.Instance.Unmarshall(context)
as RestoreDBInstanceFromDBSnapshotResponse;
InstantiateClassGenerator.ValidateObjectFullyInstantiated(response);
}
/// <summary>
/// <para> Creates a new DB instance from a DB snapshot. The target database is created from the source database restore point with the same
/// configuration as the original source database, except that the new RDS instance is created with the default security group. </para>
/// </summary>
///
/// <param name="restoreDBInstanceFromDBSnapshotRequest">Container for the necessary parameters to execute the RestoreDBInstanceFromDBSnapshot
/// service method on AmazonRDS.</param>
///
/// <returns>The response from the RestoreDBInstanceFromDBSnapshot service method, as returned by AmazonRDS.</returns>
///
/// <exception cref="T:Amazon.RDS.Model.DBSubnetGroupNotFoundException" />
/// <exception cref="T:Amazon.RDS.Model.DBInstanceAlreadyExistsException" />
/// <exception cref="T:Amazon.RDS.Model.InvalidVPCNetworkStateException" />
/// <exception cref="T:Amazon.RDS.Model.InvalidDBSnapshotStateException" />
/// <exception cref="T:Amazon.RDS.Model.InvalidSubnetException" />
/// <exception cref="T:Amazon.RDS.Model.DBSnapshotNotFoundException" />
/// <exception cref="T:Amazon.RDS.Model.InvalidRestoreException" />
/// <exception cref="T:Amazon.RDS.Model.InstanceQuotaExceededException" />
/// <exception cref="T:Amazon.RDS.Model.StorageQuotaExceededException" />
/// <exception cref="T:Amazon.RDS.Model.InsufficientDBInstanceCapacityException" />
/// <exception cref="T:Amazon.RDS.Model.DBSubnetGroupDoesNotCoverEnoughAZsException" />
/// <exception cref="T:Amazon.RDS.Model.OptionGroupNotFoundException" />
/// <exception cref="T:Amazon.RDS.Model.ProvisionedIopsNotAvailableInAZException" />
/// <param name="cancellationToken">
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
/// </param>
public async Task<RestoreDBInstanceFromDBSnapshotResponse> RestoreDBInstanceFromDBSnapshotAsync(RestoreDBInstanceFromDBSnapshotRequest restoreDBInstanceFromDBSnapshotRequest, CancellationToken cancellationToken = default(CancellationToken))
{
var marshaller = new RestoreDBInstanceFromDBSnapshotRequestMarshaller();
var unmarshaller = RestoreDBInstanceFromDBSnapshotResponseUnmarshaller.GetInstance();
var response = await Invoke<IRequest, RestoreDBInstanceFromDBSnapshotRequest, RestoreDBInstanceFromDBSnapshotResponse>(restoreDBInstanceFromDBSnapshotRequest, marshaller, unmarshaller, signer, cancellationToken)
.ConfigureAwait(continueOnCapturedContext: false);
return response;
}
/// <summary>
/// Initiates the asynchronous execution of the RestoreDBInstanceFromDBSnapshot operation.
/// <seealso cref="Amazon.RDS.IAmazonRDS"/>
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the RestoreDBInstanceFromDBSnapshot operation on AmazonRDSClient.</param>
/// <param name="callback">An AsyncCallback delegate that is invoked when the operation completes.</param>
/// <param name="state">A user-defined state object that is passed to the callback procedure. Retrieve this object from within the callback
/// procedure using the AsyncState property.</param>
///
/// <returns>An IAsyncResult that can be used to poll or wait for results, or both; this value is also needed when invoking EndRestoreDBInstanceFromDBSnapshot
/// operation.</returns>
public IAsyncResult BeginRestoreDBInstanceFromDBSnapshot(RestoreDBInstanceFromDBSnapshotRequest request, AsyncCallback callback, object state)
{
var marshaller = new RestoreDBInstanceFromDBSnapshotRequestMarshaller();
var unmarshaller = RestoreDBInstanceFromDBSnapshotResponseUnmarshaller.Instance;
return BeginInvoke<RestoreDBInstanceFromDBSnapshotRequest>(request, marshaller, unmarshaller,
callback, state);
}
/// <summary>
/// <para> Creates a new DB Instance from a DB snapshot. The target database is created from the source database restore point with the same
/// configuration as the original source database, except that the new RDS instance is created with the default security group. </para>
/// </summary>
///
/// <param name="restoreDBInstanceFromDBSnapshotRequest">Container for the necessary parameters to execute the RestoreDBInstanceFromDBSnapshot
/// service method on AmazonRDS.</param>
///
/// <returns>The response from the RestoreDBInstanceFromDBSnapshot service method, as returned by AmazonRDS.</returns>
///
/// <exception cref="InvalidRestoreException"/>
/// <exception cref="InstanceQuotaExceededException"/>
/// <exception cref="DBSubnetGroupNotFoundException"/>
/// <exception cref="DBInstanceAlreadyExistsException"/>
/// <exception cref="StorageQuotaExceededException"/>
/// <exception cref="InvalidVPCNetworkStateException"/>
/// <exception cref="InvalidDBSnapshotStateException"/>
/// <exception cref="InsufficientDBInstanceCapacityException"/>
/// <exception cref="DBSnapshotNotFoundException"/>
public RestoreDBInstanceFromDBSnapshotResponse RestoreDBInstanceFromDBSnapshot(RestoreDBInstanceFromDBSnapshotRequest restoreDBInstanceFromDBSnapshotRequest)
{
IRequest<RestoreDBInstanceFromDBSnapshotRequest> request = new RestoreDBInstanceFromDBSnapshotRequestMarshaller().Marshall(restoreDBInstanceFromDBSnapshotRequest);
RestoreDBInstanceFromDBSnapshotResponse response = Invoke<RestoreDBInstanceFromDBSnapshotRequest, RestoreDBInstanceFromDBSnapshotResponse> (request, this.signer, RestoreDBInstanceFromDBSnapshotResponseUnmarshaller.GetInstance());
return response;
}
