feat: [google-cloud-securitycenter] Add Notebook field to finding's list of attributes (googleapis#12523)

gcf-owl-bot[bot] · web-flow · commit ec1301ef5759 · 2024-03-28T06:22:13.000-04:00
- [ ] Regenerate this pull request now. PiperOrigin-RevId: 619663717 Source-Link: googleapis/googleapis@038629f Source-Link: https://github.com/googleapis/googleapis-gen/commit/90ac380358c55e6d6521d4779128316994263e0d Copy-Tag: eyJwIjoicGFja2FnZXMvZ29vZ2xlLWNsb3VkLXNlY3VyaXR5Y2VudGVyLy5Pd2xCb3QueWFtbCIsImgiOiI5MGFjMzgwMzU4YzU1ZTZkNjUyMWQ0Nzc5MTI4MzE2OTk0MjYzZTBkIn0= --------- Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>
diff --git a/packages/google-cloud-securitycenter/google/cloud/securitycenter/__init__.py b/packages/google-cloud-securitycenter/google/cloud/securitycenter/__init__.py
@@ -64,6 +64,7 @@
 from google.cloud.securitycenter_v1.types.log_entry import CloudLoggingEntry, LogEntry
 from google.cloud.securitycenter_v1.types.mitre_attack import MitreAttack
 from google.cloud.securitycenter_v1.types.mute_config import MuteConfig
+from google.cloud.securitycenter_v1.types.notebook import Notebook
 from google.cloud.securitycenter_v1.types.notification_config import NotificationConfig
 from google.cloud.securitycenter_v1.types.notification_message import (
     NotificationMessage,
@@ -188,6 +189,7 @@
     "LogEntry",
     "MitreAttack",
     "MuteConfig",
+    "Notebook",
     "NotificationConfig",
     "NotificationMessage",
     "OrgPolicy",
diff --git a/packages/google-cloud-securitycenter/google/cloud/securitycenter_v1/__init__.py b/packages/google-cloud-securitycenter/google/cloud/securitycenter_v1/__init__.py
@@ -48,6 +48,7 @@
 from .types.log_entry import CloudLoggingEntry, LogEntry
 from .types.mitre_attack import MitreAttack
 from .types.mute_config import MuteConfig
+from .types.notebook import Notebook
 from .types.notification_config import NotificationConfig
 from .types.notification_message import NotificationMessage
 from .types.org_policy import OrgPolicy
@@ -208,6 +209,7 @@
     "LogEntry",
     "MitreAttack",
     "MuteConfig",
+    "Notebook",
     "NotificationConfig",
     "NotificationMessage",
     "OrgPolicy",
diff --git a/packages/google-cloud-securitycenter/google/cloud/securitycenter_v1/services/security_center/async_client.py b/packages/google-cloud-securitycenter/google/cloud/securitycenter_v1/services/security_center/async_client.py
@@ -102,6 +102,7 @@
 from google.cloud.securitycenter_v1.types import finding as gcs_finding
 from google.cloud.securitycenter_v1.types import mute_config
 from google.cloud.securitycenter_v1.types import mute_config as gcs_mute_config
+from google.cloud.securitycenter_v1.types import notebook
 from google.cloud.securitycenter_v1.types import notification_config
 from google.cloud.securitycenter_v1.types import org_policy
 from google.cloud.securitycenter_v1.types import organization_settings
diff --git a/packages/google-cloud-securitycenter/google/cloud/securitycenter_v1/services/security_center/client.py b/packages/google-cloud-securitycenter/google/cloud/securitycenter_v1/services/security_center/client.py
@@ -106,6 +106,7 @@
 from google.cloud.securitycenter_v1.types import finding as gcs_finding
 from google.cloud.securitycenter_v1.types import mute_config
 from google.cloud.securitycenter_v1.types import mute_config as gcs_mute_config
+from google.cloud.securitycenter_v1.types import notebook
 from google.cloud.securitycenter_v1.types import notification_config
 from google.cloud.securitycenter_v1.types import org_policy
 from google.cloud.securitycenter_v1.types import organization_settings
diff --git a/packages/google-cloud-securitycenter/google/cloud/securitycenter_v1/types/__init__.py b/packages/google-cloud-securitycenter/google/cloud/securitycenter_v1/types/__init__.py
@@ -42,6 +42,7 @@
 from .log_entry import CloudLoggingEntry, LogEntry
 from .mitre_attack import MitreAttack
 from .mute_config import MuteConfig
+from .notebook import Notebook
 from .notification_config import NotificationConfig
 from .notification_message import NotificationMessage
 from .org_policy import OrgPolicy
@@ -154,6 +155,7 @@
     "LogEntry",
     "MitreAttack",
     "MuteConfig",
+    "Notebook",
     "NotificationConfig",
     "NotificationMessage",
     "OrgPolicy",
diff --git a/packages/google-cloud-securitycenter/google/cloud/securitycenter_v1/types/finding.py b/packages/google-cloud-securitycenter/google/cloud/securitycenter_v1/types/finding.py
@@ -51,6 +51,7 @@
 from google.cloud.securitycenter_v1.types import indicator as gcs_indicator
 from google.cloud.securitycenter_v1.types import kubernetes as gcs_kubernetes
 from google.cloud.securitycenter_v1.types import load_balancer, log_entry
+from google.cloud.securitycenter_v1.types import notebook as gcs_notebook
 from google.cloud.securitycenter_v1.types import org_policy, process
 
 __protobuf__ = proto.module(
@@ -262,6 +263,8 @@ class Finding(proto.Message):
         load_balancers (MutableSequence[google.cloud.securitycenter_v1.types.LoadBalancer]):
             The load balancers associated with the
             finding.
+        notebook (google.cloud.securitycenter_v1.types.Notebook):
+            Notebook associated with the finding.
     """
 
     class State(proto.Enum):
@@ -640,6 +643,11 @@ class FindingClass(proto.Enum):
         number=58,
         message=load_balancer.LoadBalancer,
     )
+    notebook: gcs_notebook.Notebook = proto.Field(
+        proto.MESSAGE,
+        number=63,
+        message=gcs_notebook.Notebook,
+    )
 
 
 __all__ = tuple(sorted(__protobuf__.manifest))
diff --git a/packages/google-cloud-securitycenter/google/cloud/securitycenter_v1/types/notebook.py b/packages/google-cloud-securitycenter/google/cloud/securitycenter_v1/types/notebook.py
@@ -0,0 +1,70 @@
+# -*- coding: utf-8 -*-
+# Copyright 2024 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.
+#
+from __future__ import annotations
+
+from typing import MutableMapping, MutableSequence
+
+from google.protobuf import timestamp_pb2  # type: ignore
+import proto  # type: ignore
+
+__protobuf__ = proto.module(
+    package="google.cloud.securitycenter.v1",
+    manifest={
+        "Notebook",
+    },
+)
+
+
+class Notebook(proto.Message):
+    r"""Represents a Jupyter notebook IPYNB file, such as a `Colab
+    Enterprise
+    notebook <https://cloud.google.com/colab/docs/introduction>`__ file,
+    that is associated with a finding.
+
+    Attributes:
+        name (str):
+            The name of the notebook.
+        service (str):
+            The source notebook service, for example,
+            "Colab Enterprise".
+        last_author (str):
+            The user ID of the latest author to modify
+            the notebook.
+        notebook_update_time (google.protobuf.timestamp_pb2.Timestamp):
+            The most recent time the notebook was
+            updated.
+    """
+
+    name: str = proto.Field(
+        proto.STRING,
+        number=1,
+    )
+    service: str = proto.Field(
+        proto.STRING,
+        number=2,
+    )
+    last_author: str = proto.Field(
+        proto.STRING,
+        number=3,
+    )
+    notebook_update_time: timestamp_pb2.Timestamp = proto.Field(
+        proto.MESSAGE,
+        number=4,
+        message=timestamp_pb2.Timestamp,
+    )
+
+
+__all__ = tuple(sorted(__protobuf__.manifest))
diff --git a/packages/google-cloud-securitycenter/tests/unit/gapic/securitycenter_v1/test_security_center.py b/packages/google-cloud-securitycenter/tests/unit/gapic/securitycenter_v1/test_security_center.py
@@ -119,6 +119,7 @@
 from google.cloud.securitycenter_v1.types import finding as gcs_finding
 from google.cloud.securitycenter_v1.types import mute_config
 from google.cloud.securitycenter_v1.types import mute_config as gcs_mute_config
+from google.cloud.securitycenter_v1.types import notebook
 from google.cloud.securitycenter_v1.types import notification_config
 from google.cloud.securitycenter_v1.types import org_policy
 from google.cloud.securitycenter_v1.types import organization_settings
@@ -19024,6 +19025,12 @@ def test_create_finding_rest(request_type):
             }
         ],
         "load_balancers": [{"name": "name_value"}],
+        "notebook": {
+            "name": "name_value",
+            "service": "service_value",
+            "last_author": "last_author_value",
+            "notebook_update_time": {},
+        },
     }
     # The version of a generated dependency at test runtime may differ from the version used during generation.
     # Delete any fields which are not present in the current runtime dependency
@@ -29017,6 +29024,12 @@ def test_update_finding_rest(request_type):
             }
         ],
         "load_balancers": [{"name": "name_value"}],
+        "notebook": {
+            "name": "name_value",
+            "service": "service_value",
+            "last_author": "last_author_value",
+            "notebook_update_time": {},
+        },
     }
     # The version of a generated dependency at test runtime may differ from the version used during generation.
     # Delete any fields which are not present in the current runtime dependency
