feat: Add Anywhere cache control APIs (googleapis#14427)

docs: Added comments for Anywhere cache messages

PiperOrigin-RevId: 735570925

Source-Link: googleapis/googleapis@66ab6ce

Source-Link: https://github.com/googleapis/googleapis-gen/commit/8f7d5dba0f0418d1f03ce56a767f251b8b69ca3e
Copy-Tag: eyJwIjoiYXBpcy9Hb29nbGUuQ2xvdWQuU3RvcmFnZS5Db250cm9sLlYyLy5Pd2xCb3QueWFtbCIsImgiOiI4ZjdkNWRiYTBmMDQxOGQxZjAzY2U1NmE3NjdmMjUxYjhiNjljYTNlIn0=

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

apis/Google.Cloud.Storage.Control.V2/Google.Cloud.Storage.Control.V2.GeneratedSnippets/StorageControlClient.CreateAnywhereCacheAsyncSnippet.g.cs

@@ -0,0 +1,63 @@
+// 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
+//
+//     https://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.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START storage_v2_generated_StorageControl_CreateAnywhereCache_async_flattened]
+    using Google.Cloud.Storage.Control.V2;
+    using Google.LongRunning;
+    using System.Threading.Tasks;
+
+    public sealed partial class GeneratedStorageControlClientSnippets
+    {
+        /// <summary>Snippet for CreateAnywhereCacheAsync</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public async Task CreateAnywhereCacheAsync()
+        {
+            // Create client
+            StorageControlClient storageControlClient = await StorageControlClient.CreateAsync();
+            // Initialize request argument(s)
+            string parent = "projects/[PROJECT]/buckets/[BUCKET]";
+            AnywhereCache anywhereCache = new AnywhereCache();
+            string anywhereCacheId = "";
+            // Make the request
+            Operation<AnywhereCache, CreateAnywhereCacheMetadata> response = await storageControlClient.CreateAnywhereCacheAsync(parent, anywhereCache, anywhereCacheId);
+
+            // Poll until the returned long-running operation is complete
+            Operation<AnywhereCache, CreateAnywhereCacheMetadata> completedResponse = await response.PollUntilCompletedAsync();
+            // Retrieve the operation result
+            AnywhereCache result = completedResponse.Result;
+
+            // Or get the name of the operation
+            string operationName = response.Name;
+            // This name can be stored, then the long-running operation retrieved later by name
+            Operation<AnywhereCache, CreateAnywhereCacheMetadata> retrievedResponse = await storageControlClient.PollOnceCreateAnywhereCacheAsync(operationName);
+            // Check if the retrieved long-running operation has completed
+            if (retrievedResponse.IsCompleted)
+            {
+                // If it has completed, then access the result
+                AnywhereCache retrievedResult = retrievedResponse.Result;
+            }
+        }
+    }
+    // [END storage_v2_generated_StorageControl_CreateAnywhereCache_async_flattened]
+}

apis/Google.Cloud.Storage.Control.V2/Google.Cloud.Storage.Control.V2.GeneratedSnippets/StorageControlClient.CreateAnywhereCacheRequestObjectAsyncSnippet.g.cs

@@ -0,0 +1,67 @@
+// 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
+//
+//     https://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.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START storage_v2_generated_StorageControl_CreateAnywhereCache_async]
+    using Google.Cloud.Storage.Control.V2;
+    using Google.LongRunning;
+    using System.Threading.Tasks;
+
+    public sealed partial class GeneratedStorageControlClientSnippets
+    {
+        /// <summary>Snippet for CreateAnywhereCacheAsync</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public async Task CreateAnywhereCacheRequestObjectAsync()
+        {
+            // Create client
+            StorageControlClient storageControlClient = await StorageControlClient.CreateAsync();
+            // Initialize request argument(s)
+            CreateAnywhereCacheRequest request = new CreateAnywhereCacheRequest
+            {
+                ParentAsBucketName = BucketName.FromProjectBucket("[PROJECT]", "[BUCKET]"),
+                AnywhereCacheId = "",
+                AnywhereCache = new AnywhereCache(),
+                RequestId = "",
+            };
+            // Make the request
+            Operation<AnywhereCache, CreateAnywhereCacheMetadata> response = await storageControlClient.CreateAnywhereCacheAsync(request);
+
+            // Poll until the returned long-running operation is complete
+            Operation<AnywhereCache, CreateAnywhereCacheMetadata> completedResponse = await response.PollUntilCompletedAsync();
+            // Retrieve the operation result
+            AnywhereCache result = completedResponse.Result;
+
+            // Or get the name of the operation
+            string operationName = response.Name;
+            // This name can be stored, then the long-running operation retrieved later by name
+            Operation<AnywhereCache, CreateAnywhereCacheMetadata> retrievedResponse = await storageControlClient.PollOnceCreateAnywhereCacheAsync(operationName);
+            // Check if the retrieved long-running operation has completed
+            if (retrievedResponse.IsCompleted)
+            {
+                // If it has completed, then access the result
+                AnywhereCache retrievedResult = retrievedResponse.Result;
+            }
+        }
+    }
+    // [END storage_v2_generated_StorageControl_CreateAnywhereCache_async]
+}

apis/Google.Cloud.Storage.Control.V2/Google.Cloud.Storage.Control.V2.GeneratedSnippets/StorageControlClient.CreateAnywhereCacheRequestObjectSnippet.g.cs

@@ -0,0 +1,66 @@
+// 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
+//
+//     https://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.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START storage_v2_generated_StorageControl_CreateAnywhereCache_sync]
+    using Google.Cloud.Storage.Control.V2;
+    using Google.LongRunning;
+
+    public sealed partial class GeneratedStorageControlClientSnippets
+    {
+        /// <summary>Snippet for CreateAnywhereCache</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public void CreateAnywhereCacheRequestObject()
+        {
+            // Create client
+            StorageControlClient storageControlClient = StorageControlClient.Create();
+            // Initialize request argument(s)
+            CreateAnywhereCacheRequest request = new CreateAnywhereCacheRequest
+            {
+                ParentAsBucketName = BucketName.FromProjectBucket("[PROJECT]", "[BUCKET]"),
+                AnywhereCacheId = "",
+                AnywhereCache = new AnywhereCache(),
+                RequestId = "",
+            };
+            // Make the request
+            Operation<AnywhereCache, CreateAnywhereCacheMetadata> response = storageControlClient.CreateAnywhereCache(request);
+
+            // Poll until the returned long-running operation is complete
+            Operation<AnywhereCache, CreateAnywhereCacheMetadata> completedResponse = response.PollUntilCompleted();
+            // Retrieve the operation result
+            AnywhereCache result = completedResponse.Result;
+
+            // Or get the name of the operation
+            string operationName = response.Name;
+            // This name can be stored, then the long-running operation retrieved later by name
+            Operation<AnywhereCache, CreateAnywhereCacheMetadata> retrievedResponse = storageControlClient.PollOnceCreateAnywhereCache(operationName);
+            // Check if the retrieved long-running operation has completed
+            if (retrievedResponse.IsCompleted)
+            {
+                // If it has completed, then access the result
+                AnywhereCache retrievedResult = retrievedResponse.Result;
+            }
+        }
+    }
+    // [END storage_v2_generated_StorageControl_CreateAnywhereCache_sync]
+}

apis/Google.Cloud.Storage.Control.V2/Google.Cloud.Storage.Control.V2.GeneratedSnippets/StorageControlClient.CreateAnywhereCacheResourceNamesAsyncSnippet.g.cs

@@ -0,0 +1,63 @@
+// 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
+//
+//     https://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.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START storage_v2_generated_StorageControl_CreateAnywhereCache_async_flattened_resourceNames]
+    using Google.Cloud.Storage.Control.V2;
+    using Google.LongRunning;
+    using System.Threading.Tasks;
+
+    public sealed partial class GeneratedStorageControlClientSnippets
+    {
+        /// <summary>Snippet for CreateAnywhereCacheAsync</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public async Task CreateAnywhereCacheResourceNamesAsync()
+        {
+            // Create client
+            StorageControlClient storageControlClient = await StorageControlClient.CreateAsync();
+            // Initialize request argument(s)
+            BucketName parent = BucketName.FromProjectBucket("[PROJECT]", "[BUCKET]");
+            AnywhereCache anywhereCache = new AnywhereCache();
+            string anywhereCacheId = "";
+            // Make the request
+            Operation<AnywhereCache, CreateAnywhereCacheMetadata> response = await storageControlClient.CreateAnywhereCacheAsync(parent, anywhereCache, anywhereCacheId);
+
+            // Poll until the returned long-running operation is complete
+            Operation<AnywhereCache, CreateAnywhereCacheMetadata> completedResponse = await response.PollUntilCompletedAsync();
+            // Retrieve the operation result
+            AnywhereCache result = completedResponse.Result;
+
+            // Or get the name of the operation
+            string operationName = response.Name;
+            // This name can be stored, then the long-running operation retrieved later by name
+            Operation<AnywhereCache, CreateAnywhereCacheMetadata> retrievedResponse = await storageControlClient.PollOnceCreateAnywhereCacheAsync(operationName);
+            // Check if the retrieved long-running operation has completed
+            if (retrievedResponse.IsCompleted)
+            {
+                // If it has completed, then access the result
+                AnywhereCache retrievedResult = retrievedResponse.Result;
+            }
+        }
+    }
+    // [END storage_v2_generated_StorageControl_CreateAnywhereCache_async_flattened_resourceNames]
+}

apis/Google.Cloud.Storage.Control.V2/Google.Cloud.Storage.Control.V2.GeneratedSnippets/StorageControlClient.CreateAnywhereCacheResourceNamesSnippet.g.cs

@@ -0,0 +1,62 @@
+// 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
+//
+//     https://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.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START storage_v2_generated_StorageControl_CreateAnywhereCache_sync_flattened_resourceNames]
+    using Google.Cloud.Storage.Control.V2;
+    using Google.LongRunning;
+
+    public sealed partial class GeneratedStorageControlClientSnippets
+    {
+        /// <summary>Snippet for CreateAnywhereCache</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public void CreateAnywhereCacheResourceNames()
+        {
+            // Create client
+            StorageControlClient storageControlClient = StorageControlClient.Create();
+            // Initialize request argument(s)
+            BucketName parent = BucketName.FromProjectBucket("[PROJECT]", "[BUCKET]");
+            AnywhereCache anywhereCache = new AnywhereCache();
+            string anywhereCacheId = "";
+            // Make the request
+            Operation<AnywhereCache, CreateAnywhereCacheMetadata> response = storageControlClient.CreateAnywhereCache(parent, anywhereCache, anywhereCacheId);
+
+            // Poll until the returned long-running operation is complete
+            Operation<AnywhereCache, CreateAnywhereCacheMetadata> completedResponse = response.PollUntilCompleted();
+            // Retrieve the operation result
+            AnywhereCache result = completedResponse.Result;
+
+            // Or get the name of the operation
+            string operationName = response.Name;
+            // This name can be stored, then the long-running operation retrieved later by name
+            Operation<AnywhereCache, CreateAnywhereCacheMetadata> retrievedResponse = storageControlClient.PollOnceCreateAnywhereCache(operationName);
+            // Check if the retrieved long-running operation has completed
+            if (retrievedResponse.IsCompleted)
+            {
+                // If it has completed, then access the result
+                AnywhereCache retrievedResult = retrievedResponse.Result;
+            }
+        }
+    }
+    // [END storage_v2_generated_StorageControl_CreateAnywhereCache_sync_flattened_resourceNames]
+}

apis/Google.Cloud.Storage.Control.V2/Google.Cloud.Storage.Control.V2.GeneratedSnippets/StorageControlClient.CreateAnywhereCacheSnippet.g.cs

@@ -0,0 +1,62 @@
+// 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
+//
+//     https://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.
+
+// Generated code. DO NOT EDIT!
+
+namespace GoogleCSharpSnippets
+{
+    // [START storage_v2_generated_StorageControl_CreateAnywhereCache_sync_flattened]
+    using Google.Cloud.Storage.Control.V2;
+    using Google.LongRunning;
+
+    public sealed partial class GeneratedStorageControlClientSnippets
+    {
+        /// <summary>Snippet for CreateAnywhereCache</summary>
+        /// <remarks>
+        /// This snippet has been automatically generated and should be regarded as a code template only.
+        /// It will require modifications to work:
+        /// - It may require correct/in-range values for request initialization.
+        /// - It may require specifying regional endpoints when creating the service client as shown in
+        ///   https://cloud.google.com/dotnet/docs/reference/help/client-configuration#endpoint.
+        /// </remarks>
+        public void CreateAnywhereCache()
+        {
+            // Create client
+            StorageControlClient storageControlClient = StorageControlClient.Create();
+            // Initialize request argument(s)
+            string parent = "projects/[PROJECT]/buckets/[BUCKET]";
+            AnywhereCache anywhereCache = new AnywhereCache();
+            string anywhereCacheId = "";
+            // Make the request
+            Operation<AnywhereCache, CreateAnywhereCacheMetadata> response = storageControlClient.CreateAnywhereCache(parent, anywhereCache, anywhereCacheId);
+
+            // Poll until the returned long-running operation is complete
+            Operation<AnywhereCache, CreateAnywhereCacheMetadata> completedResponse = response.PollUntilCompleted();
+            // Retrieve the operation result
+            AnywhereCache result = completedResponse.Result;
+
+            // Or get the name of the operation
+            string operationName = response.Name;
+            // This name can be stored, then the long-running operation retrieved later by name
+            Operation<AnywhereCache, CreateAnywhereCacheMetadata> retrievedResponse = storageControlClient.PollOnceCreateAnywhereCache(operationName);
+            // Check if the retrieved long-running operation has completed
+            if (retrievedResponse.IsCompleted)
+            {
+                // If it has completed, then access the result
+                AnywhereCache retrievedResult = retrievedResponse.Result;
+            }
+        }
+    }
+    // [END storage_v2_generated_StorageControl_CreateAnywhereCache_sync_flattened]
+}