google-cloud-asset 0.5.2 → 0.6.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5a689a784987f7d4f4cc741ee9d1a396bb2c3bbbb14a7436a5f36ee5b2de6017
-  data.tar.gz: f5bebf6b421e022dafa870ac2eb9de5d18eda7552a9516c9ea92c3c15236d7f4
+  metadata.gz: 2bb0c0ca81e8a3f8d29eda8b5449d10743216c46491ae8c16e576e4e818e4974
+  data.tar.gz: 207ecd01a72c4dd44ce7701f4c5e37b97e38606c1aef635e328c3aa8d6d2f6fb
 SHA512:
-  metadata.gz: d1b4e77354e19012322fb52d18a9ef9d13d0e3ae4a97f88d643f32b777bff0f209c342aca4d4b3fd4cd4b6a5b07b32fcbf70b9e0cd57b7379b1d014f50932202
-  data.tar.gz: ea83b7cc3e02d3931c7d5e8fabf49be1486840fe655742571b51a326d02949315a82ab6ab6e52638c43bff904a53aa0499e25a0dfddf88e268e02b87aad42e15
+  metadata.gz: adf65e8955cda487fe03574b37b93e49f655d1e1fdb84164ade3b60796dd746d465c61abdbf8db0eddb7a89d3f0629df73de2a07937a64fef728aaf0b6764470
+  data.tar.gz: 2b25d32de17712e24f729295375255e9b81e300dc0a22511e3b2feb2b22e976a66511798dc2f3e466f5f63849eb4257562b6631ee4cde6f1b094f50a8905ec74

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

@@ -66,12 +66,29 @@ module Google
             self::GRPC_INTERCEPTORS = AssetServiceClient::GRPC_INTERCEPTORS
           end
 
+          FEED_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
+            "projects/{project}/feeds/{feed}"
+          )
+
+          private_constant :FEED_PATH_TEMPLATE
+
           PROJECT_PATH_TEMPLATE = Google::Gax::PathTemplate.new(
             "projects/{project}"
           )
 
           private_constant :PROJECT_PATH_TEMPLATE
 
+          # Returns a fully-qualified feed resource name string.
+          # @param project [String]
+          # @param feed [String]
+          # @return [String]
+          def self.feed_path project, feed
+            FEED_PATH_TEMPLATE.render(
+              :"project" => project,
+              :"feed" => feed
+            )
+          end
+
           # Returns a fully-qualified project resource name string.
           # @param project [String]
           # @return [String]
@@ -217,6 +234,46 @@ module Google
                 {'parent' => request.parent}
               end
             )
+            @create_feed = Google::Gax.create_api_call(
+              @asset_service_stub.method(:create_feed),
+              defaults["create_feed"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
+            )
+            @get_feed = Google::Gax.create_api_call(
+              @asset_service_stub.method(:get_feed),
+              defaults["get_feed"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
+            )
+            @list_feeds = Google::Gax.create_api_call(
+              @asset_service_stub.method(:list_feeds),
+              defaults["list_feeds"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'parent' => request.parent}
+              end
+            )
+            @update_feed = Google::Gax.create_api_call(
+              @asset_service_stub.method(:update_feed),
+              defaults["update_feed"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'feed.name' => request.feed.name}
+              end
+            )
+            @delete_feed = Google::Gax.create_api_call(
+              @asset_service_stub.method(:delete_feed),
+              defaults["delete_feed"],
+              exception_transformer: exception_transformer,
+              params_extractor: proc do |request|
+                {'name' => request.name}
+              end
+            )
           end
 
           # Service calls
@@ -395,6 +452,213 @@ module Google
             req = Google::Gax::to_proto(req, Google::Cloud::Asset::V1::BatchGetAssetsHistoryRequest)
             @batch_get_assets_history.call(req, options, &block)
           end
+
+          # Creates a feed in a parent project/folder/organization to listen to its
+          # asset updates.
+          #
+          # @param parent [String]
+          #   Required. The name of the project/folder/organization where this feed
+          #   should be created in. It can only be an organization number (such as
+          #   "organizations/123"), a folder number (such as "folders/123"), a project ID
+          #   (such as "projects/my-project-id")", or a project number (such as
+          #   "projects/12345").
+          # @param feed_id [String]
+          #   Required. This is the client-assigned asset feed identifier and it needs to
+          #   be unique under a specific parent project/folder/organization.
+          # @param feed [Google::Cloud::Asset::V1::Feed | Hash]
+          #   Required. The feed details. The field `name` must be empty and it will be generated
+          #   in the format of:
+          #   projects/project_number/feeds/feed_id
+          #   folders/folder_number/feeds/feed_id
+          #   organizations/organization_number/feeds/feed_id
+          #   A hash of the same form as `Google::Cloud::Asset::V1::Feed`
+          #   can also be provided.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::Asset::V1::Feed]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::Asset::V1::Feed]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/asset"
+          #
+          #   asset_client = Google::Cloud::Asset.new(version: :v1)
+          #
+          #   # TODO: Initialize `parent`:
+          #   parent = ''
+          #
+          #   # TODO: Initialize `feed_id`:
+          #   feed_id = ''
+          #
+          #   # TODO: Initialize `feed`:
+          #   feed = {}
+          #   response = asset_client.create_feed(parent, feed_id, feed)
+
+          def create_feed \
+              parent,
+              feed_id,
+              feed,
+              options: nil,
+              &block
+            req = {
+              parent: parent,
+              feed_id: feed_id,
+              feed: feed
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Cloud::Asset::V1::CreateFeedRequest)
+            @create_feed.call(req, options, &block)
+          end
+
+          # Gets details about an asset feed.
+          #
+          # @param name [String]
+          #   Required. The name of the Feed and it must be in the format of:
+          #   projects/project_number/feeds/feed_id
+          #   folders/folder_number/feeds/feed_id
+          #   organizations/organization_number/feeds/feed_id
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::Asset::V1::Feed]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::Asset::V1::Feed]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/asset"
+          #
+          #   asset_client = Google::Cloud::Asset.new(version: :v1)
+          #   formatted_name = Google::Cloud::Asset::V1::AssetServiceClient.feed_path("[PROJECT]", "[FEED]")
+          #   response = asset_client.get_feed(formatted_name)
+
+          def get_feed \
+              name,
+              options: nil,
+              &block
+            req = {
+              name: name
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Cloud::Asset::V1::GetFeedRequest)
+            @get_feed.call(req, options, &block)
+          end
+
+          # Lists all asset feeds in a parent project/folder/organization.
+          #
+          # @param parent [String]
+          #   Required. The parent project/folder/organization whose feeds are to be
+          #   listed. It can only be using project/folder/organization number (such as
+          #   "folders/12345")", or a project ID (such as "projects/my-project-id").
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::Asset::V1::ListFeedsResponse]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::Asset::V1::ListFeedsResponse]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/asset"
+          #
+          #   asset_client = Google::Cloud::Asset.new(version: :v1)
+          #
+          #   # TODO: Initialize `parent`:
+          #   parent = ''
+          #   response = asset_client.list_feeds(parent)
+
+          def list_feeds \
+              parent,
+              options: nil,
+              &block
+            req = {
+              parent: parent
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Cloud::Asset::V1::ListFeedsRequest)
+            @list_feeds.call(req, options, &block)
+          end
+
+          # Updates an asset feed configuration.
+          #
+          # @param feed [Google::Cloud::Asset::V1::Feed | Hash]
+          #   Required. The new values of feed details. It must match an existing feed and the
+          #   field `name` must be in the format of:
+          #   projects/project_number/feeds/feed_id or
+          #   folders/folder_number/feeds/feed_id or
+          #   organizations/organization_number/feeds/feed_id.
+          #   A hash of the same form as `Google::Cloud::Asset::V1::Feed`
+          #   can also be provided.
+          # @param update_mask [Google::Protobuf::FieldMask | Hash]
+          #   Required. Only updates the `feed` fields indicated by this mask.
+          #   The field mask must not be empty, and it must not contain fields that
+          #   are immutable or only set by the server.
+          #   A hash of the same form as `Google::Protobuf::FieldMask`
+          #   can also be provided.
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result [Google::Cloud::Asset::V1::Feed]
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @return [Google::Cloud::Asset::V1::Feed]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/asset"
+          #
+          #   asset_client = Google::Cloud::Asset.new(version: :v1)
+          #
+          #   # TODO: Initialize `feed`:
+          #   feed = {}
+          #
+          #   # TODO: Initialize `update_mask`:
+          #   update_mask = {}
+          #   response = asset_client.update_feed(feed, update_mask)
+
+          def update_feed \
+              feed,
+              update_mask,
+              options: nil,
+              &block
+            req = {
+              feed: feed,
+              update_mask: update_mask
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Cloud::Asset::V1::UpdateFeedRequest)
+            @update_feed.call(req, options, &block)
+          end
+
+          # Deletes an asset feed.
+          #
+          # @param name [String]
+          #   Required. The name of the feed and it must be in the format of:
+          #   projects/project_number/feeds/feed_id
+          #   folders/folder_number/feeds/feed_id
+          #   organizations/organization_number/feeds/feed_id
+          # @param options [Google::Gax::CallOptions]
+          #   Overrides the default settings for this call, e.g, timeout,
+          #   retries, etc.
+          # @yield [result, operation] Access the result along with the RPC operation
+          # @yieldparam result []
+          # @yieldparam operation [GRPC::ActiveCall::Operation]
+          # @raise [Google::Gax::GaxError] if the RPC is aborted.
+          # @example
+          #   require "google/cloud/asset"
+          #
+          #   asset_client = Google::Cloud::Asset.new(version: :v1)
+          #   formatted_name = Google::Cloud::Asset::V1::AssetServiceClient.feed_path("[PROJECT]", "[FEED]")
+          #   asset_client.delete_feed(formatted_name)
+
+          def delete_feed \
+              name,
+              options: nil,
+              &block
+            req = {
+              name: name
+            }.delete_if { |_, v| v.nil? }
+            req = Google::Gax::to_proto(req, Google::Cloud::Asset::V1::DeleteFeedRequest)
+            @delete_feed.call(req, options, &block)
+            nil
+          end
         end
       end
     end

data/lib/google/cloud/asset/v1/asset_service_client_config.json

@@ -29,6 +29,31 @@
           "timeout_millis": 600000,
           "retry_codes_name": "idempotent",
           "retry_params_name": "default"
+        },
+        "CreateFeed": {
+          "timeout_millis": 30000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        },
+        "GetFeed": {
+          "timeout_millis": 10000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "ListFeeds": {
+          "timeout_millis": 10000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
+        },
+        "UpdateFeed": {
+          "timeout_millis": 30000,
+          "retry_codes_name": "non_idempotent",
+          "retry_params_name": "default"
+        },
+        "DeleteFeed": {
+          "timeout_millis": 30000,
+          "retry_codes_name": "idempotent",
+          "retry_params_name": "default"
         }
       }
     }

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

@@ -34,6 +34,27 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.asset.v1.BatchGetAssetsHistoryResponse" do
     repeated :assets, :message, 1, "google.cloud.asset.v1.TemporalAsset"
   end
+  add_message "google.cloud.asset.v1.CreateFeedRequest" do
+    optional :parent, :string, 1
+    optional :feed_id, :string, 2
+    optional :feed, :message, 3, "google.cloud.asset.v1.Feed"
+  end
+  add_message "google.cloud.asset.v1.GetFeedRequest" do
+    optional :name, :string, 1
+  end
+  add_message "google.cloud.asset.v1.ListFeedsRequest" do
+    optional :parent, :string, 1
+  end
+  add_message "google.cloud.asset.v1.ListFeedsResponse" do
+    repeated :feeds, :message, 1, "google.cloud.asset.v1.Feed"
+  end
+  add_message "google.cloud.asset.v1.UpdateFeedRequest" do
+    optional :feed, :message, 1, "google.cloud.asset.v1.Feed"
+    optional :update_mask, :message, 2, "google.protobuf.FieldMask"
+  end
+  add_message "google.cloud.asset.v1.DeleteFeedRequest" do
+    optional :name, :string, 1
+  end
   add_message "google.cloud.asset.v1.OutputConfig" do
     oneof :destination do
       optional :gcs_destination, :message, 1, "google.cloud.asset.v1.GcsDestination"
@@ -51,6 +72,21 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :table, :string, 2
     optional :force, :bool, 3
   end
+  add_message "google.cloud.asset.v1.PubsubDestination" do
+    optional :topic, :string, 1
+  end
+  add_message "google.cloud.asset.v1.FeedOutputConfig" do
+    oneof :destination do
+      optional :pubsub_destination, :message, 1, "google.cloud.asset.v1.PubsubDestination"
+    end
+  end
+  add_message "google.cloud.asset.v1.Feed" do
+    optional :name, :string, 1
+    repeated :asset_names, :string, 2
+    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"
+  end
   add_enum "google.cloud.asset.v1.ContentType" do
     value :CONTENT_TYPE_UNSPECIFIED, 0
     value :RESOURCE, 1
@@ -68,9 +104,18 @@ module Google
         ExportAssetsResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.ExportAssetsResponse").msgclass
         BatchGetAssetsHistoryRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.BatchGetAssetsHistoryRequest").msgclass
         BatchGetAssetsHistoryResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.BatchGetAssetsHistoryResponse").msgclass
+        CreateFeedRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.CreateFeedRequest").msgclass
+        GetFeedRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.GetFeedRequest").msgclass
+        ListFeedsRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.ListFeedsRequest").msgclass
+        ListFeedsResponse = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.ListFeedsResponse").msgclass
+        UpdateFeedRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.UpdateFeedRequest").msgclass
+        DeleteFeedRequest = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.DeleteFeedRequest").msgclass
         OutputConfig = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.OutputConfig").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
+        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
         ContentType = Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.ContentType").enummodule
       end
     end

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

@@ -48,6 +48,17 @@ module Google
             # If a specified asset does not exist, this API returns an INVALID_ARGUMENT
             # error.
             rpc :BatchGetAssetsHistory, BatchGetAssetsHistoryRequest, BatchGetAssetsHistoryResponse
+            # Creates a feed in a parent project/folder/organization to listen to its
+            # asset updates.
+            rpc :CreateFeed, CreateFeedRequest, Feed
+            # Gets details about an asset feed.
+            rpc :GetFeed, GetFeedRequest, Feed
+            # Lists all asset feeds in a parent project/folder/organization.
+            rpc :ListFeeds, ListFeedsRequest, ListFeedsResponse
+            # Updates an asset feed configuration.
+            rpc :UpdateFeed, UpdateFeedRequest, Feed
+            # Deletes an asset feed.
+            rpc :DeleteFeed, DeleteFeedRequest, Google::Protobuf::Empty
           end
 
           Stub = Service.rpc_stub_class

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

@@ -4,12 +4,12 @@
 
 require 'google/protobuf'
 
-require 'google/api/annotations_pb'
 require 'google/api/resource_pb'
 require 'google/iam/v1/policy_pb'
 require 'google/protobuf/any_pb'
 require 'google/protobuf/struct_pb'
 require 'google/protobuf/timestamp_pb'
+require 'google/api/annotations_pb'
 Google::Protobuf::DescriptorPool.generated_pool.build do
   add_message "google.cloud.asset.v1.TemporalAsset" do
     optional :window, :message, 1, "google.cloud.asset.v1.TimeWindow"
@@ -25,6 +25,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
     optional :asset_type, :string, 2
     optional :resource, :message, 3, "google.cloud.asset.v1.Resource"
     optional :iam_policy, :message, 4, "google.iam.v1.Policy"
+    repeated :ancestors, :string, 10
   end
   add_message "google.cloud.asset.v1.Resource" do
     optional :version, :string, 1

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

@@ -97,6 +97,72 @@ module Google
         #     A list of assets with valid time windows.
         class BatchGetAssetsHistoryResponse; end
 
+        # Create asset feed request.
+        # @!attribute [rw] parent
+        #   @return [String]
+        #     Required. The name of the project/folder/organization where this feed
+        #     should be created in. It can only be an organization number (such as
+        #     "organizations/123"), a folder number (such as "folders/123"), a project ID
+        #     (such as "projects/my-project-id")", or a project number (such as
+        #     "projects/12345").
+        # @!attribute [rw] feed_id
+        #   @return [String]
+        #     Required. This is the client-assigned asset feed identifier and it needs to
+        #     be unique under a specific parent project/folder/organization.
+        # @!attribute [rw] feed
+        #   @return [Google::Cloud::Asset::V1::Feed]
+        #     Required. The feed details. The field `name` must be empty and it will be generated
+        #     in the format of:
+        #     projects/project_number/feeds/feed_id
+        #     folders/folder_number/feeds/feed_id
+        #     organizations/organization_number/feeds/feed_id
+        class CreateFeedRequest; end
+
+        # Get asset feed request.
+        # @!attribute [rw] name
+        #   @return [String]
+        #     Required. The name of the Feed and it must be in the format of:
+        #     projects/project_number/feeds/feed_id
+        #     folders/folder_number/feeds/feed_id
+        #     organizations/organization_number/feeds/feed_id
+        class GetFeedRequest; end
+
+        # List asset feeds request.
+        # @!attribute [rw] parent
+        #   @return [String]
+        #     Required. The parent project/folder/organization whose feeds are to be
+        #     listed. It can only be using project/folder/organization number (such as
+        #     "folders/12345")", or a project ID (such as "projects/my-project-id").
+        class ListFeedsRequest; end
+
+        # @!attribute [rw] feeds
+        #   @return [Array<Google::Cloud::Asset::V1::Feed>]
+        #     A list of feeds.
+        class ListFeedsResponse; end
+
+        # Update asset feed request.
+        # @!attribute [rw] feed
+        #   @return [Google::Cloud::Asset::V1::Feed]
+        #     Required. The new values of feed details. It must match an existing feed and the
+        #     field `name` must be in the format of:
+        #     projects/project_number/feeds/feed_id or
+        #     folders/folder_number/feeds/feed_id or
+        #     organizations/organization_number/feeds/feed_id.
+        # @!attribute [rw] update_mask
+        #   @return [Google::Protobuf::FieldMask]
+        #     Required. Only updates the `feed` fields indicated by this mask.
+        #     The field mask must not be empty, and it must not contain fields that
+        #     are immutable or only set by the server.
+        class UpdateFeedRequest; end
+
+        # @!attribute [rw] name
+        #   @return [String]
+        #     Required. The name of the feed and it must be in the format of:
+        #     projects/project_number/feeds/feed_id
+        #     folders/folder_number/feeds/feed_id
+        #     organizations/organization_number/feeds/feed_id
+        class DeleteFeedRequest; end
+
         # Output configuration for export assets destination.
         # @!attribute [rw] gcs_destination
         #   @return [Google::Cloud::Asset::V1::GcsDestination]
@@ -150,6 +216,62 @@ module Google
         #     returns an error.
         class BigQueryDestination; end
 
+        # A Cloud Pubsub destination.
+        # @!attribute [rw] topic
+        #   @return [String]
+        #     The name of the Cloud Pub/Sub topic to publish to.
+        #     For example: `projects/PROJECT_ID/topics/TOPIC_ID`.
+        class PubsubDestination; end
+
+        # Output configuration for asset feed destination.
+        # @!attribute [rw] pubsub_destination
+        #   @return [Google::Cloud::Asset::V1::PubsubDestination]
+        #     Destination on Cloud Pubsub.
+        class FeedOutputConfig; end
+
+        # An asset feed used to export asset updates to a destinations.
+        # An asset feed filter controls what updates are exported.
+        # The asset feed must be created within a project, organization, or
+        # folder. Supported destinations are:
+        # Cloud Pub/Sub topics.
+        # @!attribute [rw] name
+        #   @return [String]
+        #     Required. The format will be
+        #     projects/\\{project_number}/feeds/{client-assigned_feed_identifier} or
+        #     folders/\\{folder_number}/feeds/{client-assigned_feed_identifier} or
+        #     organizations/\\{organization_number}/feeds/{client-assigned_feed_identifier}
+        #
+        #     The client-assigned feed identifier must be unique within the parent
+        #     project/folder/organization.
+        # @!attribute [rw] asset_names
+        #   @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:
+        #     `//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 info.
+        # @!attribute [rw] asset_types
+        #   @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" See [Introduction to Cloud Asset
+        #     Inventory](https://cloud.google.com/resource-manager/docs/cloud-asset-inventory/overview)
+        #     for all supported asset types.
+        # @!attribute [rw] content_type
+        #   @return [Google::Cloud::Asset::V1::ContentType]
+        #     Asset content type. If not specified, no content but the asset name and
+        #     type will be returned.
+        # @!attribute [rw] feed_output_config
+        #   @return [Google::Cloud::Asset::V1::FeedOutputConfig]
+        #     Required. Feed output configuration defining where the asset updates are
+        #     published to.
+        class Feed; end
+
         # Asset content type.
         module ContentType
           # Unspecified content type.

data/lib/google/cloud/asset/v1/doc/google/cloud/asset/v1/assets.rb

@@ -59,6 +59,14 @@ module Google
         #   @return [Google::Iam::V1::Policy]
         #     Representation of the actual Cloud IAM policy set on a cloud resource. For
         #     each resource, there must be at most one Cloud IAM policy set on it.
+        # @!attribute [rw] ancestors
+        #   @return [Array<String>]
+        #     Asset's ancestry path in Cloud Resource Manager (CRM) hierarchy,
+        #     represented as a list of relative resource names. Ancestry path starts with
+        #     the closest CRM ancestor and ends at root. If the asset is a CRM
+        #     project/folder/organization, this starts from the asset itself.
+        #
+        #     Example: ["projects/123456789", "folders/5432", "organizations/1234"]
         class Asset; end
 
         # Representation of a cloud resource.

data/lib/google/cloud/asset/v1/doc/google/protobuf/empty.rb

@@ -0,0 +1,29 @@
+# Copyright 2019 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.
+
+
+module Google
+  module Protobuf
+    # A generic empty message that you can re-use to avoid defining duplicated
+    # empty messages in your APIs. A typical example is to use it as the request
+    # or the response type of an API method. For instance:
+    #
+    #     service Foo {
+    #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
+    #     }
+    #
+    # The JSON representation for `Empty` is empty JSON object `{}`.
+    class Empty; end
+  end
+end

data/lib/google/cloud/asset/v1/doc/google/protobuf/field_mask.rb

@@ -0,0 +1,222 @@
+# Copyright 2019 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.
+
+
+module Google
+  module Protobuf
+    # `FieldMask` represents a set of symbolic field paths, for example:
+    #
+    #     paths: "f.a"
+    #     paths: "f.b.d"
+    #
+    # Here `f` represents a field in some root message, `a` and `b`
+    # fields in the message found in `f`, and `d` a field found in the
+    # message in `f.b`.
+    #
+    # Field masks are used to specify a subset of fields that should be
+    # returned by a get operation or modified by an update operation.
+    # Field masks also have a custom JSON encoding (see below).
+    #
+    # = Field Masks in Projections
+    #
+    # When used in the context of a projection, a response message or
+    # sub-message is filtered by the API to only contain those fields as
+    # specified in the mask. For example, if the mask in the previous
+    # example is applied to a response message as follows:
+    #
+    #     f {
+    #       a : 22
+    #       b {
+    #         d : 1
+    #         x : 2
+    #       }
+    #       y : 13
+    #     }
+    #     z: 8
+    #
+    # The result will not contain specific values for fields x,y and z
+    # (their value will be set to the default, and omitted in proto text
+    # output):
+    #
+    #
+    #     f {
+    #       a : 22
+    #       b {
+    #         d : 1
+    #       }
+    #     }
+    #
+    # A repeated field is not allowed except at the last position of a
+    # paths string.
+    #
+    # If a FieldMask object is not present in a get operation, the
+    # operation applies to all fields (as if a FieldMask of all fields
+    # had been specified).
+    #
+    # Note that a field mask does not necessarily apply to the
+    # top-level response message. In case of a REST get operation, the
+    # field mask applies directly to the response, but in case of a REST
+    # list operation, the mask instead applies to each individual message
+    # in the returned resource list. In case of a REST custom method,
+    # other definitions may be used. Where the mask applies will be
+    # clearly documented together with its declaration in the API.  In
+    # any case, the effect on the returned resource/resources is required
+    # behavior for APIs.
+    #
+    # = Field Masks in Update Operations
+    #
+    # A field mask in update operations specifies which fields of the
+    # targeted resource are going to be updated. The API is required
+    # to only change the values of the fields as specified in the mask
+    # and leave the others untouched. If a resource is passed in to
+    # describe the updated values, the API ignores the values of all
+    # fields not covered by the mask.
+    #
+    # If a repeated field is specified for an update operation, new values will
+    # be appended to the existing repeated field in the target resource. Note that
+    # a repeated field is only allowed in the last position of a `paths` string.
+    #
+    # If a sub-message is specified in the last position of the field mask for an
+    # update operation, then new value will be merged into the existing sub-message
+    # in the target resource.
+    #
+    # For example, given the target message:
+    #
+    #     f {
+    #       b {
+    #         d: 1
+    #         x: 2
+    #       }
+    #       c: [1]
+    #     }
+    #
+    # And an update message:
+    #
+    #     f {
+    #       b {
+    #         d: 10
+    #       }
+    #       c: [2]
+    #     }
+    #
+    # then if the field mask is:
+    #
+    #  paths: ["f.b", "f.c"]
+    #
+    # then the result will be:
+    #
+    #     f {
+    #       b {
+    #         d: 10
+    #         x: 2
+    #       }
+    #       c: [1, 2]
+    #     }
+    #
+    # An implementation may provide options to override this default behavior for
+    # repeated and message fields.
+    #
+    # In order to reset a field's value to the default, the field must
+    # be in the mask and set to the default value in the provided resource.
+    # Hence, in order to reset all fields of a resource, provide a default
+    # instance of the resource and set all fields in the mask, or do
+    # not provide a mask as described below.
+    #
+    # If a field mask is not present on update, the operation applies to
+    # all fields (as if a field mask of all fields has been specified).
+    # Note that in the presence of schema evolution, this may mean that
+    # fields the client does not know and has therefore not filled into
+    # the request will be reset to their default. If this is unwanted
+    # behavior, a specific service may require a client to always specify
+    # a field mask, producing an error if not.
+    #
+    # As with get operations, the location of the resource which
+    # describes the updated values in the request message depends on the
+    # operation kind. In any case, the effect of the field mask is
+    # required to be honored by the API.
+    #
+    # == Considerations for HTTP REST
+    #
+    # The HTTP kind of an update operation which uses a field mask must
+    # be set to PATCH instead of PUT in order to satisfy HTTP semantics
+    # (PUT must only be used for full updates).
+    #
+    # = JSON Encoding of Field Masks
+    #
+    # In JSON, a field mask is encoded as a single string where paths are
+    # separated by a comma. Fields name in each path are converted
+    # to/from lower-camel naming conventions.
+    #
+    # As an example, consider the following message declarations:
+    #
+    #     message Profile {
+    #       User user = 1;
+    #       Photo photo = 2;
+    #     }
+    #     message User {
+    #       string display_name = 1;
+    #       string address = 2;
+    #     }
+    #
+    # In proto a field mask for `Profile` may look as such:
+    #
+    #     mask {
+    #       paths: "user.display_name"
+    #       paths: "photo"
+    #     }
+    #
+    # In JSON, the same mask is represented as below:
+    #
+    #     {
+    #       mask: "user.displayName,photo"
+    #     }
+    #
+    # = Field Masks and Oneof Fields
+    #
+    # Field masks treat fields in oneofs just as regular fields. Consider the
+    # following message:
+    #
+    #     message SampleMessage {
+    #       oneof test_oneof {
+    #         string name = 4;
+    #         SubMessage sub_message = 9;
+    #       }
+    #     }
+    #
+    # The field mask can be:
+    #
+    #     mask {
+    #       paths: "name"
+    #     }
+    #
+    # Or:
+    #
+    #     mask {
+    #       paths: "sub_message"
+    #     }
+    #
+    # Note that oneof type names ("test_oneof" in this case) cannot be used in
+    # paths.
+    #
+    # == Field Mask Verification
+    #
+    # The implementation of any API method which has a FieldMask type field in the
+    # request should verify the included field paths, and return an
+    # `INVALID_ARGUMENT` error if any path is duplicated or unmappable.
+    # @!attribute [rw] paths
+    #   @return [Array<String>]
+    #     The set of field mask paths.
+    class FieldMask; end
+  end
+end

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

@@ -18,6 +18,14 @@ module Google
       module V1
         class AssetServiceClient
 
+          # Alias for Google::Cloud::Asset::V1::AssetServiceClient.feed_path.
+          # @param project [String]
+          # @param feed [String]
+          # @return [String]
+          def feed_path project, feed
+            self.class.feed_path project, feed
+          end
+          
           # Alias for Google::Cloud::Asset::V1::AssetServiceClient.project_path.
           # @param project [String]
           # @return [String]

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

@@ -16,7 +16,7 @@
 module Google
   module Cloud
     module Asset
-      VERSION = "0.5.2".freeze
+      VERSION = "0.6.0".freeze
     end
   end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-asset
 version: !ruby/object:Gem::Version
-  version: 0.5.2
+  version: 0.6.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-11-20 00:00:00.000000000 Z
+date: 2019-12-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: google-gax
@@ -171,6 +171,8 @@ files:
 - lib/google/cloud/asset/v1/doc/google/iam/v1/policy.rb
 - lib/google/cloud/asset/v1/doc/google/longrunning/operations.rb
 - lib/google/cloud/asset/v1/doc/google/protobuf/any.rb
+- lib/google/cloud/asset/v1/doc/google/protobuf/empty.rb
+- lib/google/cloud/asset/v1/doc/google/protobuf/field_mask.rb
 - lib/google/cloud/asset/v1/doc/google/protobuf/struct.rb
 - lib/google/cloud/asset/v1/doc/google/protobuf/timestamp.rb
 - lib/google/cloud/asset/v1/doc/google/rpc/status.rb