Skip to content

docs: [google-cloud-securitycentermanagement] updates on multiple comments, syncing terminology and clarifying some aspects #12151

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
parthea merged 3 commits into from
Jan 5, 2024
Merged

docs: [google-cloud-securitycentermanagement] updates on multiple comments, syncing terminology and clarifying some aspects #12151

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
cfde6bd
docs: updates on multiple comments, syncing terminology and clarifyin…
gcf-owl-bot[bot] Jan 5, 2024
c6723ca
🦉 Updates from OwlBot post-processor
gcf-owl-bot[bot] Jan 5, 2024
9d1e513
revert
parthea Jan 5, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion ...gle-cloud-securitycentermanagement/google/cloud/securitycentermanagement/gapic_version.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,4 +13,4 @@
# See the License for the specific language governing permissions and
# limitations under the License.
#
__version__ = "0.1.1" # {x-release-please-version}
__version__ = "0.0.0" # {x-release-please-version}
2 changes: 1 addition & 1 deletion ...-cloud-securitycentermanagement/google/cloud/securitycentermanagement_v1/gapic_version.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -13,4 +13,4 @@
# See the License for the specific language governing permissions and
# limitations under the License.
#
__version__ = "0.1.1" # {x-release-please-version}
__version__ = "0.0.0" # {x-release-please-version}
67 changes: 29 additions & 38 deletions ...gle/cloud/securitycentermanagement_v1/services/security_center_management/async_client.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1502,16 +1502,10 @@ async def list_effective_event_threat_detection_custom_modules(
timeout: Union[float, object] = gapic_v1.method.DEFAULT,
metadata: Sequence[Tuple[str, str]] = (),
) -> pagers.ListEffectiveEventThreatDetectionCustomModulesAsyncPager:
r"""Returns a list of all EffectiveEventThreatDetectionCustomModules
for the given parent. This includes resident modules defined at
the scope of the parent, and inherited modules, inherited from
CRM ancestors (no descendants). The difference between an
EffectiveCustomModule and a CustomModule is that the fields for
an EffectiveCustomModule are computed from ancestors if needed.
For example, the enablement_state for a CustomModule can be
either ENABLED, DISABLED, or INHERITED. Where as the
enablement_state for an EffectiveCustomModule is always computed
to ENABLED or DISABLED (the effective enablement_state).
r"""Lists all effective Event Threat Detection custom
modules for the given parent. This includes resident
modules defined at the scope of the parent along with
modules inherited from its ancestors.

.. code-block:: python

Expand Down Expand Up @@ -1789,11 +1783,10 @@ async def list_event_threat_detection_custom_modules(
timeout: Union[float, object] = gapic_v1.method.DEFAULT,
metadata: Sequence[Tuple[str, str]] = (),
) -> pagers.ListEventThreatDetectionCustomModulesAsyncPager:
r"""Returns a list of all
EventThreatDetectionCustomModules for the given parent.
This includes resident modules defined at the scope of
the parent, and inherited modules, inherited from CRM
ancestors (no descendants).
r"""Lists all Event Threat Detection custom modules for
the given Resource Manager parent. This includes
resident modules defined at the scope of the parent
along with modules inherited from ancestors.

.. code-block:: python

Expand Down Expand Up @@ -1931,9 +1924,9 @@ async def list_descendant_event_threat_detection_custom_modules(
timeout: Union[float, object] = gapic_v1.method.DEFAULT,
metadata: Sequence[Tuple[str, str]] = (),
) -> pagers.ListDescendantEventThreatDetectionCustomModulesAsyncPager:
r"""Returns a list of all resident
EventThreatDetectionCustomModules under the given CRM
parent and all of the parent’s CRM descendants.
r"""Lists all resident Event Threat Detection custom
modules under the given Resource Manager parent and its
descendants.

.. code-block:: python

Expand Down Expand Up @@ -2072,14 +2065,7 @@ async def get_event_threat_detection_custom_module(
timeout: Union[float, object] = gapic_v1.method.DEFAULT,
metadata: Sequence[Tuple[str, str]] = (),
) -> security_center_management.EventThreatDetectionCustomModule:
r"""Gets an ETD custom module. Retrieves the module at the given
level. The difference between an EffectiveCustomModule and a
CustomModule is that the fields for an EffectiveCustomModule are
computed from ancestors if needed. For example, the
enablement_state for a CustomModule can be either ENABLED,
DISABLED, or INHERITED. Where as the enablement_state for an
EffectiveCustomModule is always computed to ENABLED or DISABLED
(the effective enablement_state).
r"""Gets an Event Threat Detection custom module.

.. code-block:: python

Expand Down Expand Up @@ -2210,9 +2196,11 @@ async def create_event_threat_detection_custom_module(
timeout: Union[float, object] = gapic_v1.method.DEFAULT,
metadata: Sequence[Tuple[str, str]] = (),
) -> security_center_management.EventThreatDetectionCustomModule:
r"""Creates an ETD custom module at the given level.
Creating a module has a side-effect of creating modules
at all descendants.
r"""Creates a resident Event Threat Detection custom
module at the scope of the given Resource Manager
parent, and also creates inherited custom modules for
all descendants of the given parent. These modules are
enabled by default.

.. code-block:: python

Expand Down Expand Up @@ -2346,12 +2334,14 @@ async def update_event_threat_detection_custom_module(
timeout: Union[float, object] = gapic_v1.method.DEFAULT,
metadata: Sequence[Tuple[str, str]] = (),
) -> security_center_management.EventThreatDetectionCustomModule:
r"""Updates an ETD custom module at the given level. All
config fields can be updated when updating the module at
resident level. Only enablement state can be updated
when updating the module at inherited levels. Updating
the module has a side-effect that it updates all
descendants that are inherited from this module.
r"""Updates the Event Threat Detection custom module with
the given name based on the given update mask. Updating
the enablement state is supported for both resident and
inherited modules (though resident modules cannot have
an enablement state of "inherited"). Updating the
display name or configuration of a module is supported
for resident modules only. The type of a module cannot
be changed.

.. code-block:: python

Expand Down Expand Up @@ -2486,9 +2476,10 @@ async def delete_event_threat_detection_custom_module(
timeout: Union[float, object] = gapic_v1.method.DEFAULT,
metadata: Sequence[Tuple[str, str]] = (),
) -> None:
r"""Deletes an ETD custom module. Deletion at resident
level also deletes modules at all descendants. Deletion
at any other level is not supported.
r"""Deletes the specified Event Threat Detection custom
module and all of its descendants in the Resource
Manager hierarchy. This method is only supported for
resident custom modules.

.. code-block:: python

Expand Down
67 changes: 29 additions & 38 deletions ...nt/google/cloud/securitycentermanagement_v1/services/security_center_management/client.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -1771,16 +1771,10 @@ def list_effective_event_threat_detection_custom_modules(
timeout: Union[float, object] = gapic_v1.method.DEFAULT,
metadata: Sequence[Tuple[str, str]] = (),
) -> pagers.ListEffectiveEventThreatDetectionCustomModulesPager:
r"""Returns a list of all EffectiveEventThreatDetectionCustomModules
for the given parent. This includes resident modules defined at
the scope of the parent, and inherited modules, inherited from
CRM ancestors (no descendants). The difference between an
EffectiveCustomModule and a CustomModule is that the fields for
an EffectiveCustomModule are computed from ancestors if needed.
For example, the enablement_state for a CustomModule can be
either ENABLED, DISABLED, or INHERITED. Where as the
enablement_state for an EffectiveCustomModule is always computed
to ENABLED or DISABLED (the effective enablement_state).
r"""Lists all effective Event Threat Detection custom
modules for the given parent. This includes resident
modules defined at the scope of the parent along with
modules inherited from its ancestors.

.. code-block:: python

Expand Down Expand Up @@ -2048,11 +2042,10 @@ def list_event_threat_detection_custom_modules(
timeout: Union[float, object] = gapic_v1.method.DEFAULT,
metadata: Sequence[Tuple[str, str]] = (),
) -> pagers.ListEventThreatDetectionCustomModulesPager:
r"""Returns a list of all
EventThreatDetectionCustomModules for the given parent.
This includes resident modules defined at the scope of
the parent, and inherited modules, inherited from CRM
ancestors (no descendants).
r"""Lists all Event Threat Detection custom modules for
the given Resource Manager parent. This includes
resident modules defined at the scope of the parent
along with modules inherited from ancestors.

.. code-block:: python

Expand Down Expand Up @@ -2185,9 +2178,9 @@ def list_descendant_event_threat_detection_custom_modules(
timeout: Union[float, object] = gapic_v1.method.DEFAULT,
metadata: Sequence[Tuple[str, str]] = (),
) -> pagers.ListDescendantEventThreatDetectionCustomModulesPager:
r"""Returns a list of all resident
EventThreatDetectionCustomModules under the given CRM
parent and all of the parent’s CRM descendants.
r"""Lists all resident Event Threat Detection custom
modules under the given Resource Manager parent and its
descendants.

.. code-block:: python

Expand Down Expand Up @@ -2321,14 +2314,7 @@ def get_event_threat_detection_custom_module(
timeout: Union[float, object] = gapic_v1.method.DEFAULT,
metadata: Sequence[Tuple[str, str]] = (),
) -> security_center_management.EventThreatDetectionCustomModule:
r"""Gets an ETD custom module. Retrieves the module at the given
level. The difference between an EffectiveCustomModule and a
CustomModule is that the fields for an EffectiveCustomModule are
computed from ancestors if needed. For example, the
enablement_state for a CustomModule can be either ENABLED,
DISABLED, or INHERITED. Where as the enablement_state for an
EffectiveCustomModule is always computed to ENABLED or DISABLED
(the effective enablement_state).
r"""Gets an Event Threat Detection custom module.

.. code-block:: python

Expand Down Expand Up @@ -2456,9 +2442,11 @@ def create_event_threat_detection_custom_module(
timeout: Union[float, object] = gapic_v1.method.DEFAULT,
metadata: Sequence[Tuple[str, str]] = (),
) -> security_center_management.EventThreatDetectionCustomModule:
r"""Creates an ETD custom module at the given level.
Creating a module has a side-effect of creating modules
at all descendants.
r"""Creates a resident Event Threat Detection custom
module at the scope of the given Resource Manager
parent, and also creates inherited custom modules for
all descendants of the given parent. These modules are
enabled by default.

.. code-block:: python

Expand Down Expand Up @@ -2595,12 +2583,14 @@ def update_event_threat_detection_custom_module(
timeout: Union[float, object] = gapic_v1.method.DEFAULT,
metadata: Sequence[Tuple[str, str]] = (),
) -> security_center_management.EventThreatDetectionCustomModule:
r"""Updates an ETD custom module at the given level. All
config fields can be updated when updating the module at
resident level. Only enablement state can be updated
when updating the module at inherited levels. Updating
the module has a side-effect that it updates all
descendants that are inherited from this module.
r"""Updates the Event Threat Detection custom module with
the given name based on the given update mask. Updating
the enablement state is supported for both resident and
inherited modules (though resident modules cannot have
an enablement state of "inherited"). Updating the
display name or configuration of a module is supported
for resident modules only. The type of a module cannot
be changed.

.. code-block:: python

Expand Down Expand Up @@ -2738,9 +2728,10 @@ def delete_event_threat_detection_custom_module(
timeout: Union[float, object] = gapic_v1.method.DEFAULT,
metadata: Sequence[Tuple[str, str]] = (),
) -> None:
r"""Deletes an ETD custom module. Deletion at resident
level also deletes modules at all descendants. Deletion
at any other level is not supported.
r"""Deletes the specified Event Threat Detection custom
module and all of its descendants in the Resource
Manager hierarchy. This method is only supported for
resident custom modules.

.. code-block:: python

Expand Down
67 changes: 29 additions & 38 deletions .../cloud/securitycentermanagement_v1/services/security_center_management/transports/grpc.py
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -565,16 +565,10 @@ def list_effective_event_threat_detection_custom_modules(
r"""Return a callable for the list effective event threat
detection custom modules method over gRPC.

Returns a list of all EffectiveEventThreatDetectionCustomModules
for the given parent. This includes resident modules defined at
the scope of the parent, and inherited modules, inherited from
CRM ancestors (no descendants). The difference between an
EffectiveCustomModule and a CustomModule is that the fields for
an EffectiveCustomModule are computed from ancestors if needed.
For example, the enablement_state for a CustomModule can be
either ENABLED, DISABLED, or INHERITED. Where as the
enablement_state for an EffectiveCustomModule is always computed
to ENABLED or DISABLED (the effective enablement_state).
Lists all effective Event Threat Detection custom
modules for the given parent. This includes resident
modules defined at the scope of the parent along with
modules inherited from its ancestors.

Returns:
Callable[[~.ListEffectiveEventThreatDetectionCustomModulesRequest],
Expand Down Expand Up @@ -647,11 +641,10 @@ def list_event_threat_detection_custom_modules(
r"""Return a callable for the list event threat detection
custom modules method over gRPC.

Returns a list of all
EventThreatDetectionCustomModules for the given parent.
This includes resident modules defined at the scope of
the parent, and inherited modules, inherited from CRM
ancestors (no descendants).
Lists all Event Threat Detection custom modules for
the given Resource Manager parent. This includes
resident modules defined at the scope of the parent
along with modules inherited from ancestors.

Returns:
Callable[[~.ListEventThreatDetectionCustomModulesRequest],
Expand Down Expand Up @@ -685,9 +678,9 @@ def list_descendant_event_threat_detection_custom_modules(
r"""Return a callable for the list descendant event threat
detection custom modules method over gRPC.

Returns a list of all resident
EventThreatDetectionCustomModules under the given CRM
parent and all of the parent’s CRM descendants.
Lists all resident Event Threat Detection custom
modules under the given Resource Manager parent and its
descendants.

Returns:
Callable[[~.ListDescendantEventThreatDetectionCustomModulesRequest],
Expand Down Expand Up @@ -719,14 +712,7 @@ def get_event_threat_detection_custom_module(
r"""Return a callable for the get event threat detection
custom module method over gRPC.

Gets an ETD custom module. Retrieves the module at the given
level. The difference between an EffectiveCustomModule and a
CustomModule is that the fields for an EffectiveCustomModule are
computed from ancestors if needed. For example, the
enablement_state for a CustomModule can be either ENABLED,
DISABLED, or INHERITED. Where as the enablement_state for an
EffectiveCustomModule is always computed to ENABLED or DISABLED
(the effective enablement_state).
Gets an Event Threat Detection custom module.

Returns:
Callable[[~.GetEventThreatDetectionCustomModuleRequest],
Expand Down Expand Up @@ -758,9 +744,11 @@ def create_event_threat_detection_custom_module(
r"""Return a callable for the create event threat detection
custom module method over gRPC.

Creates an ETD custom module at the given level.
Creating a module has a side-effect of creating modules
at all descendants.
Creates a resident Event Threat Detection custom
module at the scope of the given Resource Manager
parent, and also creates inherited custom modules for
all descendants of the given parent. These modules are
enabled by default.

Returns:
Callable[[~.CreateEventThreatDetectionCustomModuleRequest],
Expand Down Expand Up @@ -792,12 +780,14 @@ def update_event_threat_detection_custom_module(
r"""Return a callable for the update event threat detection
custom module method over gRPC.

Updates an ETD custom module at the given level. All
config fields can be updated when updating the module at
resident level. Only enablement state can be updated
when updating the module at inherited levels. Updating
the module has a side-effect that it updates all
descendants that are inherited from this module.
Updates the Event Threat Detection custom module with
the given name based on the given update mask. Updating
the enablement state is supported for both resident and
inherited modules (though resident modules cannot have
an enablement state of "inherited"). Updating the
display name or configuration of a module is supported
for resident modules only. The type of a module cannot
be changed.

Returns:
Callable[[~.UpdateEventThreatDetectionCustomModuleRequest],
Expand Down Expand Up @@ -829,9 +819,10 @@ def delete_event_threat_detection_custom_module(
r"""Return a callable for the delete event threat detection
custom module method over gRPC.

Deletes an ETD custom module. Deletion at resident
level also deletes modules at all descendants. Deletion
at any other level is not supported.
Deletes the specified Event Threat Detection custom
module and all of its descendants in the Resource
Manager hierarchy. This method is only supported for
resident custom modules.

Returns:
Callable[[~.DeleteEventThreatDetectionCustomModuleRequest],
Expand Down
Loading