mastergrid : Master Grid object.

This object represents the Master Grid. The Master Grid object is automatically generated when a Grid successfully joins the Master Grid.

Object Reference

References to mastergrid are object references. The name part of a Master Grid object reference has the following components:

  • The address of the Master Grid.

Example: mastergrid/ZG5zLm5ldHdvcmtfdmlldyQxMTk:10.0.0.1

Restrictions

The object does not support the following operations:

  • Create (insert)
  • Delete
  • Permissions
  • Global search (searches via the search object)
  • Scheduling
  • CSV export

The object cannot be managed on Cloud Platform members.

Fields

These fields are actual members of the object; thus, they can be requested by using _return_fields, if the fields are readable.

The basic version of the object contains the field(s): address, enable, port.

address

address

The domain name or IP address for the Master Grid.

Type

String.

Create

The default value is undefined.

Search

The field is available for search via

  • ‘:=’ (case insensitive search)
  • ‘=’ (exact equality)
  • ‘~=’ (regular expression)

Notes

The address is part of the base object.

connection_disabled

connection_disabled

Determines if the sub-grid is currently disabled.

Type

Bool.

Search

The field is not available for search.

Notes

The connection_disabled cannot be updated.

connection_disabled cannot be written.

connection_timestamp

connection_timestamp

The timestamp that indicates when the connection to the Master Grid was established.

Type

Timestamp.

Search

The field is not available for search.

Notes

The connection_timestamp cannot be updated.

connection_timestamp cannot be written.

detached

detached

The detached flag for the Master Grid.

Type

Bool.

Search

The field is not available for search.

Notes

The detached cannot be updated.

detached cannot be written.

enable

enable

Determines if the Master Grid is enabled.

Type

Bool.

Create

The default value is False.

Search

The field is not available for search.

Notes

The enable is part of the base object.

joined

joined

The flag shows if the Grid has joined the Master Grid.

Type

Bool.

Search

The field is not available for search.

Notes

The joined cannot be updated.

joined cannot be written.

last_event

last_event

The Master Grid’s last event.

Type

String.

Valid values are:
  • ATTACH
  • DETACH
  • DISABLE
  • EVICT
  • MESSAGE

Search

The field is not available for search.

Notes

The last_event cannot be updated.

last_event cannot be written.

last_event_details

last_event_details

The details of the Master Grid’s last event.

Type

String.

Search

The field is not available for search.

Notes

The last_event_details cannot be updated.

last_event_details cannot be written.

last_sync_timestamp

last_sync_timestamp

The timestamp or the last synchronization operation with the Master Grid.

Type

Timestamp.

Search

The field is not available for search.

Notes

The last_sync_timestamp cannot be updated.

last_sync_timestamp cannot be written.

port

port

The Master Grid port to which the Grid connects.

Type

Unsigned integer.

Create

The default value is 1194.

Search

The field is available for search via

  • ‘=’ (exact equality)

Notes

The port is part of the base object.

status

status

The Master Grid’s status.

Type

String.

Valid values are:
  • FAILED
  • INACTIVE
  • WARNING
  • WORKING

Search

The field is not available for search.

Notes

The status cannot be updated.

status cannot be written.

use_mgmt_port

use_mgmt_port

The flag shows if the MGMT port was used to join the Grid.

Type

Bool.

Search

The field is not available for search.

Notes

The use_mgmt_port cannot be updated.

use_mgmt_port cannot be written.

Fields List

Field Type Req R/O Base Search
address String N N Y : = ~
connection_disabled Bool N Y N N/A
connection_timestamp Timestamp N Y N N/A
detached Bool N Y N N/A
enable Bool N N Y N/A
joined Bool N Y N N/A
last_event String N Y N N/A
last_event_details String N Y N N/A
last_sync_timestamp Timestamp N Y N N/A
port Unsigned int N N Y =
status String N Y N N/A
use_mgmt_port Bool N Y N N/A