feat(v1): add relationships

google/cloud/asset/__init__.py

@@ -69,6 +69,8 @@
 from google.cloud.asset_v1.types.assets import IamPolicySearchResult
 from google.cloud.asset_v1.types.assets import RelatedAsset
 from google.cloud.asset_v1.types.assets import RelatedAssets
+from google.cloud.asset_v1.types.assets import RelatedResource
+from google.cloud.asset_v1.types.assets import RelatedResources
 from google.cloud.asset_v1.types.assets import RelationshipAttributes
 from google.cloud.asset_v1.types.assets import Resource
 from google.cloud.asset_v1.types.assets import ResourceSearchResult
@@ -125,6 +127,8 @@
     "IamPolicySearchResult",
     "RelatedAsset",
     "RelatedAssets",
+    "RelatedResource",
+    "RelatedResources",
     "RelationshipAttributes",
     "Resource",
     "ResourceSearchResult",

google/cloud/asset_v1/__init__.py

@@ -63,6 +63,8 @@
 from .types.assets import IamPolicySearchResult
 from .types.assets import RelatedAsset
 from .types.assets import RelatedAssets
+from .types.assets import RelatedResource
+from .types.assets import RelatedResources
 from .types.assets import RelationshipAttributes
 from .types.assets import Resource
 from .types.assets import ResourceSearchResult
@@ -114,6 +116,8 @@
     "PubsubDestination",
     "RelatedAsset",
     "RelatedAssets",
+    "RelatedResource",
+    "RelatedResources",
     "RelationshipAttributes",
     "Resource",
     "ResourceSearchResult",

google/cloud/asset_v1/types/__init__.py

@@ -62,6 +62,8 @@
     IamPolicySearchResult,
     RelatedAsset,
     RelatedAssets,
+    RelatedResource,
+    RelatedResources,
     RelationshipAttributes,
     Resource,
     ResourceSearchResult,
@@ -117,6 +119,8 @@
     "IamPolicySearchResult",
     "RelatedAsset",
     "RelatedAssets",
+    "RelatedResource",
+    "RelatedResources",
     "RelationshipAttributes",
     "Resource",
     "ResourceSearchResult",

google/cloud/asset_v1/types/assets.py

@@ -39,6 +39,8 @@
         "ResourceSearchResult",
         "VersionedResource",
         "AttachedResource",
+        "RelatedResources",
+        "RelatedResource",
         "IamPolicySearchResult",
         "IamPolicyAnalysisState",
         "ConditionEvaluation",
@@ -575,6 +577,13 @@ class ResourceSearchResult(proto.Message):
             attributes of the attached resources are exposed in
             ``additional_attributes`` field, so as to allow users to
             search on them.
+        relationships (Sequence[google.cloud.asset_v1.types.ResourceSearchResult.RelationshipsEntry]):
+            A map of related resources of this resource, keyed by the
+            relationship type. A relationship type is in the format of
+            {SourceType}*{ACTION}*\ {DestType}. Example:
+            ``DISK_TO_INSTANCE``, ``DISK_TO_NETWORK``,
+            ``INSTANCE_TO_INSTANCEGROUP``. See `supported relationship
+            types <https://cloud.google.com/asset-inventory/docs/supported-asset-types#supported_relationship_types>`__.
         parent_asset_type (str):
             The type of this resource's immediate parent, if there is
             one.
@@ -615,6 +624,9 @@ class ResourceSearchResult(proto.Message):
     attached_resources = proto.RepeatedField(
         proto.MESSAGE, number=20, message="AttachedResource",
     )
+    relationships = proto.MapField(
+        proto.STRING, proto.MESSAGE, number=21, message="RelatedResources",
+    )
     parent_asset_type = proto.Field(proto.STRING, number=103,)
 
 
@@ -676,6 +688,34 @@ class AttachedResource(proto.Message):
     )
 
 
+class RelatedResources(proto.Message):
+    r"""The related resources of the primary resource.
+    Attributes:
+        related_resources (Sequence[google.cloud.asset_v1.types.RelatedResource]):
+            The detailed related resources of the primary
+            resource.
+    """
+
+    related_resources = proto.RepeatedField(
+        proto.MESSAGE, number=1, message="RelatedResource",
+    )
+
+
+class RelatedResource(proto.Message):
+    r"""The detailed related resource.
+    Attributes:
+        asset_type (str):
+            The type of the asset. Example:
+            ``compute.googleapis.com/Instance``
+        full_resource_name (str):
+            The full resource name of the related resource. Example:
+            ``//compute.googleapis.com/projects/my_proj_123/zones/instance/instance123``
+    """
+
+    asset_type = proto.Field(proto.STRING, number=1,)
+    full_resource_name = proto.Field(proto.STRING, number=2,)
+
+
 class IamPolicySearchResult(proto.Message):
     r"""A result of IAM Policy search, containing information of an
     IAM policy.