/// <summary>
/// Initiates the asynchronous execution of the ModifyCluster operation.
/// <seealso cref="Amazon.Redshift.IAmazonRedshift.ModifyCluster"/>
/// </summary>
///
/// <param name="modifyClusterRequest">Container for the necessary parameters to execute the ModifyCluster operation on AmazonRedshift.</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 EndModifyCluster
/// operation.</returns>
public IAsyncResult BeginModifyCluster(ModifyClusterRequest modifyClusterRequest, AsyncCallback callback, object state)
{
return invokeModifyCluster(modifyClusterRequest, callback, state, false);
}
IAsyncResult invokeModifyCluster(ModifyClusterRequest modifyClusterRequest, AsyncCallback callback, object state, bool synchronized)
{
IRequest irequest = new ModifyClusterRequestMarshaller().Marshall(modifyClusterRequest);
var unmarshaller = ModifyClusterResponseUnmarshaller.GetInstance();
AsyncResult result = new AsyncResult(irequest, callback, state, synchronized, signer, unmarshaller);
Invoke(result);
return result;
}
/// <summary>
/// Initiates the asynchronous execution of the ModifyCluster operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the ModifyCluster operation on AmazonRedshiftClient.</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 EndModifyCluster
/// operation.</returns>
public IAsyncResult BeginModifyCluster(ModifyClusterRequest request, AsyncCallback callback, object state)
{
var marshaller = new ModifyClusterRequestMarshaller();
var unmarshaller = ModifyClusterResponseUnmarshaller.Instance;
return BeginInvoke<ModifyClusterRequest>(request, marshaller, unmarshaller,
callback, state);
}
/// <summary>
/// <para> Modifies the settings for a cluster. For example, you can add another security or parameter group, update the preferred maintenance
/// window, or change the master user password. Resetting a cluster password or modifying the security groups associated with a cluster do not
/// need a reboot. However, modifying parameter group requires a reboot for parameters to take effect. For more information about managing
/// clusters, go to <a href="http://docs.aws.amazon.com/redshift/latest/mgmt/working-with-clusters.html" >Amazon Redshift Clusters</a> in the
/// <i>Amazon Redshift Management Guide</i> </para> <para>You can also change node type and the number of nodes to scale up or down the cluster.
/// When resizing a cluster, you must specify both the number of nodes and the node type even if one of the parameters does not change. If you
/// specify the same number of nodes and node type that are already configured for the cluster, an error is returned.</para>
/// </summary>
///
/// <param name="modifyClusterRequest">Container for the necessary parameters to execute the ModifyCluster service method on
/// AmazonRedshift.</param>
///
/// <returns>The response from the ModifyCluster service method, as returned by AmazonRedshift.</returns>
///
/// <exception cref="InvalidClusterSecurityGroupStateException"/>
/// <exception cref="HsmConfigurationNotFoundException"/>
/// <exception cref="InsufficientClusterCapacityException"/>
/// <exception cref="UnauthorizedOperationException"/>
/// <exception cref="InvalidClusterStateException"/>
/// <exception cref="NumberOfNodesQuotaExceededException"/>
/// <exception cref="ClusterNotFoundException"/>
/// <exception cref="UnsupportedOptionException"/>
/// <exception cref="ClusterSecurityGroupNotFoundException"/>
/// <exception cref="HsmClientCertificateNotFoundException"/>
/// <exception cref="ClusterParameterGroupNotFoundException"/>
public ModifyClusterResponse ModifyCluster(ModifyClusterRequest modifyClusterRequest)
{
IAsyncResult asyncResult = invokeModifyCluster(modifyClusterRequest, null, null, true);
return EndModifyCluster(asyncResult);
}
/// <summary>
/// <para> Modifies the settings for a cluster. For example, you can add another security or parameter group, update the preferred maintenance
/// window, or change the master user password. Resetting a cluster password or modifying the security groups associated with a cluster do not
/// need a reboot. However, modifying parameter group requires a reboot for parameters to take effect. For more information about managing
/// clusters, go to <a href="http://docs.aws.amazon.com/redshift/latest/mgmt/working-with-clusters.html">Amazon Redshift Clusters</a> in the
/// <i>Amazon Redshift Management Guide</i> </para> <para>You can also change node type and the number of nodes to scale up or down the cluster.
/// When resizing a cluster, you must specify both the number of nodes and the node type even if one of the parameters does not change. If you
/// specify the same number of nodes and node type that are already configured for the cluster, an error is returned.</para>
/// </summary>
///
/// <param name="modifyClusterRequest">Container for the necessary parameters to execute the ModifyCluster service method on
/// AmazonRedshift.</param>
///
/// <returns>The response from the ModifyCluster service method, as returned by AmazonRedshift.</returns>
///
/// <exception cref="T:Amazon.Redshift.Model.InvalidClusterSecurityGroupStateException" />
/// <exception cref="T:Amazon.Redshift.Model.HsmConfigurationNotFoundException" />
/// <exception cref="T:Amazon.Redshift.Model.InsufficientClusterCapacityException" />
/// <exception cref="T:Amazon.Redshift.Model.UnauthorizedOperationException" />
/// <exception cref="T:Amazon.Redshift.Model.InvalidClusterStateException" />
/// <exception cref="T:Amazon.Redshift.Model.NumberOfNodesQuotaExceededException" />
/// <exception cref="T:Amazon.Redshift.Model.ClusterNotFoundException" />
/// <exception cref="T:Amazon.Redshift.Model.UnsupportedOptionException" />
/// <exception cref="T:Amazon.Redshift.Model.ClusterSecurityGroupNotFoundException" />
/// <exception cref="T:Amazon.Redshift.Model.HsmClientCertificateNotFoundException" />
/// <exception cref="T:Amazon.Redshift.Model.ClusterParameterGroupNotFoundException" />
/// <param name="cancellationToken">
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
/// </param>
public Task<ModifyClusterResponse> ModifyClusterAsync(ModifyClusterRequest modifyClusterRequest, CancellationToken cancellationToken = default(CancellationToken))
{
var marshaller = new ModifyClusterRequestMarshaller();
var unmarshaller = ModifyClusterResponseUnmarshaller.GetInstance();
return Invoke<IRequest, ModifyClusterRequest, ModifyClusterResponse>(modifyClusterRequest, marshaller, unmarshaller, signer, cancellationToken);
}
/// <summary>
/// Modifies the settings for a cluster. For example, you can add another security or
/// parameter group, update the preferred maintenance window, or change the master user
/// password. Resetting a cluster password or modifying the security groups associated
/// with a cluster do not need a reboot. However, modifying a parameter group requires
/// a reboot for parameters to take effect. For more information about managing clusters,
/// go to <a href="http://docs.aws.amazon.com/redshift/latest/mgmt/working-with-clusters.html">Amazon
/// Redshift Clusters</a> in the <i>Amazon Redshift Cluster Management Guide</i> .
///
///
/// <para>
/// You can also change node type and the number of nodes to scale up or down the cluster.
/// When resizing a cluster, you must specify both the number of nodes and the node type
/// even if one of the parameters does not change.
/// </para>
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the ModifyCluster service method.</param>
///
/// <returns>The response from the ModifyCluster service method, as returned by Redshift.</returns>
/// <exception cref="Amazon.Redshift.Model.ClusterAlreadyExistsException">
/// The account already has a cluster with the given identifier.
/// </exception>
/// <exception cref="Amazon.Redshift.Model.ClusterNotFoundException">
/// The <i>ClusterIdentifier</i> parameter does not refer to an existing cluster.
/// </exception>
/// <exception cref="Amazon.Redshift.Model.ClusterParameterGroupNotFoundException">
/// The parameter group name does not refer to an existing parameter group.
/// </exception>
/// <exception cref="Amazon.Redshift.Model.ClusterSecurityGroupNotFoundException">
/// The cluster security group name does not refer to an existing cluster security group.
/// </exception>
/// <exception cref="Amazon.Redshift.Model.HsmClientCertificateNotFoundException">
/// There is no Amazon Redshift HSM client certificate with the specified identifier.
/// </exception>
/// <exception cref="Amazon.Redshift.Model.HsmConfigurationNotFoundException">
/// There is no Amazon Redshift HSM configuration with the specified identifier.
/// </exception>
/// <exception cref="Amazon.Redshift.Model.InsufficientClusterCapacityException">
/// The number of nodes specified exceeds the allotted capacity of the cluster.
/// </exception>
/// <exception cref="Amazon.Redshift.Model.InvalidClusterSecurityGroupStateException">
/// The state of the cluster security group is not <code>available</code>.
/// </exception>
/// <exception cref="Amazon.Redshift.Model.InvalidClusterStateException">
/// The specified cluster is not in the <code>available</code> state.
/// </exception>
/// <exception cref="Amazon.Redshift.Model.LimitExceededException">
/// The encryption key has exceeded its grant limit in AWS KMS.
/// </exception>
/// <exception cref="Amazon.Redshift.Model.NumberOfNodesQuotaExceededException">
/// The operation would exceed the number of nodes allotted to the account. For information
/// about increasing your quota, go to <a href="http://docs.aws.amazon.com/redshift/latest/mgmt/amazon-redshift-limits.html">Limits
/// in Amazon Redshift</a> in the <i>Amazon Redshift Cluster Management Guide</i>.
/// </exception>
/// <exception cref="Amazon.Redshift.Model.UnauthorizedOperationException">
/// Your account is not authorized to perform the requested operation.
/// </exception>
/// <exception cref="Amazon.Redshift.Model.UnsupportedOptionException">
/// A request option was specified that is not supported.
/// </exception>
public ModifyClusterResponse ModifyCluster(ModifyClusterRequest request)
{
var marshaller = new ModifyClusterRequestMarshaller();
var unmarshaller = ModifyClusterResponseUnmarshaller.Instance;
return Invoke<ModifyClusterRequest,ModifyClusterResponse>(request, marshaller, unmarshaller);
}
private Amazon.Redshift.Model.ModifyClusterResponse CallAWSServiceOperation(IAmazonRedshift client, Amazon.Redshift.Model.ModifyClusterRequest request)
{
Utils.Common.WriteVerboseEndpointMessage(this, client.Config, "Amazon Redshift", "ModifyCluster");
try
{
#if DESKTOP
return(client.ModifyCluster(request));
#elif CORECLR
return(client.ModifyClusterAsync(request).GetAwaiter().GetResult());
#else
#error "Unknown build edition"
#endif
}
catch (AmazonServiceException exc)
{
var webException = exc.InnerException as System.Net.WebException;
if (webException != null)
{
throw new Exception(Utils.Common.FormatNameResolutionFailureMessage(client.Config, webException.Message), webException);
}
throw;
}
}
internal ModifyClusterResponse ModifyCluster(ModifyClusterRequest request)
{
var task = ModifyClusterAsync(request);
try
{
return task.Result;
}
catch(AggregateException e)
{
ExceptionDispatchInfo.Capture(e.InnerException).Throw();
return null;
}
}
public object Execute(ExecutorContext context)
{
var cmdletContext = context as CmdletContext;
// create request
var request = new Amazon.Redshift.Model.ModifyClusterRequest();
if (cmdletContext.AllowVersionUpgrade != null)
{
request.AllowVersionUpgrade = cmdletContext.AllowVersionUpgrade.Value;
}
if (cmdletContext.AutomatedSnapshotRetentionPeriod != null)
{
request.AutomatedSnapshotRetentionPeriod = cmdletContext.AutomatedSnapshotRetentionPeriod.Value;
}
if (cmdletContext.ClusterIdentifier != null)
{
request.ClusterIdentifier = cmdletContext.ClusterIdentifier;
}
if (cmdletContext.ClusterParameterGroupName != null)
{
request.ClusterParameterGroupName = cmdletContext.ClusterParameterGroupName;
}
if (cmdletContext.ClusterSecurityGroup != null)
{
request.ClusterSecurityGroups = cmdletContext.ClusterSecurityGroup;
}
if (cmdletContext.ClusterType != null)
{
request.ClusterType = cmdletContext.ClusterType;
}
if (cmdletContext.ClusterVersion != null)
{
request.ClusterVersion = cmdletContext.ClusterVersion;
}
if (cmdletContext.ElasticIp != null)
{
request.ElasticIp = cmdletContext.ElasticIp;
}
if (cmdletContext.Encrypted != null)
{
request.Encrypted = cmdletContext.Encrypted.Value;
}
if (cmdletContext.EnhancedVpcRouting != null)
{
request.EnhancedVpcRouting = cmdletContext.EnhancedVpcRouting.Value;
}
if (cmdletContext.HsmClientCertificateIdentifier != null)
{
request.HsmClientCertificateIdentifier = cmdletContext.HsmClientCertificateIdentifier;
}
if (cmdletContext.HsmConfigurationIdentifier != null)
{
request.HsmConfigurationIdentifier = cmdletContext.HsmConfigurationIdentifier;
}
if (cmdletContext.KmsKeyId != null)
{
request.KmsKeyId = cmdletContext.KmsKeyId;
}
if (cmdletContext.MaintenanceTrackName != null)
{
request.MaintenanceTrackName = cmdletContext.MaintenanceTrackName;
}
if (cmdletContext.ManualSnapshotRetentionPeriod != null)
{
request.ManualSnapshotRetentionPeriod = cmdletContext.ManualSnapshotRetentionPeriod.Value;
}
if (cmdletContext.MasterUserPassword != null)
{
request.MasterUserPassword = cmdletContext.MasterUserPassword;
}
if (cmdletContext.NewClusterIdentifier != null)
{
request.NewClusterIdentifier = cmdletContext.NewClusterIdentifier;
}
if (cmdletContext.NodeType != null)
{
request.NodeType = cmdletContext.NodeType;
}
if (cmdletContext.NumberOfNodes != null)
{
request.NumberOfNodes = cmdletContext.NumberOfNodes.Value;
}
if (cmdletContext.PreferredMaintenanceWindow != null)
{
request.PreferredMaintenanceWindow = cmdletContext.PreferredMaintenanceWindow;
}
if (cmdletContext.PubliclyAccessible != null)
{
request.PubliclyAccessible = cmdletContext.PubliclyAccessible.Value;
}
if (cmdletContext.VpcSecurityGroupId != null)
{
request.VpcSecurityGroupIds = cmdletContext.VpcSecurityGroupId;
}
CmdletOutput output;
// issue call
var client = Client ?? CreateClient(_CurrentCredentials, _RegionEndpoint);
try
{
var response = CallAWSServiceOperation(client, request);
object pipelineOutput = null;
pipelineOutput = cmdletContext.Select(response, this);
output = new CmdletOutput
{
PipelineOutput = pipelineOutput,
ServiceResponse = response
};
}
catch (Exception e)
{
output = new CmdletOutput {
ErrorResponse = e
};
}
return(output);
}
/// <summary>
/// <para> Modifies the settings for a cluster. For example, you can add another security or parameter group, update the preferred maintenance
/// window, or change the master user password. Resetting a cluster password or modifying the security groups associated with a cluster do not
/// need a reboot. However, modifying parameter group requires a reboot for parameters to take effect. For more information about managing
/// clusters, go to <a href="http://docs.aws.amazon.com/redshift/latest/mgmt/working-with-clusters.html">Amazon Redshift Clusters</a> in the
/// <i>Amazon Redshift Management Guide</i> </para> <para>You can also change node type and the number of nodes to scale up or down the cluster.
/// When resizing a cluster, you must specify both the number of nodes and the node type even if one of the parameters does not change. If you
/// specify the same number of nodes and node type that are already configured for the cluster, an error is returned.</para>
/// </summary>
///
/// <param name="modifyClusterRequest">Container for the necessary parameters to execute the ModifyCluster service method on
/// AmazonRedshift.</param>
///
/// <returns>The response from the ModifyCluster service method, as returned by AmazonRedshift.</returns>
///
/// <exception cref="T:Amazon.Redshift.Model.InvalidClusterSecurityGroupStateException" />
/// <exception cref="T:Amazon.Redshift.Model.HsmConfigurationNotFoundException" />
/// <exception cref="T:Amazon.Redshift.Model.InsufficientClusterCapacityException" />
/// <exception cref="T:Amazon.Redshift.Model.UnauthorizedOperationException" />
/// <exception cref="T:Amazon.Redshift.Model.InvalidClusterStateException" />
/// <exception cref="T:Amazon.Redshift.Model.NumberOfNodesQuotaExceededException" />
/// <exception cref="T:Amazon.Redshift.Model.ClusterNotFoundException" />
/// <exception cref="T:Amazon.Redshift.Model.UnsupportedOptionException" />
/// <exception cref="T:Amazon.Redshift.Model.ClusterSecurityGroupNotFoundException" />
/// <exception cref="T:Amazon.Redshift.Model.HsmClientCertificateNotFoundException" />
/// <exception cref="T:Amazon.Redshift.Model.ClusterParameterGroupNotFoundException" />
/// <param name="cancellationToken">
/// A cancellation token that can be used by other objects or threads to receive notice of cancellation.
/// </param>
public async Task<ModifyClusterResponse> ModifyClusterAsync(ModifyClusterRequest modifyClusterRequest, CancellationToken cancellationToken = default(CancellationToken))
{
var marshaller = new ModifyClusterRequestMarshaller();
var unmarshaller = ModifyClusterResponseUnmarshaller.GetInstance();
var response = await Invoke<IRequest, ModifyClusterRequest, ModifyClusterResponse>(modifyClusterRequest, marshaller, unmarshaller, signer, cancellationToken)
.ConfigureAwait(continueOnCapturedContext: false);
return response;
}
internal ModifyClusterResponse ModifyCluster(ModifyClusterRequest request)
{
var task = ModifyClusterAsync(request);
try
{
return task.Result;
}
catch(AggregateException e)
{
throw e.InnerException;
}
}
/// <summary>
/// Initiates the asynchronous execution of the ModifyCluster operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the ModifyCluster 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<ModifyClusterResponse> ModifyClusterAsync(ModifyClusterRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken))
{
var marshaller = new ModifyClusterRequestMarshaller();
var unmarshaller = ModifyClusterResponseUnmarshaller.Instance;
return InvokeAsync<ModifyClusterRequest,ModifyClusterResponse>(request, marshaller,
unmarshaller, cancellationToken);
}
IAsyncResult invokeModifyCluster(ModifyClusterRequest request, AsyncCallback callback, object state, bool synchronized)
{
var marshaller = new ModifyClusterRequestMarshaller();
var unmarshaller = ModifyClusterResponseUnmarshaller.Instance;
return Invoke(request, callback, state, synchronized, marshaller, unmarshaller, signer);
}