google-cloud-security_center-v1 0.25.0 → 0.26.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 78a251e99aa3cc3bfe81741cae881837a4664b1a3c774aba58cfea98d27062f4
-  data.tar.gz: a3d0da9f53f313ed334dc2dbcd3a1927d3a8de6e47571ef518a192d1f1be9fe0
+  metadata.gz: 51dc99d67ee38591128f7547330f3b9ae90005346df0134e640c26dbe654b1c4
+  data.tar.gz: 0bfec05a888c1106cff65021c7a5633e10a51dd5cde26f36ee8788ff3d8ece52
 SHA512:
-  metadata.gz: 0f9ff79caa81c3925328e56b459b8a18edaff9be983677e2a164054026a5f138872e9f4c61fa2564893cf0929e17f1fc854c4e9e5b5c1d9443efd922e9f6f01f
-  data.tar.gz: 1b21eaba1e28a31e247f9b49a0df180882e19f6b7073bf03b77bc2317ccf94dcdda8d58528fd344bd34d3e317052edd4582302bdba7b747550d0664db7a8e895
+  metadata.gz: 8bda3d7720e1d8645ddb8ba6dfb8f5ccfb0a9d1bdedb12c493722a984e43cb0efebc6bb62be7e34e1624e80174fa16a810638aa1fe167344a6eaca5bfa6f3bce
+  data.tar.gz: 8c4340940dfa3e2518cb55cab47af408699494cd640b2e58b854ca3f8d81fe4f1bf5fcf71fb62912caaa47a0c4d2c32d651cbc891b30d26d62c9dbc3d0a1c179

data/README.md

@@ -1,6 +1,6 @@
 # Ruby Client for the Cloud Security Command Center V1 API
 
-API Client library for the Cloud Security Command Center V1 API
+Security Command Center API provides access to temporal views of assets and findings within an organization.
 
 Security Command Center API provides access to temporal views of assets and findings within an organization.
 

data/lib/google/cloud/security_center/v1/rest.rb

@@ -0,0 +1,37 @@
+# frozen_string_literal: true
+
+# Copyright 2023 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.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+require "google/cloud/security_center/v1/security_center/rest"
+require "google/cloud/security_center/v1/version"
+
+module Google
+  module Cloud
+    module SecurityCenter
+      ##
+      # To load just the REST part of this package, including all its services, and instantiate a REST client:
+      #
+      # @example
+      #
+      #     require "google/cloud/security_center/v1/rest"
+      #     client = ::Google::Cloud::SecurityCenter::V1::SecurityCenter::Rest::Client.new
+      #
+      module V1
+      end
+    end
+  end
+end

data/lib/google/cloud/security_center/v1/security_center/client.rb

@@ -305,14 +305,14 @@ module Google
             #   # Call the bulk_mute_findings method.
             #   result = client.bulk_mute_findings request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def bulk_mute_findings request, options = nil
@@ -1452,8 +1452,8 @@ module Google
             #
             #   @param parent [::String]
             #     Required. The name of the parent to group the assets by. Its format is
-            #     "organizations/[organization_id], folders/[folder_id], or
-            #     projects/[project_id]".
+            #     "organizations/[organization_id]", "folders/[folder_id]", or
+            #     "projects/[project_id]".
             #   @param filter [::String]
             #     Expression that defines the filter to apply across assets.
             #     The expression is a list of zero or more restrictions combined via logical
@@ -1597,13 +1597,11 @@ module Google
             #   # Call the group_assets method.
             #   result = client.group_assets request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::SecurityCenter::V1::GroupResult.
-            #     p response
+            #     p item
             #   end
             #
             def group_assets request, options = nil
@@ -1822,13 +1820,11 @@ module Google
             #   # Call the group_findings method.
             #   result = client.group_findings request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::SecurityCenter::V1::GroupResult.
-            #     p response
+            #     p item
             #   end
             #
             def group_findings request, options = nil
@@ -1892,9 +1888,11 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The name of the parent that the listed assets belong to. Its
-            #     format is "organizations/[organization_id], folders/[folder_id], or
-            #     projects/[project_id]".
+            #     Required. The name of the parent resource that contains the assets. The
+            #     value that you can specify on parent depends on the method in which you
+            #     specify parent. You can specify one of the following values:
+            #     "organizations/[organization_id]", "folders/[folder_id]", or
+            #     "projects/[project_id]".
             #   @param filter [::String]
             #     Expression that defines the filter to apply across assets.
             #     The expression is a list of zero or more restrictions combined via logical
@@ -2042,13 +2040,11 @@ module Google
             #   # Call the list_assets method.
             #   result = client.list_assets request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::SecurityCenter::V1::ListAssetsResponse::ListAssetsResult.
-            #     p response
+            #     p item
             #   end
             #
             def list_assets request, options = nil
@@ -2270,13 +2266,11 @@ module Google
             #   # Call the list_findings method.
             #   result = client.list_findings request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::SecurityCenter::V1::ListFindingsResponse::ListFindingsResult.
-            #     p response
+            #     p item
             #   end
             #
             def list_findings request, options = nil
@@ -2375,13 +2369,11 @@ module Google
             #   # Call the list_mute_configs method.
             #   result = client.list_mute_configs request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::SecurityCenter::V1::MuteConfig.
-            #     p response
+            #     p item
             #   end
             #
             def list_mute_configs request, options = nil
@@ -2476,13 +2468,11 @@ module Google
             #   # Call the list_notification_configs method.
             #   result = client.list_notification_configs request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::SecurityCenter::V1::NotificationConfig.
-            #     p response
+            #     p item
             #   end
             #
             def list_notification_configs request, options = nil
@@ -2547,8 +2537,8 @@ module Google
             #
             #   @param parent [::String]
             #     Required. Resource name of the parent of sources to list. Its format should
-            #     be "organizations/[organization_id], folders/[folder_id], or
-            #     projects/[project_id]".
+            #     be "organizations/[organization_id]", "folders/[folder_id]", or
+            #     "projects/[project_id]".
             #   @param page_token [::String]
             #     The value returned by the last `ListSourcesResponse`; indicates
             #     that this is a continuation of a prior `ListSources` call, and
@@ -2577,13 +2567,11 @@ module Google
             #   # Call the list_sources method.
             #   result = client.list_sources request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::SecurityCenter::V1::Source.
-            #     p response
+            #     p item
             #   end
             #
             def list_sources request, options = nil
@@ -2675,14 +2663,14 @@ module Google
             #   # Call the run_asset_discovery method.
             #   result = client.run_asset_discovery request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def run_asset_discovery request, options = nil
@@ -4068,13 +4056,11 @@ module Google
             #   # Call the list_big_query_exports method.
             #   result = client.list_big_query_exports request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Cloud::SecurityCenter::V1::BigQueryExport.
-            #     p response
+            #     p item
             #   end
             #
             def list_big_query_exports request, options = nil

data/lib/google/cloud/security_center/v1/security_center/operations.rb

@@ -158,13 +158,11 @@ module Google
             #   # Call the list_operations method.
             #   result = client.list_operations request
             #
-            #   # The returned object is of type Gapic::PagedEnumerable. You can
-            #   # iterate over all elements by calling #each, and the enumerable
-            #   # will lazily make API calls to fetch subsequent pages. Other
-            #   # methods are also available for managing paging directly.
-            #   result.each do |response|
+            #   # The returned object is of type Gapic::PagedEnumerable. You can iterate
+            #   # over elements, and API calls will be issued to fetch pages as needed.
+            #   result.each do |item|
             #     # Each element is of type ::Google::Longrunning::Operation.
-            #     p response
+            #     p item
             #   end
             #
             def list_operations request, options = nil
@@ -253,14 +251,14 @@ module Google
             #   # Call the get_operation method.
             #   result = client.get_operation request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def get_operation request, options = nil
@@ -540,14 +538,14 @@ module Google
             #   # Call the wait_operation method.
             #   result = client.wait_operation request
             #
-            #   # The returned object is of type Gapic::Operation. You can use this
-            #   # object to check the status of an operation, cancel it, or wait
-            #   # for results. Here is how to block until completion:
+            #   # The returned object is of type Gapic::Operation. You can use it to
+            #   # check the status of an operation, cancel it, or wait for results.
+            #   # Here is how to wait for a response.
             #   result.wait_until_done! timeout: 60
             #   if result.response?
             #     p result.response
             #   else
-            #     puts "Error!"
+            #     puts "No response received."
             #   end
             #
             def wait_operation request, options = nil