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

# POST /v1alpha/{+parent}/realms

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

Creates a new Realm in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `realmId` string
- `requestId` string

## Request body

- Realm — A Realm represents a distinct network domain or security zone. It groups Ranges that share the same traffic and management characteristics. All the ranges in a Realm are routable to each other, meaning that they cannot overlap.
  - `discoveryMetadata` DiscoveryMetadata — Metadata about a discovered resource, tracking event times, state, and source information.
    - `updateTime` string, google-datetime — Output only. The time when the resource was last modified.
    - `state` 'RESOURCE_STATE_UNSPECIFIED' | 'INVALID' | 'EXISTS' | 'DOES_NOT_EXIST' | 'ERROR' — Output only. The state of the resource.
    - `eventTime` string, google-datetime — Output only. The time when the event happened.
    - `resourceUri` string — Output only. The resource uri of the discovered resource.
    - `sourceId` string — Output only. The canonical google.aip.dev/122 name of the source resource.
    - `createTime` string, google-datetime — Output only. The time when the resource was created.
    - `sourceSubId` string — Output only. A single source resource can be the source of multiple CNR resources. This sub_id is used to distinguish between the different CNR resources derived from the same upstream resource. For example, a single subnetwork can be the source of multiple Ranges, one for each protocol. In this case, the sub_id could be "private-ipv4" or "private-ipv6".
    - `resource` string — Output only. The resource name of the discovered resource, should be API-agnostic. Example: "projects/{project_number}/networks/{network_id}".
  - `updateTime` string, google-datetime — Output only. The time at which the Realm was last updated.
  - `labels` object — Optional. User-defined labels.
  - `aggregatedData` RealmAggregatedData — Aggregated data for the Realm.
    - `customRangesCount` integer — Output only. Number of CustomRanges in the Realm.
    - `discoveredRangesCount` integer — Output only. Number of DiscoveredRanges in the Realm.
  - `name` string — Required. Identifier. The resource name of the Realm.
  - `ipVersion` 'IP_VERSION_UNSPECIFIED' | 'IPV4' | 'IPV6' — Optional. IP version of the Realm.
  - `trafficType` 'TRAFFIC_TYPE_UNSPECIFIED' | 'UNSET' | 'INTERNET' | 'PRIVATE' | 'LINKLOCAL' — Required. Traffic type of the Realm.
  - `registryBook` string — Required. Name of the RegistryBook that claims the Realm.
  - `managementType` 'MANAGEMENT_TYPE_UNSPECIFIED' | 'CNR' | 'USER' — Optional. Management type of the Realm.
  - `createTime` string, google-datetime — Output only. The time at which the Realm was created.

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