MemorystoreInstance

Property	Value
Google Cloud Service Name	Cloud Memorystore for Valkey
Google Cloud Service Documentation	/memorystore/docs/valkey/
Google Cloud REST Resource Name	v1.projects.locations.instances
Google Cloud REST Resource Documentation	/memorystore/docs/valkey/reference/rest/v1/projects.locations.instances
Config Connector Resource Short Names	gcpmemorystoreinstance gcpmemorystoreinstances memorystoreinstance
Config Connector Service Name	memorystore.googleapis.com
Config Connector Resource Fully Qualified Name	memorystoreinstances.memorystore.cnrm.cloud.google.com
Can Be Referenced by IAMPolicy/IAMPolicyMember	No
Config Connector Default Average Reconcile Interval In Seconds	600

Custom Resource Definition Properties

Spec

Schema

authorizationMode: string
deletionProtectionEnabled: boolean
endpoints:
- connections:
  - pscAutoConnection:
      networkRef:
        external: string
        name: string
        namespace: string
      projectRef:
        external: string
        kind: string
        name: string
        namespace: string
engineConfigs:
  string: string
engineVersion: string
labels:
  string: string
location: string
mode: string
nodeType: string
persistenceConfig:
  aofConfig:
    appendFsync: string
  mode: string
  rdbConfig:
    rdbSnapshotPeriod: string
    rdbSnapshotStartTime: string
projectRef:
  external: string
  kind: string
  name: string
  namespace: string
replicaCount: integer
resourceID: string
shardCount: integer
transitEncryptionMode: string
zoneDistributionConfig:
  mode: string
  zone: string

Fields

Fields
`authorizationMode` Optional	`string` Optional. Immutable. Authorization mode of the instance.
`deletionProtectionEnabled` Optional	`boolean` Optional. If set to true deletion of the instance will fail.
`endpoints` Optional	`list (object)` Optional. Endpoints for the instance.
`endpoints[]` Optional	`object`
`endpoints[].connections` Optional	`list (object)` Optional. A group of Private Service Connect connections. The group of connections are created in the same VPC network, one for each service attachment in the cluster.
`endpoints[].connections[]` Optional	`object`
`endpoints[].connections[].pscAutoConnection` Optional	`object` Detailed information of a PSC connection that is created through service connectivity automation.
`endpoints[].connections[].pscAutoConnection.networkRef` Required*	`object` Required. The network where the PSC endpoints are created, in the form of projects/{project_id}/global/networks/{network_id}.
`endpoints[].connections[].pscAutoConnection.networkRef.external` Optional	`string` The value of an externally managed ComputeNetwork resource. Should be in the format "https://www.googleapis.com/compute/{{version}}/projects/{{projectId}}/global/networks/{{networkId}}" or "projects/{{projectId}}/global/networks/{{networkId}}"
`endpoints[].connections[].pscAutoConnection.networkRef.name` Optional	`string` The name of a ComputeNetwork resource.
`endpoints[].connections[].pscAutoConnection.networkRef.namespace` Optional	`string` The namespace of a ComputeNetwork resource.
`endpoints[].connections[].pscAutoConnection.projectRef` Required*	`object` Required. The consumer project_id where PSC connections are established. This should be the same project_id that the instance is being created in.
`endpoints[].connections[].pscAutoConnection.projectRef.external` Optional	`string` The `projectID` field of a project, when not managed by Config Connector.
`endpoints[].connections[].pscAutoConnection.projectRef.kind` Optional	`string` The kind of the Project resource; optional but must be `Project` if provided.
`endpoints[].connections[].pscAutoConnection.projectRef.name` Optional	`string` The `name` field of a `Project` resource.
`endpoints[].connections[].pscAutoConnection.projectRef.namespace` Optional	`string` The `namespace` field of a `Project` resource.
`engineConfigs` Optional	`map (key: string, value: string)` Optional. User-provided engine configurations for the instance.
`engineVersion` Optional	`string` Optional. Immutable. Engine version of the instance.
`labels` Optional	`map (key: string, value: string)` Optional. Labels to represent user-provided metadata.
`location` Required	`string` Immutable.
`mode` Optional	`string` Optional. The mode config for the instance.
`nodeType` Optional	`string` Optional. Immutable. Machine type for individual nodes of the instance.
`persistenceConfig` Optional	`object` Optional. Persistence configuration of the instance.
`persistenceConfig.aofConfig` Optional	`object` Optional. AOF configuration. This field will be ignored if mode is not AOF.
`persistenceConfig.aofConfig.appendFsync` Optional	`string` Optional. The fsync mode.
`persistenceConfig.mode` Optional	`string` Optional. Current persistence mode.
`persistenceConfig.rdbConfig` Optional	`object` Optional. RDB configuration. This field will be ignored if mode is not RDB.
`persistenceConfig.rdbConfig.rdbSnapshotPeriod` Optional	`string` Optional. Period between RDB snapshots.
`persistenceConfig.rdbConfig.rdbSnapshotStartTime` Optional	`string` Optional. Time that the first snapshot was or will be attempted, and to which future snapshots will be aligned. If not provided, the current time will be used.
`projectRef` Required	`object` The Project that this resource belongs to.
`projectRef.external` Optional	`string` The `projectID` field of a project, when not managed by Config Connector.
`projectRef.kind` Optional	`string` The kind of the Project resource; optional but must be `Project` if provided.
`projectRef.name` Optional	`string` The `name` field of a `Project` resource.
`projectRef.namespace` Optional	`string` The `namespace` field of a `Project` resource.
`replicaCount` Optional	`integer` Optional. Number of replica nodes per shard. If omitted the default is 0 replicas.
`resourceID` Optional	`string` The MemorystoreInstance name. If not given, the metadata.name will be used.
`shardCount` Optional	`integer` Optional. Number of shards for the instance.
`transitEncryptionMode` Optional	`string` Optional. Immutable. In-transit encryption mode of the instance.
`zoneDistributionConfig` Optional	`object` Optional. Immutable. Zone distribution configuration of the instance for node allocation.
`zoneDistributionConfig.mode` Optional	`string` Optional. Current zone distribution mode. Defaults to MULTI_ZONE.
`zoneDistributionConfig.zone` Optional	`string` Optional. Defines zone where all resources will be allocated with SINGLE_ZONE mode. Ignored for MULTI_ZONE mode.

authorizationMode

Optional

string

Optional. Immutable. Authorization mode of the instance.

deletionProtectionEnabled

Optional

boolean

Optional. If set to true deletion of the instance will fail.

endpoints

Optional

list (object)

Optional. Endpoints for the instance.

endpoints[]

Optional

object

endpoints[].connections

Optional

list (object)

Optional. A group of Private Service Connect connections. The group of connections are created in the same VPC network, one for each service attachment in the cluster.

endpoints[].connections[]

Optional

object

endpoints[].connections[].pscAutoConnection

Optional

object

Detailed information of a PSC connection that is created through service connectivity automation.

endpoints[].connections[].pscAutoConnection.networkRef

Required*

object

Required. The network where the PSC endpoints are created, in the form of projects/{project_id}/global/networks/{network_id}.

endpoints[].connections[].pscAutoConnection.networkRef.external

Optional

string

The value of an externally managed ComputeNetwork resource. Should be in the format "https://www.googleapis.com/compute/{{version}}/projects/{{projectId}}/global/networks/{{networkId}}" or "projects/{{projectId}}/global/networks/{{networkId}}"

endpoints[].connections[].pscAutoConnection.networkRef.name

Optional

string

The name of a ComputeNetwork resource.

endpoints[].connections[].pscAutoConnection.networkRef.namespace

Optional

string

The namespace of a ComputeNetwork resource.

endpoints[].connections[].pscAutoConnection.projectRef

Required*

object

Required. The consumer project_id where PSC connections are established. This should be the same project_id that the instance is being created in.

endpoints[].connections[].pscAutoConnection.projectRef.external

Optional

string

The `projectID` field of a project, when not managed by Config Connector.

endpoints[].connections[].pscAutoConnection.projectRef.kind

Optional

string

The kind of the Project resource; optional but must be `Project` if provided.

endpoints[].connections[].pscAutoConnection.projectRef.name

Optional

string

The `name` field of a `Project` resource.

endpoints[].connections[].pscAutoConnection.projectRef.namespace

Optional

string

The `namespace` field of a `Project` resource.

engineConfigs

Optional

map (key: string, value: string)

Optional. User-provided engine configurations for the instance.

engineVersion

Optional

string

Optional. Immutable. Engine version of the instance.

labels

Optional

map (key: string, value: string)

Optional. Labels to represent user-provided metadata.

location

Required

string

Immutable.

mode

Optional

string

Optional. The mode config for the instance.

nodeType

Optional

string

Optional. Immutable. Machine type for individual nodes of the instance.

persistenceConfig

Optional

object

Optional. Persistence configuration of the instance.

persistenceConfig.aofConfig

Optional

object

Optional. AOF configuration. This field will be ignored if mode is not AOF.

persistenceConfig.aofConfig.appendFsync

Optional

string

Optional. The fsync mode.

persistenceConfig.mode

Optional

string

Optional. Current persistence mode.

persistenceConfig.rdbConfig

Optional

object

Optional. RDB configuration. This field will be ignored if mode is not RDB.

persistenceConfig.rdbConfig.rdbSnapshotPeriod

Optional

string

Optional. Period between RDB snapshots.

persistenceConfig.rdbConfig.rdbSnapshotStartTime

Optional

string

Optional. Time that the first snapshot was or will be attempted, and to which future snapshots will be aligned. If not provided, the current time will be used.

projectRef

Required

object

The Project that this resource belongs to.

projectRef.external

Optional

string

The `projectID` field of a project, when not managed by Config Connector.

projectRef.kind

Optional

string

The kind of the Project resource; optional but must be `Project` if provided.

projectRef.name

Optional

string

The `name` field of a `Project` resource.

projectRef.namespace

Optional

string

The `namespace` field of a `Project` resource.

replicaCount

Optional

integer

Optional. Number of replica nodes per shard. If omitted the default is 0 replicas.

resourceID

Optional

string

The MemorystoreInstance name. If not given, the metadata.name will be used.

shardCount

Optional

integer

Optional. Number of shards for the instance.

transitEncryptionMode

Optional

string

Optional. Immutable. In-transit encryption mode of the instance.

zoneDistributionConfig

Optional

object

Optional. Immutable. Zone distribution configuration of the instance for node allocation.

zoneDistributionConfig.mode

Optional

string

Optional. Current zone distribution mode. Defaults to MULTI_ZONE.

zoneDistributionConfig.zone

Optional

string

Optional. Defines zone where all resources will be allocated with SINGLE_ZONE mode. Ignored for MULTI_ZONE mode.

* Field is required when parent field is specified

Status

Schema

conditions:
- lastTransitionTime: string
  message: string
  reason: string
  status: string
  type: string
externalRef: string
observedGeneration: integer
observedState:
  createTime: string
  endpoints:
  - connections:
    - pscAutoConnection:
        connectionType: string
        forwardingRule: string
        ipAddress: string
        port: integer
        pscConnectionID: string
        pscConnectionStatus: string
        serviceAttachment: string
  nodeConfig:
    sizeGB: float
  state: string
  stateInfo:
    updateInfo: {}
  uid: string
  updateTime: string

Fields
`conditions`	`list (object)` Conditions represent the latest available observations of the object's current state.
`conditions[]`	`object`
`conditions[].lastTransitionTime`	`string` Last time the condition transitioned from one status to another.
`conditions[].message`	`string` Human-readable message indicating details about last transition.
`conditions[].reason`	`string` Unique, one-word, CamelCase reason for the condition's last transition.
`conditions[].status`	`string` Status is the status of the condition. Can be True, False, Unknown.
`conditions[].type`	`string` Type is the type of the condition.
`externalRef`	`string` A unique specifier for the MemorystoreInstance resource in Google Cloud.
`observedGeneration`	`integer` ObservedGeneration is the generation of the resource that was most recently observed by the Config Connector controller. If this is equal to metadata.generation, then that means that the current reported status reflects the most recent desired state of the resource.
`observedState`	`object` ObservedState is the state of the resource as most recently observed in GCP.
`observedState.createTime`	`string` Output only. Creation timestamp of the instance.
`observedState.endpoints`	`list (object)` Optional. Endpoints for the instance.
`observedState.endpoints[]`	`object`
`observedState.endpoints[].connections`	`list (object)` Optional. A group of PSC connections. They are created in the same VPC network, one for each service attachment in the cluster.
`observedState.endpoints[].connections[]`	`object`
`observedState.endpoints[].connections[].pscAutoConnection`	`object` Detailed information of a PSC connection that is created through service connectivity automation.
`observedState.endpoints[].connections[].pscAutoConnection.connectionType`	`string` Output only. Type of the PSC connection.
`observedState.endpoints[].connections[].pscAutoConnection.forwardingRule`	`string` Output only. The URI of the consumer side forwarding rule. Format: projects/{project}/regions/{region}/forwardingRules/{forwarding_rule}
`observedState.endpoints[].connections[].pscAutoConnection.ipAddress`	`string` Output only. The IP allocated on the consumer network for the PSC forwarding rule.
`observedState.endpoints[].connections[].pscAutoConnection.port`	`integer` Optional. Output only. port will only be set for Primary/Reader or Discovery endpoint.
`observedState.endpoints[].connections[].pscAutoConnection.pscConnectionID`	`string` Output only. The PSC connection id of the forwarding rule connected to the service attachment.
`observedState.endpoints[].connections[].pscAutoConnection.pscConnectionStatus`	`string` Output only. The status of the PSC connection: whether a connection exists and ACTIVE or it no longer exists. Note that this value is updated periodically. Please use Private Service Connect APIs for the latest status.
`observedState.endpoints[].connections[].pscAutoConnection.serviceAttachment`	`string` Output only. The service attachment which is the target of the PSC connection, in the form of projects/{project-id}/regions/{region}/serviceAttachments/{service-attachment-id}.
`observedState.nodeConfig`	`object` Output only. Configuration of individual nodes of the instance.
`observedState.nodeConfig.sizeGB`	`float` Output only. Memory size in GB of the node.
`observedState.state`	`string` Output only. Current state of the instance.
`observedState.stateInfo`	`object` Output only. Additional information about the state of the instance.
`observedState.stateInfo.updateInfo`	`object` Output only. Describes ongoing update when instance state is UPDATING.
`observedState.uid`	`string` Output only. System assigned, unique identifier for the instance.
`observedState.updateTime`	`string` Output only. Latest update timestamp of the instance.

Sample YAML(s)

Typical Use Case

# Copyright 2026 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

apiVersion: memorystore.cnrm.cloud.google.com/v1beta1
kind: MemorystoreInstance
metadata:
  name: memorystoreinstance-sample
spec:
  shardCount: 6
  location: us-central1
  projectRef:
    external: projects/${PROJECT_ID?}
  replicaCount: 2
  nodeType: STANDARD_SMALL
  transitEncryptionMode: SERVER_AUTHENTICATION
  authorizationMode: IAM_AUTH
  engineVersion: VALKEY_7_2
  engineConfigs:
    maxmemory-policy: volatile-ttl
  zoneDistributionConfig:
    mode: SINGLE_ZONE
    zone: us-central1-b
  persistenceConfig:
    mode: AOF
    aofConfig:
      appendFsync: EVERY_SEC
  deletionProtectionEnabled: true
  endpoints:
  - connections:
    - pscAutoConnection:
          networkRef:
            name: memorystoreinstance-dep
          projectRef:
            external: projects/${PROJECT_ID?}
  mode: CLUSTER
  labels:
    key1: val1
    key2: val2
---
apiVersion: compute.cnrm.cloud.google.com/v1beta1
kind: ComputeNetwork
metadata:
  name: memorystoreinstance-dep
spec:
  description: Test network for the project
  autoCreateSubnetworks: false
---
apiVersion: compute.cnrm.cloud.google.com/v1beta1
kind: ComputeSubnetwork
metadata:
  name: memorystoreinstance-dep
spec:
  ipCidrRange: 10.128.0.0/20
  region: us-central1
  networkRef:
    name: memorystoreinstance-dep
---
apiVersion: networkconnectivity.cnrm.cloud.google.com/v1alpha1
kind: NetworkConnectivityServiceConnectionPolicy
metadata:
  name: memorystoreinstance-dep
  labels:
    label-one: "value-one"
spec:
  projectRef:
    external: projects/${PROJECT_ID?}
  location: us-central1
  serviceClass: "gcp-memorystore"
  description: "Service Connection Policy for memorystore"
  networkRef:
    name: memorystoreinstance-dep
  pscConfig:
    subnetworkRefs:
    - name: memorystoreinstance-dep