/* * 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.protocol.StructuredPojo; import com.amazonaws.protocol.ProtocolMarshaller; /** *
* High-level information for a managed rule set. *
** This is intended for use only by vendors of managed rule sets. Vendors are Amazon Web Services and Amazon Web * Services Marketplace sellers. *
*
* Vendors, you can use the managed rule set APIs to provide controlled rollout of your versioned managed rule group
* offerings for your customers. The APIs are ListManagedRuleSets
, GetManagedRuleSet
,
* PutManagedRuleSetVersions
, and UpdateManagedRuleSetVersionExpiryDate
.
*
* The name of the managed rule set. You use this, along with the rule set ID, to identify the rule set. *
** This name is assigned to the corresponding managed rule group, which your customers can access and use. *
*/ private String name; /** *
* A unique identifier for the managed rule set. The ID is returned in the responses to commands like
* list
. You provide it to operations like get
and update
.
*
* A description of the set that helps with identification. *
*/ private String description; /** *
* 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.
*
* The Amazon Resource Name (ARN) of the entity. *
*/ private String aRN; /** ** The label namespace prefix for the managed rule groups that are offered to customers from this managed rule set. * All labels that are added by rules in the managed rule group have this prefix. *
** The syntax for the label namespace prefix for a managed rule group is the following: *
*
* awswaf:managed:<vendor>:<rule group name>
:
*
* When a rule with a label matches a web request, WAF adds the fully qualified label to the request. A fully * qualified label is made up of the label namespace from the rule group or web ACL where the rule is defined and * the label from the rule, separated by a colon: *
*
* <label namespace>:<label from rule>
*
* The name of the managed rule set. You use this, along with the rule set ID, to identify the rule set. *
** This name is assigned to the corresponding managed rule group, which your customers can access and use. *
* * @param name * The name of the managed rule set. You use this, along with the rule set ID, to identify the rule set. ** This name is assigned to the corresponding managed rule group, which your customers can access and use. */ public void setName(String name) { this.name = name; } /** *
* The name of the managed rule set. You use this, along with the rule set ID, to identify the rule set. *
** This name is assigned to the corresponding managed rule group, which your customers can access and use. *
* * @return The name of the managed rule set. You use this, along with the rule set ID, to identify the rule set. ** This name is assigned to the corresponding managed rule group, which your customers can access and use. */ public String getName() { return this.name; } /** *
* The name of the managed rule set. You use this, along with the rule set ID, to identify the rule set. *
** This name is assigned to the corresponding managed rule group, which your customers can access and use. *
* * @param name * The name of the managed rule set. You use this, along with the rule set ID, to identify the rule set. ** This name is assigned to the corresponding managed rule group, which your customers can access and use. * @return Returns a reference to this object so that method calls can be chained together. */ public ManagedRuleSetSummary withName(String name) { setName(name); return this; } /** *
* A unique identifier for the managed rule set. The ID is returned in the responses to commands like
* list
. You provide it to operations like get
and update
.
*
list
. You provide it to operations like get
and update
.
*/
public void setId(String id) {
this.id = id;
}
/**
*
* A unique identifier for the managed rule set. The ID is returned in the responses to commands like
* list
. You provide it to operations like get
and update
.
*
list
. You provide it to operations like get
and update
.
*/
public String getId() {
return this.id;
}
/**
*
* A unique identifier for the managed rule set. The ID is returned in the responses to commands like
* list
. You provide it to operations like get
and update
.
*
list
. You provide it to operations like get
and update
.
* @return Returns a reference to this object so that method calls can be chained together.
*/
public ManagedRuleSetSummary withId(String id) {
setId(id);
return this;
}
/**
* * A description of the set that helps with identification. *
* * @param description * A description of the set that helps with identification. */ public void setDescription(String description) { this.description = description; } /** ** A description of the set that helps with identification. *
* * @return A description of the set that helps with identification. */ public String getDescription() { return this.description; } /** ** A description of the set that helps with identification. *
* * @param description * A description of the set that helps with identification. * @return Returns a reference to this object so that method calls can be chained together. */ public ManagedRuleSetSummary withDescription(String description) { setDescription(description); 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 ManagedRuleSetSummary withLockToken(String lockToken) {
setLockToken(lockToken);
return this;
}
/**
* * The Amazon Resource Name (ARN) of the entity. *
* * @param aRN * The Amazon Resource Name (ARN) of the entity. */ public void setARN(String aRN) { this.aRN = aRN; } /** ** The Amazon Resource Name (ARN) of the entity. *
* * @return The Amazon Resource Name (ARN) of the entity. */ public String getARN() { return this.aRN; } /** ** The Amazon Resource Name (ARN) of the entity. *
* * @param aRN * The Amazon Resource Name (ARN) of the entity. * @return Returns a reference to this object so that method calls can be chained together. */ public ManagedRuleSetSummary withARN(String aRN) { setARN(aRN); return this; } /** ** The label namespace prefix for the managed rule groups that are offered to customers from this managed rule set. * All labels that are added by rules in the managed rule group have this prefix. *
** The syntax for the label namespace prefix for a managed rule group is the following: *
*
* awswaf:managed:<vendor>:<rule group name>
:
*
* When a rule with a label matches a web request, WAF adds the fully qualified label to the request. A fully * qualified label is made up of the label namespace from the rule group or web ACL where the rule is defined and * the label from the rule, separated by a colon: *
*
* <label namespace>:<label from rule>
*
* The syntax for the label namespace prefix for a managed rule group is the following: *
*
* awswaf:managed:<vendor>:<rule group name>
:
*
* When a rule with a label matches a web request, WAF adds the fully qualified label to the request. A fully * qualified label is made up of the label namespace from the rule group or web ACL where the rule is defined * and the label from the rule, separated by a colon: *
*
* <label namespace>:<label from rule>
*
* The label namespace prefix for the managed rule groups that are offered to customers from this managed rule set. * All labels that are added by rules in the managed rule group have this prefix. *
** The syntax for the label namespace prefix for a managed rule group is the following: *
*
* awswaf:managed:<vendor>:<rule group name>
:
*
* When a rule with a label matches a web request, WAF adds the fully qualified label to the request. A fully * qualified label is made up of the label namespace from the rule group or web ACL where the rule is defined and * the label from the rule, separated by a colon: *
*
* <label namespace>:<label from rule>
*
* The syntax for the label namespace prefix for a managed rule group is the following: *
*
* awswaf:managed:<vendor>:<rule group name>
:
*
* When a rule with a label matches a web request, WAF adds the fully qualified label to the request. A * fully qualified label is made up of the label namespace from the rule group or web ACL where the rule is * defined and the label from the rule, separated by a colon: *
*
* <label namespace>:<label from rule>
*
* The label namespace prefix for the managed rule groups that are offered to customers from this managed rule set. * All labels that are added by rules in the managed rule group have this prefix. *
** The syntax for the label namespace prefix for a managed rule group is the following: *
*
* awswaf:managed:<vendor>:<rule group name>
:
*
* When a rule with a label matches a web request, WAF adds the fully qualified label to the request. A fully * qualified label is made up of the label namespace from the rule group or web ACL where the rule is defined and * the label from the rule, separated by a colon: *
*
* <label namespace>:<label from rule>
*
* The syntax for the label namespace prefix for a managed rule group is the following: *
*
* awswaf:managed:<vendor>:<rule group name>
:
*
* When a rule with a label matches a web request, WAF adds the fully qualified label to the request. A fully * qualified label is made up of the label namespace from the rule group or web ACL where the rule is defined * and the label from the rule, separated by a colon: *
*
* <label namespace>:<label from rule>
*