google-cloud-asset-v1 0.1.0

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

@@ -0,0 +1,85 @@
+# 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 Cloud
+    module Asset
+      module V1
+        module AssetService
+          # Path helper methods for the AssetService API.
+          module Paths
+            ##
+            # Create a fully-qualified Feed resource string.
+            #
+            # @overload feed_path(project:, feed:)
+            #   The resource will be in the following format:
+            #
+            #   `projects/{project}/feeds/{feed}`
+            #
+            #   @param project [String]
+            #   @param feed [String]
+            #
+            # @overload feed_path(folder:, feed:)
+            #   The resource will be in the following format:
+            #
+            #   `folders/{folder}/feeds/{feed}`
+            #
+            #   @param folder [String]
+            #   @param feed [String]
+            #
+            # @overload feed_path(organization:, feed:)
+            #   The resource will be in the following format:
+            #
+            #   `organizations/{organization}/feeds/{feed}`
+            #
+            #   @param organization [String]
+            #   @param feed [String]
+            #
+            # @return [String]
+            def feed_path **args
+              resources = {
+                "feed:project"      => (proc do |project:, feed:|
+                  raise ArgumentError, "project cannot contain /" if project.to_s.include? "/"
+
+                  "projects/#{project}/feeds/#{feed}"
+                end),
+                "feed:folder"       => (proc do |folder:, feed:|
+                  raise ArgumentError, "folder cannot contain /" if folder.to_s.include? "/"
+
+                  "folders/#{folder}/feeds/#{feed}"
+                end),
+                "feed:organization" => (proc do |organization:, feed:|
+                  raise ArgumentError, "organization cannot contain /" if organization.to_s.include? "/"
+
+                  "organizations/#{organization}/feeds/#{feed}"
+                end)
+              }
+
+              resource = resources[args.keys.sort.join(":")]
+              raise ArgumentError, "no resource found for values #{args.keys}" if resource.nil?
+              resource.call(**args)
+            end
+
+            extend self
+          end
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,124 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/asset/v1/asset_service.proto
+
+require 'google/protobuf'
+
+require 'google/api/annotations_pb'
+require 'google/api/client_pb'
+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/empty_pb'
+require 'google/protobuf/field_mask_pb'
+require 'google/protobuf/timestamp_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/asset/v1/asset_service.proto", :syntax => :proto3) do
+    add_message "google.cloud.asset.v1.ExportAssetsRequest" do
+      optional :parent, :string, 1
+      optional :read_time, :message, 2, "google.protobuf.Timestamp"
+      repeated :asset_types, :string, 3
+      optional :content_type, :enum, 4, "google.cloud.asset.v1.ContentType"
+      optional :output_config, :message, 5, "google.cloud.asset.v1.OutputConfig"
+    end
+    add_message "google.cloud.asset.v1.ExportAssetsResponse" do
+      optional :read_time, :message, 1, "google.protobuf.Timestamp"
+      optional :output_config, :message, 2, "google.cloud.asset.v1.OutputConfig"
+    end
+    add_message "google.cloud.asset.v1.BatchGetAssetsHistoryRequest" do
+      optional :parent, :string, 1
+      repeated :asset_names, :string, 2
+      optional :content_type, :enum, 3, "google.cloud.asset.v1.ContentType"
+      optional :read_time_window, :message, 4, "google.cloud.asset.v1.TimeWindow"
+    end
+    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"
+        optional :bigquery_destination, :message, 2, "google.cloud.asset.v1.BigQueryDestination"
+      end
+    end
+    add_message "google.cloud.asset.v1.GcsDestination" do
+      oneof :object_uri do
+        optional :uri, :string, 1
+        optional :uri_prefix, :string, 2
+      end
+    end
+    add_message "google.cloud.asset.v1.BigQueryDestination" do
+      optional :dataset, :string, 1
+      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
+      value :IAM_POLICY, 2
+      value :ORG_POLICY, 4
+      value :ACCESS_POLICY, 5
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Asset
+      module V1
+        ExportAssetsRequest = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.ExportAssetsRequest").msgclass
+        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
+  end
+end

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

@@ -0,0 +1,68 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# Source: google/cloud/asset/v1/asset_service.proto for package 'google.cloud.asset.v1'
+# Original file comments:
+# 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
+#
+#     http://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.
+#
+#
+
+require 'grpc'
+require 'google/cloud/asset/v1/asset_service_pb'
+
+module Google
+  module Cloud
+    module Asset
+      module V1
+        module AssetService
+          # Asset service definition.
+          class Service
+
+            include GRPC::GenericService
+
+            self.marshal_class_method = :encode
+            self.unmarshal_class_method = :decode
+            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
+            # 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.
+            # 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
+        end
+      end
+    end
+  end
+end

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

@@ -0,0 +1,52 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/asset/v1/assets.proto
+
+require 'google/protobuf'
+
+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_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"
+    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 :name, :string, 1
+      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
+      optional :discovery_document_uri, :string, 2
+      optional :discovery_name, :string, 3
+      optional :resource_url, :string, 4
+      optional :parent, :string, 5
+      optional :data, :message, 6, "google.protobuf.Struct"
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module Asset
+      module V1
+        TemporalAsset = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.TemporalAsset").msgclass
+        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
+      end
+    end
+  end
+end

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

@@ -0,0 +1,28 @@
+# 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 Cloud
+    module Asset
+      module V1
+        VERSION = "0.1.0"
+      end
+    end
+  end
+end

data/lib/google/cloud/common_resources_pb.rb

@@ -0,0 +1,15 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/common_resources.proto
+
+require 'google/protobuf'
+
+require 'google/api/resource_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/common_resources.proto", :syntax => :proto3) do
+  end
+end
+
+module Google
+  module Cloud
+  end
+end

data/lib/google/cloud/orgpolicy/v1/orgpolicy_pb.rb

@@ -0,0 +1,54 @@
+# Generated by the protocol buffer compiler.  DO NOT EDIT!
+# source: google/cloud/orgpolicy/v1/orgpolicy.proto
+
+require 'google/protobuf'
+
+require 'google/protobuf/empty_pb'
+require 'google/protobuf/timestamp_pb'
+require 'google/api/annotations_pb'
+Google::Protobuf::DescriptorPool.generated_pool.build do
+  add_file("google/cloud/orgpolicy/v1/orgpolicy.proto", :syntax => :proto3) do
+    add_message "google.cloud.orgpolicy.v1.Policy" do
+      optional :version, :int32, 1
+      optional :constraint, :string, 2
+      optional :etag, :bytes, 3
+      optional :update_time, :message, 4, "google.protobuf.Timestamp"
+      oneof :policy_type do
+        optional :list_policy, :message, 5, "google.cloud.orgpolicy.v1.Policy.ListPolicy"
+        optional :boolean_policy, :message, 6, "google.cloud.orgpolicy.v1.Policy.BooleanPolicy"
+        optional :restore_default, :message, 7, "google.cloud.orgpolicy.v1.Policy.RestoreDefault"
+      end
+    end
+    add_message "google.cloud.orgpolicy.v1.Policy.ListPolicy" do
+      repeated :allowed_values, :string, 1
+      repeated :denied_values, :string, 2
+      optional :all_values, :enum, 3, "google.cloud.orgpolicy.v1.Policy.ListPolicy.AllValues"
+      optional :suggested_value, :string, 4
+      optional :inherit_from_parent, :bool, 5
+    end
+    add_enum "google.cloud.orgpolicy.v1.Policy.ListPolicy.AllValues" do
+      value :ALL_VALUES_UNSPECIFIED, 0
+      value :ALLOW, 1
+      value :DENY, 2
+    end
+    add_message "google.cloud.orgpolicy.v1.Policy.BooleanPolicy" do
+      optional :enforced, :bool, 1
+    end
+    add_message "google.cloud.orgpolicy.v1.Policy.RestoreDefault" do
+    end
+  end
+end
+
+module Google
+  module Cloud
+    module OrgPolicy
+      module V1
+        Policy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.orgpolicy.v1.Policy").msgclass
+        Policy::ListPolicy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.orgpolicy.v1.Policy.ListPolicy").msgclass
+        Policy::ListPolicy::AllValues = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.orgpolicy.v1.Policy.ListPolicy.AllValues").enummodule
+        Policy::BooleanPolicy = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.orgpolicy.v1.Policy.BooleanPolicy").msgclass
+        Policy::RestoreDefault = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.orgpolicy.v1.Policy.RestoreDefault").msgclass
+      end
+    end
+  end
+end

data/proto_docs/README.md

@@ -0,0 +1,4 @@
+# Cloud Asset V1 Protocol Buffer Documentation
+
+These files are for the YARD documentation of the generated protobuf files.
+They are not intended to be required or loaded at runtime.

data/proto_docs/google/api/field_behavior.rb

@@ -0,0 +1,59 @@
+# 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 Api
+    # An indicator of the behavior of a given field (for example, that a field
+    # is required in requests, or given as output but ignored as input).
+    # This **does not** change the behavior in protocol buffers itself; it only
+    # denotes the behavior and may affect how API tooling handles the field.
+    #
+    # Note: This enum **may** receive new values in the future.
+    module FieldBehavior
+      # Conventional default for enums. Do not use this.
+      FIELD_BEHAVIOR_UNSPECIFIED = 0
+
+      # Specifically denotes a field as optional.
+      # While all fields in protocol buffers are optional, this may be specified
+      # for emphasis if appropriate.
+      OPTIONAL = 1
+
+      # Denotes a field as required.
+      # This indicates that the field **must** be provided as part of the request,
+      # and failure to do so will cause an error (usually `INVALID_ARGUMENT`).
+      REQUIRED = 2
+
+      # Denotes a field as output only.
+      # This indicates that the field is provided in responses, but including the
+      # field in a request does nothing (the server *must* ignore it and
+      # *must not* throw an error as a result of the field's presence).
+      OUTPUT_ONLY = 3
+
+      # Denotes a field as input only.
+      # This indicates that the field is provided in requests, and the
+      # corresponding field is not included in output.
+      INPUT_ONLY = 4
+
+      # Denotes a field as immutable.
+      # This indicates that the field may be set once in a request to create a
+      # resource, but may not be changed thereafter.
+      IMMUTABLE = 5
+    end
+  end
+end