REST Resource: projects.locations.instances

Resource: Instance

A Memorystore for Memcached instance

JSON representation
{
  "name": string,
  "displayName": string,
  "labels": {
    string: string,
    ...
  },
  "authorizedNetwork": string,
  "zones": [
    string
  ],
  "nodeCount": integer,
  "nodeConfig": {
    object (NodeConfig)
  },
  "memcacheVersion": enum (MemcacheVersion),
  "parameters": {
    object (MemcacheParameters)
  },
  "memcacheNodes": [
    {
      object (Node)
    }
  ],
  "createTime": string,
  "updateTime": string,
  "state": enum (State),
  "memcacheFullVersion": string,
  "instanceMessages": [
    {
      object (InstanceMessage)
    }
  ],
  "discoveryEndpoint": string
}
Fields
name

string

Required. Unique name of the resource in this scope including project and location using the form: projects/{projectId}/locations/{locationId}/instances/{instanceId}

Note: Memcached instances are managed and addressed at the regional level so locationId here refers to a Google Cloud region; however, users may choose which zones Memcached nodes should be provisioned in within an instance. Refer to zones field for more details.

displayName

string

User provided name for the instance, which is only used for display purposes. Cannot be more than 80 characters.

labels

map (key: string, value: string)

Resource labels to represent user-provided metadata. Refer to cloud documentation on labels for more details. https://cloud.google.com/compute/docs/labeling-resources

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

authorizedNetwork

string

The full name of the Google Compute Engine network to which the instance is connected. If left unspecified, the default network will be used.

zones[]

string

Zones in which Memcached nodes should be provisioned. Memcached nodes will be equally distributed across these zones. If not provided, the service will by default create nodes in all zones in the region for the instance.

nodeCount

integer

Required. Number of nodes in the Memcached instance.

nodeConfig

object (NodeConfig)

Required. Configuration for Memcached nodes.

memcacheVersion

enum (MemcacheVersion)

The major version of Memcached software. If not provided, latest supported version will be used. Currently the latest supported major version is MEMCACHE_1_5. The minor version will be automatically determined by our system based on the latest supported minor version.

parameters

object (MemcacheParameters)

Optional: User defined parameters to apply to the memcached process on each node.

memcacheNodes[]

object (Node)

Output only. List of Memcached nodes. Refer to Node message for more details.

createTime

string (Timestamp format)

Output only. The time the instance was created.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. The time the instance was updated.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

state

enum (State)

Output only. The state of this Memcached instance.

memcacheFullVersion

string

Output only. The full version of memcached server running on this instance. System automatically determines the full memcached version for an instance based on the input MemcacheVersion. The full version format will be "memcached-1.5.16".

instanceMessages[]

object (InstanceMessage)

List of messages that describe the current state of the Memcached instance.

discoveryEndpoint

string

Output only. Endpoint for the Discovery API.

NodeConfig

Configuration for a Memcached Node.

JSON representation
{
  "cpuCount": integer,
  "memorySizeMb": integer
}
Fields
cpuCount

integer

Required. Number of cpus per Memcached node.

memorySizeMb

integer

Required. Memory size in MiB for each Memcached node.

MemcacheVersion

Memcached versions supported by our service.

Enums
MEMCACHE_VERSION_UNSPECIFIED
MEMCACHE_1_5 Memcached 1.5 version.

MemcacheParameters

The unique ID associated with this set of parameters. Users can use this id to determine if the parameters associated with the instance differ from the parameters associated with the nodes. A discrepancy between parameter ids can inform users that they may need to take action to apply parameters on nodes.

JSON representation
{
  "id": string,
  "params": {
    string: string,
    ...
  }
}
Fields
id

string

Output only.

params

map (key: string, value: string)

User defined set of parameters to use in the memcached process.

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

Node

JSON representation
{
  "nodeId": string,
  "zone": string,
  "state": enum (State),
  "host": string,
  "port": integer,
  "parameters": {
    object (MemcacheParameters)
  }
}
Fields
nodeId

string

Output only. Identifier of the Memcached node. The node id does not include project or location like the Memcached instance name.

zone

string

Output only. Location (GCP Zone) for the Memcached node.

state

enum (State)

Output only. Current state of the Memcached node.

host

string

Output only. Hostname or IP address of the Memcached node used by the clients to connect to the Memcached server on this node.

port

integer

Output only. The port number of the Memcached server on this node.

parameters

object (MemcacheParameters)

User defined parameters currently applied to the node.

State

Different states of a Memcached node.

Enums
STATE_UNSPECIFIED Node state is not set.
CREATING Node is being created.
READY Node has been created and ready to be used.
DELETING Node is being deleted.
UPDATING Node is being updated.

State

Different states of a Memcached instance.

Enums
STATE_UNSPECIFIED State not set.
CREATING Memcached instance is being created.
READY Memcached instance has been created and ready to be used.
DELETING Memcached instance is being deleted.
PERFORMING_MAINTENANCE Memcached instance is going through maintenance, e.g. data plane rollout.

InstanceMessage

JSON representation
{
  "code": enum (Code),
  "message": string
}
Fields
code

enum (Code)

A code that correspond to one type of user-facing message.

message

string

Message on memcached instance which will be exposed to users.

Code

Enums
CODE_UNSPECIFIED Message Code not set.
ZONE_DISTRIBUTION_UNBALANCED Memcached nodes are distributed unevenly.

Methods

applyParameters

ApplyParameters restarts the set of specified nodes in order to update them to the current set of parameters for the Memcached Instance.

create

Creates a new Instance in a given location.

delete

Deletes a single Instance.

get

Gets details of a single Instance.

list

Lists Instances in a given location.

patch

Updates an existing Instance in a given project and location.

updateParameters

Updates the defined Memcached parameters for an existing instance.