REST Resource: projects.locations.instances

Resource: 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/{project_id}/locations/{locationId}/instances/{instanceId}

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

displayName

string

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

labels

map (key: string, value: string)

Optional. 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

Optional. 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

Optional. Zones where Memcached nodes should be provisioned in. 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)

Optional. 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, accurate to nanoseconds. Example: "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, accurate to nanoseconds. Example: "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 current statuses of memcached instance.

discoveryEndpoint

string

Output only. Endpoint for 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

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

string

Output only. 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 and any action needs to be taken to apply parameters on nodes.

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 will update current set of Parameters to the set of specified nodes of the Memcached Instance.

create

Creates a new Instance in a given project and location.

delete

Deletes a single Instance.

get

Gets details of a single Instance.

getIamPolicy

Gets the access control policy for a resource.

list

Lists Instances in a given project and location.

patch

Updates an existing Instance in a given project and location.

setIamPolicy

Sets the access control policy on the specified resource.

testIamPermissions

Returns permissions that a caller has on the specified resource.

updateParameters

Updates the defined Memcached Parameters for an existing Instance.