google-cloud-asset-v1 0.19.0 → 0.21.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7c69069aef838189b9793582c05367de1fe7f3715120394a36e21de7e1aca22e
-  data.tar.gz: 41291195873ad22a3647e141741daa78bbe90badad75915cb9764bedd12c0eeb
+  metadata.gz: 3707e5c254ca43502c0169aaf0948734bc5d801fdb0754abbec34f17787cb5c3
+  data.tar.gz: 7e404e7cbcdb10c94c7f62321eaf88fcee4745fbbc330a345861d94126e76241
 SHA512:
-  metadata.gz: e852294078cfb17d478af784985b462835b4e44d9d3fd8196fdef50d0f9fd57f295b18a9846682b9e9afe99ece1f6cef32d823d7efc1ed7ee4a46c8b9a6395e3
-  data.tar.gz: 94b70fe2fe83202cf8a645c9af8f7395cbb1d8b1656448d606e0fabccf54ab9422d4178cabcd5fe5a6646f1dd86c592b3054b582ba86e504c166d727be11060e
+  metadata.gz: f486ec177ea1c1557db69e775bb0ba8cca6f0a0e01a5ceba28b9920fd362a6c040c4c741ec08bd41ddfef3e2cac7e99a61e40d0efffaec531eb0225bf0237557
+  data.tar.gz: c6c6c1144eec85735c6345698175eb499677dea87549207d55c5075202067853b6f60b4031950f3911b17f1e9a98ec791c9d35c8f8bafd9160d8822c940b56a7

data/README.md

@@ -76,14 +76,14 @@ To browse ready to use code samples check [Google Cloud Samples](https://cloud.g
 
 ## Supported Ruby Versions
 
-This library is supported on Ruby 2.5+.
+This library is supported on Ruby 2.6+.
 
 Google provides official support for Ruby versions that are actively supported
 by Ruby Core—that is, Ruby versions that are either in normal maintenance or
-in security maintenance, and not end of life. Currently, this means Ruby 2.5
-and later. Older versions of Ruby _may_ still work, but are unsupported and not
-recommended. See https://www.ruby-lang.org/en/downloads/branches/ for details
-about the Ruby support schedule.
+in security maintenance, and not end of life. Older versions of Ruby _may_
+still work, but are unsupported and not recommended. See
+https://www.ruby-lang.org/en/downloads/branches/ for details about the Ruby
+support schedule.
 
 ## Which client should I use?
 

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

@@ -112,6 +112,16 @@ module Google
 
                 default_config.rpcs.analyze_iam_policy_longrunning.timeout = 60.0
 
+                default_config.rpcs.query_assets.timeout = 200.0
+                default_config.rpcs.query_assets.retry_policy = {
+                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
+                }
+
+                default_config.rpcs.batch_get_effective_iam_policies.timeout = 300.0
+                default_config.rpcs.batch_get_effective_iam_policies.retry_policy = {
+                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
+                }
+
                 default_config
               end
               yield @configure if block_given?
@@ -1145,6 +1155,14 @@ module Google
             #     * `labels.env:*` to find Cloud resources that have a label "env".
             #     * `kmsKey:key` to find Cloud resources encrypted with a customer-managed
             #       encryption key whose name contains the word "key".
+            #     * `relationships:instance-group-1` to find Cloud resources that have
+            #       relationships with "instance-group-1" in the related resource name.
+            #     * `relationships:INSTANCE_TO_INSTANCEGROUP` to find compute instances that
+            #       have relationships of type "INSTANCE_TO_INSTANCEGROUP".
+            #     * `relationships.INSTANCE_TO_INSTANCEGROUP:instance-group-1` to find
+            #       compute instances that have relationships with "instance-group-1" in the
+            #       compute instance group resource name, for relationship type
+            #       "INSTANCE_TO_INSTANCEGROUP".
             #     * `state:ACTIVE` to find Cloud resources whose state contains "ACTIVE" as a
             #       word.
             #     * `NOT state:ACTIVE` to find Cloud resources whose state doesn't contain
@@ -1358,8 +1376,8 @@ module Google
             #     compared against each Cloud IAM policy binding, including its principals,
             #     roles, and Cloud IAM conditions. The returned Cloud IAM policies will only
             #     contain the bindings that match your query. To learn more about the IAM
-            #     policy structure, see [IAM policy
-            #     doc](https://cloud.google.com/iam/docs/policies#structure).
+            #     policy structure, see the [IAM policy
+            #     documentation](https://cloud.google.com/iam/help/allow-policies/structure).
             #
             #     Examples:
             #
@@ -1843,6 +1861,158 @@ module Google
               raise ::Google::Cloud::Error.from_error(e)
             end
 
+            ##
+            # Issue a job that queries assets using a SQL statement compatible with
+            # [BigQuery Standard
+            # SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql).
+            #
+            # If the query execution finishes within timeout and there's no pagination,
+            # the full query results will be returned in the `QueryAssetsResponse`.
+            #
+            # Otherwise, full query results can be obtained by issuing extra requests
+            # with the `job_reference` from the a previous `QueryAssets` call.
+            #
+            # Note, the query result has approximately 10 GB limitation enforced by
+            # BigQuery
+            # https://cloud.google.com/bigquery/docs/best-practices-performance-output,
+            # queries return larger results will result in errors.
+            #
+            # @overload query_assets(request, options = nil)
+            #   Pass arguments to `query_assets` via a request object, either of type
+            #   {::Google::Cloud::Asset::V1::QueryAssetsRequest} or an equivalent Hash.
+            #
+            #   @param request [::Google::Cloud::Asset::V1::QueryAssetsRequest, ::Hash]
+            #     A request object representing the call parameters. Required. To specify no
+            #     parameters, or to keep all the default parameter values, pass an empty Hash.
+            #   @param options [::Gapic::CallOptions, ::Hash]
+            #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
+            #
+            # @overload query_assets(parent: nil, statement: nil, job_reference: nil, page_size: nil, page_token: nil, timeout: nil, read_time_window: nil, read_time: nil, output_config: nil)
+            #   Pass arguments to `query_assets` via keyword arguments. Note that at
+            #   least one keyword argument is required. To specify no parameters, or to keep all
+            #   the default parameter values, pass an empty Hash as a request object (see above).
+            #
+            #   @param parent [::String]
+            #     Required. The relative name of the root asset. This can only be an
+            #     organization number (such as "organizations/123"), a project ID (such as
+            #     "projects/my-project-id"), or a project number (such as "projects/12345"),
+            #     or a folder number (such as "folders/123").
+            #
+            #     Only assets belonging to the `parent` will be returned.
+            #   @param statement [::String]
+            #     Optional. A SQL statement that's compatible with [BigQuery Standard
+            #     SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql).
+            #   @param job_reference [::String]
+            #     Optional. Reference to the query job, which is from the
+            #     `QueryAssetsResponse` of previous `QueryAssets` call.
+            #   @param page_size [::Integer]
+            #     Optional. The maximum number of rows to return in the results. Responses
+            #     are limited to 10 MB and 1000 rows.
+            #
+            #     By default, the maximum row count is 1000. When the byte or row count limit
+            #     is reached, the rest of the query results will be paginated.
+            #
+            #     The field will be ignored when [output_config] is specified.
+            #   @param page_token [::String]
+            #     Optional. A page token received from previous `QueryAssets`.
+            #
+            #     The field will be ignored when [output_config] is specified.
+            #   @param timeout [::Google::Protobuf::Duration, ::Hash]
+            #     Optional. Specifies the maximum amount of time that the client is willing
+            #     to wait for the query to complete. By default, this limit is 5 min for the
+            #     first query, and 1 minute for the following queries. If the query is
+            #     complete, the `done` field in the `QueryAssetsResponse` is true, otherwise
+            #     false.
+            #
+            #     Like BigQuery [jobs.query
+            #     API](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#queryrequest)
+            #     The call is not guaranteed to wait for the specified timeout; it typically
+            #     returns after around 200 seconds (200,000 milliseconds), even if the query
+            #     is not complete.
+            #
+            #     The field will be ignored when [output_config] is specified.
+            #   @param read_time_window [::Google::Cloud::Asset::V1::TimeWindow, ::Hash]
+            #     Optional. [start_time] is required. [start_time] must be less than
+            #     [end_time] Defaults [end_time] to now if [start_time] is set and
+            #     [end_time] isn't. Maximum permitted time range is 7 days.
+            #   @param read_time [::Google::Protobuf::Timestamp, ::Hash]
+            #     Optional. Queries cloud assets as they appeared at the specified point in
+            #     time.
+            #   @param output_config [::Google::Cloud::Asset::V1::QueryAssetsOutputConfig, ::Hash]
+            #     Optional. Destination where the query results will be saved.
+            #
+            #     When this field is specified, the query results won't be saved in the
+            #     [QueryAssetsResponse.query_result]. Instead
+            #     [QueryAssetsResponse.output_config] will be set.
+            #
+            #     Meanwhile, [QueryAssetsResponse.job_reference] will be set and can be used
+            #     to check the status of the query job when passed to a following
+            #     [QueryAssets] API call.
+            #
+            # @yield [response, operation] Access the result along with the RPC operation
+            # @yieldparam response [::Google::Cloud::Asset::V1::QueryAssetsResponse]
+            # @yieldparam operation [::GRPC::ActiveCall::Operation]
+            #
+            # @return [::Google::Cloud::Asset::V1::QueryAssetsResponse]
+            #
+            # @raise [::Google::Cloud::Error] if the RPC 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::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?
+
+              request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Asset::V1::QueryAssetsRequest
+
+              # Converts hash and nil to an options object
+              options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
+
+              # Customize the options with defaults
+              metadata = @config.rpcs.query_assets.metadata.to_h
+
+              # Set x-goog-api-client and x-goog-user-project headers
+              metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
+                lib_name: @config.lib_name, lib_version: @config.lib_version,
+                gapic_version: ::Google::Cloud::Asset::V1::VERSION
+              metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
+
+              header_params = {}
+              if request.parent
+                header_params["parent"] = request.parent
+              end
+
+              request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
+              metadata[:"x-goog-request-params"] ||= request_params_header
+
+              options.apply_defaults timeout:      @config.rpcs.query_assets.timeout,
+                                     metadata:     metadata,
+                                     retry_policy: @config.rpcs.query_assets.retry_policy
+
+              options.apply_defaults timeout:      @config.timeout,
+                                     metadata:     @config.metadata,
+                                     retry_policy: @config.retry_policy
+
+              @asset_service_stub.call_rpc :query_assets, request, options: options do |response, operation|
+                yield response, operation if block_given?
+                return response
+              end
+            rescue ::GRPC::BadStatus => e
+              raise ::Google::Cloud::Error.from_error(e)
+            end
+
             ##
             # Creates a saved query in a parent project/folder/organization.
             #
@@ -2633,6 +2803,11 @@ module Google
                 #
                 attr_reader :analyze_move
                 ##
+                # RPC-specific configuration for `query_assets`
+                # @return [::Gapic::Config::Method]
+                #
+                attr_reader :query_assets
+                ##
                 # RPC-specific configuration for `create_saved_query`
                 # @return [::Gapic::Config::Method]
                 #
@@ -2691,6 +2866,8 @@ module Google
                   @analyze_iam_policy_longrunning = ::Gapic::Config::Method.new analyze_iam_policy_longrunning_config
                   analyze_move_config = parent_rpcs.analyze_move if parent_rpcs.respond_to? :analyze_move
                   @analyze_move = ::Gapic::Config::Method.new analyze_move_config
+                  query_assets_config = parent_rpcs.query_assets if parent_rpcs.respond_to? :query_assets
+                  @query_assets = ::Gapic::Config::Method.new query_assets_config
                   create_saved_query_config = parent_rpcs.create_saved_query if parent_rpcs.respond_to? :create_saved_query
                   @create_saved_query = ::Gapic::Config::Method.new create_saved_query_config
                   get_saved_query_config = parent_rpcs.get_saved_query if parent_rpcs.respond_to? :get_saved_query

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

@@ -95,6 +95,9 @@ module Google
                 channel_args: @config.channel_args,
                 interceptors: @config.interceptors
               )
+
+              # Used by an LRO wrapper for some methods of this service
+              @operations_client = self
             end
 
             # Service calls

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

@@ -13,6 +13,7 @@ require 'google/longrunning/operations_pb'
 require 'google/protobuf/duration_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
+require 'google/protobuf/struct_pb'
 require 'google/protobuf/timestamp_pb'
 require 'google/rpc/status_pb'
 require 'google/type/expr_pb'
@@ -297,6 +298,53 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     add_message "google.cloud.asset.v1.MoveImpact" do
       optional :detail, :string, 1
     end
+    add_message "google.cloud.asset.v1.QueryAssetsOutputConfig" do
+      optional :bigquery_destination, :message, 1, "google.cloud.asset.v1.QueryAssetsOutputConfig.BigQueryDestination"
+    end
+    add_message "google.cloud.asset.v1.QueryAssetsOutputConfig.BigQueryDestination" do
+      optional :dataset, :string, 1
+      optional :table, :string, 2
+      optional :write_disposition, :string, 3
+    end
+    add_message "google.cloud.asset.v1.QueryAssetsRequest" do
+      optional :parent, :string, 1
+      optional :page_size, :int32, 4
+      optional :page_token, :string, 5
+      optional :timeout, :message, 6, "google.protobuf.Duration"
+      optional :output_config, :message, 9, "google.cloud.asset.v1.QueryAssetsOutputConfig"
+      oneof :query do
+        optional :statement, :string, 2
+        optional :job_reference, :string, 3
+      end
+      oneof :time do
+        optional :read_time_window, :message, 7, "google.cloud.asset.v1.TimeWindow"
+        optional :read_time, :message, 8, "google.protobuf.Timestamp"
+      end
+    end
+    add_message "google.cloud.asset.v1.QueryAssetsResponse" do
+      optional :job_reference, :string, 1
+      optional :done, :bool, 2
+      oneof :response do
+        optional :error, :message, 3, "google.rpc.Status"
+        optional :query_result, :message, 4, "google.cloud.asset.v1.QueryResult"
+        optional :output_config, :message, 5, "google.cloud.asset.v1.QueryAssetsOutputConfig"
+      end
+    end
+    add_message "google.cloud.asset.v1.QueryResult" do
+      repeated :rows, :message, 1, "google.protobuf.Struct"
+      optional :schema, :message, 2, "google.cloud.asset.v1.TableSchema"
+      optional :next_page_token, :string, 3
+      optional :total_rows, :int64, 4
+    end
+    add_message "google.cloud.asset.v1.TableSchema" do
+      repeated :fields, :message, 1, "google.cloud.asset.v1.TableFieldSchema"
+    end
+    add_message "google.cloud.asset.v1.TableFieldSchema" do
+      optional :field, :string, 1
+      optional :type, :string, 2
+      optional :mode, :string, 3
+      repeated :fields, :message, 4, "google.cloud.asset.v1.TableFieldSchema"
+    end
     add_message "google.cloud.asset.v1.BatchGetEffectiveIamPoliciesRequest" do
       optional :scope, :string, 1
       repeated :names, :string, 3
@@ -384,6 +432,13 @@ module Google
         MoveAnalysis = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.MoveAnalysis").msgclass
         MoveAnalysisResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.MoveAnalysisResult").msgclass
         MoveImpact = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.MoveImpact").msgclass
+        QueryAssetsOutputConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.QueryAssetsOutputConfig").msgclass
+        QueryAssetsOutputConfig::BigQueryDestination = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.QueryAssetsOutputConfig.BigQueryDestination").msgclass
+        QueryAssetsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.QueryAssetsRequest").msgclass
+        QueryAssetsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.QueryAssetsResponse").msgclass
+        QueryResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.QueryResult").msgclass
+        TableSchema = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.TableSchema").msgclass
+        TableFieldSchema = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.TableFieldSchema").msgclass
         BatchGetEffectiveIamPoliciesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.BatchGetEffectiveIamPoliciesRequest").msgclass
         BatchGetEffectiveIamPoliciesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.BatchGetEffectiveIamPoliciesResponse").msgclass
         BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.BatchGetEffectiveIamPoliciesResponse.EffectiveIamPolicy").msgclass

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

@@ -97,6 +97,21 @@ module Google
             # The policies and configuration are subject to change before the actual
             # resource migration takes place.
             rpc :AnalyzeMove, ::Google::Cloud::Asset::V1::AnalyzeMoveRequest, ::Google::Cloud::Asset::V1::AnalyzeMoveResponse
+            # Issue a job that queries assets using a SQL statement compatible with
+            # [BigQuery Standard
+            # SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql).
+            #
+            # If the query execution finishes within timeout and there's no pagination,
+            # the full query results will be returned in the `QueryAssetsResponse`.
+            #
+            # Otherwise, full query results can be obtained by issuing extra requests
+            # with the `job_reference` from the a previous `QueryAssets` call.
+            #
+            # Note, the query result has approximately 10 GB limitation enforced by
+            # BigQuery
+            # https://cloud.google.com/bigquery/docs/best-practices-performance-output,
+            # queries return larger results will result in errors.
+            rpc :QueryAssets, ::Google::Cloud::Asset::V1::QueryAssetsRequest, ::Google::Cloud::Asset::V1::QueryAssetsResponse
             # Creates a saved query in a parent project/folder/organization.
             rpc :CreateSavedQuery, ::Google::Cloud::Asset::V1::CreateSavedQueryRequest, ::Google::Cloud::Asset::V1::SavedQuery
             # Gets details about a saved query.

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Asset
       module V1
-        VERSION = "0.19.0"
+        VERSION = "0.21.0"
       end
     end
   end

data/proto_docs/google/cloud/asset/v1/asset_service.rb

@@ -649,6 +649,14 @@ module Google
         #     * `labels.env:*` to find Cloud resources that have a label "env".
         #     * `kmsKey:key` to find Cloud resources encrypted with a customer-managed
         #       encryption key whose name contains the word "key".
+        #     * `relationships:instance-group-1` to find Cloud resources that have
+        #       relationships with "instance-group-1" in the related resource name.
+        #     * `relationships:INSTANCE_TO_INSTANCEGROUP` to find compute instances that
+        #       have relationships of type "INSTANCE_TO_INSTANCEGROUP".
+        #     * `relationships.INSTANCE_TO_INSTANCEGROUP:instance-group-1` to find
+        #       compute instances that have relationships with "instance-group-1" in the
+        #       compute instance group resource name, for relationship type
+        #       "INSTANCE_TO_INSTANCEGROUP".
         #     * `state:ACTIVE` to find Cloud resources whose state contains "ACTIVE" as a
         #       word.
         #     * `NOT state:ACTIVE` to find Cloud resources whose state doesn't contain
@@ -797,8 +805,8 @@ module Google
         #     compared against each Cloud IAM policy binding, including its principals,
         #     roles, and Cloud IAM conditions. The returned Cloud IAM policies will only
         #     contain the bindings that match your query. To learn more about the IAM
-        #     policy structure, see [IAM policy
-        #     doc](https://cloud.google.com/iam/docs/policies#structure).
+        #     policy structure, see the [IAM policy
+        #     documentation](https://cloud.google.com/iam/help/allow-policies/structure).
         #
         #     Examples:
         #
@@ -1575,6 +1583,206 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Output configuration query assets.
+        # @!attribute [rw] bigquery_destination
+        #   @return [::Google::Cloud::Asset::V1::QueryAssetsOutputConfig::BigQueryDestination]
+        #     BigQuery destination where the query results will be saved.
+        class QueryAssetsOutputConfig
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # BigQuery destination.
+          # @!attribute [rw] dataset
+          #   @return [::String]
+          #     Required. The BigQuery dataset where the query results will be saved. It
+          #     has the format of "projects/\\{projectId}/datasets/\\{datasetId}".
+          # @!attribute [rw] table
+          #   @return [::String]
+          #     Required. The BigQuery table where the query results will be saved. If
+          #     this table does not exist, a new table with the given name will be
+          #     created.
+          # @!attribute [rw] write_disposition
+          #   @return [::String]
+          #     Specifies the action that occurs if the destination table or partition
+          #     already exists. The following values are supported:
+          #
+          #     * WRITE_TRUNCATE: If the table or partition already exists, BigQuery
+          #     overwrites the entire table or all the partitions data.
+          #     * WRITE_APPEND: If the table or partition already exists, BigQuery
+          #     appends the data to the table or the latest partition.
+          #     * WRITE_EMPTY: If the table already exists and contains data, an error is
+          #     returned.
+          class BigQueryDestination
+            include ::Google::Protobuf::MessageExts
+            extend ::Google::Protobuf::MessageExts::ClassMethods
+          end
+        end
+
+        # QueryAssets request.
+        # @!attribute [rw] parent
+        #   @return [::String]
+        #     Required. The relative name of the root asset. This can only be an
+        #     organization number (such as "organizations/123"), a project ID (such as
+        #     "projects/my-project-id"), or a project number (such as "projects/12345"),
+        #     or a folder number (such as "folders/123").
+        #
+        #     Only assets belonging to the `parent` will be returned.
+        # @!attribute [rw] statement
+        #   @return [::String]
+        #     Optional. A SQL statement that's compatible with [BigQuery Standard
+        #     SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql).
+        # @!attribute [rw] job_reference
+        #   @return [::String]
+        #     Optional. Reference to the query job, which is from the
+        #     `QueryAssetsResponse` of previous `QueryAssets` call.
+        # @!attribute [rw] page_size
+        #   @return [::Integer]
+        #     Optional. The maximum number of rows to return in the results. Responses
+        #     are limited to 10 MB and 1000 rows.
+        #
+        #     By default, the maximum row count is 1000. When the byte or row count limit
+        #     is reached, the rest of the query results will be paginated.
+        #
+        #     The field will be ignored when [output_config] is specified.
+        # @!attribute [rw] page_token
+        #   @return [::String]
+        #     Optional. A page token received from previous `QueryAssets`.
+        #
+        #     The field will be ignored when [output_config] is specified.
+        # @!attribute [rw] timeout
+        #   @return [::Google::Protobuf::Duration]
+        #     Optional. Specifies the maximum amount of time that the client is willing
+        #     to wait for the query to complete. By default, this limit is 5 min for the
+        #     first query, and 1 minute for the following queries. If the query is
+        #     complete, the `done` field in the `QueryAssetsResponse` is true, otherwise
+        #     false.
+        #
+        #     Like BigQuery [jobs.query
+        #     API](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#queryrequest)
+        #     The call is not guaranteed to wait for the specified timeout; it typically
+        #     returns after around 200 seconds (200,000 milliseconds), even if the query
+        #     is not complete.
+        #
+        #     The field will be ignored when [output_config] is specified.
+        # @!attribute [rw] read_time_window
+        #   @return [::Google::Cloud::Asset::V1::TimeWindow]
+        #     Optional. [start_time] is required. [start_time] must be less than
+        #     [end_time] Defaults [end_time] to now if [start_time] is set and
+        #     [end_time] isn't. Maximum permitted time range is 7 days.
+        # @!attribute [rw] read_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     Optional. Queries cloud assets as they appeared at the specified point in
+        #     time.
+        # @!attribute [rw] output_config
+        #   @return [::Google::Cloud::Asset::V1::QueryAssetsOutputConfig]
+        #     Optional. Destination where the query results will be saved.
+        #
+        #     When this field is specified, the query results won't be saved in the
+        #     [QueryAssetsResponse.query_result]. Instead
+        #     [QueryAssetsResponse.output_config] will be set.
+        #
+        #     Meanwhile, [QueryAssetsResponse.job_reference] will be set and can be used
+        #     to check the status of the query job when passed to a following
+        #     [QueryAssets] API call.
+        class QueryAssetsRequest
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # QueryAssets response.
+        # @!attribute [rw] job_reference
+        #   @return [::String]
+        #     Reference to a query job.
+        # @!attribute [rw] done
+        #   @return [::Boolean]
+        #     The query response, which can be either an `error` or a valid `response`.
+        #
+        #     If `done` == `false` and the query result is being saved in a output, the
+        #     output_config field will be set.
+        #     If `done` == `true`, exactly one of
+        #     `error`, `query_result` or `output_config` will be set.
+        # @!attribute [rw] error
+        #   @return [::Google::Rpc::Status]
+        #     Error status.
+        # @!attribute [rw] query_result
+        #   @return [::Google::Cloud::Asset::V1::QueryResult]
+        #     Result of the query.
+        # @!attribute [rw] output_config
+        #   @return [::Google::Cloud::Asset::V1::QueryAssetsOutputConfig]
+        #     Output configuration which indicates instead of being returned in API
+        #     response on the fly, the query result will be saved in a specific output.
+        class QueryAssetsResponse
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # Execution results of the query.
+        #
+        # The result is formatted as rows represented by BigQuery compatible [schema].
+        # When pagination is necessary, it will contains the page token to retrieve
+        # the results of following pages.
+        # @!attribute [rw] rows
+        #   @return [::Array<::Google::Protobuf::Struct>]
+        #     Each row hold a query result in the format of `Struct`.
+        # @!attribute [rw] schema
+        #   @return [::Google::Cloud::Asset::V1::TableSchema]
+        #     Describes the format of the [rows].
+        # @!attribute [rw] next_page_token
+        #   @return [::String]
+        #     Token to retrieve the next page of the results.
+        # @!attribute [rw] total_rows
+        #   @return [::Integer]
+        #     Total rows of the whole query results.
+        class QueryResult
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # BigQuery Compatible table schema.
+        # @!attribute [rw] fields
+        #   @return [::Array<::Google::Cloud::Asset::V1::TableFieldSchema>]
+        #     Describes the fields in a table.
+        class TableSchema
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # A field in TableSchema.
+        # @!attribute [rw] field
+        #   @return [::String]
+        #     The field name. The name must contain only letters (a-z, A-Z),
+        #     numbers (0-9), or underscores (_), and must start with a letter or
+        #     underscore. The maximum length is 128 characters.
+        # @!attribute [rw] type
+        #   @return [::String]
+        #     The field data type. Possible values include
+        #     * STRING
+        #     * BYTES
+        #     * INTEGER
+        #     * FLOAT
+        #     * BOOLEAN
+        #     * TIMESTAMP
+        #     * DATE
+        #     * TIME
+        #     * DATETIME
+        #     * GEOGRAPHY,
+        #     * NUMERIC,
+        #     * BIGNUMERIC,
+        #     * RECORD
+        #     (where RECORD indicates that the field contains a nested schema).
+        # @!attribute [rw] mode
+        #   @return [::String]
+        #     The field mode. Possible values include NULLABLE, REQUIRED and
+        #     REPEATED. The default value is NULLABLE.
+        # @!attribute [rw] fields
+        #   @return [::Array<::Google::Cloud::Asset::V1::TableFieldSchema>]
+        #     Describes the nested schema fields if the type property is set
+        #     to RECORD.
+        class TableFieldSchema
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # A request message for
         # {::Google::Cloud::Asset::V1::AssetService::Client#batch_get_effective_iam_policies AssetService.BatchGetEffectiveIamPolicies}.
         # @!attribute [rw] scope

data/proto_docs/google/cloud/asset/v1/assets.rb

@@ -115,8 +115,8 @@ module Google
         #     effectively policy is the union of both the policy set on this resource
         #     and each policy set on all of the resource's ancestry resource levels in
         #     the hierarchy. See
-        #     [this topic](https://cloud.google.com/iam/docs/policies#inheritance) for
-        #     more information.
+        #     [this topic](https://cloud.google.com/iam/help/allow-policies/inheritance)
+        #     for more information.
         # @!attribute [rw] org_policy
         #   @return [::Array<::Google::Cloud::OrgPolicy::V1::Policy>]
         #     A representation of an [organization
@@ -297,6 +297,7 @@ module Google
         end
 
         # A result of Resource Search, containing information of a cloud resource.
+        # Next ID: 29
         # @!attribute [rw] name
         #   @return [::String]
         #     The full resource name of this resource. Example:

data/proto_docs/google/protobuf/empty.rb

@@ -26,8 +26,6 @@ module Google
     #     service Foo {
     #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
     #     }
-    #
-    # The JSON representation for `Empty` is empty JSON object `{}`.
     class Empty
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-asset-v1
 version: !ruby/object:Gem::Version
-  version: 0.19.0
+  version: 0.21.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-06-09 00:00:00.000000000 Z
+date: 2022-08-17 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.7'
+        version: '0.10'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.7'
+        version: '0.10'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -104,28 +104,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.25.1
+        version: 1.26.1
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 1.25.1
+        version: 1.26.1
 - !ruby/object:Gem::Dependency
   name: minitest
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.14'
+        version: '5.16'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '5.14'
+        version: '5.16'
 - !ruby/object:Gem::Dependency
   name: minitest-focus
   requirement: !ruby/object:Gem::Requirement
@@ -160,14 +160,14 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
   type: :development
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '12.0'
+        version: '13.0'
 - !ruby/object:Gem::Dependency
   name: redcarpet
   requirement: !ruby/object:Gem::Requirement
@@ -271,7 +271,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.5'
+      version: '2.6'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="