- "description": "This API manages IP lists (sets of IPv4 CIDR ranges) scoped to a project and region. IP lists enable blacklisting: they can be referenced by Application and Network Load Balancer to deny traffic from matching source addresses.\n\n**Upload format**\nLists are uploaded as a single raw payload in `file_content` (base64 in JSON transport). The server first tries to parse the payload as CSV (with a `cidr` column; any other columns are ignored) and falls back to a newline-separated `.txt` list of CIDR entries when CSV parsing fails.\n\n**Limits**\n- Maximum raw upload size: 4 MiB (enforced before parsing).\n- Maximum number of CIDR entries per list: 100000 (enforced during streaming parse).\n- Maximum number of IP lists per project: 3.\n- Empty lists (0 CIDRs) are rejected.\n- Only IPv4 CIDR entries are supported for now; IPv6 entries are rejected.\n- No duplicate or overlap checks are performed.\n\n**Semantics**\n- `Upload` creates the list if it does not exist and replaces its content otherwise. Uploads with identical stored content are a no-op (no version bump, no reload).\n- `List` returns each stored IP list without its CIDR entries (name, labels, number of IPs, content hash, usage). The CIDR entries themselves are never returned by the API.\n- There is no single-item Get endpoint. Clients verify content by comparing the returned `content_hash`.\n- IP lists referenced by any load balancer cannot be deleted; the reference must be cleared or replaced with a different list first.\n",
0 commit comments