StorageAnywhereCache

Property Value
Google Cloud Service Name Cloud Storage
Google Cloud Service Documentation /storage/docs/
Google Cloud REST Resource Name v1.AnywhereCache
Google Cloud REST Resource Documentation /storage/docs/json_api/v1/AnywhereCache
Config Connector Resource Short Names gcpstorageanywherecache
gcpstorageanywherecaches
storageanywherecache
Config Connector Service Name storage.googleapis.com
Config Connector Resource Fully Qualified Name storageanywherecaches.storage.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

admissionPolicy: string
bucketRef:
  external: string
  name: string
  namespace: string
desiredState: string
resourceID: string
ttl: string
zone: string
Fields

admissionPolicy

Optional

string

Cache admission policy. Valid values includes: `admit-on-first-miss` and `admit-on-second-miss`. Defaults to `admit-on-first-miss`.

bucketRef

Required

object

Immutable. The reference to bucket where cache needs to be created.

bucketRef.external

Optional

string

The StorageBucket selfLink, when not managed by Config Connector.

bucketRef.name

Optional

string

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

bucketRef.namespace

Optional

string

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

desiredState

Optional

string

The desired state of the cache. Possible values include "running", "disabled", and "paused". If not specified, the default value is "running". This field controls the runtime behavior of the cache. Please note that changes to the `desiredState` are prioritized over any other updates. For instance, if both the `desiredState` and `ttl` are updated simultaneously, the state would be updated first, followed by `ttl`.

resourceID

Optional

string

The AnywhereCacheID generated via backend. This field manages an existing cache.

ttl

Optional

string

Cache entry TTL (ranges between 1h to 7d). This is a cache-level config that defines how long a cache entry can live. Defaults to "86400s". TTL must be in whole seconds.

zone

Required

string

Immutable. The zone in which the cache instance needs to be created. For example, us-central1-a.

Status

Schema

conditions:
- lastTransitionTime: string
  message: string
  reason: string
  status: string
  type: string
externalRef: string
observedGeneration: integer
observedState:
  createTime: string
  pendingUpdate: boolean
  state: 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 StorageAnywhereCache resource in GCP.
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. Time when Anywhere cache instance is allocated.
observedState.pendingUpdate

boolean

Output only. True if there is an active update operation against this cache instance. Subsequent update requests will be rejected if this field is true. Output only.
observedState.state

string

Output only. Cache state including "running", "creating", "disabled" and "paused".
observedState.updateTime

string

Output only. Time when Anywhere cache instance is last updated, including creation.

Sample YAML(s)

Typical Use Case

# Copyright 2025 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: storage.cnrm.cloud.google.com/v1beta1
kind: StorageAnywhereCache
metadata:
  name: storageanywherecache-sample
  annotations:
    cnrm.cloud.google.com/reconcile-interval-in-seconds: "20"
spec:
  bucketRef:
    name: ${PROJECT_ID?}-storageanywherecache-dep
  zone: us-central1-a
  admissionPolicy: admit-on-second-miss
  desiredState: running
  ttl: 56400s
---
apiVersion: storage.cnrm.cloud.google.com/v1beta1
kind: StorageBucket
metadata:
  # StorageBucket names must be globally unique. Replace ${PROJECT_ID?} with your project ID.
  name: ${PROJECT_ID?}-storageanywherecache-dep