# ByteMatchSet
<a name="API_wafRegional_ByteMatchSet"></a>

**Note**  
 Amazon WAF Classic support will end on September 30, 2025.   
This is ** Amazon WAF Classic** documentation. For more information, see [Amazon WAF Classic](https://docs.amazonaws.cn/waf/latest/developerguide/classic-waf-chapter.html) in the developer guide.  
 **For the latest version of Amazon WAF **, use the Amazon WAFV2 API and see the [Amazon WAF Developer Guide](https://docs.amazonaws.cn/waf/latest/developerguide/waf-chapter.html). With the latest version, Amazon WAF has a single set of endpoints for regional and global use. 

In a [GetByteMatchSet](API_wafRegional_GetByteMatchSet.md) request, `ByteMatchSet` is a complex type that contains the `ByteMatchSetId` and `Name` of a `ByteMatchSet`, and the values that you specified when you updated the `ByteMatchSet`. 

A complex type that contains `ByteMatchTuple` objects, which specify the parts of web requests that you want Amazon WAF to inspect and the values that you want Amazon WAF to search for. If a `ByteMatchSet` contains more than one `ByteMatchTuple` object, a request needs to match the settings in only one `ByteMatchTuple` to be considered a match.

## Contents
<a name="API_wafRegional_ByteMatchSet_Contents"></a>

 ** ByteMatchSetId **   <a name="WAF-Type-wafRegional_ByteMatchSet-ByteMatchSetId"></a>
The `ByteMatchSetId` for a `ByteMatchSet`. You use `ByteMatchSetId` to get information about a `ByteMatchSet` (see [GetByteMatchSet](API_wafRegional_GetByteMatchSet.md)), update a `ByteMatchSet` (see [UpdateByteMatchSet](API_wafRegional_UpdateByteMatchSet.md)), insert a `ByteMatchSet` into a `Rule` or delete one from a `Rule` (see [UpdateRule](API_wafRegional_UpdateRule.md)), and delete a `ByteMatchSet` from Amazon WAF (see [DeleteByteMatchSet](API_wafRegional_DeleteByteMatchSet.md)).  
 `ByteMatchSetId` is returned by [CreateByteMatchSet](API_wafRegional_CreateByteMatchSet.md) and by [ListByteMatchSets](API_wafRegional_ListByteMatchSets.md).  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `.*\S.*`   
Required: Yes

 ** ByteMatchTuples **   <a name="WAF-Type-wafRegional_ByteMatchSet-ByteMatchTuples"></a>
Specifies the bytes (typically a string that corresponds with ASCII characters) that you want Amazon WAF to search for in web requests, the location in requests that you want Amazon WAF to search, and other settings.  
Type: Array of [ByteMatchTuple](API_wafRegional_ByteMatchTuple.md) objects  
Required: Yes

 ** Name **   <a name="WAF-Type-wafRegional_ByteMatchSet-Name"></a>
A friendly name or description of the [ByteMatchSet](#API_wafRegional_ByteMatchSet). You can't change `Name` after you create a `ByteMatchSet`.  
Type: String  
Length Constraints: Minimum length of 1. Maximum length of 128.  
Pattern: `.*\S.*`   
Required: No

## See Also
<a name="API_wafRegional_ByteMatchSet_SeeAlso"></a>

For more information about using this API in one of the language-specific Amazon SDKs, see the following:
+  [Amazon SDK for C\$1\$1](https://docs.amazonaws.cn/goto/SdkForCpp/waf-regional-2016-11-28/ByteMatchSet) 
+  [Amazon SDK for Java V2](https://docs.amazonaws.cn/goto/SdkForJavaV2/waf-regional-2016-11-28/ByteMatchSet) 
+  [Amazon SDK for Ruby V3](https://docs.amazonaws.cn/goto/SdkForRubyV3/waf-regional-2016-11-28/ByteMatchSet)