google-cloud-asset-v1 0.14.1 → 0.15.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d23289f05b8a078cd8c757cca3adc7016839554e57eaa015503d9fb588720c24
-  data.tar.gz: 34c663c90be473fcb2157705edd1690dd1d68790bbe3a5fe43400d68cc917522
+  metadata.gz: fe4cb183d47d24ad9e43d0e891edf702ca9fa3d1208f1d59ea304c3afa9ec580
+  data.tar.gz: 153470a82f027869dbf0a6efae2633c471ea63e873f07ee79265153bdb1a290b
 SHA512:
-  metadata.gz: 8f13a32a9dbc259de82f09a988f812334c9622f48ed44203a1939bd4d6052e2ce3a5b688680d143ba56d35c43bc1ffb2238f3ffc6e2c383e59110b6e7d42d332
-  data.tar.gz: afa78794e6c1e9f77e7d78915a74fcb6f7038c2a7c80d30c8171d3793fd176a1c1443ea080766f638e87dbb5335bc98bdc719eacf6af3f830189d503f8eb5b9c
+  metadata.gz: f3a92efbe9930cb0e62d26963e50baa9a7b1f0c33e82ea05103f1154485003bae40459ac9c96efb8c0c6ac02ae09661754e0cf0f271e4d9c83707857d2e68a01
+  data.tar.gz: e5be3acdae9470c8e543a9caeb544e8b3f63c22a7afc5d35bba90ac0f98331696a6e3451c9313e41e584ea254d72d53bc30c7341218482d24a9a90394359f0ec

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

@@ -226,7 +226,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload export_assets(parent: nil, read_time: nil, asset_types: nil, content_type: nil, output_config: nil)
+            # @overload export_assets(parent: nil, read_time: nil, asset_types: nil, content_type: nil, output_config: nil, relationship_types: nil)
             #   Pass arguments to `export_assets` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -266,6 +266,22 @@ module Google
             #     returned.
             #   @param output_config [::Google::Cloud::Asset::V1::OutputConfig, ::Hash]
             #     Required. Output configuration indicating where the results will be output to.
+            #   @param relationship_types [::Array<::String>]
+            #     A list of relationship types to export, for example:
+            #     `INSTANCE_TO_INSTANCEGROUP`. This field should only be specified if
+            #     content_type=RELATIONSHIP.
+            #     * If specified:
+            #     it snapshots specified relationships. It returns an error if
+            #     any of the [relationship_types] doesn't belong to the supported
+            #     relationship types of the [asset_types] or if any of the [asset_types]
+            #     doesn't belong to the source types of the [relationship_types].
+            #     * Otherwise:
+            #     it snapshots the supported relationships for all [asset_types] or returns
+            #     an error if any of the [asset_types] has no relationship support.
+            #     An unspecified asset types field means all supported asset_types.
+            #     See [Introduction to Cloud Asset
+            #     Inventory](https://cloud.google.com/asset-inventory/docs/overview) for all
+            #     supported asset types and relationship types.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::Operation]
@@ -329,7 +345,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload list_assets(parent: nil, read_time: nil, asset_types: nil, content_type: nil, page_size: nil, page_token: nil)
+            # @overload list_assets(parent: nil, read_time: nil, asset_types: nil, content_type: nil, page_size: nil, page_token: nil, relationship_types: nil)
             #   Pass arguments to `list_assets` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -374,6 +390,22 @@ module Google
             #     The `next_page_token` returned from the previous `ListAssetsResponse`, or
             #     unspecified for the first `ListAssetsRequest`. It is a continuation of a
             #     prior `ListAssets` call, and the API should return the next page of assets.
+            #   @param relationship_types [::Array<::String>]
+            #     A list of relationship types to output, for example:
+            #     `INSTANCE_TO_INSTANCEGROUP`. This field should only be specified if
+            #     content_type=RELATIONSHIP.
+            #     * If specified:
+            #     it snapshots specified relationships. It returns an error if
+            #     any of the [relationship_types] doesn't belong to the supported
+            #     relationship types of the [asset_types] or if any of the [asset_types]
+            #     doesn't belong to the source types of the [relationship_types].
+            #     * Otherwise:
+            #     it snapshots the supported relationships for all [asset_types] or returns
+            #     an error if any of the [asset_types] has no relationship support.
+            #     An unspecified asset types field means all supported asset_types.
+            #     See [Introduction to Cloud Asset
+            #     Inventory](https://cloud.google.com/asset-inventory/docs/overview)
+            #     for all supported asset types and relationship types.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::Asset::V1::Asset>]
@@ -442,7 +474,7 @@ module Google
             #   @param options [::Gapic::CallOptions, ::Hash]
             #     Overrides the default settings for this call, e.g, timeout, retries, etc. Optional.
             #
-            # @overload batch_get_assets_history(parent: nil, asset_names: nil, content_type: nil, read_time_window: nil)
+            # @overload batch_get_assets_history(parent: nil, asset_names: nil, content_type: nil, read_time_window: nil, relationship_types: nil)
             #   Pass arguments to `batch_get_assets_history` via keyword arguments. Note that at
             #   least one keyword argument is required. To specify no parameters, or to keep all
             #   the default parameter values, pass an empty Hash as a request object (see above).
@@ -469,6 +501,23 @@ module Google
             #     If start_time is not set, the snapshot of the assets at end_time will be
             #     returned. The returned results contain all temporal assets whose time
             #     window overlap with read_time_window.
+            #   @param relationship_types [::Array<::String>]
+            #     Optional. A list of relationship types to output, for example:
+            #     `INSTANCE_TO_INSTANCEGROUP`. This field should only be specified if
+            #     content_type=RELATIONSHIP.
+            #     * If specified:
+            #     it outputs specified relationships' history on the [asset_names]. It
+            #     returns an error if any of the [relationship_types] doesn't belong to the
+            #     supported relationship types of the [asset_names] or if any of the
+            #     [asset_names]'s types doesn't belong to the source types of the
+            #     [relationship_types].
+            #     * Otherwise:
+            #     it outputs the supported relationships' history on the [asset_names] or
+            #     returns an error if any of the [asset_names]'s types has no relationship
+            #     support.
+            #     See [Introduction to Cloud Asset
+            #     Inventory](https://cloud.google.com/asset-inventory/docs/overview) for all
+            #     supported asset types and relationship types.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::Asset::V1::BatchGetAssetsHistoryResponse]

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

@@ -27,6 +27,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       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"
+      repeated :relationship_types, :string, 6
     end
     add_message "google.cloud.asset.v1.ExportAssetsResponse" do
       optional :read_time, :message, 1, "google.protobuf.Timestamp"
@@ -40,6 +41,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :content_type, :enum, 4, "google.cloud.asset.v1.ContentType"
       optional :page_size, :int32, 5
       optional :page_token, :string, 6
+      repeated :relationship_types, :string, 7
     end
     add_message "google.cloud.asset.v1.ListAssetsResponse" do
       optional :read_time, :message, 1, "google.protobuf.Timestamp"
@@ -51,6 +53,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       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"
+      repeated :relationship_types, :string, 5
     end
     add_message "google.cloud.asset.v1.BatchGetAssetsHistoryResponse" do
       repeated :assets, :message, 1, "google.cloud.asset.v1.TemporalAsset"
@@ -126,6 +129,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       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"
+      repeated :relationship_types, :string, 7
     end
     add_message "google.cloud.asset.v1.SearchAllResourcesRequest" do
       optional :scope, :string, 1
@@ -257,6 +261,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       value :ORG_POLICY, 4
       value :ACCESS_POLICY, 5
       value :OS_INVENTORY, 6
+      value :RELATIONSHIP, 7
     end
   end
 end

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

@@ -10,9 +10,11 @@ require 'google/identity/accesscontextmanager/v1/access_level_pb'
 require 'google/identity/accesscontextmanager/v1/access_policy_pb'
 require 'google/cloud/osconfig/v1/inventory_pb'
 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'
+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
@@ -41,6 +43,7 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :iam_policy, :message, 4, "google.iam.v1.Policy"
       repeated :org_policy, :message, 6, "google.cloud.orgpolicy.v1.Policy"
       optional :os_inventory, :message, 12, "google.cloud.osconfig.v1.Inventory"
+      optional :related_assets, :message, 13, "google.cloud.asset.v1.RelatedAssets"
       repeated :ancestors, :string, 10
       oneof :access_context_policy do
         optional :access_policy, :message, 7, "google.identity.accesscontextmanager.v1.AccessPolicy"
@@ -57,6 +60,21 @@ Google::Protobuf::DescriptorPool.generated_pool.build do
       optional :data, :message, 6, "google.protobuf.Struct"
       optional :location, :string, 8
     end
+    add_message "google.cloud.asset.v1.RelatedAssets" do
+      optional :relationship_attributes, :message, 1, "google.cloud.asset.v1.RelationshipAttributes"
+      repeated :assets, :message, 2, "google.cloud.asset.v1.RelatedAsset"
+    end
+    add_message "google.cloud.asset.v1.RelationshipAttributes" do
+      optional :type, :string, 4
+      optional :source_resource_type, :string, 1
+      optional :target_resource_type, :string, 2
+      optional :action, :string, 3
+    end
+    add_message "google.cloud.asset.v1.RelatedAsset" do
+      optional :asset, :string, 1
+      optional :asset_type, :string, 2
+      repeated :ancestors, :string, 3
+    end
     add_message "google.cloud.asset.v1.ResourceSearchResult" do
       optional :name, :string, 1
       optional :asset_type, :string, 2
@@ -162,6 +180,9 @@ module Google
         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
+        RelatedAssets = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.RelatedAssets").msgclass
+        RelationshipAttributes = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.RelationshipAttributes").msgclass
+        RelatedAsset = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.RelatedAsset").msgclass
         ResourceSearchResult = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.ResourceSearchResult").msgclass
         VersionedResource = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.VersionedResource").msgclass
         AttachedResource = ::Google::Protobuf::DescriptorPool.generated_pool.lookup("google.cloud.asset.v1.AttachedResource").msgclass

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

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module Asset
       module V1
-        VERSION = "0.14.1"
+        VERSION = "0.15.0"
       end
     end
   end

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

@@ -25,7 +25,7 @@ module Google
         # AnalyzeIamPolicyLongrunning rpc.
         # @!attribute [r] create_time
         #   @return [::Google::Protobuf::Timestamp]
-        #     The time the operation was created.
+        #     Output only. The time the operation was created.
         class AnalyzeIamPolicyLongrunningMetadata
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -72,6 +72,23 @@ module Google
         # @!attribute [rw] output_config
         #   @return [::Google::Cloud::Asset::V1::OutputConfig]
         #     Required. Output configuration indicating where the results will be output to.
+        # @!attribute [rw] relationship_types
+        #   @return [::Array<::String>]
+        #     A list of relationship types to export, for example:
+        #     `INSTANCE_TO_INSTANCEGROUP`. This field should only be specified if
+        #     content_type=RELATIONSHIP.
+        #     * If specified:
+        #     it snapshots specified relationships. It returns an error if
+        #     any of the [relationship_types] doesn't belong to the supported
+        #     relationship types of the [asset_types] or if any of the [asset_types]
+        #     doesn't belong to the source types of the [relationship_types].
+        #     * Otherwise:
+        #     it snapshots the supported relationships for all [asset_types] or returns
+        #     an error if any of the [asset_types] has no relationship support.
+        #     An unspecified asset types field means all supported asset_types.
+        #     See [Introduction to Cloud Asset
+        #     Inventory](https://cloud.google.com/asset-inventory/docs/overview) for all
+        #     supported asset types and relationship types.
         class ExportAssetsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -145,6 +162,23 @@ module Google
         #     The `next_page_token` returned from the previous `ListAssetsResponse`, or
         #     unspecified for the first `ListAssetsRequest`. It is a continuation of a
         #     prior `ListAssets` call, and the API should return the next page of assets.
+        # @!attribute [rw] relationship_types
+        #   @return [::Array<::String>]
+        #     A list of relationship types to output, for example:
+        #     `INSTANCE_TO_INSTANCEGROUP`. This field should only be specified if
+        #     content_type=RELATIONSHIP.
+        #     * If specified:
+        #     it snapshots specified relationships. It returns an error if
+        #     any of the [relationship_types] doesn't belong to the supported
+        #     relationship types of the [asset_types] or if any of the [asset_types]
+        #     doesn't belong to the source types of the [relationship_types].
+        #     * Otherwise:
+        #     it snapshots the supported relationships for all [asset_types] or returns
+        #     an error if any of the [asset_types] has no relationship support.
+        #     An unspecified asset types field means all supported asset_types.
+        #     See [Introduction to Cloud Asset
+        #     Inventory](https://cloud.google.com/asset-inventory/docs/overview)
+        #     for all supported asset types and relationship types.
         class ListAssetsRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -194,6 +228,24 @@ module Google
         #     If start_time is not set, the snapshot of the assets at end_time will be
         #     returned. The returned results contain all temporal assets whose time
         #     window overlap with read_time_window.
+        # @!attribute [rw] relationship_types
+        #   @return [::Array<::String>]
+        #     Optional. A list of relationship types to output, for example:
+        #     `INSTANCE_TO_INSTANCEGROUP`. This field should only be specified if
+        #     content_type=RELATIONSHIP.
+        #     * If specified:
+        #     it outputs specified relationships' history on the [asset_names]. It
+        #     returns an error if any of the [relationship_types] doesn't belong to the
+        #     supported relationship types of the [asset_names] or if any of the
+        #     [asset_names]'s types doesn't belong to the source types of the
+        #     [relationship_types].
+        #     * Otherwise:
+        #     it outputs the supported relationships' history on the [asset_names] or
+        #     returns an error if any of the [asset_names]'s types has no relationship
+        #     support.
+        #     See [Introduction to Cloud Asset
+        #     Inventory](https://cloud.google.com/asset-inventory/docs/overview) for all
+        #     supported asset types and relationship types.
         class BatchGetAssetsHistoryRequest
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -530,6 +582,24 @@ module Google
         #     See our [user
         #     guide](https://cloud.google.com/asset-inventory/docs/monitoring-asset-changes-with-condition)
         #     for detailed instructions.
+        # @!attribute [rw] relationship_types
+        #   @return [::Array<::String>]
+        #     A list of relationship types to output, for example:
+        #     `INSTANCE_TO_INSTANCEGROUP`. This field should only be specified if
+        #     content_type=RELATIONSHIP.
+        #     * If specified:
+        #     it outputs specified relationship updates on the [asset_names] or the
+        #     [asset_types]. It returns an error if any of the [relationship_types]
+        #     doesn't belong to the supported relationship types of the [asset_names] or
+        #     [asset_types], or any of the [asset_names] or the [asset_types] doesn't
+        #     belong to the source types of the [relationship_types].
+        #     * Otherwise:
+        #     it outputs the supported relationships of the types of [asset_names] and
+        #     [asset_types] or returns an error if any of the [asset_names] or the
+        #     [asset_types] has no replationship support.
+        #     See [Introduction to Cloud Asset
+        #     Inventory](https://cloud.google.com/asset-inventory/docs/overview)
+        #     for all supported asset types and relationship types.
         class Feed
           include ::Google::Protobuf::MessageExts
           extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -1263,6 +1333,9 @@ module Google
 
           # The runtime OS Inventory information.
           OS_INVENTORY = 6
+
+          # The related resources.
+          RELATIONSHIP = 7
         end
       end
     end

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

@@ -140,6 +140,10 @@ module Google
         #     A representation of runtime OS Inventory information. See [this
         #     topic](https://cloud.google.com/compute/docs/instances/os-inventory-management)
         #     for more information.
+        # @!attribute [rw] related_assets
+        #   @return [::Google::Cloud::Asset::V1::RelatedAssets]
+        #     The related assets of the asset of one relationship type.
+        #     One asset only represents one type of relationship.
         # @!attribute [rw] ancestors
         #   @return [::Array<::String>]
         #     The ancestry path of an asset in Google Cloud [resource
@@ -208,6 +212,74 @@ module Google
           extend ::Google::Protobuf::MessageExts::ClassMethods
         end
 
+        # The detailed related assets with the `relationship_type`.
+        # @!attribute [rw] relationship_attributes
+        #   @return [::Google::Cloud::Asset::V1::RelationshipAttributes]
+        #     The detailed relationship attributes.
+        # @!attribute [rw] assets
+        #   @return [::Array<::Google::Cloud::Asset::V1::RelatedAsset>]
+        #     The peer resources of the relationship.
+        class RelatedAssets
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # The relationship attributes which include  `type`, `source_resource_type`,
+        # `target_resource_type` and `action`.
+        # @!attribute [rw] type
+        #   @return [::String]
+        #     The unique identifier of the relationship type. Example:
+        #     `INSTANCE_TO_INSTANCEGROUP`
+        # @!attribute [rw] source_resource_type
+        #   @return [::String]
+        #     The source asset type. Example: `compute.googleapis.com/Instance`
+        # @!attribute [rw] target_resource_type
+        #   @return [::String]
+        #     The target asset type. Example: `compute.googleapis.com/Disk`
+        # @!attribute [rw] action
+        #   @return [::String]
+        #     The detail of the relationship, e.g. `contains`, `attaches`
+        class RelationshipAttributes
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
+        # An asset identify in Google Cloud which contains its name, type and
+        # ancestors. An asset can be any resource in the Google Cloud [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 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] asset
+        #   @return [::String]
+        #     The full name of the asset. Example:
+        #     `//compute.googleapis.com/projects/my_project_123/zones/zone1/instances/instance1`
+        #
+        #     See [Resource
+        #     names](https://cloud.google.com/apis/design/resource_names#full_resource_name)
+        #     for more information.
+        # @!attribute [rw] asset_type
+        #   @return [::String]
+        #     The type of the asset. Example: `compute.googleapis.com/Disk`
+        #
+        #     See [Supported asset
+        #     types](https://cloud.google.com/asset-inventory/docs/supported-asset-types)
+        #     for more information.
+        # @!attribute [rw] ancestors
+        #   @return [::Array<::String>]
+        #     The ancestors of an asset in Google Cloud [resource
+        #     hierarchy](https://cloud.google.com/resource-manager/docs/cloud-platform-resource-hierarchy),
+        #     represented as a list of relative resource names. An ancestry path starts
+        #     with the closest ancestor in the hierarchy and ends at root.
+        #
+        #     Example: `["projects/123456789", "folders/5432", "organizations/1234"]`
+        class RelatedAsset
+          include ::Google::Protobuf::MessageExts
+          extend ::Google::Protobuf::MessageExts::ClassMethods
+        end
+
         # A result of Resource Search, containing information of a cloud resource.
         # @!attribute [rw] name
         #   @return [::String]

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: google-cloud-asset-v1
 version: !ruby/object:Gem::Version
-  version: 0.14.1
+  version: 0.15.0
 platform: ruby
 authors:
 - Google LLC
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-08-11 00:00:00.000000000 Z
+date: 2021-08-19 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: gapic-common