REST Resource: projects.locations.realms

Resource: Realm

Message describing Realm object

JSON representation
{
  "name": string,
  "trafficType": enum (TrafficType),
  "managementType": enum (ManagementType),
  "registryBook": string,
  "discoveryMetadata": {
    object (DiscoveryMetadata)
  },
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "ipVersion": enum (IpVersion),
  "aggregatedData": {
    object (RealmAggregatedData)
  }
}
Fields
name

string

Required. Identifier. Unique name/ID of the realm

trafficType

enum (TrafficType)

Required. Traffic type of realm.

managementType

enum (ManagementType)

Required. Management type of realm.

registryBook

string

Required. URI of the registry book that claims the realm.

discoveryMetadata

object (DiscoveryMetadata)

Output only. Discovery metadata of the realm.

createTime

string (Timestamp format)

Output only. [Output only] Create time stamp

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

updateTime

string (Timestamp format)

Output only. [Output only] Update time stamp

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".

labels

map (key: string, value: string)

Optional. Labels as key value pairs

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

ipVersion

enum (IpVersion)

Optional. IP version of the realm.

aggregatedData

object (RealmAggregatedData)

Output only. Aggregated data for the Realm. Populated only when the view is AGGREGATE.

TrafficType

Traffic type of realm.

Enums
TRAFFIC_TYPE_UNSPECIFIED Unspecified traffic type.
UNSET Unset traffic type.
INTERNET Internet traffic.
PRIVATE Private traffic.
LINKLOCAL Linklocal traffic.

ManagementType

Managed type of realm.

Enums
MANAGEMENT_TYPE_UNSPECIFIED Unspecified management type.
CNR Managed by Cloud Number Registry.
USER Managed by User.

IpVersion

IP version of the realm.

Enums
IP_VERSION_UNSPECIFIED Unspecified IP version.
IPV4 IPv4 IP version.
IPV6 IPv6 IP version.

RealmAggregatedData

Aggregated data for the Realm.

JSON representation
{
  "discoveredRangesCount": integer,
  "customRangesCount": integer
}
Fields
discoveredRangesCount

integer

Output only. Number of discovered ranges in the Realm.

customRangesCount

integer

Output only. Number of custom ranges in the Realm.

Methods

create

Creates a new Realm in a given project and location.

delete

Deletes a single Realm.

get

Gets details of a single Realm.

list

Lists Realms in a given project and location.

patch

Updates the parameters of a single Realm.