/// <summary>
/// Initiates the asynchronous execution of the ModifyDBInstance operation.
/// <seealso cref="Amazon.RDS.AmazonRDS.ModifyDBInstance"/>
/// </summary>
///
/// <param name="modifyDBInstanceRequest">Container for the necessary parameters to execute the ModifyDBInstance operation on AmazonRDS.</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 EndModifyDBInstance
/// operation.</returns>
public IAsyncResult BeginModifyDBInstance(ModifyDBInstanceRequest modifyDBInstanceRequest, AsyncCallback callback, object state)
{
return invokeModifyDBInstance(modifyDBInstanceRequest, callback, state, false);
}
/// <summary>
/// <para> Modify settings for a DB Instance. You can change one or more database configuration parameters by specifying these parameters and
/// the new values in the request. </para>
/// </summary>
///
/// <param name="modifyDBInstanceRequest">Container for the necessary parameters to execute the ModifyDBInstance service method on
/// AmazonRDS.</param>
///
/// <returns>The response from the ModifyDBInstance service method, as returned by AmazonRDS.</returns>
///
/// <exception cref="DBParameterGroupNotFoundException"/>
/// <exception cref="DBInstanceAlreadyExistsException"/>
/// <exception cref="DBInstanceNotFoundException"/>
/// <exception cref="StorageQuotaExceededException"/>
/// <exception cref="InvalidVPCNetworkStateException"/>
/// <exception cref="InvalidDBInstanceStateException"/>
/// <exception cref="DBSecurityGroupNotFoundException"/>
/// <exception cref="InvalidDBSecurityGroupStateException"/>
/// <exception cref="InsufficientDBInstanceCapacityException"/>
/// <exception cref="DBUpgradeDependencyFailureException"/>
/// <exception cref="OptionGroupNotFoundException"/>
/// <exception cref="ProvisionedIopsNotAvailableInAZException"/>
public ModifyDBInstanceResponse ModifyDBInstance(ModifyDBInstanceRequest modifyDBInstanceRequest)
{
IAsyncResult asyncResult = invokeModifyDBInstance(modifyDBInstanceRequest, null, null, true);
return EndModifyDBInstance(asyncResult);
}
IAsyncResult invokeModifyDBInstance(ModifyDBInstanceRequest modifyDBInstanceRequest, AsyncCallback callback, object state, bool synchronized)
{
IRequest irequest = new ModifyDBInstanceRequestMarshaller().Marshall(modifyDBInstanceRequest);
var unmarshaller = ModifyDBInstanceResponseUnmarshaller.GetInstance();
AsyncResult result = new AsyncResult(irequest, callback, state, synchronized, signer, unmarshaller);
Invoke(result);
return result;
}
/// <summary>
/// Modify settings for a DB instance. You can change one or more database configuration
/// parameters by specifying these parameters and the new values in the request.
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the ModifyDBInstance service method.</param>
///
/// <returns>The response from the ModifyDBInstance 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.CertificateNotFoundException">
/// <i>CertificateIdentifier</i> does not refer to an existing certificate.
/// </exception>
/// <exception cref="Amazon.RDS.Model.DBInstanceAlreadyExistsException">
/// User already has a DB instance with the given identifier.
/// </exception>
/// <exception cref="Amazon.RDS.Model.DBInstanceNotFoundException">
/// <i>DBInstanceIdentifier</i> does not refer to an existing DB instance.
/// </exception>
/// <exception cref="Amazon.RDS.Model.DBParameterGroupNotFoundException">
/// <i>DBParameterGroupName</i> does not refer to an existing DB parameter group.
/// </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.DBUpgradeDependencyFailureException">
/// The DB upgrade failed because a resource the DB depends on could not be modified.
/// </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.InvalidDBInstanceStateException">
/// The specified DB instance is not in the <i>available</i> state.
/// </exception>
/// <exception cref="Amazon.RDS.Model.InvalidDBSecurityGroupStateException">
/// The state of the DB security group does not allow deletion.
/// </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.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 ModifyDBInstanceResponse ModifyDBInstance(ModifyDBInstanceRequest request)
{
var marshaller = new ModifyDBInstanceRequestMarshaller();
var unmarshaller = ModifyDBInstanceResponseUnmarshaller.Instance;
return Invoke<ModifyDBInstanceRequest,ModifyDBInstanceResponse>(request, marshaller, unmarshaller);
}
/// <summary>
/// Initiates the asynchronous execution of the ModifyDBInstance operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the ModifyDBInstance 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<ModifyDBInstanceResponse> ModifyDBInstanceAsync(ModifyDBInstanceRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken))
{
var marshaller = new ModifyDBInstanceRequestMarshaller();
var unmarshaller = ModifyDBInstanceResponseUnmarshaller.Instance;
return InvokeAsync<ModifyDBInstanceRequest,ModifyDBInstanceResponse>(request, marshaller,
unmarshaller, cancellationToken);
}
/// <summary>
/// <para> Modify settings for a DB instance. You can change one or more database configuration parameters by specifying these parameters and
/// the new values in the request. </para>
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the ModifyDBInstance service method on
/// AmazonRDS.</param>
///
/// <returns>The response from the ModifyDBInstance service method, as returned by AmazonRDS.</returns>
///
/// <exception cref="T:Amazon.RDS.Model.DBParameterGroupNotFoundException" />
/// <exception cref="T:Amazon.RDS.Model.DBInstanceAlreadyExistsException" />
/// <exception cref="T:Amazon.RDS.Model.DBInstanceNotFoundException" />
/// <exception cref="T:Amazon.RDS.Model.StorageQuotaExceededException" />
/// <exception cref="T:Amazon.RDS.Model.InvalidVPCNetworkStateException" />
/// <exception cref="T:Amazon.RDS.Model.InvalidDBInstanceStateException" />
/// <exception cref="T:Amazon.RDS.Model.DBSecurityGroupNotFoundException" />
/// <exception cref="T:Amazon.RDS.Model.InvalidDBSecurityGroupStateException" />
/// <exception cref="T:Amazon.RDS.Model.InsufficientDBInstanceCapacityException" />
/// <exception cref="T:Amazon.RDS.Model.DBUpgradeDependencyFailureException" />
/// <exception cref="T:Amazon.RDS.Model.OptionGroupNotFoundException" />
/// <exception cref="T:Amazon.RDS.Model.ProvisionedIopsNotAvailableInAZException" />
public ModifyDBInstanceResponse ModifyDBInstance(ModifyDBInstanceRequest request)
{
var task = ModifyDBInstanceAsync(request);
try
{
return task.Result;
}
catch(AggregateException e)
{
ExceptionDispatchInfo.Capture(e.InnerException).Throw();
return null;
}
}
/// <summary>
/// Initiates the asynchronous execution of the ModifyDBInstance operation.
/// <seealso cref="Amazon.RDS.IAmazonRDS.ModifyDBInstance"/>
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the ModifyDBInstance 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<ModifyDBInstanceResponse> ModifyDBInstanceAsync(ModifyDBInstanceRequest request, CancellationToken cancellationToken = default(CancellationToken))
{
var marshaller = new ModifyDBInstanceRequestMarshaller();
var unmarshaller = ModifyDBInstanceResponseUnmarshaller.GetInstance();
return Invoke<IRequest, ModifyDBInstanceRequest, ModifyDBInstanceResponse>(request, marshaller, unmarshaller, signer, cancellationToken);
}
/// <summary>
/// <para> Modify settings for a DB instance. You can change one or more database configuration parameters by specifying these parameters and
/// the new values in the request. </para>
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the ModifyDBInstance service method on
/// AmazonRDS.</param>
///
/// <returns>The response from the ModifyDBInstance service method, as returned by AmazonRDS.</returns>
///
/// <exception cref="T:Amazon.RDS.Model.DBParameterGroupNotFoundException" />
/// <exception cref="T:Amazon.RDS.Model.DBInstanceAlreadyExistsException" />
/// <exception cref="T:Amazon.RDS.Model.DBInstanceNotFoundException" />
/// <exception cref="T:Amazon.RDS.Model.StorageQuotaExceededException" />
/// <exception cref="T:Amazon.RDS.Model.InvalidVPCNetworkStateException" />
/// <exception cref="T:Amazon.RDS.Model.InvalidDBInstanceStateException" />
/// <exception cref="T:Amazon.RDS.Model.DBSecurityGroupNotFoundException" />
/// <exception cref="T:Amazon.RDS.Model.InvalidDBSecurityGroupStateException" />
/// <exception cref="T:Amazon.RDS.Model.InsufficientDBInstanceCapacityException" />
/// <exception cref="T:Amazon.RDS.Model.DBUpgradeDependencyFailureException" />
/// <exception cref="T:Amazon.RDS.Model.OptionGroupNotFoundException" />
/// <exception cref="T:Amazon.RDS.Model.ProvisionedIopsNotAvailableInAZException" />
public ModifyDBInstanceResponse ModifyDBInstance(ModifyDBInstanceRequest request)
{
var task = ModifyDBInstanceAsync(request);
try
{
return task.Result;
}
catch(AggregateException e)
{
throw e.InnerException;
}
}
/// <summary>
/// <para> Modify settings for a DB instance. You can change one or more database configuration parameters by specifying these parameters and
/// the new values in the request. </para>
/// </summary>
///
/// <param name="modifyDBInstanceRequest">Container for the necessary parameters to execute the ModifyDBInstance service method on
/// AmazonRDS.</param>
///
/// <returns>The response from the ModifyDBInstance service method, as returned by AmazonRDS.</returns>
///
/// <exception cref="T:Amazon.RDS.Model.DBParameterGroupNotFoundException" />
/// <exception cref="T:Amazon.RDS.Model.DBInstanceAlreadyExistsException" />
/// <exception cref="T:Amazon.RDS.Model.DBInstanceNotFoundException" />
/// <exception cref="T:Amazon.RDS.Model.StorageQuotaExceededException" />
/// <exception cref="T:Amazon.RDS.Model.InvalidVPCNetworkStateException" />
/// <exception cref="T:Amazon.RDS.Model.InvalidDBInstanceStateException" />
/// <exception cref="T:Amazon.RDS.Model.DBSecurityGroupNotFoundException" />
/// <exception cref="T:Amazon.RDS.Model.InvalidDBSecurityGroupStateException" />
/// <exception cref="T:Amazon.RDS.Model.InsufficientDBInstanceCapacityException" />
/// <exception cref="T:Amazon.RDS.Model.DBUpgradeDependencyFailureException" />
/// <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<ModifyDBInstanceResponse> ModifyDBInstanceAsync(ModifyDBInstanceRequest modifyDBInstanceRequest, CancellationToken cancellationToken = default(CancellationToken))
{
var marshaller = new ModifyDBInstanceRequestMarshaller();
var unmarshaller = ModifyDBInstanceResponseUnmarshaller.GetInstance();
var response = await Invoke<IRequest, ModifyDBInstanceRequest, ModifyDBInstanceResponse>(modifyDBInstanceRequest, marshaller, unmarshaller, signer, cancellationToken)
.ConfigureAwait(continueOnCapturedContext: false);
return response;
}
protected override void ProcessRecord()
{
AmazonRDS client = base.GetClient();
Amazon.RDS.Model.ModifyDBInstanceRequest request = new Amazon.RDS.Model.ModifyDBInstanceRequest();
request.DBInstanceIdentifier = this._DBInstanceIdentifier;
request.AllocatedStorage = this._AllocatedStorage;
request.DBInstanceClass = this._DBInstanceClass;
if (string.IsNullOrEmpty(this._DBSecurityGroups))
{
request.DBSecurityGroups.Add(this._DBSecurityGroups);
}
request.ApplyImmediately = this._ApplyImmediately;
request.MasterUserPassword = this._MasterUserPassword;
request.DBParameterGroupName = this._DBParameterGroupName;
request.BackupRetentionPeriod = this._BackupRetentionPeriod;
request.PreferredBackupWindow = this._PreferredBackupWindow;
request.PreferredMaintenanceWindow = this._PreferredMaintenanceWindow;
Amazon.RDS.Model.ModifyDBInstanceResponse response = client.ModifyDBInstance(request);
base.WriteObject(response.ModifyDBInstanceResult, true);
}
/// <summary>
/// Initiates the asynchronous execution of the ModifyDBInstance operation.
/// <seealso cref="Amazon.RDS.IAmazonRDS"/>
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the ModifyDBInstance 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 EndModifyDBInstance
/// operation.</returns>
public IAsyncResult BeginModifyDBInstance(ModifyDBInstanceRequest request, AsyncCallback callback, object state)
{
var marshaller = new ModifyDBInstanceRequestMarshaller();
var unmarshaller = ModifyDBInstanceResponseUnmarshaller.Instance;
return BeginInvoke<ModifyDBInstanceRequest>(request, marshaller, unmarshaller,
callback, state);
}
/// <summary>
/// <para> Modify settings for a DB Instance. You can change one or more database configuration parameters by specifying these parameters and
/// the new values in the request. </para>
/// </summary>
///
/// <param name="modifyDBInstanceRequest">Container for the necessary parameters to execute the ModifyDBInstance service method on
/// AmazonRDS.</param>
///
/// <returns>The response from the ModifyDBInstance service method, as returned by AmazonRDS.</returns>
///
/// <exception cref="DBParameterGroupNotFoundException"/>
/// <exception cref="DBInstanceNotFoundException"/>
/// <exception cref="StorageQuotaExceededException"/>
/// <exception cref="InvalidVPCNetworkStateException"/>
/// <exception cref="InvalidDBInstanceStateException"/>
/// <exception cref="DBSecurityGroupNotFoundException"/>
/// <exception cref="InvalidDBSecurityGroupStateException"/>
/// <exception cref="InsufficientDBInstanceCapacityException"/>
public ModifyDBInstanceResponse ModifyDBInstance(ModifyDBInstanceRequest modifyDBInstanceRequest)
{
IRequest<ModifyDBInstanceRequest> request = new ModifyDBInstanceRequestMarshaller().Marshall(modifyDBInstanceRequest);
ModifyDBInstanceResponse response = Invoke<ModifyDBInstanceRequest, ModifyDBInstanceResponse> (request, this.signer, ModifyDBInstanceResponseUnmarshaller.GetInstance());
return response;
}
