google-cloud-asset-v1 0.20.1 → 0.21.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/lib/google/cloud/asset/v1/asset_service/client.rb +164 -0
- data/lib/google/cloud/asset/v1/asset_service_pb.rb +55 -0
- data/lib/google/cloud/asset/v1/asset_service_services_pb.rb +15 -0
- data/lib/google/cloud/asset/v1/version.rb +1 -1
- data/proto_docs/google/cloud/asset/v1/asset_service.rb +200 -0
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 3707e5c254ca43502c0169aaf0948734bc5d801fdb0754abbec34f17787cb5c3
|
4
|
+
data.tar.gz: 7e404e7cbcdb10c94c7f62321eaf88fcee4745fbbc330a345861d94126e76241
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: f486ec177ea1c1557db69e775bb0ba8cca6f0a0e01a5ceba28b9920fd362a6c040c4c741ec08bd41ddfef3e2cac7e99a61e40d0efffaec531eb0225bf0237557
|
7
|
+
data.tar.gz: c6c6c1144eec85735c6345698175eb499677dea87549207d55c5075202067853b6f60b4031950f3911b17f1e9a98ec791c9d35c8f8bafd9160d8822c940b56a7
|
@@ -112,6 +112,11 @@ module Google
|
|
112
112
|
|
113
113
|
default_config.rpcs.analyze_iam_policy_longrunning.timeout = 60.0
|
114
114
|
|
115
|
+
default_config.rpcs.query_assets.timeout = 200.0
|
116
|
+
default_config.rpcs.query_assets.retry_policy = {
|
117
|
+
initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
|
118
|
+
}
|
119
|
+
|
115
120
|
default_config.rpcs.batch_get_effective_iam_policies.timeout = 300.0
|
116
121
|
default_config.rpcs.batch_get_effective_iam_policies.retry_policy = {
|
117
122
|
initial_delay: 0.1, max_delay: 60.0, multiplier: 1.3, retry_codes: [14]
|
@@ -1856,6 +1861,158 @@ module Google
|
|
1856
1861
|
raise ::Google::Cloud::Error.from_error(e)
|
1857
1862
|
end
|
1858
1863
|
|
1864
|
+
##
|
1865
|
+
# Issue a job that queries assets using a SQL statement compatible with
|
1866
|
+
# [BigQuery Standard
|
1867
|
+
# SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql).
|
1868
|
+
#
|
1869
|
+
# If the query execution finishes within timeout and there's no pagination,
|
1870
|
+
# the full query results will be returned in the `QueryAssetsResponse`.
|
1871
|
+
#
|
1872
|
+
# Otherwise, full query results can be obtained by issuing extra requests
|
1873
|
+
# with the `job_reference` from the a previous `QueryAssets` call.
|
1874
|
+
#
|
1875
|
+
# Note, the query result has approximately 10 GB limitation enforced by
|
1876
|
+
# BigQuery
|
1877
|
+
# https://cloud.google.com/bigquery/docs/best-practices-performance-output,
|
1878
|
+
# queries return larger results will result in errors.
|
1879
|
+
#
|
1880
|
+
# @overload query_assets(request, options = nil)
|
1881
|
+
# Pass arguments to `query_assets` via a request object, either of type
|
1882
|
+
# {::Google::Cloud::Asset::V1::QueryAssetsRequest} or an equivalent Hash.
|
1883
|
+
#
|
1884
|
+
# @param request [::Google::Cloud::Asset::V1::QueryAssetsRequest, ::Hash]
|
1885
|
+
# A request object representing the call parameters. Required. To specify no
|
1886
|
+
# parameters, or to keep all the default parameter values, pass an empty Hash.
|
1887
|
+
# @param options [::Gapic::CallOptions, ::Hash]
|
1888
|
+
# Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
|
1889
|
+
#
|
1890
|
+
# @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)
|
1891
|
+
# Pass arguments to `query_assets` via keyword arguments. Note that at
|
1892
|
+
# least one keyword argument is required. To specify no parameters, or to keep all
|
1893
|
+
# the default parameter values, pass an empty Hash as a request object (see above).
|
1894
|
+
#
|
1895
|
+
# @param parent [::String]
|
1896
|
+
# Required. The relative name of the root asset. This can only be an
|
1897
|
+
# organization number (such as "organizations/123"), a project ID (such as
|
1898
|
+
# "projects/my-project-id"), or a project number (such as "projects/12345"),
|
1899
|
+
# or a folder number (such as "folders/123").
|
1900
|
+
#
|
1901
|
+
# Only assets belonging to the `parent` will be returned.
|
1902
|
+
# @param statement [::String]
|
1903
|
+
# Optional. A SQL statement that's compatible with [BigQuery Standard
|
1904
|
+
# SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql).
|
1905
|
+
# @param job_reference [::String]
|
1906
|
+
# Optional. Reference to the query job, which is from the
|
1907
|
+
# `QueryAssetsResponse` of previous `QueryAssets` call.
|
1908
|
+
# @param page_size [::Integer]
|
1909
|
+
# Optional. The maximum number of rows to return in the results. Responses
|
1910
|
+
# are limited to 10 MB and 1000 rows.
|
1911
|
+
#
|
1912
|
+
# By default, the maximum row count is 1000. When the byte or row count limit
|
1913
|
+
# is reached, the rest of the query results will be paginated.
|
1914
|
+
#
|
1915
|
+
# The field will be ignored when [output_config] is specified.
|
1916
|
+
# @param page_token [::String]
|
1917
|
+
# Optional. A page token received from previous `QueryAssets`.
|
1918
|
+
#
|
1919
|
+
# The field will be ignored when [output_config] is specified.
|
1920
|
+
# @param timeout [::Google::Protobuf::Duration, ::Hash]
|
1921
|
+
# Optional. Specifies the maximum amount of time that the client is willing
|
1922
|
+
# to wait for the query to complete. By default, this limit is 5 min for the
|
1923
|
+
# first query, and 1 minute for the following queries. If the query is
|
1924
|
+
# complete, the `done` field in the `QueryAssetsResponse` is true, otherwise
|
1925
|
+
# false.
|
1926
|
+
#
|
1927
|
+
# Like BigQuery [jobs.query
|
1928
|
+
# API](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#queryrequest)
|
1929
|
+
# The call is not guaranteed to wait for the specified timeout; it typically
|
1930
|
+
# returns after around 200 seconds (200,000 milliseconds), even if the query
|
1931
|
+
# is not complete.
|
1932
|
+
#
|
1933
|
+
# The field will be ignored when [output_config] is specified.
|
1934
|
+
# @param read_time_window [::Google::Cloud::Asset::V1::TimeWindow, ::Hash]
|
1935
|
+
# Optional. [start_time] is required. [start_time] must be less than
|
1936
|
+
# [end_time] Defaults [end_time] to now if [start_time] is set and
|
1937
|
+
# [end_time] isn't. Maximum permitted time range is 7 days.
|
1938
|
+
# @param read_time [::Google::Protobuf::Timestamp, ::Hash]
|
1939
|
+
# Optional. Queries cloud assets as they appeared at the specified point in
|
1940
|
+
# time.
|
1941
|
+
# @param output_config [::Google::Cloud::Asset::V1::QueryAssetsOutputConfig, ::Hash]
|
1942
|
+
# Optional. Destination where the query results will be saved.
|
1943
|
+
#
|
1944
|
+
# When this field is specified, the query results won't be saved in the
|
1945
|
+
# [QueryAssetsResponse.query_result]. Instead
|
1946
|
+
# [QueryAssetsResponse.output_config] will be set.
|
1947
|
+
#
|
1948
|
+
# Meanwhile, [QueryAssetsResponse.job_reference] will be set and can be used
|
1949
|
+
# to check the status of the query job when passed to a following
|
1950
|
+
# [QueryAssets] API call.
|
1951
|
+
#
|
1952
|
+
# @yield [response, operation] Access the result along with the RPC operation
|
1953
|
+
# @yieldparam response [::Google::Cloud::Asset::V1::QueryAssetsResponse]
|
1954
|
+
# @yieldparam operation [::GRPC::ActiveCall::Operation]
|
1955
|
+
#
|
1956
|
+
# @return [::Google::Cloud::Asset::V1::QueryAssetsResponse]
|
1957
|
+
#
|
1958
|
+
# @raise [::Google::Cloud::Error] if the RPC is aborted.
|
1959
|
+
#
|
1960
|
+
# @example Basic example
|
1961
|
+
# require "google/cloud/asset/v1"
|
1962
|
+
#
|
1963
|
+
# # Create a client object. The client can be reused for multiple calls.
|
1964
|
+
# client = Google::Cloud::Asset::V1::AssetService::Client.new
|
1965
|
+
#
|
1966
|
+
# # Create a request. To set request fields, pass in keyword arguments.
|
1967
|
+
# request = Google::Cloud::Asset::V1::QueryAssetsRequest.new
|
1968
|
+
#
|
1969
|
+
# # Call the query_assets method.
|
1970
|
+
# result = client.query_assets request
|
1971
|
+
#
|
1972
|
+
# # The returned object is of type Google::Cloud::Asset::V1::QueryAssetsResponse.
|
1973
|
+
# p result
|
1974
|
+
#
|
1975
|
+
def query_assets request, options = nil
|
1976
|
+
raise ::ArgumentError, "request must be provided" if request.nil?
|
1977
|
+
|
1978
|
+
request = ::Gapic::Protobuf.coerce request, to: ::Google::Cloud::Asset::V1::QueryAssetsRequest
|
1979
|
+
|
1980
|
+
# Converts hash and nil to an options object
|
1981
|
+
options = ::Gapic::CallOptions.new(**options.to_h) if options.respond_to? :to_h
|
1982
|
+
|
1983
|
+
# Customize the options with defaults
|
1984
|
+
metadata = @config.rpcs.query_assets.metadata.to_h
|
1985
|
+
|
1986
|
+
# Set x-goog-api-client and x-goog-user-project headers
|
1987
|
+
metadata[:"x-goog-api-client"] ||= ::Gapic::Headers.x_goog_api_client \
|
1988
|
+
lib_name: @config.lib_name, lib_version: @config.lib_version,
|
1989
|
+
gapic_version: ::Google::Cloud::Asset::V1::VERSION
|
1990
|
+
metadata[:"x-goog-user-project"] = @quota_project_id if @quota_project_id
|
1991
|
+
|
1992
|
+
header_params = {}
|
1993
|
+
if request.parent
|
1994
|
+
header_params["parent"] = request.parent
|
1995
|
+
end
|
1996
|
+
|
1997
|
+
request_params_header = header_params.map { |k, v| "#{k}=#{v}" }.join("&")
|
1998
|
+
metadata[:"x-goog-request-params"] ||= request_params_header
|
1999
|
+
|
2000
|
+
options.apply_defaults timeout: @config.rpcs.query_assets.timeout,
|
2001
|
+
metadata: metadata,
|
2002
|
+
retry_policy: @config.rpcs.query_assets.retry_policy
|
2003
|
+
|
2004
|
+
options.apply_defaults timeout: @config.timeout,
|
2005
|
+
metadata: @config.metadata,
|
2006
|
+
retry_policy: @config.retry_policy
|
2007
|
+
|
2008
|
+
@asset_service_stub.call_rpc :query_assets, request, options: options do |response, operation|
|
2009
|
+
yield response, operation if block_given?
|
2010
|
+
return response
|
2011
|
+
end
|
2012
|
+
rescue ::GRPC::BadStatus => e
|
2013
|
+
raise ::Google::Cloud::Error.from_error(e)
|
2014
|
+
end
|
2015
|
+
|
1859
2016
|
##
|
1860
2017
|
# Creates a saved query in a parent project/folder/organization.
|
1861
2018
|
#
|
@@ -2646,6 +2803,11 @@ module Google
|
|
2646
2803
|
#
|
2647
2804
|
attr_reader :analyze_move
|
2648
2805
|
##
|
2806
|
+
# RPC-specific configuration for `query_assets`
|
2807
|
+
# @return [::Gapic::Config::Method]
|
2808
|
+
#
|
2809
|
+
attr_reader :query_assets
|
2810
|
+
##
|
2649
2811
|
# RPC-specific configuration for `create_saved_query`
|
2650
2812
|
# @return [::Gapic::Config::Method]
|
2651
2813
|
#
|
@@ -2704,6 +2866,8 @@ module Google
|
|
2704
2866
|
@analyze_iam_policy_longrunning = ::Gapic::Config::Method.new analyze_iam_policy_longrunning_config
|
2705
2867
|
analyze_move_config = parent_rpcs.analyze_move if parent_rpcs.respond_to? :analyze_move
|
2706
2868
|
@analyze_move = ::Gapic::Config::Method.new analyze_move_config
|
2869
|
+
query_assets_config = parent_rpcs.query_assets if parent_rpcs.respond_to? :query_assets
|
2870
|
+
@query_assets = ::Gapic::Config::Method.new query_assets_config
|
2707
2871
|
create_saved_query_config = parent_rpcs.create_saved_query if parent_rpcs.respond_to? :create_saved_query
|
2708
2872
|
@create_saved_query = ::Gapic::Config::Method.new create_saved_query_config
|
2709
2873
|
get_saved_query_config = parent_rpcs.get_saved_query if parent_rpcs.respond_to? :get_saved_query
|
@@ -13,6 +13,7 @@ require 'google/longrunning/operations_pb'
|
|
13
13
|
require 'google/protobuf/duration_pb'
|
14
14
|
require 'google/protobuf/empty_pb'
|
15
15
|
require 'google/protobuf/field_mask_pb'
|
16
|
+
require 'google/protobuf/struct_pb'
|
16
17
|
require 'google/protobuf/timestamp_pb'
|
17
18
|
require 'google/rpc/status_pb'
|
18
19
|
require 'google/type/expr_pb'
|
@@ -297,6 +298,53 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
|
|
297
298
|
add_message "google.cloud.asset.v1.MoveImpact" do
|
298
299
|
optional :detail, :string, 1
|
299
300
|
end
|
301
|
+
add_message "google.cloud.asset.v1.QueryAssetsOutputConfig" do
|
302
|
+
optional :bigquery_destination, :message, 1, "google.cloud.asset.v1.QueryAssetsOutputConfig.BigQueryDestination"
|
303
|
+
end
|
304
|
+
add_message "google.cloud.asset.v1.QueryAssetsOutputConfig.BigQueryDestination" do
|
305
|
+
optional :dataset, :string, 1
|
306
|
+
optional :table, :string, 2
|
307
|
+
optional :write_disposition, :string, 3
|
308
|
+
end
|
309
|
+
add_message "google.cloud.asset.v1.QueryAssetsRequest" do
|
310
|
+
optional :parent, :string, 1
|
311
|
+
optional :page_size, :int32, 4
|
312
|
+
optional :page_token, :string, 5
|
313
|
+
optional :timeout, :message, 6, "google.protobuf.Duration"
|
314
|
+
optional :output_config, :message, 9, "google.cloud.asset.v1.QueryAssetsOutputConfig"
|
315
|
+
oneof :query do
|
316
|
+
optional :statement, :string, 2
|
317
|
+
optional :job_reference, :string, 3
|
318
|
+
end
|
319
|
+
oneof :time do
|
320
|
+
optional :read_time_window, :message, 7, "google.cloud.asset.v1.TimeWindow"
|
321
|
+
optional :read_time, :message, 8, "google.protobuf.Timestamp"
|
322
|
+
end
|
323
|
+
end
|
324
|
+
add_message "google.cloud.asset.v1.QueryAssetsResponse" do
|
325
|
+
optional :job_reference, :string, 1
|
326
|
+
optional :done, :bool, 2
|
327
|
+
oneof :response do
|
328
|
+
optional :error, :message, 3, "google.rpc.Status"
|
329
|
+
optional :query_result, :message, 4, "google.cloud.asset.v1.QueryResult"
|
330
|
+
optional :output_config, :message, 5, "google.cloud.asset.v1.QueryAssetsOutputConfig"
|
331
|
+
end
|
332
|
+
end
|
333
|
+
add_message "google.cloud.asset.v1.QueryResult" do
|
334
|
+
repeated :rows, :message, 1, "google.protobuf.Struct"
|
335
|
+
optional :schema, :message, 2, "google.cloud.asset.v1.TableSchema"
|
336
|
+
optional :next_page_token, :string, 3
|
337
|
+
optional :total_rows, :int64, 4
|
338
|
+
end
|
339
|
+
add_message "google.cloud.asset.v1.TableSchema" do
|
340
|
+
repeated :fields, :message, 1, "google.cloud.asset.v1.TableFieldSchema"
|
341
|
+
end
|
342
|
+
add_message "google.cloud.asset.v1.TableFieldSchema" do
|
343
|
+
optional :field, :string, 1
|
344
|
+
optional :type, :string, 2
|
345
|
+
optional :mode, :string, 3
|
346
|
+
repeated :fields, :message, 4, "google.cloud.asset.v1.TableFieldSchema"
|
347
|
+
end
|
300
348
|
add_message "google.cloud.asset.v1.BatchGetEffectiveIamPoliciesRequest" do
|
301
349
|
optional :scope, :string, 1
|
302
350
|
repeated :names, :string, 3
|
@@ -384,6 +432,13 @@ module Google
|
|
384
432
|
MoveAnalysis = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.MoveAnalysis").msgclass
|
385
433
|
MoveAnalysisResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.MoveAnalysisResult").msgclass
|
386
434
|
MoveImpact = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.MoveImpact").msgclass
|
435
|
+
QueryAssetsOutputConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.QueryAssetsOutputConfig").msgclass
|
436
|
+
QueryAssetsOutputConfig::BigQueryDestination = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.QueryAssetsOutputConfig.BigQueryDestination").msgclass
|
437
|
+
QueryAssetsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.QueryAssetsRequest").msgclass
|
438
|
+
QueryAssetsResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.QueryAssetsResponse").msgclass
|
439
|
+
QueryResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.QueryResult").msgclass
|
440
|
+
TableSchema = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.TableSchema").msgclass
|
441
|
+
TableFieldSchema = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.TableFieldSchema").msgclass
|
387
442
|
BatchGetEffectiveIamPoliciesRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.BatchGetEffectiveIamPoliciesRequest").msgclass
|
388
443
|
BatchGetEffectiveIamPoliciesResponse = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.BatchGetEffectiveIamPoliciesResponse").msgclass
|
389
444
|
BatchGetEffectiveIamPoliciesResponse::EffectiveIamPolicy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.BatchGetEffectiveIamPoliciesResponse.EffectiveIamPolicy").msgclass
|
@@ -97,6 +97,21 @@ module Google
|
|
97
97
|
# The policies and configuration are subject to change before the actual
|
98
98
|
# resource migration takes place.
|
99
99
|
rpc :AnalyzeMove, ::Google::Cloud::Asset::V1::AnalyzeMoveRequest, ::Google::Cloud::Asset::V1::AnalyzeMoveResponse
|
100
|
+
# Issue a job that queries assets using a SQL statement compatible with
|
101
|
+
# [BigQuery Standard
|
102
|
+
# SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql).
|
103
|
+
#
|
104
|
+
# If the query execution finishes within timeout and there's no pagination,
|
105
|
+
# the full query results will be returned in the `QueryAssetsResponse`.
|
106
|
+
#
|
107
|
+
# Otherwise, full query results can be obtained by issuing extra requests
|
108
|
+
# with the `job_reference` from the a previous `QueryAssets` call.
|
109
|
+
#
|
110
|
+
# Note, the query result has approximately 10 GB limitation enforced by
|
111
|
+
# BigQuery
|
112
|
+
# https://cloud.google.com/bigquery/docs/best-practices-performance-output,
|
113
|
+
# queries return larger results will result in errors.
|
114
|
+
rpc :QueryAssets, ::Google::Cloud::Asset::V1::QueryAssetsRequest, ::Google::Cloud::Asset::V1::QueryAssetsResponse
|
100
115
|
# Creates a saved query in a parent project/folder/organization.
|
101
116
|
rpc :CreateSavedQuery, ::Google::Cloud::Asset::V1::CreateSavedQueryRequest, ::Google::Cloud::Asset::V1::SavedQuery
|
102
117
|
# Gets details about a saved query.
|
@@ -1583,6 +1583,206 @@ module Google
|
|
1583
1583
|
extend ::Google::Protobuf::MessageExts::ClassMethods
|
1584
1584
|
end
|
1585
1585
|
|
1586
|
+
# Output configuration query assets.
|
1587
|
+
# @!attribute [rw] bigquery_destination
|
1588
|
+
# @return [::Google::Cloud::Asset::V1::QueryAssetsOutputConfig::BigQueryDestination]
|
1589
|
+
# BigQuery destination where the query results will be saved.
|
1590
|
+
class QueryAssetsOutputConfig
|
1591
|
+
include ::Google::Protobuf::MessageExts
|
1592
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
1593
|
+
|
1594
|
+
# BigQuery destination.
|
1595
|
+
# @!attribute [rw] dataset
|
1596
|
+
# @return [::String]
|
1597
|
+
# Required. The BigQuery dataset where the query results will be saved. It
|
1598
|
+
# has the format of "projects/\\{projectId}/datasets/\\{datasetId}".
|
1599
|
+
# @!attribute [rw] table
|
1600
|
+
# @return [::String]
|
1601
|
+
# Required. The BigQuery table where the query results will be saved. If
|
1602
|
+
# this table does not exist, a new table with the given name will be
|
1603
|
+
# created.
|
1604
|
+
# @!attribute [rw] write_disposition
|
1605
|
+
# @return [::String]
|
1606
|
+
# Specifies the action that occurs if the destination table or partition
|
1607
|
+
# already exists. The following values are supported:
|
1608
|
+
#
|
1609
|
+
# * WRITE_TRUNCATE: If the table or partition already exists, BigQuery
|
1610
|
+
# overwrites the entire table or all the partitions data.
|
1611
|
+
# * WRITE_APPEND: If the table or partition already exists, BigQuery
|
1612
|
+
# appends the data to the table or the latest partition.
|
1613
|
+
# * WRITE_EMPTY: If the table already exists and contains data, an error is
|
1614
|
+
# returned.
|
1615
|
+
class BigQueryDestination
|
1616
|
+
include ::Google::Protobuf::MessageExts
|
1617
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
1618
|
+
end
|
1619
|
+
end
|
1620
|
+
|
1621
|
+
# QueryAssets request.
|
1622
|
+
# @!attribute [rw] parent
|
1623
|
+
# @return [::String]
|
1624
|
+
# Required. The relative name of the root asset. This can only be an
|
1625
|
+
# organization number (such as "organizations/123"), a project ID (such as
|
1626
|
+
# "projects/my-project-id"), or a project number (such as "projects/12345"),
|
1627
|
+
# or a folder number (such as "folders/123").
|
1628
|
+
#
|
1629
|
+
# Only assets belonging to the `parent` will be returned.
|
1630
|
+
# @!attribute [rw] statement
|
1631
|
+
# @return [::String]
|
1632
|
+
# Optional. A SQL statement that's compatible with [BigQuery Standard
|
1633
|
+
# SQL](http://cloud/bigquery/docs/reference/standard-sql/enabling-standard-sql).
|
1634
|
+
# @!attribute [rw] job_reference
|
1635
|
+
# @return [::String]
|
1636
|
+
# Optional. Reference to the query job, which is from the
|
1637
|
+
# `QueryAssetsResponse` of previous `QueryAssets` call.
|
1638
|
+
# @!attribute [rw] page_size
|
1639
|
+
# @return [::Integer]
|
1640
|
+
# Optional. The maximum number of rows to return in the results. Responses
|
1641
|
+
# are limited to 10 MB and 1000 rows.
|
1642
|
+
#
|
1643
|
+
# By default, the maximum row count is 1000. When the byte or row count limit
|
1644
|
+
# is reached, the rest of the query results will be paginated.
|
1645
|
+
#
|
1646
|
+
# The field will be ignored when [output_config] is specified.
|
1647
|
+
# @!attribute [rw] page_token
|
1648
|
+
# @return [::String]
|
1649
|
+
# Optional. A page token received from previous `QueryAssets`.
|
1650
|
+
#
|
1651
|
+
# The field will be ignored when [output_config] is specified.
|
1652
|
+
# @!attribute [rw] timeout
|
1653
|
+
# @return [::Google::Protobuf::Duration]
|
1654
|
+
# Optional. Specifies the maximum amount of time that the client is willing
|
1655
|
+
# to wait for the query to complete. By default, this limit is 5 min for the
|
1656
|
+
# first query, and 1 minute for the following queries. If the query is
|
1657
|
+
# complete, the `done` field in the `QueryAssetsResponse` is true, otherwise
|
1658
|
+
# false.
|
1659
|
+
#
|
1660
|
+
# Like BigQuery [jobs.query
|
1661
|
+
# API](https://cloud.google.com/bigquery/docs/reference/rest/v2/jobs/query#queryrequest)
|
1662
|
+
# The call is not guaranteed to wait for the specified timeout; it typically
|
1663
|
+
# returns after around 200 seconds (200,000 milliseconds), even if the query
|
1664
|
+
# is not complete.
|
1665
|
+
#
|
1666
|
+
# The field will be ignored when [output_config] is specified.
|
1667
|
+
# @!attribute [rw] read_time_window
|
1668
|
+
# @return [::Google::Cloud::Asset::V1::TimeWindow]
|
1669
|
+
# Optional. [start_time] is required. [start_time] must be less than
|
1670
|
+
# [end_time] Defaults [end_time] to now if [start_time] is set and
|
1671
|
+
# [end_time] isn't. Maximum permitted time range is 7 days.
|
1672
|
+
# @!attribute [rw] read_time
|
1673
|
+
# @return [::Google::Protobuf::Timestamp]
|
1674
|
+
# Optional. Queries cloud assets as they appeared at the specified point in
|
1675
|
+
# time.
|
1676
|
+
# @!attribute [rw] output_config
|
1677
|
+
# @return [::Google::Cloud::Asset::V1::QueryAssetsOutputConfig]
|
1678
|
+
# Optional. Destination where the query results will be saved.
|
1679
|
+
#
|
1680
|
+
# When this field is specified, the query results won't be saved in the
|
1681
|
+
# [QueryAssetsResponse.query_result]. Instead
|
1682
|
+
# [QueryAssetsResponse.output_config] will be set.
|
1683
|
+
#
|
1684
|
+
# Meanwhile, [QueryAssetsResponse.job_reference] will be set and can be used
|
1685
|
+
# to check the status of the query job when passed to a following
|
1686
|
+
# [QueryAssets] API call.
|
1687
|
+
class QueryAssetsRequest
|
1688
|
+
include ::Google::Protobuf::MessageExts
|
1689
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
1690
|
+
end
|
1691
|
+
|
1692
|
+
# QueryAssets response.
|
1693
|
+
# @!attribute [rw] job_reference
|
1694
|
+
# @return [::String]
|
1695
|
+
# Reference to a query job.
|
1696
|
+
# @!attribute [rw] done
|
1697
|
+
# @return [::Boolean]
|
1698
|
+
# The query response, which can be either an `error` or a valid `response`.
|
1699
|
+
#
|
1700
|
+
# If `done` == `false` and the query result is being saved in a output, the
|
1701
|
+
# output_config field will be set.
|
1702
|
+
# If `done` == `true`, exactly one of
|
1703
|
+
# `error`, `query_result` or `output_config` will be set.
|
1704
|
+
# @!attribute [rw] error
|
1705
|
+
# @return [::Google::Rpc::Status]
|
1706
|
+
# Error status.
|
1707
|
+
# @!attribute [rw] query_result
|
1708
|
+
# @return [::Google::Cloud::Asset::V1::QueryResult]
|
1709
|
+
# Result of the query.
|
1710
|
+
# @!attribute [rw] output_config
|
1711
|
+
# @return [::Google::Cloud::Asset::V1::QueryAssetsOutputConfig]
|
1712
|
+
# Output configuration which indicates instead of being returned in API
|
1713
|
+
# response on the fly, the query result will be saved in a specific output.
|
1714
|
+
class QueryAssetsResponse
|
1715
|
+
include ::Google::Protobuf::MessageExts
|
1716
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
1717
|
+
end
|
1718
|
+
|
1719
|
+
# Execution results of the query.
|
1720
|
+
#
|
1721
|
+
# The result is formatted as rows represented by BigQuery compatible [schema].
|
1722
|
+
# When pagination is necessary, it will contains the page token to retrieve
|
1723
|
+
# the results of following pages.
|
1724
|
+
# @!attribute [rw] rows
|
1725
|
+
# @return [::Array<::Google::Protobuf::Struct>]
|
1726
|
+
# Each row hold a query result in the format of `Struct`.
|
1727
|
+
# @!attribute [rw] schema
|
1728
|
+
# @return [::Google::Cloud::Asset::V1::TableSchema]
|
1729
|
+
# Describes the format of the [rows].
|
1730
|
+
# @!attribute [rw] next_page_token
|
1731
|
+
# @return [::String]
|
1732
|
+
# Token to retrieve the next page of the results.
|
1733
|
+
# @!attribute [rw] total_rows
|
1734
|
+
# @return [::Integer]
|
1735
|
+
# Total rows of the whole query results.
|
1736
|
+
class QueryResult
|
1737
|
+
include ::Google::Protobuf::MessageExts
|
1738
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
1739
|
+
end
|
1740
|
+
|
1741
|
+
# BigQuery Compatible table schema.
|
1742
|
+
# @!attribute [rw] fields
|
1743
|
+
# @return [::Array<::Google::Cloud::Asset::V1::TableFieldSchema>]
|
1744
|
+
# Describes the fields in a table.
|
1745
|
+
class TableSchema
|
1746
|
+
include ::Google::Protobuf::MessageExts
|
1747
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
1748
|
+
end
|
1749
|
+
|
1750
|
+
# A field in TableSchema.
|
1751
|
+
# @!attribute [rw] field
|
1752
|
+
# @return [::String]
|
1753
|
+
# The field name. The name must contain only letters (a-z, A-Z),
|
1754
|
+
# numbers (0-9), or underscores (_), and must start with a letter or
|
1755
|
+
# underscore. The maximum length is 128 characters.
|
1756
|
+
# @!attribute [rw] type
|
1757
|
+
# @return [::String]
|
1758
|
+
# The field data type. Possible values include
|
1759
|
+
# * STRING
|
1760
|
+
# * BYTES
|
1761
|
+
# * INTEGER
|
1762
|
+
# * FLOAT
|
1763
|
+
# * BOOLEAN
|
1764
|
+
# * TIMESTAMP
|
1765
|
+
# * DATE
|
1766
|
+
# * TIME
|
1767
|
+
# * DATETIME
|
1768
|
+
# * GEOGRAPHY,
|
1769
|
+
# * NUMERIC,
|
1770
|
+
# * BIGNUMERIC,
|
1771
|
+
# * RECORD
|
1772
|
+
# (where RECORD indicates that the field contains a nested schema).
|
1773
|
+
# @!attribute [rw] mode
|
1774
|
+
# @return [::String]
|
1775
|
+
# The field mode. Possible values include NULLABLE, REQUIRED and
|
1776
|
+
# REPEATED. The default value is NULLABLE.
|
1777
|
+
# @!attribute [rw] fields
|
1778
|
+
# @return [::Array<::Google::Cloud::Asset::V1::TableFieldSchema>]
|
1779
|
+
# Describes the nested schema fields if the type property is set
|
1780
|
+
# to RECORD.
|
1781
|
+
class TableFieldSchema
|
1782
|
+
include ::Google::Protobuf::MessageExts
|
1783
|
+
extend ::Google::Protobuf::MessageExts::ClassMethods
|
1784
|
+
end
|
1785
|
+
|
1586
1786
|
# A request message for
|
1587
1787
|
# {::Google::Cloud::Asset::V1::AssetService::Client#batch_get_effective_iam_policies AssetService.BatchGetEffectiveIamPolicies}.
|
1588
1788
|
# @!attribute [rw] scope
|
metadata
CHANGED
@@ -1,14 +1,14 @@
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
2
2
|
name: google-cloud-asset-v1
|
3
3
|
version: !ruby/object:Gem::Version
|
4
|
-
version: 0.
|
4
|
+
version: 0.21.0
|
5
5
|
platform: ruby
|
6
6
|
authors:
|
7
7
|
- Google LLC
|
8
8
|
autorequire:
|
9
9
|
bindir: bin
|
10
10
|
cert_chain: []
|
11
|
-
date: 2022-08-
|
11
|
+
date: 2022-08-17 00:00:00.000000000 Z
|
12
12
|
dependencies:
|
13
13
|
- !ruby/object:Gem::Dependency
|
14
14
|
name: gapic-common
|