feat: Adding support for new Security Center Management Apis

docs: update comment formatting throughout API PiperOrigin-RevId: 636222407 Source-Link: googleapis/googleapis@060fd8d Source-Link: googleapis/googleapis-gen@939618f Copy-Tag: eyJwIjoiYXBpcy9Hb29nbGUuQ2xvdWQuU2VjdXJpdHlDZW50ZXJNYW5hZ2VtZW50LlYxLy5Pd2xCb3QueWFtbCIsImgiOiI5Mzk2MThmZmE0NmFhMDNjYzEyZDRmNjI1YmQzODQzMjIxZTY3NmJhIn0=
googleapis · May 22, 2024 · 1ab8dfd · 1ab8dfd
1 parent a264095
commit 1ab8dfd
Show file tree

Hide file tree

Showing 27 changed files with 7,509 additions and 1,381 deletions.
diff --git a/...eneratedSnippets/SecurityCenterManagementClient.GetSecurityCenterServiceAsyncSnippet.g.cs b/...eneratedSnippets/SecurityCenterManagementClient.GetSecurityCenterServiceAsyncSnippet.g.cs
@@ -0,0 +1,44 @@
+// Copyright 2024 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 securitycentermanagement_v1_generated_SecurityCenterManagement_GetSecurityCenterService_async_flattened]
+    using Google.Cloud.SecurityCenterManagement.V1;
+    using System.Threading.Tasks;
+
+    public sealed partial class GeneratedSecurityCenterManagementClientSnippets
+    {
+        /// <summary>Snippet for GetSecurityCenterServiceAsync</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 GetSecurityCenterServiceAsync()
+        {
+            // Create client
+            SecurityCenterManagementClient securityCenterManagementClient = await SecurityCenterManagementClient.CreateAsync();
+            // Initialize request argument(s)
+            string name = "projects/[PROJECT]/locations/[LOCATION]/securityCenterServices/[SERVICE]";
+            // Make the request
+            SecurityCenterService response = await securityCenterManagementClient.GetSecurityCenterServiceAsync(name);
+        }
+    }
+    // [END securitycentermanagement_v1_generated_SecurityCenterManagement_GetSecurityCenterService_async_flattened]
+}
diff --git a/...ets/SecurityCenterManagementClient.GetSecurityCenterServiceRequestObjectAsyncSnippet.g.cs b/...ets/SecurityCenterManagementClient.GetSecurityCenterServiceRequestObjectAsyncSnippet.g.cs
@@ -0,0 +1,47 @@
+// Copyright 2024 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 securitycentermanagement_v1_generated_SecurityCenterManagement_GetSecurityCenterService_async]
+    using Google.Cloud.SecurityCenterManagement.V1;
+    using System.Threading.Tasks;
+
+    public sealed partial class GeneratedSecurityCenterManagementClientSnippets
+    {
+        /// <summary>Snippet for GetSecurityCenterServiceAsync</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 GetSecurityCenterServiceRequestObjectAsync()
+        {
+            // Create client
+            SecurityCenterManagementClient securityCenterManagementClient = await SecurityCenterManagementClient.CreateAsync();
+            // Initialize request argument(s)
+            GetSecurityCenterServiceRequest request = new GetSecurityCenterServiceRequest
+            {
+                SecurityCenterServiceName = SecurityCenterServiceName.FromProjectLocationService("[PROJECT]", "[LOCATION]", "[SERVICE]"),
+            };
+            // Make the request
+            SecurityCenterService response = await securityCenterManagementClient.GetSecurityCenterServiceAsync(request);
+        }
+    }
+    // [END securitycentermanagement_v1_generated_SecurityCenterManagement_GetSecurityCenterService_async]
+}
diff --git a/...Snippets/SecurityCenterManagementClient.GetSecurityCenterServiceRequestObjectSnippet.g.cs b/...Snippets/SecurityCenterManagementClient.GetSecurityCenterServiceRequestObjectSnippet.g.cs
@@ -0,0 +1,46 @@
+// Copyright 2024 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 securitycentermanagement_v1_generated_SecurityCenterManagement_GetSecurityCenterService_sync]
+    using Google.Cloud.SecurityCenterManagement.V1;
+
+    public sealed partial class GeneratedSecurityCenterManagementClientSnippets
+    {
+        /// <summary>Snippet for GetSecurityCenterService</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 GetSecurityCenterServiceRequestObject()
+        {
+            // Create client
+            SecurityCenterManagementClient securityCenterManagementClient = SecurityCenterManagementClient.Create();
+            // Initialize request argument(s)
+            GetSecurityCenterServiceRequest request = new GetSecurityCenterServiceRequest
+            {
+                SecurityCenterServiceName = SecurityCenterServiceName.FromProjectLocationService("[PROJECT]", "[LOCATION]", "[SERVICE]"),
+            };
+            // Make the request
+            SecurityCenterService response = securityCenterManagementClient.GetSecurityCenterService(request);
+        }
+    }
+    // [END securitycentermanagement_v1_generated_SecurityCenterManagement_GetSecurityCenterService_sync]
+}
diff --git a/...ets/SecurityCenterManagementClient.GetSecurityCenterServiceResourceNamesAsyncSnippet.g.cs b/...ets/SecurityCenterManagementClient.GetSecurityCenterServiceResourceNamesAsyncSnippet.g.cs
@@ -0,0 +1,44 @@
+// Copyright 2024 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 securitycentermanagement_v1_generated_SecurityCenterManagement_GetSecurityCenterService_async_flattened_resourceNames]
+    using Google.Cloud.SecurityCenterManagement.V1;
+    using System.Threading.Tasks;
+
+    public sealed partial class GeneratedSecurityCenterManagementClientSnippets
+    {
+        /// <summary>Snippet for GetSecurityCenterServiceAsync</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 GetSecurityCenterServiceResourceNamesAsync()
+        {
+            // Create client
+            SecurityCenterManagementClient securityCenterManagementClient = await SecurityCenterManagementClient.CreateAsync();
+            // Initialize request argument(s)
+            SecurityCenterServiceName name = SecurityCenterServiceName.FromProjectLocationService("[PROJECT]", "[LOCATION]", "[SERVICE]");
+            // Make the request
+            SecurityCenterService response = await securityCenterManagementClient.GetSecurityCenterServiceAsync(name);
+        }
+    }
+    // [END securitycentermanagement_v1_generated_SecurityCenterManagement_GetSecurityCenterService_async_flattened_resourceNames]
+}
diff --git a/...Snippets/SecurityCenterManagementClient.GetSecurityCenterServiceResourceNamesSnippet.g.cs b/...Snippets/SecurityCenterManagementClient.GetSecurityCenterServiceResourceNamesSnippet.g.cs
@@ -0,0 +1,43 @@
+// Copyright 2024 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 securitycentermanagement_v1_generated_SecurityCenterManagement_GetSecurityCenterService_sync_flattened_resourceNames]
+    using Google.Cloud.SecurityCenterManagement.V1;
+
+    public sealed partial class GeneratedSecurityCenterManagementClientSnippets
+    {
+        /// <summary>Snippet for GetSecurityCenterService</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 GetSecurityCenterServiceResourceNames()
+        {
+            // Create client
+            SecurityCenterManagementClient securityCenterManagementClient = SecurityCenterManagementClient.Create();
+            // Initialize request argument(s)
+            SecurityCenterServiceName name = SecurityCenterServiceName.FromProjectLocationService("[PROJECT]", "[LOCATION]", "[SERVICE]");
+            // Make the request
+            SecurityCenterService response = securityCenterManagementClient.GetSecurityCenterService(name);
+        }
+    }
+    // [END securitycentermanagement_v1_generated_SecurityCenterManagement_GetSecurityCenterService_sync_flattened_resourceNames]
+}
diff --git a/....V1.GeneratedSnippets/SecurityCenterManagementClient.GetSecurityCenterServiceSnippet.g.cs b/....V1.GeneratedSnippets/SecurityCenterManagementClient.GetSecurityCenterServiceSnippet.g.cs
@@ -0,0 +1,43 @@
+// Copyright 2024 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 securitycentermanagement_v1_generated_SecurityCenterManagement_GetSecurityCenterService_sync_flattened]
+    using Google.Cloud.SecurityCenterManagement.V1;
+
+    public sealed partial class GeneratedSecurityCenterManagementClientSnippets
+    {
+        /// <summary>Snippet for GetSecurityCenterService</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 GetSecurityCenterService()
+        {
+            // Create client
+            SecurityCenterManagementClient securityCenterManagementClient = SecurityCenterManagementClient.Create();
+            // Initialize request argument(s)
+            string name = "projects/[PROJECT]/locations/[LOCATION]/securityCenterServices/[SERVICE]";
+            // Make the request
+            SecurityCenterService response = securityCenterManagementClient.GetSecurityCenterService(name);
+        }
+    }
+    // [END securitycentermanagement_v1_generated_SecurityCenterManagement_GetSecurityCenterService_sync_flattened]
+}
diff --git a/...eratedSnippets/SecurityCenterManagementClient.ListSecurityCenterServicesAsyncSnippet.g.cs b/...eratedSnippets/SecurityCenterManagementClient.ListSecurityCenterServicesAsyncSnippet.g.cs
@@ -0,0 +1,79 @@
+// Copyright 2024 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 securitycentermanagement_v1_generated_SecurityCenterManagement_ListSecurityCenterServices_async_flattened]
+    using Google.Api.Gax;
+    using Google.Cloud.SecurityCenterManagement.V1;
+    using System;
+    using System.Linq;
+    using System.Threading.Tasks;
+
+    public sealed partial class GeneratedSecurityCenterManagementClientSnippets
+    {
+        /// <summary>Snippet for ListSecurityCenterServicesAsync</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 ListSecurityCenterServicesAsync()
+        {
+            // Create client
+            SecurityCenterManagementClient securityCenterManagementClient = await SecurityCenterManagementClient.CreateAsync();
+            // Initialize request argument(s)
+            string parent = "projects/[PROJECT]/locations/[LOCATION]";
+            // Make the request
+            PagedAsyncEnumerable<ListSecurityCenterServicesResponse, SecurityCenterService> response = securityCenterManagementClient.ListSecurityCenterServicesAsync(parent);
+
+            // Iterate over all response items, lazily performing RPCs as required
+            await response.ForEachAsync((SecurityCenterService item) =>
+            {
+                // Do something with each item
+                Console.WriteLine(item);
+            });
+
+            // Or iterate over pages (of server-defined size), performing one RPC per page
+            await response.AsRawResponses().ForEachAsync((ListSecurityCenterServicesResponse page) =>
+            {
+                // Do something with each page of items
+                Console.WriteLine("A page of results:");
+                foreach (SecurityCenterService item in page)
+                {
+                    // Do something with each item
+                    Console.WriteLine(item);
+                }
+            });
+
+            // Or retrieve a single page of known size (unless it's the final page), performing as many RPCs as required
+            int pageSize = 10;
+            Page<SecurityCenterService> singlePage = await response.ReadPageAsync(pageSize);
+            // Do something with the page of items
+            Console.WriteLine($"A page of {pageSize} results (unless it's the final page):");
+            foreach (SecurityCenterService item in singlePage)
+            {
+                // Do something with each item
+                Console.WriteLine(item);
+            }
+            // Store the pageToken, for when the next page is required.
+            string nextPageToken = singlePage.NextPageToken;
+        }
+    }
+    // [END securitycentermanagement_v1_generated_SecurityCenterManagement_ListSecurityCenterServices_async_flattened]
+}