google-cloud-asset-v1 0.26.1 → 0.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a35e756907ebd1db6200332672b33c298efd5b741d7250f907691d4a33fd0736
-  data.tar.gz: ab178dde1f4d28102bf6c4bc3d7a34b0a640ba2b096a0b08e9502fd4cebc1ec3
+  metadata.gz: ce8dc4fea3414af0a84ee4b12cf7c991b4a6bd44dc1a86339cc70ffb514bad35
+  data.tar.gz: 3798fd9b888bb17b535f979a31e982b70a95c8111ab979961e8b044eced9b95d
 SHA512:
-  metadata.gz: 4308d598b287cee09c334bebb2fc331aab2a7c3529a86f2d624ce9522ba4af528353883e27396b8b0f7df56496fe8e02c4ffa43381f4fbee2758c4654dd26e50
-  data.tar.gz: 763ac86ca5e01fcbf614214cf958ec3ca1c667377140c148ec72b2a588aa9118090e77379689ceb181b7f6be184d1e57cc4ccee365306039934825449e38c905
+  metadata.gz: e8f68cbe594e330ae2029da80fafe4a049ec88709ca9de00d38100b8c574c0f722be312914d8f0e50c541d77d3e9e1bf8f5e130b8ccc6b2345d7f186c857f2fb
+  data.tar.gz: 8457d1254fb5b7bc87c4b2f379de5bcc56c88838a8956bd3980525e7f34d05b00c929ad2f2aefc2e64fc63d8c13a675a057474a5d630e6db4afd829a8d1555fd

data/lib/google/cloud/asset/v1/asset_service/client.rb

@@ -236,7 +236,8 @@ module Google
                 credentials:  credentials,
                 endpoint:     @config.endpoint,
                 channel_args: @config.channel_args,
-                interceptors: @config.interceptors
+                interceptors: @config.interceptors,
+                channel_pool_config: @config.channel_pool
               )
             end
 
@@ -3114,6 +3115,14 @@ module Google
                 end
               end
 
+              ##
+              # Configuration for the channel pool
+              # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
+              #
+              def channel_pool
+                @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
+              end
+
               ##
               # Configuration RPC class for the AssetService API.
               #

data/lib/google/cloud/asset/v1/asset_service/operations.rb

@@ -93,7 +93,8 @@ module Google
                 credentials:  credentials,
                 endpoint:     @config.endpoint,
                 channel_args: @config.channel_args,
-                interceptors: @config.interceptors
+                interceptors: @config.interceptors,
+                channel_pool_config: @config.channel_pool
               )
 
               # Used by an LRO wrapper for some methods of this service
@@ -701,6 +702,14 @@ module Google
                 end
               end
 
+              ##
+              # Configuration for the channel pool
+              # @return [::Gapic::ServiceStub::ChannelPool::Configuration]
+              #
+              def channel_pool
+                @channel_pool ||= ::Gapic::ServiceStub::ChannelPool::Configuration.new
+              end
+
               ##
               # Configuration RPC class for the Operations API.
               #

data/lib/google/cloud/asset/v1/asset_service/rest/client.rb

@@ -327,6 +327,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::ExportAssetsRequest.new
+              #
+              #   # Call the export_assets method.
+              #   result = client.export_assets request
+              #
+              #   # 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 "No response received."
+              #   end
+              #
               def export_assets request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -446,6 +469,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::Asset>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::ListAssetsRequest.new
+              #
+              #   # Call the list_assets method.
+              #   result = client.list_assets request
+              #
+              #   # 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::Asset::V1::Asset.
+              #     p item
+              #   end
+              #
               def list_assets request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -552,6 +595,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::BatchGetAssetsHistoryResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::BatchGetAssetsHistoryRequest.new
+              #
+              #   # Call the batch_get_assets_history method.
+              #   result = client.batch_get_assets_history request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::BatchGetAssetsHistoryResponse.
+              #   p result
+              #
               def batch_get_assets_history request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -627,6 +686,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::Feed]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::CreateFeedRequest.new
+              #
+              #   # Call the create_feed method.
+              #   result = client.create_feed request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::Feed.
+              #   p result
+              #
               def create_feed request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -692,6 +767,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::Feed]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::GetFeedRequest.new
+              #
+              #   # Call the get_feed method.
+              #   result = client.get_feed request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::Feed.
+              #   p result
+              #
               def get_feed request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -756,6 +847,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::ListFeedsResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::ListFeedsRequest.new
+              #
+              #   # Call the list_feeds method.
+              #   result = client.list_feeds request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::ListFeedsResponse.
+              #   p result
+              #
               def list_feeds request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -826,6 +933,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::Feed]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::UpdateFeedRequest.new
+              #
+              #   # Call the update_feed method.
+              #   result = client.update_feed request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::Feed.
+              #   p result
+              #
               def update_feed request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -891,6 +1014,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::DeleteFeedRequest.new
+              #
+              #   # Call the delete_feed method.
+              #   result = client.delete_feed request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_feed request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1102,6 +1241,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::ResourceSearchResult>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::SearchAllResourcesRequest.new
+              #
+              #   # Call the search_all_resources method.
+              #   result = client.search_all_resources request
+              #
+              #   # 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::Asset::V1::ResourceSearchResult.
+              #     p item
+              #   end
+              #
               def search_all_resources request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1262,6 +1421,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::IamPolicySearchResult>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::SearchAllIamPoliciesRequest.new
+              #
+              #   # Call the search_all_iam_policies method.
+              #   result = client.search_all_iam_policies request
+              #
+              #   # 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::Asset::V1::IamPolicySearchResult.
+              #     p item
+              #   end
+              #
               def search_all_iam_policies request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1355,6 +1534,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::AnalyzeIamPolicyRequest.new
+              #
+              #   # Call the analyze_iam_policy method.
+              #   result = client.analyze_iam_policy request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::AnalyzeIamPolicyResponse.
+              #   p result
+              #
               def analyze_iam_policy request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1446,6 +1641,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::AnalyzeIamPolicyLongrunningRequest.new
+              #
+              #   # Call the analyze_iam_policy_longrunning method.
+              #   result = client.analyze_iam_policy_longrunning request
+              #
+              #   # 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 "No response received."
+              #   end
+              #
               def analyze_iam_policy_longrunning request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1525,6 +1743,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::AnalyzeMoveResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::AnalyzeMoveRequest.new
+              #
+              #   # Call the analyze_move method.
+              #   result = client.analyze_move request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::AnalyzeMoveResponse.
+              #   p result
+              #
               def analyze_move request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1654,6 +1888,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::QueryAssetsResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::QueryAssetsRequest.new
+              #
+              #   # Call the query_assets method.
+              #   result = client.query_assets request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::QueryAssetsResponse.
+              #   p result
+              #
               def query_assets request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1733,6 +1983,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::SavedQuery]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::CreateSavedQueryRequest.new
+              #
+              #   # Call the create_saved_query method.
+              #   result = client.create_saved_query request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::SavedQuery.
+              #   p result
+              #
               def create_saved_query request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1799,6 +2065,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::SavedQuery]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::GetSavedQueryRequest.new
+              #
+              #   # Call the get_saved_query method.
+              #   result = client.get_saved_query request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::SavedQuery.
+              #   p result
+              #
               def get_saved_query request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1882,6 +2164,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::SavedQuery>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::ListSavedQueriesRequest.new
+              #
+              #   # Call the list_saved_queries method.
+              #   result = client.list_saved_queries request
+              #
+              #   # 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::Asset::V1::SavedQuery.
+              #     p item
+              #   end
+              #
               def list_saved_queries request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -1954,6 +2256,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::SavedQuery]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::UpdateSavedQueryRequest.new
+              #
+              #   # Call the update_saved_query method.
+              #   result = client.update_saved_query request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::SavedQuery.
+              #   p result
+              #
               def update_saved_query request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2021,6 +2339,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::DeleteSavedQueryRequest.new
+              #
+              #   # Call the delete_saved_query method.
+              #   result = client.delete_saved_query request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_saved_query request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2099,6 +2433,22 @@ module Google
               # @return [::Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesRequest.new
+              #
+              #   # Call the batch_get_effective_iam_policies method.
+              #   result = client.batch_get_effective_iam_policies request
+              #
+              #   # The returned object is of type Google::Cloud::Asset::V1::BatchGetEffectiveIamPoliciesResponse.
+              #   p result
+              #
               def batch_get_effective_iam_policies request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2183,6 +2533,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::AnalyzeOrgPoliciesResponse::OrgPolicyResult>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::AnalyzeOrgPoliciesRequest.new
+              #
+              #   # Call the analyze_org_policies method.
+              #   result = client.analyze_org_policies request
+              #
+              #   # 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::Asset::V1::AnalyzeOrgPoliciesResponse::OrgPolicyResult.
+              #     p item
+              #   end
+              #
               def analyze_org_policies request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2270,6 +2640,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::AnalyzeOrgPolicyGovernedContainersResponse::GovernedContainer>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::AnalyzeOrgPolicyGovernedContainersRequest.new
+              #
+              #   # Call the analyze_org_policy_governed_containers method.
+              #   result = client.analyze_org_policy_governed_containers request
+              #
+              #   # 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::Asset::V1::AnalyzeOrgPolicyGovernedContainersResponse::GovernedContainer.
+              #     p item
+              #   end
+              #
               def analyze_org_policy_governed_containers request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -2379,6 +2769,26 @@ module Google
               # @return [::Gapic::Rest::PagedEnumerable<::Google::Cloud::Asset::V1::AnalyzeOrgPolicyGovernedAssetsResponse::GovernedAsset>]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/cloud/asset/v1"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Cloud::Asset::V1::AssetService::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Cloud::Asset::V1::AnalyzeOrgPolicyGovernedAssetsRequest.new
+              #
+              #   # Call the analyze_org_policy_governed_assets method.
+              #   result = client.analyze_org_policy_governed_assets request
+              #
+              #   # 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::Asset::V1::AnalyzeOrgPolicyGovernedAssetsResponse::GovernedAsset.
+              #     p item
+              #   end
+              #
               def analyze_org_policy_governed_assets request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/asset/v1/asset_service/rest/operations.rb

@@ -136,6 +136,26 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::ListOperationsRequest.new
+              #
+              #   # Call the list_operations method.
+              #   result = client.list_operations request
+              #
+              #   # 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 item
+              #   end
+              #
               def list_operations request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -201,6 +221,29 @@ module Google
               # @return [::Gapic::Operation]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::GetOperationRequest.new
+              #
+              #   # Call the get_operation method.
+              #   result = client.get_operation request
+              #
+              #   # 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 "No response received."
+              #   end
+              #
               def get_operation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -267,6 +310,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::DeleteOperationRequest.new
+              #
+              #   # Call the delete_operation method.
+              #   result = client.delete_operation request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def delete_operation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 
@@ -338,6 +397,22 @@ module Google
               # @return [::Google::Protobuf::Empty]
               #
               # @raise [::Google::Cloud::Error] if the REST call is aborted.
+              #
+              # @example Basic example
+              #   require "google/longrunning"
+              #
+              #   # Create a client object. The client can be reused for multiple calls.
+              #   client = Google::Longrunning::Operations::Rest::Client.new
+              #
+              #   # Create a request. To set request fields, pass in keyword arguments.
+              #   request = Google::Longrunning::CancelOperationRequest.new
+              #
+              #   # Call the cancel_operation method.
+              #   result = client.cancel_operation request
+              #
+              #   # The returned object is of type Google::Protobuf::Empty.
+              #   p result
+              #
               def cancel_operation request, options = nil
                 raise ::ArgumentError, "request must be provided" if request.nil?
 

data/lib/google/cloud/asset/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Asset
       module V1
-        VERSION = "0.26.1"
+        VERSION = "0.27.0"
       end
     end
   end

data/proto_docs/google/api/field_behavior.rb

@@ -66,6 +66,20 @@ module Google
       # a non-empty value will be returned. The user will not be aware of what
       # non-empty value to expect.
       NON_EMPTY_DEFAULT = 7
+
+      # Denotes that the field in a resource (a message annotated with
+      # google.api.resource) is used in the resource name to uniquely identify the
+      # resource. For AIP-compliant APIs, this should only be applied to the
+      # `name` field on the resource.
+      #
+      # This behavior should not be applied to references to other resources within
+      # the message.
+      #
+      # The identifier field of resources often have different field behavior
+      # depending on the request it is embedded in (e.g. for Create methods name
+      # is optional and unused, while for Update methods it is required). Instead
+      # of method-specific annotations, only `IDENTIFIER` is required.
+      IDENTIFIER = 8
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-asset-v1
 version: !ruby/object:Gem::Version
-  version: 0.26.1
+  version: 0.27.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2023-08-04 00:00:00.000000000 Z
+date: 2023-09-12 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,7 +16,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: 0.20.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.19.1
+        version: 0.20.0
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -285,7 +285,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.2
+rubygems_version: 3.4.19
 signing_key: 
 specification_version: 4
 summary: The Cloud Asset API manages the history and inventory of Google Cloud resources.