google-cloud-asset-v1 0.20.1 → 0.21.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c06b554d19850b8923937a7b76e2713fd41c855d0c7e85737930564c668b5784
-  data.tar.gz: 87deccb72bb8eeeabc00feb919f455a27a171af2e31e745fa997ecb201b81222
+  metadata.gz: d8af562b0115d3d973426bda368ef1ec3e9068ec877174ce025f6da784f197e3
+  data.tar.gz: d7dcef2f57cd7ec3b82dae5491518ecfb655e7a71174ab02e72609fe8493cdb8
 SHA512:
-  metadata.gz: 35e758724c4667474c013a2484300d790ee0b15ca24577781f7c0d126bb63d0eaa818d5fae2b0d64ca70c3fa47ad54e754ed22cd8d2efccef402ec61aa4a144b
-  data.tar.gz: 6047743a05bca031e51615548b83e9416a96b86a397515c60f3d81cb5bb307ccefb9899db2ac1f8857719b9b46d631277d402e418ec3564fdb0e4f47ed851e90
+  metadata.gz: 650b132db2f02dcc24ad3f36cd631034d8da3b01054ab3ce5ff90466b8e3aa50de6e72613ecb836317ae094c9040c25e9fbd99fa4dbdb525f9bae732cb4e856f
+  data.tar.gz: 95f1007bd217d967d4d47f76d7a1ad516f1ebf0a8a86d2bb0a907dce0444fab8e4f046532c0a8af88410078ba45f2dbec1332ec70808228795fe5020a4c98bd3

data/AUTHENTICATION.md

@@ -114,7 +114,7 @@ credentials are discovered.
 To configure your system for this, simply:
 
 1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
-2. Authenticate using OAuth 2.0 `$ gcloud auth login`
+2. Authenticate using OAuth 2.0 `$ gcloud auth application-default login`
 3. Write code as if already authenticated.
 
 **NOTE:** This is _not_ recommended for running in production. The Cloud SDK

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

@@ -112,6 +112,30 @@ 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.create_saved_query.timeout = 60.0
+
+                default_config.rpcs.get_saved_query.timeout = 60.0
+                default_config.rpcs.get_saved_query.retry_policy = {
+                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
+                }
+
+                default_config.rpcs.list_saved_queries.timeout = 60.0
+                default_config.rpcs.list_saved_queries.retry_policy = {
+                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 14]
+                }
+
+                default_config.rpcs.update_saved_query.timeout = 60.0
+
+                default_config.rpcs.delete_saved_query.timeout = 60.0
+                default_config.rpcs.delete_saved_query.retry_policy = {
+                  initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [4, 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]
@@ -1856,6 +1880,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.
             #
@@ -2646,6 +2822,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]
                 #
@@ -2704,6 +2885,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_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/assets_pb.rb

@@ -3,7 +3,6 @@
 
 require 'google/protobuf'
 
-require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/cloud/orgpolicy/v1/orgpolicy_pb'
 require 'google/cloud/osconfig/v1/inventory_pb'

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Asset
       module V1
-        VERSION = "0.20.1"
+        VERSION = "0.21.1"
       end
     end
   end

data/lib/google/cloud/orgpolicy/v1/orgpolicy_pb.rb

@@ -3,9 +3,7 @@
 
 require 'google/protobuf'
 
-require 'google/protobuf/empty_pb'
 require 'google/protobuf/timestamp_pb'
-require 'google/api/annotations_pb'
 
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/orgpolicy/v1/orgpolicy.proto", :syntax => :proto3) do

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

@@ -1583,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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-asset-v1
 version: !ruby/object:Gem::Version
-  version: 0.20.1
+  version: 0.21.1
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-08-15 00:00:00.000000000 Z
+date: 2022-09-28 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.10'
+        version: '0.12'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a
@@ -26,7 +26,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0.10'
+        version: '0.12'
     - - "<"
       - !ruby/object:Gem::Version
         version: 2.a