feat(storage-control): add Anywhere Cache samples with 2026 copyright

This commit adds 7 code samples for managing Anywhere Cache using the
Storage Control API, placed in the `samples/handwritten` directory.
Each file features a 2026 copyright header.

Samples included:
- Create Anywhere Cache
- Get Anywhere Cache
- List Anywhere Caches
- Update Anywhere Cache
- Pause Anywhere Cache
- Resume Anywhere Cache
- Disable Anywhere Cache

A corresponding test suite is added in `tests/system` to verify the
samples using mocks.

Co-authored-by: nidhiii-27 <224584462+nidhiii-27@users.noreply.github.com>

Author: google-labs-jules[bot]

packages/google-cloud-storage-control/samples/handwritten/storage_control_create_anywhere_cache.py

@@ -0,0 +1,48 @@
+# 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.
+
+# [START storage_control_create_anywhere_cache]
+def create_anywhere_cache(bucket_name: str, zone: str):
+    """
+    Creates an Anywhere Cache instance.
+    """
+    # bucket_name = "your-bucket-name"
+    # zone = "us-central1-a"
+
+    from google.cloud import storage_control_v2
+
+    client = storage_control_v2.StorageControlClient()
+
+    # The resource name of the bucket to which this Anywhere Cache belongs.
+    parent = f"projects/_/buckets/{bucket_name}"
+
+    anywhere_cache = storage_control_v2.AnywhereCache(
+        zone=zone,
+    )
+
+    request = storage_control_v2.CreateAnywhereCacheRequest(
+        parent=parent,
+        anywhere_cache=anywhere_cache,
+    )
+
+    operation = client.create_anywhere_cache(request=request)
+
+    print(f"Waiting for operation {operation.operation.name} to complete...")
+    response = operation.result()
+
+    print(f"Anywhere Cache created: {response.name}")
+    return response
+
+
+# [END storage_control_create_anywhere_cache]

packages/google-cloud-storage-control/samples/handwritten/storage_control_disable_anywhere_cache.py

@@ -0,0 +1,42 @@
+# 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.
+
+# [START storage_control_disable_anywhere_cache]
+def disable_anywhere_cache(bucket_name: str, anywhere_cache_id: str):
+    """
+    Disables an Anywhere Cache instance.
+    """
+    # bucket_name = "your-bucket-name"
+    # anywhere_cache_id = "your-anywhere-cache-id"
+
+    from google.cloud import storage_control_v2
+
+    client = storage_control_v2.StorageControlClient()
+
+    # The resource name of the Anywhere Cache instance.
+    # Format: projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}
+    name = f"projects/_/buckets/{bucket_name}/anywhereCaches/{anywhere_cache_id}"
+
+    request = storage_control_v2.DisableAnywhereCacheRequest(
+        name=name,
+    )
+
+    response = client.disable_anywhere_cache(request=request)
+
+    print(f"Anywhere Cache disabled: {response.name}")
+    print(f"Anywhere Cache state: {response.state}")
+    return response
+
+
+# [END storage_control_disable_anywhere_cache]

packages/google-cloud-storage-control/samples/handwritten/storage_control_get_anywhere_cache.py

@@ -0,0 +1,42 @@
+# 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.
+
+# [START storage_control_get_anywhere_cache]
+def get_anywhere_cache(bucket_name: str, anywhere_cache_id: str):
+    """
+    Gets an Anywhere Cache instance.
+    """
+    # bucket_name = "your-bucket-name"
+    # anywhere_cache_id = "your-anywhere-cache-id"
+
+    from google.cloud import storage_control_v2
+
+    client = storage_control_v2.StorageControlClient()
+
+    # The resource name of the Anywhere Cache instance.
+    # Format: projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}
+    name = f"projects/_/buckets/{bucket_name}/anywhereCaches/{anywhere_cache_id}"
+
+    request = storage_control_v2.GetAnywhereCacheRequest(
+        name=name,
+    )
+
+    response = client.get_anywhere_cache(request=request)
+
+    print(f"Anywhere Cache name: {response.name}")
+    print(f"Anywhere Cache state: {response.state}")
+    return response
+
+
+# [END storage_control_get_anywhere_cache]

packages/google-cloud-storage-control/samples/handwritten/storage_control_list_anywhere_caches.py

@@ -0,0 +1,42 @@
+# 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.
+
+# [START storage_control_list_anywhere_caches]
+def list_anywhere_caches(bucket_name: str):
+    """
+    Lists Anywhere Cache instances for a given bucket.
+    """
+    # bucket_name = "your-bucket-name"
+
+    from google.cloud import storage_control_v2
+
+    client = storage_control_v2.StorageControlClient()
+
+    # The bucket to which this Anywhere Cache belongs.
+    # Format: projects/{project}/buckets/{bucket}
+    parent = f"projects/_/buckets/{bucket_name}"
+
+    request = storage_control_v2.ListAnywhereCachesRequest(
+        parent=parent,
+    )
+
+    page_result = client.list_anywhere_caches(request=request)
+
+    for anywhere_cache in page_result:
+        print(f"Anywhere Cache name: {anywhere_cache.name}")
+
+    return page_result
+
+
+# [END storage_control_list_anywhere_caches]

packages/google-cloud-storage-control/samples/handwritten/storage_control_pause_anywhere_cache.py

@@ -0,0 +1,42 @@
+# 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.
+
+# [START storage_control_pause_anywhere_cache]
+def pause_anywhere_cache(bucket_name: str, anywhere_cache_id: str):
+    """
+    Pauses an Anywhere Cache instance.
+    """
+    # bucket_name = "your-bucket-name"
+    # anywhere_cache_id = "your-anywhere-cache-id"
+
+    from google.cloud import storage_control_v2
+
+    client = storage_control_v2.StorageControlClient()
+
+    # The resource name of the Anywhere Cache instance.
+    # Format: projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}
+    name = f"projects/_/buckets/{bucket_name}/anywhereCaches/{anywhere_cache_id}"
+
+    request = storage_control_v2.PauseAnywhereCacheRequest(
+        name=name,
+    )
+
+    response = client.pause_anywhere_cache(request=request)
+
+    print(f"Anywhere Cache paused: {response.name}")
+    print(f"Anywhere Cache state: {response.state}")
+    return response
+
+
+# [END storage_control_pause_anywhere_cache]

packages/google-cloud-storage-control/samples/handwritten/storage_control_resume_anywhere_cache.py

@@ -0,0 +1,42 @@
+# 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.
+
+# [START storage_control_resume_anywhere_cache]
+def resume_anywhere_cache(bucket_name: str, anywhere_cache_id: str):
+    """
+    Resumes a disabled or paused Anywhere Cache instance.
+    """
+    # bucket_name = "your-bucket-name"
+    # anywhere_cache_id = "your-anywhere-cache-id"
+
+    from google.cloud import storage_control_v2
+
+    client = storage_control_v2.StorageControlClient()
+
+    # The resource name of the Anywhere Cache instance.
+    # Format: projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}
+    name = f"projects/_/buckets/{bucket_name}/anywhereCaches/{anywhere_cache_id}"
+
+    request = storage_control_v2.ResumeAnywhereCacheRequest(
+        name=name,
+    )
+
+    response = client.resume_anywhere_cache(request=request)
+
+    print(f"Anywhere Cache resumed: {response.name}")
+    print(f"Anywhere Cache state: {response.state}")
+    return response
+
+
+# [END storage_control_resume_anywhere_cache]

packages/google-cloud-storage-control/samples/handwritten/storage_control_update_anywhere_cache.py

@@ -0,0 +1,55 @@
+# 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.
+
+# [START storage_control_update_anywhere_cache]
+def update_anywhere_cache(bucket_name: str, anywhere_cache_id: str, admission_policy: str):
+    """
+    Updates an Anywhere Cache instance. Mutable fields include `ttl` and `admission_policy`.
+    """
+    # bucket_name = "your-bucket-name"
+    # anywhere_cache_id = "your-anywhere-cache-id"
+    # admission_policy = "admit-on-second-miss"
+
+    from google.cloud import storage_control_v2
+    from google.protobuf import field_mask_pb2
+
+    client = storage_control_v2.StorageControlClient()
+
+    # The resource name of the Anywhere Cache instance to be updated.
+    # Format: projects/{project}/buckets/{bucket}/anywhereCaches/{anywhere_cache}
+    name = f"projects/_/buckets/{bucket_name}/anywhereCaches/{anywhere_cache_id}"
+
+    anywhere_cache = storage_control_v2.AnywhereCache(
+        name=name,
+        admission_policy=admission_policy,
+    )
+
+    update_mask = field_mask_pb2.FieldMask(paths=["admission_policy"])
+
+    request = storage_control_v2.UpdateAnywhereCacheRequest(
+        anywhere_cache=anywhere_cache,
+        update_mask=update_mask,
+    )
+
+    operation = client.update_anywhere_cache(request=request)
+
+    print(f"Waiting for operation {operation.operation.name} to complete...")
+    response = operation.result()
+
+    print(f"Anywhere Cache updated: {response.name}")
+    print(f"Admission policy: {response.admission_policy}")
+    return response
+
+
+# [END storage_control_update_anywhere_cache]