MonetizationFilter - AWS WAFV2
ContentsSee Also
Services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the AWS European Sovereign Cloud Region, see the AWS European Sovereign Cloud User Guide.

MonetizationFilter

A filter for narrowing monetization statistics and settlement record results. Specify a filter name and one or more values to match.

Filter behavior:

  • Multiple values within one filter: OR (match any)

  • Multiple filters: AND (all must match)

  • No duplicate filter names allowed (rejected with error)

  • Duplicate values within a filter are silently deduplicated

  • If no CurrencyMode filter is specified, defaults to REAL

Contents

Name

The filter name. Format: Key is a string, Value is a list of strings.

Enum-restricted (invalid values rejected):

  • CurrencyMode: REAL, TEST

  • ChainName: BASE, SOLANA, BASE_SEPOLIA, SOLANA_DEVNET

  • SettlementStatus: SETTLED, PENDING, FAILED, SERVICE_ERROR, SKIPPED_ORIGIN_ERROR, DUPLICATE

  • HttpSourceName: CF, ALB, APIGW, APPRUNNER, COGNITO, VERIFIED_ACCESS

ARN-validated:

  • WebACLArn: valid WAFv2 web ACL ARN

Free-text (any string up to 256 chars):

  • SourceName: The name of the bot. Populated from Bot Control verified bot labels.

  • SourceCategory: The category classification of the bot. From Bot Control categorization.

  • Intent: The declared intent of the bot request.

  • Organization: The organization operating the bot.

  • UriPathPrefix: The URI path of the request that was monetized.

  • RequestId: The AWS WAF request ID associated with the transaction. Matches the requestId in AWS WAF logs. Pattern: ^[a-zA-Z0-9:._\-=+/]+$

  • TransactionId: The blockchain transaction identifier. Pattern: ^[a-zA-Z0-9:._\-=+/]+$

  • TerminatingRuleName: The name of the AWS WAF rule that triggered the Monetize action.

  • PayerAddress: The blockchain wallet address of the paying client. Pattern: ^[a-zA-Z0-9:._\-=+/]+$

  • HttpSourceId: The identifier of the AWS resource associated with the web ACL (for example, CloudFront distribution ID).

Type: String

Length Constraints: Minimum length of 1. Maximum length of 128.

Required: Yes

Values

The values to filter on. Specify as a list of strings. Results match any of the specified values (OR logic). Duplicate values are silently deduplicated. Maximum: 20 values per filter.

Type: Array of strings

Array Members: Minimum number of 1 item. Maximum number of 20 items.

Length Constraints: Minimum length of 1. Maximum length of 256.

Required: Yes

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: