google-cloud-asset-v1 0.6.1 → 0.7.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7601e08b3f6d242baec633460a4e82037603a86284c15071dda3595e20984b4d
-  data.tar.gz: 5dddf6f643e226cc7a0c9d070bd755a9735fad69d33ad1237070b80d38276a24
+  metadata.gz: 3a33096b1fa6262e9bd69d258c12d8cd8ff8efa76c1537c0d49e4e2941e3516e
+  data.tar.gz: aa07a54ad150dd6707ea2f775a46730cdf9275c8c57b943f0d7dd8c7385aa210
 SHA512:
-  metadata.gz: 5ee7a713b523233cdc7b35f12ae891388713619ca96743a8e3b1d3c30bdefd09a3be70ec00c0ada079c0a93ab85d890d1d3c7e11b7b266b51ba9d7406765ad5e
-  data.tar.gz: b3d0f7fa841d88066fe72e4835cd33891a0fb9be93ce60a80a221647bf4850e72901ee5b429c36aa733983648083d024d3118044a00099ca6e1d31dc236395e6
+  metadata.gz: 6d83fa78c7480975dc0ce2102c27421e22f1132ec29170eadf3bdf319a5e2419e09762fca2a83c8a1118d47fe5182f0822211556bcab6f4bd63c32419fde2595
+  data.tar.gz: 2e57428a82dffbf427466096119e6d0c7030d0dd232778c25d40062ece4dc8d789702e2df36e4d223ede5a491f7adf8e319be6bcc4b89fba711b68fd78db01bc

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

@@ -82,6 +82,16 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :dataset, :string, 1
       optional :table, :string, 2
       optional :force, :bool, 3
+      optional :partition_spec, :message, 4, "google.cloud.asset.v1.PartitionSpec"
+      optional :separate_tables_per_asset_type, :bool, 5
+    end
+    add_message "google.cloud.asset.v1.PartitionSpec" do
+      optional :partition_key, :enum, 1, "google.cloud.asset.v1.PartitionSpec.PartitionKey"
+    end
+    add_enum "google.cloud.asset.v1.PartitionSpec.PartitionKey" do
+      value :PARTITION_KEY_UNSPECIFIED, 0
+      value :READ_TIME, 1
+      value :REQUEST_TIME, 2
     end
     add_message "google.cloud.asset.v1.PubsubDestination" do
       optional :topic, :string, 1
@@ -150,6 +160,8 @@ module Google
         GcsOutputResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.GcsOutputResult").msgclass
         GcsDestination = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.GcsDestination").msgclass
         BigQueryDestination = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.BigQueryDestination").msgclass
+        PartitionSpec = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.PartitionSpec").msgclass
+        PartitionSpec::PartitionKey = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.PartitionSpec.PartitionKey").enummodule
         PubsubDestination = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.PubsubDestination").msgclass
         FeedOutputConfig = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.FeedOutputConfig").msgclass
         Feed = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.Feed").msgclass

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

@@ -43,7 +43,7 @@ module Google
             # at least 2 seconds with exponential retry to poll the export operation
             # result. For regular-size resource parent, the export operation usually
             # finishes within 5 minutes.
-            rpc :ExportAssets, Google::Cloud::Asset::V1::ExportAssetsRequest, Google::Longrunning::Operation
+            rpc :ExportAssets, ::Google::Cloud::Asset::V1::ExportAssetsRequest, ::Google::Longrunning::Operation
             # Batch gets the update history of assets that overlap a time window.
             # For IAM_POLICY content, this API outputs history when the asset and its
             # attached IAM POLICY both exist. This can create gaps in the output history.
@@ -51,28 +51,28 @@ module Google
             # deleted status.
             # If a specified asset does not exist, this API returns an INVALID_ARGUMENT
             # error.
-            rpc :BatchGetAssetsHistory, Google::Cloud::Asset::V1::BatchGetAssetsHistoryRequest, Google::Cloud::Asset::V1::BatchGetAssetsHistoryResponse
+            rpc :BatchGetAssetsHistory, ::Google::Cloud::Asset::V1::BatchGetAssetsHistoryRequest, ::Google::Cloud::Asset::V1::BatchGetAssetsHistoryResponse
             # Creates a feed in a parent project/folder/organization to listen to its
             # asset updates.
-            rpc :CreateFeed, Google::Cloud::Asset::V1::CreateFeedRequest, Google::Cloud::Asset::V1::Feed
+            rpc :CreateFeed, ::Google::Cloud::Asset::V1::CreateFeedRequest, ::Google::Cloud::Asset::V1::Feed
             # Gets details about an asset feed.
-            rpc :GetFeed, Google::Cloud::Asset::V1::GetFeedRequest, Google::Cloud::Asset::V1::Feed
+            rpc :GetFeed, ::Google::Cloud::Asset::V1::GetFeedRequest, ::Google::Cloud::Asset::V1::Feed
             # Lists all asset feeds in a parent project/folder/organization.
-            rpc :ListFeeds, Google::Cloud::Asset::V1::ListFeedsRequest, Google::Cloud::Asset::V1::ListFeedsResponse
+            rpc :ListFeeds, ::Google::Cloud::Asset::V1::ListFeedsRequest, ::Google::Cloud::Asset::V1::ListFeedsResponse
             # Updates an asset feed configuration.
-            rpc :UpdateFeed, Google::Cloud::Asset::V1::UpdateFeedRequest, Google::Cloud::Asset::V1::Feed
+            rpc :UpdateFeed, ::Google::Cloud::Asset::V1::UpdateFeedRequest, ::Google::Cloud::Asset::V1::Feed
             # Deletes an asset feed.
-            rpc :DeleteFeed, Google::Cloud::Asset::V1::DeleteFeedRequest, Google::Protobuf::Empty
+            rpc :DeleteFeed, ::Google::Cloud::Asset::V1::DeleteFeedRequest, ::Google::Protobuf::Empty
             # Searches all Cloud resources within the specified scope, such as a project,
             # folder, or organization. The caller must be granted the
             # `cloudasset.assets.searchAllResources` permission on the desired scope,
             # otherwise the request will be rejected.
-            rpc :SearchAllResources, Google::Cloud::Asset::V1::SearchAllResourcesRequest, Google::Cloud::Asset::V1::SearchAllResourcesResponse
+            rpc :SearchAllResources, ::Google::Cloud::Asset::V1::SearchAllResourcesRequest, ::Google::Cloud::Asset::V1::SearchAllResourcesResponse
             # Searches all IAM policies within the specified scope, such as a project,
             # folder, or organization. The caller must be granted the
             # `cloudasset.assets.searchAllIamPolicies` permission on the desired scope,
             # otherwise the request will be rejected.
-            rpc :SearchAllIamPolicies, Google::Cloud::Asset::V1::SearchAllIamPoliciesRequest, Google::Cloud::Asset::V1::SearchAllIamPoliciesResponse
+            rpc :SearchAllIamPolicies, ::Google::Cloud::Asset::V1::SearchAllIamPoliciesRequest, ::Google::Cloud::Asset::V1::SearchAllIamPoliciesResponse
           end
 
           Stub = Service.rpc_stub_class

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Asset
       module V1
-        VERSION = "0.6.1"
+        VERSION = "0.7.0"
       end
     end
   end

data/proto_docs/google/api/resource.rb

@@ -43,12 +43,12 @@ module Google
     #
     # The ResourceDescriptor Yaml config will look like:
     #
-    #    resources:
-    #    - type: "pubsub.googleapis.com/Topic"
-    #      name_descriptor:
-    #        - pattern: "projects/\\{project}/topics/\\{topic}"
-    #          parent_type: "cloudresourcemanager.googleapis.com/Project"
-    #          parent_name_extractor: "projects/\\{project}"
+    #     resources:
+    #     - type: "pubsub.googleapis.com/Topic"
+    #       name_descriptor:
+    #         - pattern: "projects/{project}/topics/{topic}"
+    #           parent_type: "cloudresourcemanager.googleapis.com/Project"
+    #           parent_name_extractor: "projects/{project}"
     #
     # Sometimes, resources have multiple patterns, typically because they can
     # live under multiple parents.
@@ -183,15 +183,24 @@ module Google
     #         }
     # @!attribute [rw] plural
     #   @return [::String]
-    #     The plural name used in the resource name, such as 'projects' for
-    #     the name of 'projects/\\{project}'. It is the same concept of the `plural`
-    #     field in k8s CRD spec
+    #     The plural name used in the resource name and permission names, such as
+    #     'projects' for the resource name of 'projects/\\{project}' and the permission
+    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
+    #     concept of the `plural` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
+    #
+    #     Note: The plural form is required even for singleton resources. See
+    #     https://aip.dev/156
     # @!attribute [rw] singular
     #   @return [::String]
     #     The same concept of the `singular` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
     #     Such as "project" for the `resourcemanager.googleapis.com/Project` type.
+    # @!attribute [rw] style
+    #   @return [::Array<::Google::Api::ResourceDescriptor::Style>]
+    #     Style flag(s) for this resource.
+    #     These indicate that a resource is expected to conform to a given
+    #     style. See the specific style flags for additional information.
     class ResourceDescriptor
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -211,6 +220,22 @@ module Google
         # that from being necessary once there are multiple patterns.)
         FUTURE_MULTI_PATTERN = 2
       end
+
+      # A flag representing a specific style that a resource claims to conform to.
+      module Style
+        # The unspecified value. Do not use.
+        STYLE_UNSPECIFIED = 0
+
+        # This resource is intended to be "declarative-friendly".
+        #
+        # Declarative-friendly resources must be more strictly consistent, and
+        # setting this to true communicates to tools that this resource should
+        # adhere to declarative-friendly expectations.
+        #
+        # Note: This is used by the API linter (linter.aip.dev) to enable
+        # additional checks.
+        DECLARATIVE_FRIENDLY = 1
+      end
     end
 
     # Defines a proto annotation that describes a string field that refers to
@@ -226,6 +251,17 @@ module Google
     #             type: "pubsub.googleapis.com/Topic"
     #           }];
     #         }
+    #
+    #     Occasionally, a field may reference an arbitrary resource. In this case,
+    #     APIs use the special value * in their resource reference.
+    #
+    #     Example:
+    #
+    #         message GetIamPolicyRequest {
+    #           string resource = 2 [(google.api.resource_reference) = {
+    #             type: "*"
+    #           }];
+    #         }
     # @!attribute [rw] child_type
     #   @return [::String]
     #     The resource type of a child collection that the annotated field
@@ -234,11 +270,11 @@ module Google
     #
     #     Example:
     #
-    #       message ListLogEntriesRequest {
-    #         string parent = 1 [(google.api.resource_reference) = {
-    #           child_type: "logging.googleapis.com/LogEntry"
-    #         };
-    #       }
+    #         message ListLogEntriesRequest {
+    #           string parent = 1 [(google.api.resource_reference) = {
+    #             child_type: "logging.googleapis.com/LogEntry"
+    #           };
+    #         }
     class ResourceReference
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -287,11 +287,91 @@ module Google
         #     table will be overwritten by the contents of assets snapshot. If the flag
         #     is `FALSE` or unset and the destination table already exists, the export
         #     call returns an INVALID_ARGUMEMT error.
+        # @!attribute [rw] partition_spec
+        #   @return [::Google::Cloud::Asset::V1::PartitionSpec]
+        #     [partition_spec] determines whether to export to partitioned table(s) and
+        #     how to partition the data.
+        #
+        #     If [partition_spec] is unset or [partition_spec.partion_key] is unset or
+        #     `PARTITION_KEY_UNSPECIFIED`, the snapshot results will be exported to
+        #     non-partitioned table(s). [force] will decide whether to overwrite existing
+        #     table(s).
+        #
+        #     If [partition_spec] is specified. First, the snapshot results will be
+        #     written to partitioned table(s) with two additional timestamp columns,
+        #     readTime and requestTime, one of which will be the partition key. Secondly,
+        #     in the case when any destination table already exists, it will first try to
+        #     update existing table's schema as necessary by appending additional
+        #     columns. Then, if [force] is `TRUE`, the corresponding partition will be
+        #     overwritten by the snapshot results (data in different partitions will
+        #     remain intact); if [force] is unset or `FALSE`, it will append the data. An
+        #     error will be returned if the schema update or data appension fails.
+        # @!attribute [rw] separate_tables_per_asset_type
+        #   @return [::Boolean]
+        #     If this flag is `TRUE`, the snapshot results will be written to one or
+        #     multiple tables, each of which contains results of one asset type. The
+        #     [force] and [partition_spec] fields will apply to each of them.
+        #
+        #     Field [table] will be concatenated with "_" and the asset type names (see
+        #     https://cloud.google.com/asset-inventory/docs/supported-asset-types for
+        #     supported asset types) to construct per-asset-type table names, in which
+        #     all non-alphanumeric characters like "." and "/" will be substituted by
+        #     "_". Example: if field [table] is "mytable" and snapshot results
+        #     contain "storage.googleapis.com/Bucket" assets, the corresponding table
+        #     name will be "mytable_storage_googleapis_com_Bucket". If any of these
+        #     tables does not exist, a new table with the concatenated name will be
+        #     created.
+        #
+        #     When [content_type] in the ExportAssetsRequest is `RESOURCE`, the schema of
+        #     each table will include RECORD-type columns mapped to the nested fields in
+        #     the Asset.resource.data field of that asset type (up to the 15 nested level
+        #     BigQuery supports
+        #     (https://cloud.google.com/bigquery/docs/nested-repeated#limitations)). The
+        #     fields in >15 nested levels will be stored in JSON format string as a child
+        #     column of its parent RECORD column.
+        #
+        #     If error occurs when exporting to any table, the whole export call will
+        #     return an error but the export results that already succeed will persist.
+        #     Example: if exporting to table_type_A succeeds when exporting to
+        #     table_type_B fails during one export call, the results in table_type_A will
+        #     persist and there will not be partial results persisting in a table.
         class BigQueryDestination
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # Specifications of BigQuery partitioned table as export destination.
+        # @!attribute [rw] partition_key
+        #   @return [::Google::Cloud::Asset::V1::PartitionSpec::PartitionKey]
+        #     The partition key for BigQuery partitioned table.
+        class PartitionSpec
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # This enum is used to determine the partition key column when exporting
+          # assets to BigQuery partitioned table(s). Note that, if the partition key is
+          # a timestamp column, the actual partition is based on its date value
+          # (expressed in UTC. see details in
+          # https://cloud.google.com/bigquery/docs/partitioned-tables#date_timestamp_partitioned_tables).
+          module PartitionKey
+            # Unspecified partition key. If used, it means using non-partitioned table.
+            PARTITION_KEY_UNSPECIFIED = 0
+
+            # The time when the snapshot is taken. If specified as partition key, the
+            # result table(s) is partitoned by the additional timestamp column,
+            # readTime. If [read_time] in ExportAssetsRequest is specified, the
+            # readTime column's value will be the same as it. Otherwise, its value will
+            # be the current time that is used to take the snapshot.
+            READ_TIME = 1
+
+            # The time when the request is received and started to be processed. If
+            # specified as partition key, the result table(s) is partitoned by the
+            # requestTime column, an additional timestamp column representing when the
+            # request was received.
+            REQUEST_TIME = 2
+          end
+        end
+
         # A Pub/Sub destination.
         # @!attribute [rw] topic
         #   @return [::String]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-asset-v1
 version: !ruby/object:Gem::Version
-  version: 0.6.1
+  version: 0.7.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-09-10 00:00:00.000000000 Z
+date: 2020-09-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -238,7 +238,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.1.3
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
 summary: API Client library for the Cloud Asset V1 API