/// <summary>
/// Initiates the asynchronous execution of the UpdateWebACL operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the UpdateWebACL 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<UpdateWebACLResponse> UpdateWebACLAsync(UpdateWebACLRequest request, System.Threading.CancellationToken cancellationToken = default(CancellationToken))
{
var marshaller = new UpdateWebACLRequestMarshaller();
var unmarshaller = UpdateWebACLResponseUnmarshaller.Instance;
return InvokeAsync<UpdateWebACLRequest,UpdateWebACLResponse>(request, marshaller,
unmarshaller, cancellationToken);
}
/// <summary>
/// Inserts or deletes <a>ActivatedRule</a> objects in a <code>WebACL</code>. Each <code>Rule</code>
/// identifies web requests that you want to allow, block, or count. When you update a
/// <code>WebACL</code>, you specify the following values:
///
/// <ul> <li>
/// <para>
/// A default action for the <code>WebACL</code>, either <code>ALLOW</code> or <code>BLOCK</code>.
/// AWS WAF performs the default action if a request doesn't match the criteria in any
/// of the <code>Rules</code> in a <code>WebACL</code>.
/// </para>
/// </li> <li>
/// <para>
/// The <code>Rules</code> that you want to add and/or delete. If you want to replace
/// one <code>Rule</code> with another, you delete the existing <code>Rule</code> and
/// add the new one.
/// </para>
/// </li> <li>
/// <para>
/// For each <code>Rule</code>, whether you want AWS WAF to allow requests, block requests,
/// or count requests that match the conditions in the <code>Rule</code>.
/// </para>
/// </li> <li>
/// <para>
/// The order in which you want AWS WAF to evaluate the <code>Rules</code> in a <code>WebACL</code>.
/// If you add more than one <code>Rule</code> to a <code>WebACL</code>, AWS WAF evaluates
/// each request against the <code>Rules</code> in order based on the value of <code>Priority</code>.
/// (The <code>Rule</code> that has the lowest value for <code>Priority</code> is evaluated
/// first.) When a web request matches all of the predicates (such as <code>ByteMatchSets</code>
/// and <code>IPSets</code>) in a <code>Rule</code>, AWS WAF immediately takes the corresponding
/// action, allow or block, and doesn't evaluate the request against the remaining <code>Rules</code>
/// in the <code>WebACL</code>, if any.
/// </para>
/// </li> <li>
/// <para>
/// The CloudFront distribution that you want to associate with the <code>WebACL</code>.
/// </para>
/// </li> </ul>
/// <para>
/// To create and configure a <code>WebACL</code>, perform the following steps:
/// </para>
/// <ol> <li>
/// <para>
/// Create and update the predicates that you want to include in <code>Rules</code>. For
/// more information, see <a>CreateByteMatchSet</a>, <a>UpdateByteMatchSet</a>, <a>CreateIPSet</a>,
/// <a>UpdateIPSet</a>, <a>CreateSqlInjectionMatchSet</a>, and <a>UpdateSqlInjectionMatchSet</a>.
/// </para>
/// </li> <li>
/// <para>
/// Create and update the <code>Rules</code> that you want to include in the <code>WebACL</code>.
/// For more information, see <a>CreateRule</a> and <a>UpdateRule</a>.
/// </para>
/// </li> <li>
/// <para>
/// Create a <code>WebACL</code>. See <a>CreateWebACL</a>.
/// </para>
/// </li> <li>
/// <para>
/// Use <code>GetChangeToken</code> to get the change token that you provide in the <code>ChangeToken</code>
/// parameter of an <a>UpdateWebACL</a> request.
/// </para>
/// </li> <li>
/// <para>
/// Submit an <code>UpdateWebACL</code> request to specify the <code>Rules</code> that
/// you want to include in the <code>WebACL</code>, to specify the default action, and
/// to associate the <code>WebACL</code> with a CloudFront distribution.
/// </para>
/// </li> </ol>
/// <para>
/// For more information about how to use the AWS WAF API to allow or block HTTP requests,
/// see the <a href="http://docs.aws.amazon.com/waf/latest/developerguide/">AWS WAF Developer
/// Guide</a>.
/// </para>
/// </summary>
/// <param name="request">Container for the necessary parameters to execute the UpdateWebACL service method.</param>
///
/// <returns>The response from the UpdateWebACL service method, as returned by WAFRegional.</returns>
/// <exception cref="Amazon.WAFRegional.Model.WAFInternalErrorException">
/// The operation failed because of a system problem, even though the request was valid.
/// Retry your request.
/// </exception>
/// <exception cref="Amazon.WAFRegional.Model.WAFInvalidAccountException">
/// The operation failed because you tried to create, update, or delete an object by using
/// an invalid account identifier.
/// </exception>
/// <exception cref="Amazon.WAFRegional.Model.WAFInvalidOperationException">
/// The operation failed because there was nothing to do. For example:
///
/// <ul> <li>
/// <para>
/// You tried to remove a <code>Rule</code> from a <code>WebACL</code>, but the <code>Rule</code>
/// isn't in the specified <code>WebACL</code>.
/// </para>
/// </li> <li>
/// <para>
/// You tried to remove an IP address from an <code>IPSet</code>, but the IP address isn't
/// in the specified <code>IPSet</code>.
/// </para>
/// </li> <li>
/// <para>
/// You tried to remove a <code>ByteMatchTuple</code> from a <code>ByteMatchSet</code>,
/// but the <code>ByteMatchTuple</code> isn't in the specified <code>WebACL</code>.
/// </para>
/// </li> <li>
/// <para>
/// You tried to add a <code>Rule</code> to a <code>WebACL</code>, but the <code>Rule</code>
/// already exists in the specified <code>WebACL</code>.
/// </para>
/// </li> <li>
/// <para>
/// You tried to add an IP address to an <code>IPSet</code>, but the IP address already
/// exists in the specified <code>IPSet</code>.
/// </para>
/// </li> <li>
/// <para>
/// You tried to add a <code>ByteMatchTuple</code> to a <code>ByteMatchSet</code>, but
/// the <code>ByteMatchTuple</code> already exists in the specified <code>WebACL</code>.
/// </para>
/// </li> </ul>
/// </exception>
/// <exception cref="Amazon.WAFRegional.Model.WAFInvalidParameterException">
/// The operation failed because AWS WAF didn't recognize a parameter in the request.
/// For example:
///
/// <ul> <li>
/// <para>
/// You specified an invalid parameter name.
/// </para>
/// </li> <li>
/// <para>
/// You specified an invalid value.
/// </para>
/// </li> <li>
/// <para>
/// You tried to update an object (<code>ByteMatchSet</code>, <code>IPSet</code>, <code>Rule</code>,
/// or <code>WebACL</code>) using an action other than <code>INSERT</code> or <code>DELETE</code>.
/// </para>
/// </li> <li>
/// <para>
/// You tried to create a <code>WebACL</code> with a <code>DefaultAction</code> <code>Type</code>
/// other than <code>ALLOW</code>, <code>BLOCK</code>, or <code>COUNT</code>.
/// </para>
/// </li> <li>
/// <para>
/// You tried to update a <code>WebACL</code> with a <code>WafAction</code> <code>Type</code>
/// other than <code>ALLOW</code>, <code>BLOCK</code>, or <code>COUNT</code>.
/// </para>
/// </li> <li>
/// <para>
/// You tried to update a <code>ByteMatchSet</code> with a <code>FieldToMatch</code> <code>Type</code>
/// other than HEADER, QUERY_STRING, or URI.
/// </para>
/// </li> <li>
/// <para>
/// You tried to update a <code>ByteMatchSet</code> with a <code>Field</code> of <code>HEADER</code>
/// but no value for <code>Data</code>.
/// </para>
/// </li> <li>
/// <para>
/// Your request references an ARN that is malformed, or corresponds to a resource with
/// which a web ACL cannot be associated.
/// </para>
/// </li> </ul>
/// </exception>
/// <exception cref="Amazon.WAFRegional.Model.WAFLimitsExceededException">
/// The operation exceeds a resource limit, for example, the maximum number of <code>WebACL</code>
/// objects that you can create for an AWS account. For more information, see <a href="http://docs.aws.amazon.com/waf/latest/developerguide/limits.html">Limits</a>
/// in the <i>AWS WAF Developer Guide</i>.
/// </exception>
/// <exception cref="Amazon.WAFRegional.Model.WAFNonexistentContainerException">
/// The operation failed because you tried to add an object to or delete an object from
/// another object that doesn't exist. For example:
///
/// <ul> <li>
/// <para>
/// You tried to add a <code>Rule</code> to or delete a <code>Rule</code> from a <code>WebACL</code>
/// that doesn't exist.
/// </para>
/// </li> <li>
/// <para>
/// You tried to add a <code>ByteMatchSet</code> to or delete a <code>ByteMatchSet</code>
/// from a <code>Rule</code> that doesn't exist.
/// </para>
/// </li> <li>
/// <para>
/// You tried to add an IP address to or delete an IP address from an <code>IPSet</code>
/// that doesn't exist.
/// </para>
/// </li> <li>
/// <para>
/// You tried to add a <code>ByteMatchTuple</code> to or delete a <code>ByteMatchTuple</code>
/// from a <code>ByteMatchSet</code> that doesn't exist.
/// </para>
/// </li> </ul>
/// </exception>
/// <exception cref="Amazon.WAFRegional.Model.WAFNonexistentItemException">
/// The operation failed because the referenced object doesn't exist.
/// </exception>
/// <exception cref="Amazon.WAFRegional.Model.WAFReferencedItemException">
/// The operation failed because you tried to delete an object that is still in use. For
/// example:
///
/// <ul> <li>
/// <para>
/// You tried to delete a <code>ByteMatchSet</code> that is still referenced by a <code>Rule</code>.
/// </para>
/// </li> <li>
/// <para>
/// You tried to delete a <code>Rule</code> that is still referenced by a <code>WebACL</code>.
/// </para>
/// </li> </ul>
/// </exception>
/// <exception cref="Amazon.WAFRegional.Model.WAFStaleDataException">
/// The operation failed because you tried to create, update, or delete an object by using
/// a change token that has already been used.
/// </exception>
public UpdateWebACLResponse UpdateWebACL(UpdateWebACLRequest request)
{
var marshaller = new UpdateWebACLRequestMarshaller();
var unmarshaller = UpdateWebACLResponseUnmarshaller.Instance;
return Invoke<UpdateWebACLRequest,UpdateWebACLResponse>(request, marshaller, unmarshaller);
}
public object Execute(ExecutorContext context)
{
var cmdletContext = context as CmdletContext;
// create request
var request = new Amazon.WAFRegional.Model.UpdateWebACLRequest();
if (cmdletContext.ChangeToken != null)
{
request.ChangeToken = cmdletContext.ChangeToken;
}
// populate DefaultAction
var requestDefaultActionIsNull = true;
request.DefaultAction = new Amazon.WAFRegional.Model.WafAction();
Amazon.WAFRegional.WafActionType requestDefaultAction_defaultAction_Type = null;
if (cmdletContext.DefaultAction_Type != null)
{
requestDefaultAction_defaultAction_Type = cmdletContext.DefaultAction_Type;
}
if (requestDefaultAction_defaultAction_Type != null)
{
request.DefaultAction.Type = requestDefaultAction_defaultAction_Type;
requestDefaultActionIsNull = false;
}
// determine if request.DefaultAction should be set to null
if (requestDefaultActionIsNull)
{
request.DefaultAction = null;
}
if (cmdletContext.Update != null)
{
request.Updates = cmdletContext.Update;
}
if (cmdletContext.WebACLId != null)
{
request.WebACLId = cmdletContext.WebACLId;
}
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);
}
private Amazon.WAFRegional.Model.UpdateWebACLResponse CallAWSServiceOperation(IAmazonWAFRegional client, Amazon.WAFRegional.Model.UpdateWebACLRequest request)
{
Utils.Common.WriteVerboseEndpointMessage(this, client.Config, "AWS WAF Regional", "UpdateWebACL");
try
{
#if DESKTOP
return(client.UpdateWebACL(request));
#elif CORECLR
return(client.UpdateWebACLAsync(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;
}
}
/// <summary>
/// Initiates the asynchronous execution of the UpdateWebACL operation.
/// </summary>
///
/// <param name="request">Container for the necessary parameters to execute the UpdateWebACL operation on AmazonWAFRegionalClient.</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 EndUpdateWebACL
/// operation.</returns>
public IAsyncResult BeginUpdateWebACL(UpdateWebACLRequest request, AsyncCallback callback, object state)
{
var marshaller = new UpdateWebACLRequestMarshaller();
var unmarshaller = UpdateWebACLResponseUnmarshaller.Instance;
return BeginInvoke<UpdateWebACLRequest>(request, marshaller, unmarshaller,
callback, state);
}