---
title: "POST /v1/{+parent}:searchRange"
method: POST
path: "/v1/{+parent}:searchRange"
tags: ["services"]
---

# POST /v1/{+parent}:searchRange

`POST /v1/{+parent}:searchRange`

Service producers can use this method to find a currently unused range within consumer allocated ranges. This returned range is not reserved, and not guaranteed to remain unused. It will validate previously provided allocated ranges, find non-conflicting sub-range of requested size (expressed in number of leading bits of ipv4 network mask, as in CIDR range notation).

## Path parameters

- `parent` string, required

## Request body

- SearchRangeRequest — Request to search for an unused range within allocated ranges.
  - `network` string — Required. Network name in the consumer project. This network must have been already peered with a shared VPC network using CreateConnection method. Must be in a form 'projects/{project}/global/networks/{network}'. {project} is a project number, as in '12345' {network} is network name.
  - `ipPrefixLength` integer — Required. The prefix length of the IP range. Use usual CIDR range notation. For example, '30' to find unused x.x.x.x/30 CIDR range. Actual range will be determined using allocated range for the consumer peered network and returned in the result.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/servicenetworking.md) · [All operations](https://skmtc.net/google/apis/servicenetworking/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/servicenetworking/versions/a9b814c6426b/schema)