/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.wafv2.model; import java.io.Serializable; import javax.annotation.Generated; import com.amazonaws.AmazonWebServiceRequest; /** * * @see AWS API * Documentation */ @Generated("com.amazonaws:aws-java-sdk-code-generator") public class UpdateRuleGroupRequest extends com.amazonaws.AmazonWebServiceRequest implements Serializable, Cloneable { /** *
* The name of the rule group. You cannot change the name of a rule group after you create it. *
*/ private String name; /** ** Specifies whether this is for an Amazon CloudFront distribution or for a regional application. A regional * application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, an * Amazon Cognito user pool, an App Runner service, or an Amazon Web Services Verified Access instance. *
** To work with CloudFront, you must also specify the Region US East (N. Virginia) as follows: *
*
* CLI - Specify the Region when you use the CloudFront scope: --scope=CLOUDFRONT --region=us-east-1
.
*
* API and SDKs - For all calls, use the Region endpoint us-east-1. *
** A unique identifier for the rule group. This ID is returned in the responses to create and list commands. You * provide it to operations like update and delete. *
*/ private String id; /** ** A description of the rule group that helps with identification. *
*/ private String description; /** ** The Rule statements used to identify the web requests that you want to allow, block, or count. Each rule * includes one top-level statement that WAF uses to identify matching web requests, and parameters that govern how * WAF handles them. *
*/ private java.util.List* Defines and enables Amazon CloudWatch metrics and web request sample collection. *
*/ private VisibilityConfig visibilityConfig; /** *
* A token used for optimistic locking. WAF returns a token to your get
and list
requests,
* to mark the state of the entity at the time of the request. To make changes to the entity associated with the
* token, you provide the token to operations like update
and delete
. WAF uses the token
* to ensure that no changes have been made to the entity since you last retrieved it. If a change has been made,
* the update fails with a WAFOptimisticLockException
. If this happens, perform another
* get
, and use the new token returned by that operation.
*
* A map of custom response keys and content bodies. When you create a rule with a block action, you can send a * custom response to the web request. You define these for the rule group, and then use them in the rules that you * define in the rule group. *
** For information about customizing web requests and responses, see Customizing web * requests and responses in WAF in the WAF Developer Guide. *
** For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer * Guide. *
*/ private java.util.Map* The name of the rule group. You cannot change the name of a rule group after you create it. *
* * @param name * The name of the rule group. You cannot change the name of a rule group after you create it. */ public void setName(String name) { this.name = name; } /** ** The name of the rule group. You cannot change the name of a rule group after you create it. *
* * @return The name of the rule group. You cannot change the name of a rule group after you create it. */ public String getName() { return this.name; } /** ** The name of the rule group. You cannot change the name of a rule group after you create it. *
* * @param name * The name of the rule group. You cannot change the name of a rule group after you create it. * @return Returns a reference to this object so that method calls can be chained together. */ public UpdateRuleGroupRequest withName(String name) { setName(name); return this; } /** ** Specifies whether this is for an Amazon CloudFront distribution or for a regional application. A regional * application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, an * Amazon Cognito user pool, an App Runner service, or an Amazon Web Services Verified Access instance. *
** To work with CloudFront, you must also specify the Region US East (N. Virginia) as follows: *
*
* CLI - Specify the Region when you use the CloudFront scope: --scope=CLOUDFRONT --region=us-east-1
.
*
* API and SDKs - For all calls, use the Region endpoint us-east-1. *
** To work with CloudFront, you must also specify the Region US East (N. Virginia) as follows: *
*
* CLI - Specify the Region when you use the CloudFront scope:
* --scope=CLOUDFRONT --region=us-east-1
.
*
* API and SDKs - For all calls, use the Region endpoint us-east-1. *
** Specifies whether this is for an Amazon CloudFront distribution or for a regional application. A regional * application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, an * Amazon Cognito user pool, an App Runner service, or an Amazon Web Services Verified Access instance. *
** To work with CloudFront, you must also specify the Region US East (N. Virginia) as follows: *
*
* CLI - Specify the Region when you use the CloudFront scope: --scope=CLOUDFRONT --region=us-east-1
.
*
* API and SDKs - For all calls, use the Region endpoint us-east-1. *
** To work with CloudFront, you must also specify the Region US East (N. Virginia) as follows: *
*
* CLI - Specify the Region when you use the CloudFront scope:
* --scope=CLOUDFRONT --region=us-east-1
.
*
* API and SDKs - For all calls, use the Region endpoint us-east-1. *
** Specifies whether this is for an Amazon CloudFront distribution or for a regional application. A regional * application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, an * Amazon Cognito user pool, an App Runner service, or an Amazon Web Services Verified Access instance. *
** To work with CloudFront, you must also specify the Region US East (N. Virginia) as follows: *
*
* CLI - Specify the Region when you use the CloudFront scope: --scope=CLOUDFRONT --region=us-east-1
.
*
* API and SDKs - For all calls, use the Region endpoint us-east-1. *
** To work with CloudFront, you must also specify the Region US East (N. Virginia) as follows: *
*
* CLI - Specify the Region when you use the CloudFront scope:
* --scope=CLOUDFRONT --region=us-east-1
.
*
* API and SDKs - For all calls, use the Region endpoint us-east-1. *
** Specifies whether this is for an Amazon CloudFront distribution or for a regional application. A regional * application can be an Application Load Balancer (ALB), an Amazon API Gateway REST API, an AppSync GraphQL API, an * Amazon Cognito user pool, an App Runner service, or an Amazon Web Services Verified Access instance. *
** To work with CloudFront, you must also specify the Region US East (N. Virginia) as follows: *
*
* CLI - Specify the Region when you use the CloudFront scope: --scope=CLOUDFRONT --region=us-east-1
.
*
* API and SDKs - For all calls, use the Region endpoint us-east-1. *
** To work with CloudFront, you must also specify the Region US East (N. Virginia) as follows: *
*
* CLI - Specify the Region when you use the CloudFront scope:
* --scope=CLOUDFRONT --region=us-east-1
.
*
* API and SDKs - For all calls, use the Region endpoint us-east-1. *
** A unique identifier for the rule group. This ID is returned in the responses to create and list commands. You * provide it to operations like update and delete. *
* * @param id * A unique identifier for the rule group. This ID is returned in the responses to create and list commands. * You provide it to operations like update and delete. */ public void setId(String id) { this.id = id; } /** ** A unique identifier for the rule group. This ID is returned in the responses to create and list commands. You * provide it to operations like update and delete. *
* * @return A unique identifier for the rule group. This ID is returned in the responses to create and list commands. * You provide it to operations like update and delete. */ public String getId() { return this.id; } /** ** A unique identifier for the rule group. This ID is returned in the responses to create and list commands. You * provide it to operations like update and delete. *
* * @param id * A unique identifier for the rule group. This ID is returned in the responses to create and list commands. * You provide it to operations like update and delete. * @return Returns a reference to this object so that method calls can be chained together. */ public UpdateRuleGroupRequest withId(String id) { setId(id); return this; } /** ** A description of the rule group that helps with identification. *
* * @param description * A description of the rule group that helps with identification. */ public void setDescription(String description) { this.description = description; } /** ** A description of the rule group that helps with identification. *
* * @return A description of the rule group that helps with identification. */ public String getDescription() { return this.description; } /** ** A description of the rule group that helps with identification. *
* * @param description * A description of the rule group that helps with identification. * @return Returns a reference to this object so that method calls can be chained together. */ public UpdateRuleGroupRequest withDescription(String description) { setDescription(description); return this; } /** ** The Rule statements used to identify the web requests that you want to allow, block, or count. Each rule * includes one top-level statement that WAF uses to identify matching web requests, and parameters that govern how * WAF handles them. *
* * @return The Rule statements used to identify the web requests that you want to allow, block, or count. * Each rule includes one top-level statement that WAF uses to identify matching web requests, and * parameters that govern how WAF handles them. */ public java.util.List* The Rule statements used to identify the web requests that you want to allow, block, or count. Each rule * includes one top-level statement that WAF uses to identify matching web requests, and parameters that govern how * WAF handles them. *
* * @param rules * The Rule statements used to identify the web requests that you want to allow, block, or count. Each * rule includes one top-level statement that WAF uses to identify matching web requests, and parameters that * govern how WAF handles them. */ public void setRules(java.util.Collection* The Rule statements used to identify the web requests that you want to allow, block, or count. Each rule * includes one top-level statement that WAF uses to identify matching web requests, and parameters that govern how * WAF handles them. *
** NOTE: This method appends the values to the existing list (if any). Use * {@link #setRules(java.util.Collection)} or {@link #withRules(java.util.Collection)} if you want to override the * existing values. *
* * @param rules * The Rule statements used to identify the web requests that you want to allow, block, or count. Each * rule includes one top-level statement that WAF uses to identify matching web requests, and parameters that * govern how WAF handles them. * @return Returns a reference to this object so that method calls can be chained together. */ public UpdateRuleGroupRequest withRules(Rule... rules) { if (this.rules == null) { setRules(new java.util.ArrayList* The Rule statements used to identify the web requests that you want to allow, block, or count. Each rule * includes one top-level statement that WAF uses to identify matching web requests, and parameters that govern how * WAF handles them. *
* * @param rules * The Rule statements used to identify the web requests that you want to allow, block, or count. Each * rule includes one top-level statement that WAF uses to identify matching web requests, and parameters that * govern how WAF handles them. * @return Returns a reference to this object so that method calls can be chained together. */ public UpdateRuleGroupRequest withRules(java.util.Collection* Defines and enables Amazon CloudWatch metrics and web request sample collection. *
* * @param visibilityConfig * Defines and enables Amazon CloudWatch metrics and web request sample collection. */ public void setVisibilityConfig(VisibilityConfig visibilityConfig) { this.visibilityConfig = visibilityConfig; } /** ** Defines and enables Amazon CloudWatch metrics and web request sample collection. *
* * @return Defines and enables Amazon CloudWatch metrics and web request sample collection. */ public VisibilityConfig getVisibilityConfig() { return this.visibilityConfig; } /** ** Defines and enables Amazon CloudWatch metrics and web request sample collection. *
* * @param visibilityConfig * Defines and enables Amazon CloudWatch metrics and web request sample collection. * @return Returns a reference to this object so that method calls can be chained together. */ public UpdateRuleGroupRequest withVisibilityConfig(VisibilityConfig visibilityConfig) { setVisibilityConfig(visibilityConfig); return this; } /** *
* A token used for optimistic locking. WAF returns a token to your get
and list
requests,
* to mark the state of the entity at the time of the request. To make changes to the entity associated with the
* token, you provide the token to operations like update
and delete
. WAF uses the token
* to ensure that no changes have been made to the entity since you last retrieved it. If a change has been made,
* the update fails with a WAFOptimisticLockException
. If this happens, perform another
* get
, and use the new token returned by that operation.
*
get
and list
* requests, to mark the state of the entity at the time of the request. To make changes to the entity
* associated with the token, you provide the token to operations like update
and
* delete
. WAF uses the token to ensure that no changes have been made to the entity since you
* last retrieved it. If a change has been made, the update fails with a
* WAFOptimisticLockException
. If this happens, perform another get
, and use the
* new token returned by that operation.
*/
public void setLockToken(String lockToken) {
this.lockToken = lockToken;
}
/**
*
* A token used for optimistic locking. WAF returns a token to your get
and list
requests,
* to mark the state of the entity at the time of the request. To make changes to the entity associated with the
* token, you provide the token to operations like update
and delete
. WAF uses the token
* to ensure that no changes have been made to the entity since you last retrieved it. If a change has been made,
* the update fails with a WAFOptimisticLockException
. If this happens, perform another
* get
, and use the new token returned by that operation.
*
get
and list
* requests, to mark the state of the entity at the time of the request. To make changes to the entity
* associated with the token, you provide the token to operations like update
and
* delete
. WAF uses the token to ensure that no changes have been made to the entity since you
* last retrieved it. If a change has been made, the update fails with a
* WAFOptimisticLockException
. If this happens, perform another get
, and use the
* new token returned by that operation.
*/
public String getLockToken() {
return this.lockToken;
}
/**
*
* A token used for optimistic locking. WAF returns a token to your get
and list
requests,
* to mark the state of the entity at the time of the request. To make changes to the entity associated with the
* token, you provide the token to operations like update
and delete
. WAF uses the token
* to ensure that no changes have been made to the entity since you last retrieved it. If a change has been made,
* the update fails with a WAFOptimisticLockException
. If this happens, perform another
* get
, and use the new token returned by that operation.
*
get
and list
* requests, to mark the state of the entity at the time of the request. To make changes to the entity
* associated with the token, you provide the token to operations like update
and
* delete
. WAF uses the token to ensure that no changes have been made to the entity since you
* last retrieved it. If a change has been made, the update fails with a
* WAFOptimisticLockException
. If this happens, perform another get
, and use the
* new token returned by that operation.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public UpdateRuleGroupRequest withLockToken(String lockToken) {
setLockToken(lockToken);
return this;
}
/**
* * A map of custom response keys and content bodies. When you create a rule with a block action, you can send a * custom response to the web request. You define these for the rule group, and then use them in the rules that you * define in the rule group. *
** For information about customizing web requests and responses, see Customizing web * requests and responses in WAF in the WAF Developer Guide. *
** For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer * Guide. *
* * @return A map of custom response keys and content bodies. When you create a rule with a block action, you can * send a custom response to the web request. You define these for the rule group, and then use them in the * rules that you define in the rule group. ** For information about customizing web requests and responses, see Customizing * web requests and responses in WAF in the WAF Developer Guide. *
*
* For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF
* Developer Guide.
*/
public java.util.Map
* A map of custom response keys and content bodies. When you create a rule with a block action, you can send a
* custom response to the web request. You define these for the rule group, and then use them in the rules that you
* define in the rule group.
*
* For information about customizing web requests and responses, see Customizing web
* requests and responses in WAF in the WAF Developer Guide.
*
* For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer
* Guide.
*
* For information about customizing web requests and responses, see Customizing * web requests and responses in WAF in the WAF Developer Guide. *
*
* For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF
* Developer Guide.
*/
public void setCustomResponseBodies(java.util.Map
* A map of custom response keys and content bodies. When you create a rule with a block action, you can send a
* custom response to the web request. You define these for the rule group, and then use them in the rules that you
* define in the rule group.
*
* For information about customizing web requests and responses, see Customizing web
* requests and responses in WAF in the WAF Developer Guide.
*
* For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF Developer
* Guide.
*
* For information about customizing web requests and responses, see Customizing * web requests and responses in WAF in the WAF Developer Guide. *
*
* For information about the limits on count and size for custom request and response settings, see WAF quotas in the WAF
* Developer Guide.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public UpdateRuleGroupRequest withCustomResponseBodies(java.util.Map