google-cloud-asset-v1 0.4.3 → 0.5.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f46ad7edc434252f8c8dee87bfba260b8aa24346e300cf6ab7d442e81c89c3e1
-  data.tar.gz: 56d5a1b6d03b3b5a8ec8448266abd000d76dc0e06245b6590a7f2739e32852f7
+  metadata.gz: 3dfb61d335222011eb319476e5f7ebc66d737ed5b5344b5db618247eeeb582c5
+  data.tar.gz: 14fd0db29853d3d81b4ce7093eab112ec73e59e8cf1a1a62113c4b897525c874
 SHA512:
-  metadata.gz: f12603eeb775698889082767fec48569b8a072e9029a42f9f4399e50148d9e322fb608fa2a13c8236980aae9249b63c011f7146aa7fa856a2a249a00bd435cf0
-  data.tar.gz: 433f992728d70ada4cce95693659300799287c9482be3d481ab9e9ea02fc8c712b0e4acc4a1be603272ae1a9c9634d5a1134204591e3644fb0249faf7e949b55
+  metadata.gz: 13b021e3db5800d776932c101235106596c33a2af3cee87ce69a1eaa384e34816439cebfb16b87fa0420028799d22ff291de97ea0e0fc9edb6ed576862e779e9
+  data.tar.gz: 45c5ff63879d978b1e7f44b9b3c2a88c3aa6aaf52be333abf5a8f09519a889617a05e9c0e3c9b01f230df0b46d2acb45ec0352fe980759077dba93071048d0bc

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

@@ -184,10 +184,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 +222,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 +232,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 +282,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 +309,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.

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,16 +34,22 @@ 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.
+            # 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, 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

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.3"
+        VERSION = "0.5.0"
       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,9 +32,34 @@ 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`.
@@ -54,10 +79,17 @@ 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:
+        #     The full name of the asset. Example:
         #     `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`
         #
         #     See [Resource
@@ -65,7 +97,7 @@ module Google
         #     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,18 +152,18 @@ 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:
+        #     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:
+        #     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
@@ -133,7 +171,7 @@ module Google
         # @!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:
+        #     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.
@@ -147,7 +185,7 @@ 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:
+        #     Example:
         #     `//cloudresourcemanager.googleapis.com/projects/my_project_123`
         #
         #     For third-party assets, this field may be set differently.

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.3
+  version: 0.5.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2020-06-06 00:00:00.000000000 Z
+date: 2020-06-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common
@@ -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