---
title: "POST /v1alpha/{+parent}/customRanges"
method: POST
path: "/v1alpha/{+parent}/customRanges"
tags: ["projects"]
---

# POST /v1alpha/{+parent}/customRanges

`POST /v1alpha/{+parent}/customRanges`

Creates a new CustomRange in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `customRangeId` string
- `requestId` string

## Request body

- CustomRange — A CustomRange represents a user-defined IP address range.
  - `description` string — Optional. The description of the CustomRange.
  - `ipv4CidrRange` string — Optional. The IPv4 CIDR range of the CustomRange.
  - `attributes` Attribute[] — Optional. The attributes of the CustomRange.
    - `value` string — Required. The value of the attribute.
    - `key` string — Required. The key of the attribute.
  - `ipv6CidrRange` string — Optional. The IPv6 CIDR range of the CustomRange.
  - `parentRange` string — Optional. The resource name of the parent CustomRange, in the format `projects/{project}/locations/{location}/customRanges/{custom_range}`. If specified, the parent CustomRange must be in the same RegistryBook. This field is mutually exclusive with the `realm` field, as the Realm is inherited from the parent CustomRange.
  - `registryBook` string — Output only. The RegistryBook of the CustomRange. This field is inherited from the Realm or parent CustomRange depending on which one is specified.
  - `labels` object — Optional. User-defined labels.
  - `name` string — Required. Identifier. The resource name of the CustomRange, in the format `projects/{project}/locations/{location}/customRanges/{custom_range}`.
  - `realm` string — Optional. The resource name of the Realm associated with the CustomRange, in the format `projects/{project}/locations/{location}/realms/{realm}`. The Realm must be in the same project as the CustomRange. This field must not be set if the `parent_range` field is set, as the Realm will be inherited from the parent CustomRange.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/cloudnumberregistry.md) · [All operations](https://skmtc.dev/google/apis/cloudnumberregistry/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/cloudnumberregistry/revisions/19ff6b3b34e9/schema)