Security::LogProfile::add_application_request_filter

Introduced : BIG-IP_v11.3.0
Adds a list of request filters to the existing list in Application Security. Request filter specifies a fundamental or detailed setting for the type of requests the system, or server logs. Every request filter has a generic form of key/values. For consistent configuration, when creating a new request filter with the specified key you must specify also the values.

Prototype

 add_application_request_filter(
    in String [] profile_names,
    in String [] [] applications,
    in FilterKey [] [] [] keys,
    in String [] [] [] [] values
);

Parameters

Parameter Type Description
profile_names String [] The names of the logging profiles.
applications String [] [] The Application Security sub-profile names.
keys FilterKey [] [] [] The keys of the request filters to add in Application Security for each profile. The available keys are mentioned under the FilterKey enumeration.
values String [] [] [] [] The values of the specified filter keys. The avaliable string values of every key are: Request type - “all” (All requests): Specifies that the system, or server, logs all requests. - “illegal” (Illegal requests only): Specifies that the system, or server, logs only illegal requests. This is the default. Protocols - “all”: Specifies that the system, or server, logs requests using the HTTP and HTTPS protocols. This is the default. - “http” (Only HTTP): Specifies that the system, or server, logs requests using only the HTTP protocol. - “https” (Only HTTPS): Specifies that the system, or server, logs requests using only the HTTPS protocol. Note that request type and protocols can have only one value. Response status codes - “all”: Specifies that the system, or server, logs all requests that generate all response status codes. This is the default. - Multiple numeric codes: Specifies that the system, or server, logs requests that generate these response status codes. HTTP methods - “all”: Specifies that the system, or server, logs requests using all HTTP methods. This is the default. - Multiple methods: Specifies the HTTP methods for which the system, or server, logs requests. Request containing string all - cannot have values. Other request containing string search in - one arbitrary non-empty string.

Return Type

Type Description
void  

Exceptions

Exception Description
Common::AccessDenied Raised if the client credentials are not valid.
Common::InvalidArgument Raised if one of the arguments is invalid.
Common::OperationFailed Raised if an operation error occurs.

See Also

iControl ::
iControl :: Security :: LogProfile

Warning

The links to the sample code below are remnants of the old DevCentral wiki and will result in a 404 error. For best results, please copy the link text and search the codeshare directly on DevCentral.

Sample Code


Copyright © 1996-2012, F5 Networks, Inc. All rights reserved.

The BIG-IP API Reference documentation contains community-contributed content. F5 does not monitor or control community code contributions. We make no guarantees or warranties regarding the available code, and it may contain errors, defects, bugs, inaccuracies, or security vulnerabilities. Your access to and use of any code available in the BIG-IP API reference guides is solely at your own risk.