AWS WAF

AWS WAF Waf Logging Configuration API

The Waf Logging Configuration API from AWS WAF — 4 operation(s) for waf logging configuration.

GitHub OpenAPI

Operations 4

POST /#DeleteLoggingConfiguration Delete Logging Configuration #
POST /#GetLoggingConfiguration Get Logging Configuration #
POST /#ListLoggingConfigurations List Logging Configurations #
POST /#PutLoggingConfiguration Put Logging Configuration #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/aws-waf/openapi/aws-waf-logging-configuration-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/aws-waf:aws-waf-logging-configuration-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

aws-waf-logging-configuration-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: AWS WAF Logging Configuration API
  version: '2015-08-24'
  description: Generated from AWS's published Smithy model for AWS WAF. 4 operation(s).
  contact:
    name: Amazon Web Services
    url: https://aws.amazon.com/contact-us/
  license:
    name: Apache 2.0
    identifier: Apache-2.0
    url: https://github.com/aws/api-models-aws/blob/main/LICENSE
servers:
- url: https://waf.{region}.amazonaws.com
  variables:
    region:
      default: us-east-1
security:
- sigv4: []
tags:
- name: Logging Configuration
paths:
  /#DeleteLoggingConfiguration:
    post:
      operationId: DeleteLoggingConfiguration
      summary: Delete Logging Configuration
      description: This is AWS WAF Classic documentation. For more information, see AWS WAF Classic in the developer guide. For the latest version of AWS WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use. Permanently deletes the LoggingConfiguration from the specified web ACL.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/DeleteLoggingConfigurationResponse'
        '500':
          description: WAFInternalErrorException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/WAFInternalErrorException'
        '400':
          description: WAFNonexistentItemException; WAFStaleDataException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/WAFNonexistentItemException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - AWSWAF_20150824.DeleteLoggingConfiguration
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/DeleteLoggingConfigurationRequest'
      tags:
      - Logging Configuration
  /#GetLoggingConfiguration:
    post:
      operationId: GetLoggingConfiguration
      summary: Get Logging Configuration
      description: This is AWS WAF Classic documentation. For more information, see AWS WAF Classic in the developer guide. For the latest version of AWS WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use. Returns the LoggingConfiguration for the specified web ACL.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/GetLoggingConfigurationResponse'
        '500':
          description: WAFInternalErrorException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/WAFInternalErrorException'
        '400':
          description: WAFNonexistentItemException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/WAFNonexistentItemException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - AWSWAF_20150824.GetLoggingConfiguration
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/GetLoggingConfigurationRequest'
      tags:
      - Logging Configuration
  /#ListLoggingConfigurations:
    post:
      operationId: ListLoggingConfigurations
      summary: List Logging Configurations
      description: This is AWS WAF Classic documentation. For more information, see AWS WAF Classic in the developer guide. For the latest version of AWS WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use. Returns an array of LoggingConfiguration objects.
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/ListLoggingConfigurationsResponse'
        '500':
          description: WAFInternalErrorException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/WAFInternalErrorException'
        '400':
          description: WAFInvalidParameterException; WAFNonexistentItemException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/WAFInvalidParameterException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - AWSWAF_20150824.ListLoggingConfigurations
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/ListLoggingConfigurationsRequest'
      tags:
      - Logging Configuration
  /#PutLoggingConfiguration:
    post:
      operationId: PutLoggingConfiguration
      summary: Put Logging Configuration
      description: 'This is AWS WAF Classic documentation. For more information, see AWS WAF Classic in the developer guide. For the latest version of AWS WAF, use the AWS WAFV2 API and see the AWS WAF Developer Guide. With the latest version, AWS WAF has a single set of endpoints for regional and global use. Associates a LoggingConfiguration with a specified web ACL. You can access information about all traffic that AWS WAF inspects using the following steps: Create an Amazon Kinesis Data Firehose. Create the data firehose with a PUT source and in the region that you are operating. However, if you are capturing logs for Amazon CloudFront, always create the firehose in US East (N. Virginia). Do not create the data firehose using a Kinesis stream as your source. Associate that firehose to your web ACL using a PutLoggingConfiguration request. When you successfully enable logging using a PutLoggingConfiguration request, AWS WAF will create a service linked role with the necessary permissions to write logs to the Amazon Kinesis Data Firehose. For more information, see Logging Web ACL Traffic Information in the AWS WAF Developer Guide.'
      responses:
        '200':
          description: Success
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/PutLoggingConfigurationResponse'
        '500':
          description: WAFInternalErrorException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/WAFInternalErrorException'
        '400':
          description: WAFNonexistentItemException; WAFServiceLinkedRoleErrorException; WAFStaleDataException
          content:
            application/x-amz-json-1.1:
              schema:
                $ref: '#/components/schemas/WAFNonexistentItemException'
      parameters:
      - name: X-Amz-Target
        in: header
        required: true
        schema:
          type: string
          enum:
          - AWSWAF_20150824.PutLoggingConfiguration
      requestBody:
        required: true
        content:
          application/x-amz-json-1.1:
            schema:
              $ref: '#/components/schemas/PutLoggingConfigurationRequest'
      tags:
      - Logging Configuration
components:
  schemas:
    WAFInvalidParameterException:
      type: object
      properties:
        field:
          type: string
          enum:
          - CHANGE_ACTION
          - WAF_ACTION
          - WAF_OVERRIDE_ACTION
          - PREDICATE_TYPE
          - IPSET_TYPE
          - BYTE_MATCH_FIELD_TYPE
          - SQL_INJECTION_MATCH_FIELD_TYPE
          - BYTE_MATCH_TEXT_TRANSFORMATION
          - BYTE_MATCH_POSITIONAL_CONSTRAINT
          - SIZE_CONSTRAINT_COMPARISON_OPERATOR
          - GEO_MATCH_LOCATION_TYPE
          - GEO_MATCH_LOCATION_VALUE
          - RATE_KEY
          - RULE_TYPE
          - NEXT_MARKER
          - RESOURCE_ARN
          - TAGS
          - TAG_KEYS
        parameter:
          type: string
        reason:
          type: string
          enum:
          - INVALID_OPTION
          - ILLEGAL_COMBINATION
          - ILLEGAL_ARGUMENT
          - INVALID_TAG_KEY
    LoggingConfiguration:
      type: object
      properties:
        ResourceArn:
          type: string
          description: The Amazon Resource Name (ARN) of the web ACL that you want to associate with LogDestinationConfigs.
        LogDestinationConfigs:
          type: array
          items:
            type: string
          description: An array of Amazon Kinesis Data Firehose ARNs.
        RedactedFields:
          type: array
          items:
            $ref: '#/components/schemas/FieldToMatch'
          description: The parts of the request that you want redacted from the logs. For example, if you redact the cookie field, the cookie field in the firehose will be xxx.
      required:
      - ResourceArn
      - LogDestinationConfigs
    PutLoggingConfigurationRequest:
      type: object
      properties:
        LoggingConfiguration:
          $ref: '#/components/schemas/LoggingConfiguration'
      required:
      - LoggingConfiguration
    WAFNonexistentItemException:
      type: object
      properties:
        message:
          type: string
    GetLoggingConfigurationRequest:
      type: object
      properties:
        ResourceArn:
          type: string
          description: The Amazon Resource Name (ARN) of the web ACL for which you want to get the LoggingConfiguration.
      required:
      - ResourceArn
    WAFInternalErrorException:
      type: object
      properties:
        message:
          type: string
    ListLoggingConfigurationsRequest:
      type: object
      properties:
        NextMarker:
          type: string
          description: If you specify a value for Limit and you have more LoggingConfigurations than the value of Limit, AWS WAF returns a NextMarker value in the response that allows you to list another group of LoggingConfigurations. For the second and subsequent ListLoggingConfigurations requests, specify the value of NextMarker from the previous response to get information about another batch of ListLoggingConfigurations.
        Limit:
          type: integer
          description: Specifies the number of LoggingConfigurations that you want AWS WAF to return for this request. If you have more LoggingConfigurations than the number that you specify for Limit, the response includes a NextMarker value that you can use to get another batch of LoggingConfigurations.
    DeleteLoggingConfigurationRequest:
      type: object
      properties:
        ResourceArn:
          type: string
          description: The Amazon Resource Name (ARN) of the web ACL from which you want to delete the LoggingConfiguration.
      required:
      - ResourceArn
    GetLoggingConfigurationResponse:
      type: object
      properties:
        LoggingConfiguration:
          $ref: '#/components/schemas/LoggingConfiguration'
    ListLoggingConfigurationsResponse:
      type: object
      properties:
        LoggingConfigurations:
          type: array
          items:
            $ref: '#/components/schemas/LoggingConfiguration'
          description: An array of LoggingConfiguration objects.
        NextMarker:
          type: string
          description: If you have more LoggingConfigurations than the number that you specified for Limit in the request, the response includes a NextMarker value. To list more LoggingConfigurations, submit another ListLoggingConfigurations request, and specify the NextMarker value from the response in the NextMarker value in the next request.
    FieldToMatch:
      type: object
      properties:
        Type:
          type: string
          enum:
          - URI
          - QUERY_STRING
          - HEADER
          - METHOD
          - BODY
          - SINGLE_QUERY_ARG
          - ALL_QUERY_ARGS
          description: 'The part of the web request that you want AWS WAF to search for a specified string. Parts of a request that you can search include the following: HEADER: A specified request header, for example, the value of the User-Agent or Referer header. If you choose HEADER for the type, specify the name of the header in Data. METHOD: The HTTP method, which indicated the type of operation that the request is asking the origin to perform. Amazon CloudFront supports the following methods: DELETE, GET, HEAD, OPTIONS, PATCH, POST, and PUT. QUERY_STRING: A query string, which is the part of a URL that appears '
        Data:
          type: string
          description: When the value of Type is HEADER, enter the name of the header that you want AWS WAF to search, for example, User-Agent or Referer. The name of the header is not case sensitive. When the value of Type is SINGLE_QUERY_ARG, enter the name of the parameter that you want AWS WAF to search, for example, UserName or SalesRegion. The parameter name is not case sensitive. If the value of Type is any other value, omit Data.
      required:
      - Type
    DeleteLoggingConfigurationResponse:
      type: object
      properties: {}
    PutLoggingConfigurationResponse:
      type: object
      properties:
        LoggingConfiguration:
          $ref: '#/components/schemas/LoggingConfiguration'
  securitySchemes:
    sigv4:
      type: apiKey
      in: header
      name: Authorization
      description: AWS Signature Version 4. The Authorization header carries an AWS4-HMAC-SHA256 signature over the canonical request, with X-Amz-Date (and X-Amz-Security-Token for temporary credentials). Not a bearer token.
      x-aws-sigv4:
        signingName: waf
x-provenance:
  method: harvested
  publisher: Amazon Web Services
  source: https://raw.githubusercontent.com/aws/api-models-aws/582e55931c45b944739742a2c1620b6026dd2d13/models/waf/service/2015-08-24/waf-2015-08-24.json
  note: converted by smithy-to-openapi.py from AWS's Smithy model (roadmap#1001)