---
title: "Batched Invocation Interceptors"
url: https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/batched-invocation-interceptors
language: python
docs_index: https://docs.zeroc.com/llms.txt
---

> For an index of every page, see [llms.txt](https://docs.zeroc.com/llms.txt).

# Batched Invocation Interceptors

Programming language: Python. Other languages: [C++](https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/batched-invocation-interceptors/cpp.md), [C#](https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/batched-invocation-interceptors/csharp.md), [Java](https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/batched-invocation-interceptors/java.md).

A batch invocation interceptor lets you flush batched requests with your own policy, and handle a failed flush.

You install an interceptor by setting the `batchRequestInterceptor` field of the [InitializationData](https://code.zeroc.com/ice/3.8/api/python/Ice.InitializationData.html) object you use to create your communicator. The communicator invokes the interceptor for each batch request, passing the following arguments:

- `req`: an object representing the batch request being queued
- `count`: the number of requests already in the queue
- `size`: the number of bytes of the queued batch message, including its header

The request represented by `req` is not included in `count` and `size`, and is queued only when the interceptor calls `enqueue` on it.

The following interceptor flushes the queued requests when adding the new request would make the batch message larger than 64 KiB:

```py
maxBatchSize = 64 * 1024  # in bytes


async def logFlushFailure(flush: Awaitable[None]) -> None:
    try:
        await flush
    except Ice.LocalException as exception:
        print(f"Failed to flush batch requests: {exception}", file=sys.stderr)


def interceptor(request: Ice.BatchRequest, count: int, size: int) -> None:
    if size + request.getSize() > maxBatchSize:
        asyncio.create_task(logFlushFailure(request.getProxy().ice_flushBatchRequestsAsync()))
    request.enqueue()


initData.batchRequestInterceptor = interceptor
```

Installing an interceptor does not turn off [automatic flushing](https://docs.zeroc.com/ice/3.8/runtime/invocation/invocation-mode/batched-invocations/python.md#automatic-flushing).
