/// <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); }