AlloyDB V1BETA API - Class Google::Cloud::AlloyDB::V1beta::Instance (v0.1.0)

Version 0.1.0

• 0.11.0 (latest)
• 0.10.0
• 0.9.0
• 0.8.1
• 0.7.0
• 0.6.2
• 0.5.0
• 0.4.0
• 0.3.0
• 0.2.0
• 0.1.0

Reference documentation and code samples for the AlloyDB V1BETA API class Google::Cloud::AlloyDB::V1beta::Instance.

An Instance is a computing unit that an end customer can connect to. It's the main unit of computing resources in AlloyDB.

Inherits

• Object

Extended By

• Google::Protobuf::MessageExts::ClassMethods

Includes

• Google::Protobuf::MessageExts

Methods

#annotations

def annotations() -> ::Google::Protobuf::Map{::String => ::String}

Returns

• (::Google::Protobuf::Map{::String => ::String}) — Annotations to allow client tools to store small amount of arbitrary data. This is distinct from labels. https://google.aip.dev/128

#annotations=

def annotations=(value) -> ::Google::Protobuf::Map{::String => ::String}

Parameter

• value (::Google::Protobuf::Map{::String => ::String}) — Annotations to allow client tools to store small amount of arbitrary data. This is distinct from labels. https://google.aip.dev/128

Returns

• (::Google::Protobuf::Map{::String => ::String}) — Annotations to allow client tools to store small amount of arbitrary data. This is distinct from labels. https://google.aip.dev/128

#availability_type

def availability_type() -> ::Google::Cloud::AlloyDB::V1beta::Instance::AvailabilityType

Returns

• (::Google::Cloud::AlloyDB::V1beta::Instance::AvailabilityType) — Availability type of an Instance. Defaults to REGIONAL for both primary and read instances. Note that primary and read instances can have different availability types.

#availability_type=

def availability_type=(value) -> ::Google::Cloud::AlloyDB::V1beta::Instance::AvailabilityType

Parameter

• value (::Google::Cloud::AlloyDB::V1beta::Instance::AvailabilityType) — Availability type of an Instance. Defaults to REGIONAL for both primary and read instances. Note that primary and read instances can have different availability types.

Returns

• (::Google::Cloud::AlloyDB::V1beta::Instance::AvailabilityType) — Availability type of an Instance. Defaults to REGIONAL for both primary and read instances. Note that primary and read instances can have different availability types.

#create_time

def create_time() -> ::Google::Protobuf::Timestamp

Returns

• (::Google::Protobuf::Timestamp) — Output only. Create time stamp

#database_flags

def database_flags() -> ::Google::Protobuf::Map{::String => ::String}

Returns

• (::Google::Protobuf::Map{::String => ::String}) — Database flags. Set at instance level.
  • They are copied from primary instance on read instance creation.
  • Read instances can set new or override existing flags that are relevant for reads, e.g. for enabling columnar cache on a read instance. Flags set on read instance may or may not be present on primary.

  This is a list of "key": "value" pairs. "key": The name of the flag. These flags are passed at instance setup time, so include both server options and system variables for Postgres. Flags are specified with underscores, not hyphens. "value": The value of the flag. Booleans are set to on for true and off for false. This field must be omitted if the flag doesn't take a value.

#database_flags=

def database_flags=(value) -> ::Google::Protobuf::Map{::String => ::String}

Parameter

• value (::Google::Protobuf::Map{::String => ::String}) — Database flags. Set at instance level.
  • They are copied from primary instance on read instance creation.
  • Read instances can set new or override existing flags that are relevant for reads, e.g. for enabling columnar cache on a read instance. Flags set on read instance may or may not be present on primary.

  This is a list of "key": "value" pairs. "key": The name of the flag. These flags are passed at instance setup time, so include both server options and system variables for Postgres. Flags are specified with underscores, not hyphens. "value": The value of the flag. Booleans are set to on for true and off for false. This field must be omitted if the flag doesn't take a value.

Returns

• (::Google::Protobuf::Map{::String => ::String}) — Database flags. Set at instance level.
  • They are copied from primary instance on read instance creation.
  • Read instances can set new or override existing flags that are relevant for reads, e.g. for enabling columnar cache on a read instance. Flags set on read instance may or may not be present on primary.

  This is a list of "key": "value" pairs. "key": The name of the flag. These flags are passed at instance setup time, so include both server options and system variables for Postgres. Flags are specified with underscores, not hyphens. "value": The value of the flag. Booleans are set to on for true and off for false. This field must be omitted if the flag doesn't take a value.

#delete_time

def delete_time() -> ::Google::Protobuf::Timestamp

Returns

• (::Google::Protobuf::Timestamp) — Output only. Delete time stamp

#display_name

def display_name() -> ::String

Returns

• (::String) — User-settable and human-readable display name for the Instance.

#display_name=

def display_name=(value) -> ::String

Parameter

• value (::String) — User-settable and human-readable display name for the Instance.

Returns

• (::String) — User-settable and human-readable display name for the Instance.

#etag

def etag() -> ::String

Returns

• (::String) — For Resource freshness validation (https://google.aip.dev/154)

#etag=

def etag=(value) -> ::String

Parameter

• value (::String) — For Resource freshness validation (https://google.aip.dev/154)

Returns

• (::String) — For Resource freshness validation (https://google.aip.dev/154)

#gce_zone

def gce_zone() -> ::String

Returns

• (::String) — The Compute Engine zone that the instance should serve from, per https://cloud.google.com/compute/docs/regions-zones This can ONLY be specified for ZONAL instances. If present for a REGIONAL instance, an error will be thrown. If this is absent for a ZONAL instance, instance is created in a random zone with available capacity.

#gce_zone=

def gce_zone=(value) -> ::String

Parameter

• value (::String) — The Compute Engine zone that the instance should serve from, per https://cloud.google.com/compute/docs/regions-zones This can ONLY be specified for ZONAL instances. If present for a REGIONAL instance, an error will be thrown. If this is absent for a ZONAL instance, instance is created in a random zone with available capacity.

Returns

• (::String) — The Compute Engine zone that the instance should serve from, per https://cloud.google.com/compute/docs/regions-zones This can ONLY be specified for ZONAL instances. If present for a REGIONAL instance, an error will be thrown. If this is absent for a ZONAL instance, instance is created in a random zone with available capacity.

#instance_type

def instance_type() -> ::Google::Cloud::AlloyDB::V1beta::Instance::InstanceType

Returns

• (::Google::Cloud::AlloyDB::V1beta::Instance::InstanceType) — Required. The type of the instance. Specified at creation time.

#instance_type=

def instance_type=(value) -> ::Google::Cloud::AlloyDB::V1beta::Instance::InstanceType

Parameter

• value (::Google::Cloud::AlloyDB::V1beta::Instance::InstanceType) — Required. The type of the instance. Specified at creation time.

Returns

• (::Google::Cloud::AlloyDB::V1beta::Instance::InstanceType) — Required. The type of the instance. Specified at creation time.

#ip_address

def ip_address() -> ::String

Returns

• (::String) — Output only. The IP address for the Instance. This is the connection endpoint for an end-user application.

#labels

def labels() -> ::Google::Protobuf::Map{::String => ::String}

Returns

• (::Google::Protobuf::Map{::String => ::String}) — Labels as key value pairs

#labels=

def labels=(value) -> ::Google::Protobuf::Map{::String => ::String}

Parameter

• value (::Google::Protobuf::Map{::String => ::String}) — Labels as key value pairs

Returns

• (::Google::Protobuf::Map{::String => ::String}) — Labels as key value pairs

#machine_config

def machine_config() -> ::Google::Cloud::AlloyDB::V1beta::Instance::MachineConfig

Returns

• (::Google::Cloud::AlloyDB::V1beta::Instance::MachineConfig) — Configurations for the machines that host the underlying database engine.

#machine_config=

def machine_config=(value) -> ::Google::Cloud::AlloyDB::V1beta::Instance::MachineConfig

Parameter

• value (::Google::Cloud::AlloyDB::V1beta::Instance::MachineConfig) — Configurations for the machines that host the underlying database engine.

Returns

• (::Google::Cloud::AlloyDB::V1beta::Instance::MachineConfig) — Configurations for the machines that host the underlying database engine.

#name

def name() -> ::String

Returns

• (::String) —

  Output only. The name of the instance resource with the format:

  • projects/{project}/locations/{region}/clusters/{cluster_id}/instances/{instance_id} where the cluster and instance ID segments should satisfy the regex expression [a-z]([a-z0-9-]{0,61}[a-z0-9])?, e.g. 1-63 characters of lowercase letters, numbers, and dashes, starting with a letter, and ending with a letter or number. For more details see https://google.aip.dev/122. The prefix of the instance resource name is the name of the parent resource:
  • projects/{project}/locations/{region}/clusters/{cluster_id}

#nodes

def nodes() -> ::Array<::Google::Cloud::AlloyDB::V1beta::Instance::Node>

Returns

• (::Array<::Google::Cloud::AlloyDB::V1beta::Instance::Node>) — Output only. List of available read-only VMs in this instance, including the standby for a PRIMARY instance.

#query_insights_config

def query_insights_config() -> ::Google::Cloud::AlloyDB::V1beta::Instance::QueryInsightsInstanceConfig

Returns

• (::Google::Cloud::AlloyDB::V1beta::Instance::QueryInsightsInstanceConfig) — Configuration for query insights.

#query_insights_config=

def query_insights_config=(value) -> ::Google::Cloud::AlloyDB::V1beta::Instance::QueryInsightsInstanceConfig

Parameter

• value (::Google::Cloud::AlloyDB::V1beta::Instance::QueryInsightsInstanceConfig) — Configuration for query insights.

Returns

• (::Google::Cloud::AlloyDB::V1beta::Instance::QueryInsightsInstanceConfig) — Configuration for query insights.

#read_pool_config

def read_pool_config() -> ::Google::Cloud::AlloyDB::V1beta::Instance::ReadPoolConfig

Returns

• (::Google::Cloud::AlloyDB::V1beta::Instance::ReadPoolConfig) — Read pool specific config.

#read_pool_config=

def read_pool_config=(value) -> ::Google::Cloud::AlloyDB::V1beta::Instance::ReadPoolConfig

Parameter

• value (::Google::Cloud::AlloyDB::V1beta::Instance::ReadPoolConfig) — Read pool specific config.

Returns

• (::Google::Cloud::AlloyDB::V1beta::Instance::ReadPoolConfig) — Read pool specific config.

#reconciling

def reconciling() -> ::Boolean

Returns

• (::Boolean) — Output only. Reconciling (https://google.aip.dev/128#reconciliation). Set to true if the current state of Instance does not match the user's intended state, and the service is actively updating the resource to reconcile them. This can happen due to user-triggered updates or system actions like failover or maintenance.

#state

def state() -> ::Google::Cloud::AlloyDB::V1beta::Instance::State

Returns

• (::Google::Cloud::AlloyDB::V1beta::Instance::State) — Output only. The current serving state of the instance.

#uid

def uid() -> ::String

Returns

• (::String) — Output only. The system-generated UID of the resource. The UID is assigned when the resource is created, and it is retained until it is deleted.

#update_time

def update_time() -> ::Google::Protobuf::Timestamp

Returns

• (::Google::Protobuf::Timestamp) — Output only. Update time stamp

#writable_node

def writable_node() -> ::Google::Cloud::AlloyDB::V1beta::Instance::Node

Returns

• (::Google::Cloud::AlloyDB::V1beta::Instance::Node) — Output only. This is set for the read-write VM of the PRIMARY instance only.