google-cloud-asset-v1 0.4.1 → 0.5.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 4cd675722292c39ebd65ef783e6c66b16e1da00d186e2cdc38075353a4cb2040
-  data.tar.gz: d3799a1c1f4c8cdddbd754b0b0d57937b389e8cf94a8965bb65772f84295ce1b
+  metadata.gz: 9dbd360a64ed48dfbf749f266ab5c5338e8ded9409c34d28a7688f58c2c952e6
+  data.tar.gz: 9515e97298798479197877d170ec3b496ac28f214e72b5c283fcda41315d2323
 SHA512:
-  metadata.gz: fe1e023fe812625b51f399ffffd5fc4f0004caea5fb6f84bd56c367053678efd17f4131e7a93511a18ff1e680dd78f71fabf300e6a0c50c0a765eda0de7b6f51
-  data.tar.gz: af1344a7910432823015326c3b72a143280523bd3e2ef53d02f5c5408e6474c3f50e61573ccea3f38cdbefcdd396113500a1dd27e1d7f3da8151d268f2d54807
+  metadata.gz: 2e50236aa6ef4801b77150d09b9c3bfc75fde0022e54b00d7310670255f7306c8ed54e3de05ecdaf408c6b5819b3773b7981e0c265656cc95be0209ed44ebcf1
+  data.tar.gz: 252d7eb1beeb6fb3f265403318ae903d6da4a0785fb2b3ae049fe31bc173c309ae71f746139cd80b69511b9e97594730068148bef038a8ec46fcc08090502b7b

data/README.md

@@ -18,6 +18,7 @@ In order to use this library, you first need to go through the following steps:
 
 1. [Select or create a Cloud Platform project.](https://console.cloud.google.com/project)
 1. [Enable billing for your project.](https://cloud.google.com/billing/docs/how-to/modify-project#enable_billing_for_a_project)
+1. [Enable the API.](https://console.cloud.google.com/apis/library/cloudasset.googleapis.com)
 1. {file:AUTHENTICATION.md Set up authentication.}
 
 ## Quick Start
@@ -33,6 +34,9 @@ response = client.export_assets request
 View the [Client Library Documentation](https://googleapis.dev/ruby/google-cloud-asset-v1/latest)
 for class and method documentation.
 
+See also the [Product Documentation](https://cloud.google.com/asset-inventory/)
+for general usage information.
+
 ## Enabling Logging
 
 To enable logging for this library, set the logger for the underlying [gRPC](https://github.com/grpc/grpc/tree/master/src/ruby) library.

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

@@ -72,7 +72,35 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["DEADLINE_EXCEEDED", "UNAVAILABLE"]
+                  retry_codes:   [4, 14]
+                }
+
+                default_config.rpcs.create_feed.timeout = 60.0
+
+                default_config.rpcs.get_feed.timeout = 60.0
+                default_config.rpcs.get_feed.retry_policy = {
+                  initial_delay: 0.1,
+                  max_delay:     60.0,
+                  multiplier:    1.3,
+                  retry_codes:   [4, 14]
+                }
+
+                default_config.rpcs.list_feeds.timeout = 60.0
+                default_config.rpcs.list_feeds.retry_policy = {
+                  initial_delay: 0.1,
+                  max_delay:     60.0,
+                  multiplier:    1.3,
+                  retry_codes:   [4, 14]
+                }
+
+                default_config.rpcs.update_feed.timeout = 60.0
+
+                default_config.rpcs.delete_feed.timeout = 60.0
+                default_config.rpcs.delete_feed.retry_policy = {
+                  initial_delay: 0.1,
+                  max_delay:     60.0,
+                  multiplier:    1.3,
+                  retry_codes:   [4, 14]
                 }
 
                 default_config.rpcs.search_all_resources.timeout = 15.0
@@ -80,7 +108,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["DEADLINE_EXCEEDED", "UNAVAILABLE"]
+                  retry_codes:   [4, 14]
                 }
 
                 default_config.rpcs.search_all_iam_policies.timeout = 15.0
@@ -88,7 +116,7 @@ module Google
                   initial_delay: 0.1,
                   max_delay:     60.0,
                   multiplier:    1.3,
-                  retry_codes:   ["DEADLINE_EXCEEDED", "UNAVAILABLE"]
+                  retry_codes:   [4, 14]
                 }
 
                 default_config
@@ -184,10 +212,16 @@ module Google
 
             ##
             # Exports assets with time and resource types to a given Cloud Storage
-            # location. The output format is newline-delimited JSON.
-            # This API implements the
-            # {::Google::Longrunning::Operation google.longrunning.Operation} API allowing
-            # you to keep track of the export.
+            # location/BigQuery table. For Cloud Storage location destinations, the
+            # output format is newline-delimited JSON. Each line represents a
+            # {::Google::Cloud::Asset::V1::Asset google.cloud.asset.v1.Asset} in the JSON
+            # format; for BigQuery table destinations, the output table stores the fields
+            # in asset proto as columns. This API implements the
+            # {::Google::Longrunning::Operation google.longrunning.Operation} API , which
+            # allows you to keep track of the export. We recommend intervals of 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.
             #
             # @overload export_assets(request, options = nil)
             #   Pass arguments to `export_assets` via a request object, either of type
@@ -216,7 +250,7 @@ module Google
             #     data collection and indexing, there is a volatile window during which
             #     running the same query may get different results.
             #   @param asset_types [::Array<::String>]
-            #     A list of asset types of which to take a snapshot for. For example:
+            #     A list of asset types of which to take a snapshot for. Example:
             #     "compute.googleapis.com/Disk". If specified, only matching assets will be
             #     returned. See [Introduction to Cloud Asset
             #     Inventory](https://cloud.google.com/asset-inventory/docs/overview)
@@ -226,7 +260,7 @@ module Google
             #     returned.
             #   @param output_config [::Google::Cloud::Asset::V1::OutputConfig, ::Hash]
             #     Required. Output configuration indicating where the results will be output
-            #     to. All results will be in newline delimited JSON format.
+            #     to.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -276,10 +310,10 @@ module Google
 
             ##
             # Batch gets the update history of assets that overlap a time window.
-            # For RESOURCE content, this API outputs history with asset in both
-            # non-delete or deleted status.
             # 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.
+            # Otherwise, this API outputs history with asset in both non-delete or
+            # deleted status.
             # If a specified asset does not exist, this API returns an INVALID_ARGUMENT
             # error.
             #
@@ -303,13 +337,11 @@ module Google
             #     organization number (such as "organizations/123"), a project ID (such as
             #     "projects/my-project-id")", or a project number (such as "projects/12345").
             #   @param asset_names [::Array<::String>]
-            #     A list of the full names of the assets. For example:
+            #     A list of the full names of the assets.
+            #     See: https://cloud.google.com/asset-inventory/docs/resource-name-format
+            #     Example:
+            #
             #     `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
-            #     See [Resource
-            #     Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
-            #     and [Resource Name
-            #     Format](https://cloud.google.com/asset-inventory/docs/resource-name-format)
-            #     for more info.
             #
             #     The request becomes a no-op if the asset name list is empty, and the max
             #     size of the asset name list is 100 in one request.
@@ -1084,7 +1116,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if @parent_config&.respond_to? :rpcs
+                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
                   Rpcs.new parent_rpcs
                 end
               end

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

@@ -503,7 +503,7 @@ module Google
               def rpcs
                 @rpcs ||= begin
                   parent_rpcs = nil
-                  parent_rpcs = @parent_config.rpcs if @parent_config&.respond_to? :rpcs
+                  parent_rpcs = @parent_config.rpcs if defined?(@parent_config) && @parent_config&.respond_to?(:rpcs)
                   Rpcs.new parent_rpcs
                 end
               end

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

@@ -9,6 +9,7 @@ require 'google/api/field_behavior_pb'
 require 'google/api/resource_pb'
 require 'google/cloud/asset/v1/assets_pb'
 require 'google/longrunning/operations_pb'
+require 'google/protobuf/duration_pb'
 require 'google/protobuf/empty_pb'
 require 'google/protobuf/field_mask_pb'
 require 'google/protobuf/timestamp_pb'
@@ -87,6 +88,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       repeated :asset_types, :string, 3
       optional :content_type, :enum, 4, "google.cloud.asset.v1.ContentType"
       optional :feed_output_config, :message, 5, "google.cloud.asset.v1.FeedOutputConfig"
+      optional :condition, :message, 6, "google.type.Expr"
     end
     add_message "google.cloud.asset.v1.SearchAllResourcesRequest" do
       optional :scope, :string, 1

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

@@ -34,40 +34,46 @@ module Google
             self.service_name = 'google.cloud.asset.v1.AssetService'
 
             # Exports assets with time and resource types to a given Cloud Storage
-            # location. The output format is newline-delimited JSON.
-            # This API implements the
-            # [google.longrunning.Operation][google.longrunning.Operation] API allowing
-            # you to keep track of the export.
-            rpc :ExportAssets, ExportAssetsRequest, Google::Longrunning::Operation
+            # location/BigQuery table. For Cloud Storage location destinations, the
+            # output format is newline-delimited JSON. Each line represents a
+            # [google.cloud.asset.v1.Asset][google.cloud.asset.v1.Asset] in the JSON
+            # format; for BigQuery table destinations, the output table stores the fields
+            # in asset proto as columns. This API implements the
+            # [google.longrunning.Operation][google.longrunning.Operation] API , which
+            # allows you to keep track of the export. We recommend intervals of 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
             # Batch gets the update history of assets that overlap a time window.
-            # For RESOURCE content, this API outputs history with asset in both
-            # non-delete or deleted status.
             # 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.
+            # Otherwise, this API outputs history with asset in both non-delete or
+            # deleted status.
             # If a specified asset does not exist, this API returns an INVALID_ARGUMENT
             # error.
-            rpc :BatchGetAssetsHistory, BatchGetAssetsHistoryRequest, 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, CreateFeedRequest, Feed
+            rpc :CreateFeed, Google::Cloud::Asset::V1::CreateFeedRequest, Google::Cloud::Asset::V1::Feed
             # Gets details about an asset feed.
-            rpc :GetFeed, GetFeedRequest, 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, ListFeedsRequest, ListFeedsResponse
+            rpc :ListFeeds, Google::Cloud::Asset::V1::ListFeedsRequest, Google::Cloud::Asset::V1::ListFeedsResponse
             # Updates an asset feed configuration.
-            rpc :UpdateFeed, UpdateFeedRequest, Feed
+            rpc :UpdateFeed, Google::Cloud::Asset::V1::UpdateFeedRequest, Google::Cloud::Asset::V1::Feed
             # Deletes an asset feed.
-            rpc :DeleteFeed, DeleteFeedRequest, Google::Protobuf::Empty
+            rpc :DeleteFeed, Google::Cloud::Asset::V1::DeleteFeedRequest, Google::Protobuf::Empty
             # Searches all the resources within the given accessible scope (e.g., a
             # project, a folder or an organization). Callers should have
             # cloud.assets.SearchAllResources permission upon the requested scope,
             # otherwise the request will be rejected.
-            rpc :SearchAllResources, SearchAllResourcesRequest, SearchAllResourcesResponse
+            rpc :SearchAllResources, Google::Cloud::Asset::V1::SearchAllResourcesRequest, Google::Cloud::Asset::V1::SearchAllResourcesResponse
             # Searches all the IAM policies within the given accessible scope (e.g., a
             # project, a folder or an organization). Callers should have
             # cloud.assets.SearchAllIamPolicies permission upon the requested scope,
             # otherwise the request will be rejected.
-            rpc :SearchAllIamPolicies, SearchAllIamPoliciesRequest, 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/assets_pb.rb

@@ -13,18 +13,29 @@ require 'google/identity/accesscontextmanager/v1/service_perimeter_pb'
 require 'google/protobuf/any_pb'
 require 'google/protobuf/struct_pb'
 require 'google/protobuf/timestamp_pb'
+require 'google/rpc/code_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_file("google/cloud/asset/v1/assets.proto", :syntax => :proto3) do
     add_message "google.cloud.asset.v1.TemporalAsset" do
       optional :window, :message, 1, "google.cloud.asset.v1.TimeWindow"
       optional :deleted, :bool, 2
       optional :asset, :message, 3, "google.cloud.asset.v1.Asset"
+      optional :prior_asset_state, :enum, 4, "google.cloud.asset.v1.TemporalAsset.PriorAssetState"
+      optional :prior_asset, :message, 5, "google.cloud.asset.v1.Asset"
+    end
+    add_enum "google.cloud.asset.v1.TemporalAsset.PriorAssetState" do
+      value :PRIOR_ASSET_STATE_UNSPECIFIED, 0
+      value :PRESENT, 1
+      value :INVALID, 2
+      value :DOES_NOT_EXIST, 3
+      value :DELETED, 4
     end
     add_message "google.cloud.asset.v1.TimeWindow" do
       optional :start_time, :message, 1, "google.protobuf.Timestamp"
       optional :end_time, :message, 2, "google.protobuf.Timestamp"
     end
     add_message "google.cloud.asset.v1.Asset" do
+      optional :update_time, :message, 11, "google.protobuf.Timestamp"
       optional :name, :string, 1
       optional :asset_type, :string, 2
       optional :resource, :message, 3, "google.cloud.asset.v1.Resource"
@@ -77,6 +88,7 @@ module Google
     module Asset
       module V1
         TemporalAsset = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.TemporalAsset").msgclass
+        TemporalAsset::PriorAssetState = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.TemporalAsset.PriorAssetState").enummodule
         TimeWindow = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.TimeWindow").msgclass
         Asset = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.Asset").msgclass
         Resource = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.Resource").msgclass

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Asset
       module V1
-        VERSION = "0.4.1"
+        VERSION = "0.5.2"
       end
     end
   end

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

@@ -37,7 +37,7 @@ module Google
         #     running the same query may get different results.
         # @!attribute [rw] asset_types
         #   @return [::Array<::String>]
-        #     A list of asset types of which to take a snapshot for. For example:
+        #     A list of asset types of which to take a snapshot for. Example:
         #     "compute.googleapis.com/Disk". If specified, only matching assets will be
         #     returned. See [Introduction to Cloud Asset
         #     Inventory](https://cloud.google.com/asset-inventory/docs/overview)
@@ -49,7 +49,7 @@ module Google
         # @!attribute [rw] output_config
         #   @return [::Google::Cloud::Asset::V1::OutputConfig]
         #     Required. Output configuration indicating where the results will be output
-        #     to. All results will be in newline delimited JSON format.
+        #     to.
         class ExportAssetsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -66,7 +66,6 @@ module Google
         # @!attribute [rw] output_config
         #   @return [::Google::Cloud::Asset::V1::OutputConfig]
         #     Output configuration indicating where the results were output to.
-        #     All results are in JSON format.
         class ExportAssetsResponse
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -80,13 +79,11 @@ module Google
         #     "projects/my-project-id")", or a project number (such as "projects/12345").
         # @!attribute [rw] asset_names
         #   @return [::Array<::String>]
-        #     A list of the full names of the assets. For example:
+        #     A list of the full names of the assets.
+        #     See: https://cloud.google.com/asset-inventory/docs/resource-name-format
+        #     Example:
+        #
         #     `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
-        #     See [Resource
-        #     Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
-        #     and [Resource Name
-        #     Format](https://cloud.google.com/asset-inventory/docs/resource-name-format)
-        #     for more info.
         #
         #     The request becomes a no-op if the asset name list is empty, and the max
         #     size of the asset name list is 100 in one request.
@@ -205,9 +202,7 @@ module Google
         # @!attribute [rw] bigquery_destination
         #   @return [::Google::Cloud::Asset::V1::BigQueryDestination]
         #     Destination on BigQuery. The output table stores the fields in asset
-        #     proto as columns in BigQuery. The resource/iam_policy field is converted
-        #     to a record with each field to a column, except metadata to a single JSON
-        #     string.
+        #     proto as columns in BigQuery.
         class OutputConfig
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -217,16 +212,16 @@ module Google
         # @!attribute [rw] uri
         #   @return [::String]
         #     The uri of the Cloud Storage object. It's the same uri that is used by
-        #     gsutil. For example: "gs://bucket_name/object_name". See [Viewing and
+        #     gsutil. Example: "gs://bucket_name/object_name". See [Viewing and
         #     Editing Object
         #     Metadata](https://cloud.google.com/storage/docs/viewing-editing-metadata)
         #     for more information.
         # @!attribute [rw] uri_prefix
         #   @return [::String]
-        #     The uri prefix of all generated Cloud Storage objects. For example:
+        #     The uri prefix of all generated Cloud Storage objects. Example:
         #     "gs://bucket_name/object_name_prefix". Each object uri is in format:
         #     "gs://bucket_name/object_name_prefix/<asset type>/<shard number> and only
-        #     contains assets for that type. <shard number> starts from 0. For example:
+        #     contains assets for that type. <shard number> starts from 0. Example:
         #     "gs://bucket_name/object_name_prefix/compute.googleapis.com/Disk/0" is
         #     the first shard of output objects containing all
         #     compute.googleapis.com/Disk assets. An INVALID_ARGUMENT error will be
@@ -237,7 +232,7 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
-        # A BigQuery destination.
+        # A BigQuery destination for exporting assets to.
         # @!attribute [rw] dataset
         #   @return [::String]
         #     Required. The BigQuery dataset in format
@@ -264,7 +259,7 @@ module Google
         # @!attribute [rw] topic
         #   @return [::String]
         #     The name of the Pub/Sub topic to publish to.
-        #     For example: `projects/PROJECT_ID/topics/TOPIC_ID`.
+        #     Example: `projects/PROJECT_ID/topics/TOPIC_ID`.
         class PubsubDestination
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -297,8 +292,8 @@ module Google
         #   @return [::Array<::String>]
         #     A list of the full names of the assets to receive updates. You must specify
         #     either or both of asset_names and asset_types. Only asset updates matching
-        #     specified asset_names and asset_types are exported to the feed. For
-        #     example:
+        #     specified asset_names or asset_types are exported to the feed.
+        #     Example:
         #     `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
         #     See [Resource
         #     Names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
@@ -307,8 +302,8 @@ module Google
         #   @return [::Array<::String>]
         #     A list of types of the assets to receive updates. You must specify either
         #     or both of asset_names and asset_types. Only asset updates matching
-        #     specified asset_names and asset_types are exported to the feed.
-        #     For example: `"compute.googleapis.com/Disk"`
+        #     specified asset_names or asset_types are exported to the feed.
+        #     Example: `"compute.googleapis.com/Disk"`
         #
         #     See [this
         #     topic](https://cloud.google.com/asset-inventory/docs/supported-asset-types)
@@ -321,6 +316,16 @@ module Google
         #   @return [::Google::Cloud::Asset::V1::FeedOutputConfig]
         #     Required. Feed output configuration defining where the asset updates are
         #     published to.
+        # @!attribute [rw] condition
+        #   @return [::Google::Type::Expr]
+        #     A condition which determines whether an asset update should be published.
+        #     If specified, an asset will be returned only when the expression evaluates
+        #     to true.
+        #     When set, `expression` field in the `Expr` must be a valid [CEL expression]
+        #     (https://github.com/google/cel-spec) on a TemporalAsset with name
+        #     `temporal_asset`. Example: a Feed with expression ("temporal_asset.deleted
+        #     == true") will only publish Asset deletions. Other fields in `Expr` are
+        #     optional.
         class Feed
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods

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

@@ -32,12 +32,37 @@ module Google
         # @!attribute [rw] asset
         #   @return [::Google::Cloud::Asset::V1::Asset]
         #     An asset in Google Cloud.
+        # @!attribute [rw] prior_asset_state
+        #   @return [::Google::Cloud::Asset::V1::TemporalAsset::PriorAssetState]
+        #     State of prior_asset.
+        # @!attribute [rw] prior_asset
+        #   @return [::Google::Cloud::Asset::V1::Asset]
+        #     Prior copy of the asset. Populated if prior_asset_state is PRESENT.
+        #     Currently this is only set for responses in Real-Time Feed.
         class TemporalAsset
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
+
+          # State of prior asset.
+          module PriorAssetState
+            # prior_asset is not applicable for the current asset.
+            PRIOR_ASSET_STATE_UNSPECIFIED = 0
+
+            # prior_asset is populated correctly.
+            PRESENT = 1
+
+            # Failed to set prior_asset.
+            INVALID = 2
+
+            # Current asset is the first known state.
+            DOES_NOT_EXIST = 3
+
+            # prior_asset is a deletion.
+            DELETED = 4
+          end
         end
 
-        # A time window specified by its "start_time" and "end_time".
+        # A time window specified by its `start_time` and `end_time`.
         # @!attribute [rw] start_time
         #   @return [::Google::Protobuf::Timestamp]
         #     Start time of the time window (exclusive).
@@ -54,18 +79,25 @@ module Google
         # [resource
         # hierarchy](https://cloud.google.com/resource-manager/docs/cloud-platform-resource-hierarchy),
         # a resource outside the Google Cloud resource hierarchy (such as Google
-        # Kubernetes Engine clusters and objects), or a Cloud IAM policy.
+        # Kubernetes Engine clusters and objects), or a policy (e.g. Cloud IAM policy).
+        # See [Supported asset
+        # types](https://cloud.google.com/asset-inventory/docs/supported-asset-types)
+        # for more information.
+        # @!attribute [rw] update_time
+        #   @return [::Google::Protobuf::Timestamp]
+        #     The last update timestamp of an asset. update_time is updated when
+        #     create/update/delete operation is performed.
         # @!attribute [rw] name
         #   @return [::String]
-        #     The full name of the asset. For example:
-        #     "//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1"
+        #     The full name of the asset. Example:
+        #     `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`
         #
         #     See [Resource
         #     names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
         #     for more information.
         # @!attribute [rw] asset_type
         #   @return [::String]
-        #     The type of the asset. For example: "compute.googleapis.com/Disk"
+        #     The type of the asset. Example: `compute.googleapis.com/Disk`
         #
         #     See [Supported asset
         #     types](https://cloud.google.com/asset-inventory/docs/supported-asset-types)
@@ -92,10 +124,16 @@ module Google
         #     set on a given resource.
         # @!attribute [rw] access_policy
         #   @return [::Google::Identity::AccessContextManager::V1::AccessPolicy]
+        #     Please also refer to the [access policy user
+        #     guide](https://cloud.google.com/access-context-manager/docs/overview#access-policies).
         # @!attribute [rw] access_level
         #   @return [::Google::Identity::AccessContextManager::V1::AccessLevel]
+        #     Please also refer to the [access level user
+        #     guide](https://cloud.google.com/access-context-manager/docs/overview#access-levels).
         # @!attribute [rw] service_perimeter
         #   @return [::Google::Identity::AccessContextManager::V1::ServicePerimeter]
+        #     Please also refer to the [service perimeter user
+        #     guide](https://cloud.google.com/vpc-service-controls/docs/overview).
         # @!attribute [rw] ancestors
         #   @return [::Array<::String>]
         #     The ancestry path of an asset in Google Cloud [resource
@@ -105,7 +143,7 @@ module Google
         #     is a project, folder, or organization, the ancestry path starts from the
         #     asset itself.
         #
-        #     For example: `["projects/123456789", "folders/5432", "organizations/1234"]`
+        #     Example: `["projects/123456789", "folders/5432", "organizations/1234"]`
         class Asset
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -114,27 +152,27 @@ module Google
         # A representation of a Google Cloud resource.
         # @!attribute [rw] version
         #   @return [::String]
-        #     The API version. For example: "v1"
+        #     The API version. Example: `v1`
         # @!attribute [rw] discovery_document_uri
         #   @return [::String]
         #     The URL of the discovery document containing the resource's JSON schema.
-        #     For example:
-        #     "https://www.googleapis.com/discovery/v1/apis/compute/v1/rest"
+        #     Example:
+        #     `https://www.googleapis.com/discovery/v1/apis/compute/v1/rest`
         #
         #     This value is unspecified for resources that do not have an API based on a
         #     discovery document, such as Cloud Bigtable.
         # @!attribute [rw] discovery_name
         #   @return [::String]
-        #     The JSON schema name listed in the discovery document. For example:
-        #     "Project"
+        #     The JSON schema name listed in the discovery document. Example:
+        #     `Project`
         #
         #     This value is unspecified for resources that do not have an API based on a
         #     discovery document, such as Cloud Bigtable.
         # @!attribute [rw] resource_url
         #   @return [::String]
         #     The REST URL for accessing the resource. An HTTP `GET` request using this
-        #     URL returns the resource itself. For example:
-        #     "https://cloudresourcemanager.googleapis.com/v1/projects/my-project-123"
+        #     URL returns the resource itself. Example:
+        #     `https://cloudresourcemanager.googleapis.com/v1/projects/my-project-123`
         #
         #     This value is unspecified for resources without a REST API.
         # @!attribute [rw] parent
@@ -147,8 +185,8 @@ module Google
         #     For Google Cloud assets, this value is the parent resource defined in the
         #     [Cloud IAM policy
         #     hierarchy](https://cloud.google.com/iam/docs/overview#policy_hierarchy).
-        #     For example:
-        #     "//cloudresourcemanager.googleapis.com/projects/my_project_123"
+        #     Example:
+        #     `//cloudresourcemanager.googleapis.com/projects/my_project_123`
         #
         #     For third-party assets, this field may be set differently.
         # @!attribute [rw] data
@@ -168,7 +206,7 @@ module Google
         # @!attribute [rw] name
         #   @return [::String]
         #     The full resource name of this resource. Example:
-        #     "//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1".
+        #     `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
         #     See [Cloud Asset Inventory Resource Name
         #     Format](https://cloud.google.com/asset-inventory/docs/resource-name-format)
         #     for more information.
@@ -179,7 +217,7 @@ module Google
         #     * use a free text query. Example: `"instance1"`
         # @!attribute [rw] asset_type
         #   @return [::String]
-        #     The type of this resource. Example: "compute.googleapis.com/Disk".
+        #     The type of this resource. Example: `compute.googleapis.com/Disk`.
         #
         #     To search against the `asset_type`:
         #
@@ -211,8 +249,8 @@ module Google
         #     * use a free text query. Example: `"*important instance*"`
         # @!attribute [rw] location
         #   @return [::String]
-        #     Location can be "global", regional like "us-east1", or zonal like
-        #     "us-west1-b".
+        #     Location can be `global`, regional like `us-east1`, or zonal like
+        #     `us-west1-b`.
         #
         #     To search against the `location`:
         #
@@ -245,13 +283,13 @@ module Google
         # @!attribute [rw] additional_attributes
         #   @return [::Google::Protobuf::Struct]
         #     The additional attributes of this resource. The attributes may vary from
-        #     one resource type to another. Examples: "projectId" for Project,
-        #     "dnsName" for DNS ManagedZone.
+        #     one resource type to another. Examples: `projectId` for Project,
+        #     `dnsName` for DNS ManagedZone.
         #
         #     To search against the `additional_attributes`:
         #
         #     * use a free text query to match the attributes values. Example: to search
-        #       additional_attributes = { dnsName: "foobar" }, you can issue a query
+        #       `additional_attributes = { dnsName: "foobar" }`, you can issue a query
         #       `"foobar"`.
         class ResourceSearchResult
           include ::Google::Protobuf::MessageExts
@@ -272,7 +310,7 @@ module Google
         #   @return [::String]
         #     The full resource name of the resource associated with this IAM policy.
         #     Example:
-        #     "//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1".
+        #     `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`.
         #     See [Cloud Asset Inventory Resource Name
         #     Format](https://cloud.google.com/asset-inventory/docs/resource-name-format)
         #     for more information.
@@ -322,7 +360,7 @@ module Google
           #     permission query (i.e., a query containing `policy.role.permissions:`).
           #     Example: if query `policy.role.permissions : "compute.disk.get"`
           #     matches a policy binding that contains owner role, the
-          #     matched_permissions will be \\{"roles/owner": ["compute.disk.get"]}. The
+          #     matched_permissions will be `{"roles/owner": ["compute.disk.get"]}`. The
           #     roles can also be found in the returned `policy` bindings. Note that the
           #     map is populated only for requests with permission queries.
           class Explanation
@@ -332,7 +370,7 @@ module Google
             # IAM permissions
             # @!attribute [rw] permissions
             #   @return [::Array<::String>]
-            #     A list of permissions. A sample permission string: "compute.disk.get".
+            #     A list of permissions. A sample permission string: `compute.disk.get`.
             class Permissions
               include ::Google::Protobuf::MessageExts
               extend ::Google::Protobuf::MessageExts::ClassMethods

data/proto_docs/google/protobuf/duration.rb

@@ -0,0 +1,98 @@
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Protobuf
+    # A Duration represents a signed, fixed-length span of time represented
+    # as a count of seconds and fractions of seconds at nanosecond
+    # resolution. It is independent of any calendar and concepts like "day"
+    # or "month". It is related to Timestamp in that the difference between
+    # two Timestamp values is a Duration and it can be added or subtracted
+    # from a Timestamp. Range is approximately +-10,000 years.
+    #
+    # # Examples
+    #
+    # Example 1: Compute Duration from two Timestamps in pseudo code.
+    #
+    #     Timestamp start = ...;
+    #     Timestamp end = ...;
+    #     Duration duration = ...;
+    #
+    #     duration.seconds = end.seconds - start.seconds;
+    #     duration.nanos = end.nanos - start.nanos;
+    #
+    #     if (duration.seconds < 0 && duration.nanos > 0) {
+    #       duration.seconds += 1;
+    #       duration.nanos -= 1000000000;
+    #     } else if (duration.seconds > 0 && duration.nanos < 0) {
+    #       duration.seconds -= 1;
+    #       duration.nanos += 1000000000;
+    #     }
+    #
+    # Example 2: Compute Timestamp from Timestamp + Duration in pseudo code.
+    #
+    #     Timestamp start = ...;
+    #     Duration duration = ...;
+    #     Timestamp end = ...;
+    #
+    #     end.seconds = start.seconds + duration.seconds;
+    #     end.nanos = start.nanos + duration.nanos;
+    #
+    #     if (end.nanos < 0) {
+    #       end.seconds -= 1;
+    #       end.nanos += 1000000000;
+    #     } else if (end.nanos >= 1000000000) {
+    #       end.seconds += 1;
+    #       end.nanos -= 1000000000;
+    #     }
+    #
+    # Example 3: Compute Duration from datetime.timedelta in Python.
+    #
+    #     td = datetime.timedelta(days=3, minutes=10)
+    #     duration = Duration()
+    #     duration.FromTimedelta(td)
+    #
+    # # JSON Mapping
+    #
+    # In JSON format, the Duration type is encoded as a string rather than an
+    # object, where the string ends in the suffix "s" (indicating seconds) and
+    # is preceded by the number of seconds, with nanoseconds expressed as
+    # fractional seconds. For example, 3 seconds with 0 nanoseconds should be
+    # encoded in JSON format as "3s", while 3 seconds and 1 nanosecond should
+    # be expressed in JSON format as "3.000000001s", and 3 seconds and 1
+    # microsecond should be expressed in JSON format as "3.000001s".
+    # @!attribute [rw] seconds
+    #   @return [::Integer]
+    #     Signed seconds of the span of time. Must be from -315,576,000,000
+    #     to +315,576,000,000 inclusive. Note: these bounds are computed from:
+    #     60 sec/min * 60 min/hr * 24 hr/day * 365.25 days/year * 10000 years
+    # @!attribute [rw] nanos
+    #   @return [::Integer]
+    #     Signed fractions of a second at nanosecond resolution of the span
+    #     of time. Durations less than one second are represented with a 0
+    #     `seconds` field and a positive or negative `nanos` field. For durations
+    #     of one second or more, a non-zero value for the `nanos` field must be
+    #     of the same sign as the `seconds` field. Must be from -999,999,999
+    #     to +999,999,999 inclusive.
+    class Duration
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+  end
+end

data/proto_docs/google/rpc/code.rb

@@ -0,0 +1,185 @@
+# frozen_string_literal: true
+
+# Copyright 2020 Google LLC
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+# Auto-generated by gapic-generator-ruby. DO NOT EDIT!
+
+
+module Google
+  module Rpc
+    # The canonical error codes for gRPC APIs.
+    #
+    #
+    # Sometimes multiple error codes may apply.  Services should return
+    # the most specific error code that applies.  For example, prefer
+    # `OUT_OF_RANGE` over `FAILED_PRECONDITION` if both codes apply.
+    # Similarly prefer `NOT_FOUND` or `ALREADY_EXISTS` over `FAILED_PRECONDITION`.
+    module Code
+      # Not an error; returned on success
+      #
+      # HTTP Mapping: 200 OK
+      OK = 0
+
+      # The operation was cancelled, typically by the caller.
+      #
+      # HTTP Mapping: 499 Client Closed Request
+      CANCELLED = 1
+
+      # Unknown error.  For example, this error may be returned when
+      # a `Status` value received from another address space belongs to
+      # an error space that is not known in this address space.  Also
+      # errors raised by APIs that do not return enough error information
+      # may be converted to this error.
+      #
+      # HTTP Mapping: 500 Internal Server Error
+      UNKNOWN = 2
+
+      # The client specified an invalid argument.  Note that this differs
+      # from `FAILED_PRECONDITION`.  `INVALID_ARGUMENT` indicates arguments
+      # that are problematic regardless of the state of the system
+      # (e.g., a malformed file name).
+      #
+      # HTTP Mapping: 400 Bad Request
+      INVALID_ARGUMENT = 3
+
+      # The deadline expired before the operation could complete. For operations
+      # that change the state of the system, this error may be returned
+      # even if the operation has completed successfully.  For example, a
+      # successful response from a server could have been delayed long
+      # enough for the deadline to expire.
+      #
+      # HTTP Mapping: 504 Gateway Timeout
+      DEADLINE_EXCEEDED = 4
+
+      # Some requested entity (e.g., file or directory) was not found.
+      #
+      # Note to server developers: if a request is denied for an entire class
+      # of users, such as gradual feature rollout or undocumented whitelist,
+      # `NOT_FOUND` may be used. If a request is denied for some users within
+      # a class of users, such as user-based access control, `PERMISSION_DENIED`
+      # must be used.
+      #
+      # HTTP Mapping: 404 Not Found
+      NOT_FOUND = 5
+
+      # The entity that a client attempted to create (e.g., file or directory)
+      # already exists.
+      #
+      # HTTP Mapping: 409 Conflict
+      ALREADY_EXISTS = 6
+
+      # The caller does not have permission to execute the specified
+      # operation. `PERMISSION_DENIED` must not be used for rejections
+      # caused by exhausting some resource (use `RESOURCE_EXHAUSTED`
+      # instead for those errors). `PERMISSION_DENIED` must not be
+      # used if the caller can not be identified (use `UNAUTHENTICATED`
+      # instead for those errors). This error code does not imply the
+      # request is valid or the requested entity exists or satisfies
+      # other pre-conditions.
+      #
+      # HTTP Mapping: 403 Forbidden
+      PERMISSION_DENIED = 7
+
+      # The request does not have valid authentication credentials for the
+      # operation.
+      #
+      # HTTP Mapping: 401 Unauthorized
+      UNAUTHENTICATED = 16
+
+      # Some resource has been exhausted, perhaps a per-user quota, or
+      # perhaps the entire file system is out of space.
+      #
+      # HTTP Mapping: 429 Too Many Requests
+      RESOURCE_EXHAUSTED = 8
+
+      # The operation was rejected because the system is not in a state
+      # required for the operation's execution.  For example, the directory
+      # to be deleted is non-empty, an rmdir operation is applied to
+      # a non-directory, etc.
+      #
+      # Service implementors can use the following guidelines to decide
+      # between `FAILED_PRECONDITION`, `ABORTED`, and `UNAVAILABLE`:
+      #  (a) Use `UNAVAILABLE` if the client can retry just the failing call.
+      #  (b) Use `ABORTED` if the client should retry at a higher level
+      #      (e.g., when a client-specified test-and-set fails, indicating the
+      #      client should restart a read-modify-write sequence).
+      #  (c) Use `FAILED_PRECONDITION` if the client should not retry until
+      #      the system state has been explicitly fixed.  E.g., if an "rmdir"
+      #      fails because the directory is non-empty, `FAILED_PRECONDITION`
+      #      should be returned since the client should not retry unless
+      #      the files are deleted from the directory.
+      #
+      # HTTP Mapping: 400 Bad Request
+      FAILED_PRECONDITION = 9
+
+      # The operation was aborted, typically due to a concurrency issue such as
+      # a sequencer check failure or transaction abort.
+      #
+      # See the guidelines above for deciding between `FAILED_PRECONDITION`,
+      # `ABORTED`, and `UNAVAILABLE`.
+      #
+      # HTTP Mapping: 409 Conflict
+      ABORTED = 10
+
+      # The operation was attempted past the valid range.  E.g., seeking or
+      # reading past end-of-file.
+      #
+      # Unlike `INVALID_ARGUMENT`, this error indicates a problem that may
+      # be fixed if the system state changes. For example, a 32-bit file
+      # system will generate `INVALID_ARGUMENT` if asked to read at an
+      # offset that is not in the range [0,2^32-1], but it will generate
+      # `OUT_OF_RANGE` if asked to read from an offset past the current
+      # file size.
+      #
+      # There is a fair bit of overlap between `FAILED_PRECONDITION` and
+      # `OUT_OF_RANGE`.  We recommend using `OUT_OF_RANGE` (the more specific
+      # error) when it applies so that callers who are iterating through
+      # a space can easily look for an `OUT_OF_RANGE` error to detect when
+      # they are done.
+      #
+      # HTTP Mapping: 400 Bad Request
+      OUT_OF_RANGE = 11
+
+      # The operation is not implemented or is not supported/enabled in this
+      # service.
+      #
+      # HTTP Mapping: 501 Not Implemented
+      UNIMPLEMENTED = 12
+
+      # Internal errors.  This means that some invariants expected by the
+      # underlying system have been broken.  This error code is reserved
+      # for serious errors.
+      #
+      # HTTP Mapping: 500 Internal Server Error
+      INTERNAL = 13
+
+      # The service is currently unavailable.  This is most likely a
+      # transient condition, which can be corrected by retrying with
+      # a backoff. Note that it is not always safe to retry
+      # non-idempotent operations.
+      #
+      # See the guidelines above for deciding between `FAILED_PRECONDITION`,
+      # `ABORTED`, and `UNAVAILABLE`.
+      #
+      # HTTP Mapping: 503 Service Unavailable
+      UNAVAILABLE = 14
+
+      # Unrecoverable data loss or corruption.
+      #
+      # HTTP Mapping: 500 Internal Server Error
+      DATA_LOSS = 15
+    end
+  end
+end

data/proto_docs/google/rpc/status.rb

@@ -28,7 +28,7 @@ module Google
     # [API Design Guide](https://cloud.google.com/apis/design/errors).
     # @!attribute [rw] code
     #   @return [::Integer]
-    #     The status code, which should be an enum value of [google.rpc.Code][google.rpc.Code].
+    #     The status code, which should be an enum value of {::Google::Rpc::Code google.rpc.Code}.
     # @!attribute [rw] message
     #   @return [::String]
     #     A developer-facing error message, which should be in English. Any

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-asset-v1
 version: !ruby/object:Gem::Version
-  version: 0.4.1
+  version: 0.5.2
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-05-26 00:00:00.000000000 Z
+date: 2020-08-06 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -16,14 +16,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.2'
+        version: '0.3'
 - !ruby/object:Gem::Dependency
   name: google-cloud-errors
   requirement: !ruby/object:Gem::Requirement
@@ -211,10 +211,12 @@ files:
 - proto_docs/google/identity/accesscontextmanager/v1/service_perimeter.rb
 - proto_docs/google/longrunning/operations.rb
 - proto_docs/google/protobuf/any.rb
+- proto_docs/google/protobuf/duration.rb
 - proto_docs/google/protobuf/empty.rb
 - proto_docs/google/protobuf/field_mask.rb
 - proto_docs/google/protobuf/struct.rb
 - proto_docs/google/protobuf/timestamp.rb
+- proto_docs/google/rpc/code.rb
 - proto_docs/google/rpc/status.rb
 - proto_docs/google/type/expr.rb
 homepage: https://github.com/googleapis/google-cloud-ruby
@@ -236,7 +238,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.6
+rubygems_version: 3.1.3
 signing_key: 
 specification_version: 4
 summary: API Client library for the Cloud Asset V1 API