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

# POST /v1alpha/{+parent}/registryBooks

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

Creates a new RegistryBook in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `registryBookId` string
- `requestId` string

## Request body

- RegistryBook — A RegistryBook organizes and manages IP address space. It claims specific scopes (such as projects) and groups related Realms and Ranges.
  - `createTime` string, google-datetime — Output only. The time at which the RegistryBook was created.
  - `labels` object — Optional. User-defined labels.
  - `claimedScopes` string[] — Optional. List of scopes claimed by the RegistryBook. In Preview, Only project scope is supported. Each scope is in the format of projects/{project}. Each scope can only be claimed once.
  - `aggregatedData` AggregatedData — Aggregated data for the RegistryBook.
    - `uniqueScopesCount` integer — Output only. Number of scopes unique to the RegistryBook.
    - `customRealmsCount` integer — Output only. Number of custom Realms in the RegistryBook.
    - `discoveredRealmsCount` integer — Output only. Number of discovered Realms in the RegistryBook.
    - `customRangesCount` integer — Output only. Number of CustomRanges in the RegistryBook.
    - `discoveredRangesCount` integer — Output only. Number of DiscoveredRanges in the RegistryBook.
  - `updateTime` string, google-datetime — Output only. The time at which the RegistryBook was last updated.
  - `name` string — Required. Identifier. The resource name of the RegistryBook.
  - `isDefault` boolean — Output only. Whether the RegistryBook is the default one.

## 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)