feat: add kernel_rootkit field to finding's list of attributes (#413)

* feat: add kernel_rootkit field to finding's list of attributes
docs: miscellaneous style improvements

PiperOrigin-RevId: 493119809

Source-Link: googleapis/googleapis@6aff678

Source-Link: googleapis/googleapis-gen@ee52194
Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiZWU1MjE5NDBhMDE3ZjM5M2ZjZTc3MzFlNGMyMmE0M2FmZjZiMDAwZSJ9

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

Author: gcf-owl-bot[bot]

packages/google-cloud-securitycenter/google/cloud/securitycenter/__init__.py

@@ -46,6 +46,7 @@
 from google.cloud.securitycenter_v1.types.folder import Folder
 from google.cloud.securitycenter_v1.types.iam_binding import IamBinding
 from google.cloud.securitycenter_v1.types.indicator import Indicator
+from google.cloud.securitycenter_v1.types.kernel_rootkit import KernelRootkit
 from google.cloud.securitycenter_v1.types.kubernetes import Kubernetes
 from google.cloud.securitycenter_v1.types.label import Label
 from google.cloud.securitycenter_v1.types.mitre_attack import MitreAttack
@@ -138,6 +139,7 @@
     "Folder",
     "IamBinding",
     "Indicator",
+    "KernelRootkit",
     "Kubernetes",
     "Label",
     "MitreAttack",

packages/google-cloud-securitycenter/google/cloud/securitycenter_v1/__init__.py

@@ -34,6 +34,7 @@
 from .types.folder import Folder
 from .types.iam_binding import IamBinding
 from .types.indicator import Indicator
+from .types.kernel_rootkit import KernelRootkit
 from .types.kubernetes import Kubernetes
 from .types.label import Label
 from .types.mitre_attack import MitreAttack
@@ -136,6 +137,7 @@
     "GroupResult",
     "IamBinding",
     "Indicator",
+    "KernelRootkit",
     "Kubernetes",
     "Label",
     "ListAssetsRequest",

packages/google-cloud-securitycenter/google/cloud/securitycenter_v1/services/security_center/async_client.py

@@ -62,6 +62,7 @@
 from google.cloud.securitycenter_v1.types import (
     iam_binding,
     indicator,
+    kernel_rootkit,
     kubernetes,
     mitre_attack,
 )
@@ -871,9 +872,9 @@ async def sample_create_notification_config():
                 Required.
                 Unique identifier provided by the client
                 within the parent scope. It must be
-                between 1 and 128 characters, and
-                contains alphanumeric characters,
-                underscores or hyphens only.
+                between 1 and 128 characters and contain
+                alphanumeric characters, underscores, or
+                hyphens only.
 
                 This corresponds to the ``config_id`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1086,7 +1087,10 @@ async def sample_delete_notification_config():
             name (:class:`str`):
                 Required. Name of the notification config to delete. Its
                 format is
-                "organizations/[organization_id]/notificationConfigs/[config_id]".
+                "organizations/[organization_id]/notificationConfigs/[config_id]",
+                "folders/[folder_id]/notificationConfigs/[config_id]",
+                or
+                "projects/[project_id]/notificationConfigs/[config_id]".
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1147,7 +1151,7 @@ async def get_big_query_export(
         timeout: Optional[float] = None,
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> bigquery_export.BigQueryExport:
-        r"""Gets a big query export.
+        r"""Gets a BigQuery export.
 
         .. code-block:: python
 
@@ -1177,10 +1181,10 @@ async def sample_get_big_query_export():
 
         Args:
             request (Optional[Union[google.cloud.securitycenter_v1.types.GetBigQueryExportRequest, dict]]):
-                The request object. Request message for retrieving a big
-                query export.
+                The request object. Request message for retrieving a
+                BigQuery export.
             name (:class:`str`):
-                Required. Name of the big query export to retrieve. Its
+                Required. Name of the BigQuery export to retrieve. Its
                 format is
                 organizations/{organization}/bigQueryExports/{export_id},
                 folders/{folder}/bigQueryExports/{export_id}, or
@@ -1574,7 +1578,10 @@ async def sample_get_notification_config():
             name (:class:`str`):
                 Required. Name of the notification config to get. Its
                 format is
-                "organizations/[organization_id]/notificationConfigs/[config_id]".
+                "organizations/[organization_id]/notificationConfigs/[config_id]",
+                "folders/[folder_id]/notificationConfigs/[config_id]",
+                or
+                "projects/[project_id]/notificationConfigs/[config_id]".
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -2526,8 +2533,8 @@ async def sample_list_notification_configs():
                 The request object. Request message for listing
                 notification configs.
             parent (:class:`str`):
-                Required. Name of the organization to list notification
-                configs. Its format is
+                Required. The name of the parent in which to list the
+                notification configurations. Its format is
                 "organizations/[organization_id]",
                 "folders/[folder_id]", or "projects/[project_id]".
 
@@ -2909,11 +2916,12 @@ async def sample_set_finding_state():
                 The request object. Request message for updating a
                 finding's state.
             name (:class:`str`):
-                Required. The relative resource name of the finding.
-                See:
-                https://cloud.google.com/apis/design/resource_names#relative_resource_name
-                Example:
-                "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}".
+                Required. The `relative resource
+                name <https://cloud.google.com/apis/design/resource_names#relative_resource_name>`__
+                of the finding. Example:
+                "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}",
+                "folders/{folder_id}/sources/{source_id}/findings/{finding_id}",
+                "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -3041,10 +3049,9 @@ async def sample_set_mute():
                 The request object. Request message for updating a
                 finding's mute status.
             name (:class:`str`):
-                Required. The relative resource name of the finding.
-                See:
-                https://cloud.google.com/apis/design/resource_names#relative_resource_name
-                Example:
+                Required. The `relative resource
+                name <https://cloud.google.com/apis/design/resource_names#relative_resource_name>`__
+                of the finding. Example:
                 "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}",
                 "folders/{folder_id}/sources/{source_id}/findings/{finding_id}",
                 "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
@@ -4238,7 +4245,7 @@ async def create_big_query_export(
         timeout: Optional[float] = None,
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> bigquery_export.BigQueryExport:
-        r"""Creates a big query export.
+        r"""Creates a BigQuery export.
 
         .. code-block:: python
 
@@ -4269,18 +4276,19 @@ async def sample_create_big_query_export():
 
         Args:
             request (Optional[Union[google.cloud.securitycenter_v1.types.CreateBigQueryExportRequest, dict]]):
-                The request object. Request message for creating a big
-                query export.
+                The request object. Request message for creating a
+                BigQuery export.
             parent (:class:`str`):
-                Required. Resource name of the new big query export's
-                parent. Its format is "organizations/[organization_id]",
+                Required. The name of the parent resource of the new
+                BigQuery export. Its format is
+                "organizations/[organization_id]",
                 "folders/[folder_id]", or "projects/[project_id]".
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
             big_query_export (:class:`google.cloud.securitycenter_v1.types.BigQueryExport`):
-                Required. The big query export being
+                Required. The BigQuery export being
                 created.
 
                 This corresponds to the ``big_query_export`` field
@@ -4366,7 +4374,7 @@ async def delete_big_query_export(
         timeout: Optional[float] = None,
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> None:
-        r"""Deletes an existing big query export.
+        r"""Deletes an existing BigQuery export.
 
         .. code-block:: python
 
@@ -4393,10 +4401,10 @@ async def sample_delete_big_query_export():
 
         Args:
             request (Optional[Union[google.cloud.securitycenter_v1.types.DeleteBigQueryExportRequest, dict]]):
-                The request object. Request message for deleting a big
-                query export.
+                The request object. Request message for deleting a
+                BigQuery export.
             name (:class:`str`):
-                Required. Name of the big query export to delete. Its
+                Required. The name of the BigQuery export to delete. Its
                 format is
                 organizations/{organization}/bigQueryExports/{export_id},
                 folders/{folder}/bigQueryExports/{export_id}, or

packages/google-cloud-securitycenter/google/cloud/securitycenter_v1/services/security_center/client.py

@@ -66,6 +66,7 @@
 from google.cloud.securitycenter_v1.types import (
     iam_binding,
     indicator,
+    kernel_rootkit,
     kubernetes,
     mitre_attack,
 )
@@ -1244,9 +1245,9 @@ def sample_create_notification_config():
                 Required.
                 Unique identifier provided by the client
                 within the parent scope. It must be
-                between 1 and 128 characters, and
-                contains alphanumeric characters,
-                underscores or hyphens only.
+                between 1 and 128 characters and contain
+                alphanumeric characters, underscores, or
+                hyphens only.
 
                 This corresponds to the ``config_id`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1463,7 +1464,10 @@ def sample_delete_notification_config():
             name (str):
                 Required. Name of the notification config to delete. Its
                 format is
-                "organizations/[organization_id]/notificationConfigs/[config_id]".
+                "organizations/[organization_id]/notificationConfigs/[config_id]",
+                "folders/[folder_id]/notificationConfigs/[config_id]",
+                or
+                "projects/[project_id]/notificationConfigs/[config_id]".
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -1528,7 +1532,7 @@ def get_big_query_export(
         timeout: Optional[float] = None,
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> bigquery_export.BigQueryExport:
-        r"""Gets a big query export.
+        r"""Gets a BigQuery export.
 
         .. code-block:: python
 
@@ -1558,10 +1562,10 @@ def sample_get_big_query_export():
 
         Args:
             request (Union[google.cloud.securitycenter_v1.types.GetBigQueryExportRequest, dict]):
-                The request object. Request message for retrieving a big
-                query export.
+                The request object. Request message for retrieving a
+                BigQuery export.
             name (str):
-                Required. Name of the big query export to retrieve. Its
+                Required. Name of the BigQuery export to retrieve. Its
                 format is
                 organizations/{organization}/bigQueryExports/{export_id},
                 folders/{folder}/bigQueryExports/{export_id}, or
@@ -1942,7 +1946,10 @@ def sample_get_notification_config():
             name (str):
                 Required. Name of the notification config to get. Its
                 format is
-                "organizations/[organization_id]/notificationConfigs/[config_id]".
+                "organizations/[organization_id]/notificationConfigs/[config_id]",
+                "folders/[folder_id]/notificationConfigs/[config_id]",
+                or
+                "projects/[project_id]/notificationConfigs/[config_id]".
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -2831,8 +2838,8 @@ def sample_list_notification_configs():
                 The request object. Request message for listing
                 notification configs.
             parent (str):
-                Required. Name of the organization to list notification
-                configs. Its format is
+                Required. The name of the parent in which to list the
+                notification configurations. Its format is
                 "organizations/[organization_id]",
                 "folders/[folder_id]", or "projects/[project_id]".
 
@@ -3198,11 +3205,12 @@ def sample_set_finding_state():
                 The request object. Request message for updating a
                 finding's state.
             name (str):
-                Required. The relative resource name of the finding.
-                See:
-                https://cloud.google.com/apis/design/resource_names#relative_resource_name
-                Example:
-                "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}".
+                Required. The `relative resource
+                name <https://cloud.google.com/apis/design/resource_names#relative_resource_name>`__
+                of the finding. Example:
+                "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}",
+                "folders/{folder_id}/sources/{source_id}/findings/{finding_id}",
+                "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
 
                 This corresponds to the ``name`` field
                 on the ``request`` instance; if ``request`` is provided, this
@@ -3330,10 +3338,9 @@ def sample_set_mute():
                 The request object. Request message for updating a
                 finding's mute status.
             name (str):
-                Required. The relative resource name of the finding.
-                See:
-                https://cloud.google.com/apis/design/resource_names#relative_resource_name
-                Example:
+                Required. The `relative resource
+                name <https://cloud.google.com/apis/design/resource_names#relative_resource_name>`__
+                of the finding. Example:
                 "organizations/{organization_id}/sources/{source_id}/findings/{finding_id}",
                 "folders/{folder_id}/sources/{source_id}/findings/{finding_id}",
                 "projects/{project_id}/sources/{source_id}/findings/{finding_id}".
@@ -4520,7 +4527,7 @@ def create_big_query_export(
         timeout: Optional[float] = None,
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> bigquery_export.BigQueryExport:
-        r"""Creates a big query export.
+        r"""Creates a BigQuery export.
 
         .. code-block:: python
 
@@ -4551,18 +4558,19 @@ def sample_create_big_query_export():
 
         Args:
             request (Union[google.cloud.securitycenter_v1.types.CreateBigQueryExportRequest, dict]):
-                The request object. Request message for creating a big
-                query export.
+                The request object. Request message for creating a
+                BigQuery export.
             parent (str):
-                Required. Resource name of the new big query export's
-                parent. Its format is "organizations/[organization_id]",
+                Required. The name of the parent resource of the new
+                BigQuery export. Its format is
+                "organizations/[organization_id]",
                 "folders/[folder_id]", or "projects/[project_id]".
 
                 This corresponds to the ``parent`` field
                 on the ``request`` instance; if ``request`` is provided, this
                 should not be set.
             big_query_export (google.cloud.securitycenter_v1.types.BigQueryExport):
-                Required. The big query export being
+                Required. The BigQuery export being
                 created.
 
                 This corresponds to the ``big_query_export`` field
@@ -4648,7 +4656,7 @@ def delete_big_query_export(
         timeout: Optional[float] = None,
         metadata: Sequence[Tuple[str, str]] = (),
     ) -> None:
-        r"""Deletes an existing big query export.
+        r"""Deletes an existing BigQuery export.
 
         .. code-block:: python
 
@@ -4675,10 +4683,10 @@ def sample_delete_big_query_export():
 
         Args:
             request (Union[google.cloud.securitycenter_v1.types.DeleteBigQueryExportRequest, dict]):
-                The request object. Request message for deleting a big
-                query export.
+                The request object. Request message for deleting a
+                BigQuery export.
             name (str):
-                Required. Name of the big query export to delete. Its
+                Required. The name of the BigQuery export to delete. Its
                 format is
                 organizations/{organization}/bigQueryExports/{export_id},
                 folders/{folder}/bigQueryExports/{export_id}, or

packages/google-cloud-securitycenter/google/cloud/securitycenter_v1/services/security_center/transports/grpc.py

@@ -468,7 +468,7 @@ def get_big_query_export(
     ]:
         r"""Return a callable for the get big query export method over gRPC.
 
-        Gets a big query export.
+        Gets a BigQuery export.
 
         Returns:
             Callable[[~.GetBigQueryExportRequest],
@@ -1189,7 +1189,7 @@ def create_big_query_export(
     ]:
         r"""Return a callable for the create big query export method over gRPC.
 
-        Creates a big query export.
+        Creates a BigQuery export.
 
         Returns:
             Callable[[~.CreateBigQueryExportRequest],
@@ -1217,7 +1217,7 @@ def delete_big_query_export(
     ]:
         r"""Return a callable for the delete big query export method over gRPC.
 
-        Deletes an existing big query export.
+        Deletes an existing BigQuery export.
 
         Returns:
             Callable[[~.DeleteBigQueryExportRequest],