RubyGems - google-cloud-security_center_management-v1 - Versions diffs - 1.0.1 → 1.1.0 - Mend

google-cloud-security_center_management-v1 1.0.1 → 1.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (11) hide show

checksums.yaml +4 -4
data/.yardopts +1 -1
data/README.md +2 -2
data/lib/google/cloud/security_center_management/v1/security_center_management/client.rb +287 -208
data/lib/google/cloud/security_center_management/v1/security_center_management/rest/client.rb +287 -208
data/lib/google/cloud/security_center_management/v1/version.rb +1 -1
data/lib/google/cloud/securitycentermanagement/v1/security_center_management_services_pb.rb +60 -41
data/proto_docs/README.md +1 -1
data/proto_docs/google/api/client.rb +14 -0
data/proto_docs/google/cloud/securitycentermanagement/v1/security_center_management.rb +511 -430
metadata +3 -3

data/lib/google/cloud/security_center_management/v1/security_center_management/client.rb CHANGED Viewed

@@ -251,10 +251,11 @@ module Google
             # Service calls
             ##
-            # Returns a list of all EffectiveSecurityHealthAnalyticsCustomModules for the
-            # given parent. This includes resident modules defined at the scope of the
-            # parent, and inherited modules, inherited from CRM ancestors (no
-            # descendants).
+            # Returns a list of all
+            # {::Google::Cloud::SecurityCenterManagement::V1::EffectiveSecurityHealthAnalyticsCustomModule EffectiveSecurityHealthAnalyticsCustomModule}
+            # resources for the given parent. This includes resident modules defined at
+            # the scope of the parent, and inherited modules, inherited from ancestor
+            # organizations, folders, and projects (no descendants).
             #
             # @overload list_effective_security_health_analytics_custom_modules(request, options = nil)
             #   Pass arguments to `list_effective_security_health_analytics_custom_modules` via a request object, either of type
@@ -272,17 +273,21 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. Name of parent to list effective custom modules. specified in one
-            #     of the following formats:
+            #     Required. Name of parent to list effective custom modules, in one of the
+            #     following formats:
+            #
             #     * `organizations/{organization}/locations/{location}`
             #     * `folders/{folder}/locations/{location}`
-            #     or
-            #     `projects/{project}/locations/{location}`
+            #     * `projects/{project}/locations/{location}`
             #   @param page_size [::Integer]
             #     Optional. The maximum number of results to return in a single response.
             #     Default is 10, minimum is 1, maximum is 1000.
             #   @param page_token [::String]
-            #     Optional. The value returned by the last call indicating a continuation.
+            #     Optional. A pagination token returned from a previous request. Provide this
+            #     token to retrieve the next page of results.
+            #
+            #     When paginating, the rest of the request must match the request that
+            #     generated the page token.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::SecurityCenterManagement::V1::EffectiveSecurityHealthAnalyticsCustomModule>]
@@ -355,7 +360,8 @@ module Google
             end
             ##
-            # Gets details of a single EffectiveSecurityHealthAnalyticsCustomModule.
+            # Gets details of a single
+            # {::Google::Cloud::SecurityCenterManagement::V1::EffectiveSecurityHealthAnalyticsCustomModule EffectiveSecurityHealthAnalyticsCustomModule}.
             #
             # @overload get_effective_security_health_analytics_custom_module(request, options = nil)
             #   Pass arguments to `get_effective_security_health_analytics_custom_module` via a request object, either of type
@@ -376,9 +382,9 @@ module Google
             #     Required. The full resource name of the custom module, specified in one of
             #     the following formats:
             #
-            #     * `organizations/organization/{location}/effectiveSecurityHealthAnalyticsCustomModules/{effective_security_health_analytics_custom_module}`
-            #     * `folders/folder/{location}/effectiveSecurityHealthAnalyticsCustomModules/{effective_security_health_analytics_custom_module}`
-            #     * `projects/project/{location}/effectiveSecurityHealthAnalyticsCustomModules/{effective_security_health_analytics_custom_module}`
+            #     * `organizations/organization/{location}/effectiveSecurityHealthAnalyticsCustomModules/{custom_module}`
+            #     * `folders/folder/{location}/effectiveSecurityHealthAnalyticsCustomModules/{custom_module}`
+            #     * `projects/project/{location}/effectiveSecurityHealthAnalyticsCustomModules/{custom_module}`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::SecurityCenterManagement::V1::EffectiveSecurityHealthAnalyticsCustomModule]
@@ -446,9 +452,11 @@ module Google
             end
             ##
-            # Returns a list of all SecurityHealthAnalyticsCustomModules for the given
-            # parent. This includes resident modules defined at the scope of the parent,
-            # and inherited modules, inherited from CRM ancestors (no descendants).
+            # Returns a list of all
+            # {::Google::Cloud::SecurityCenterManagement::V1::SecurityHealthAnalyticsCustomModule SecurityHealthAnalyticsCustomModule}
+            # resources for the given parent. This includes resident modules defined at
+            # the scope of the parent, and inherited modules, inherited from ancestor
+            # organizations, folders, and projects (no descendants).
             #
             # @overload list_security_health_analytics_custom_modules(request, options = nil)
             #   Pass arguments to `list_security_health_analytics_custom_modules` via a request object, either of type
@@ -466,8 +474,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. Name of parent organization, folder, or project in which to list
-            #     custom modules, specified in one of the following formats:
+            #     Required. Name of the parent organization, folder, or project in which to
+            #     list custom modules, in one of the following formats:
             #
             #     * `organizations/{organization}/locations/{location}`
             #     * `folders/{folder}/locations/{location}`
@@ -476,7 +484,11 @@ module Google
             #     Optional. The maximum number of results to return in a single response.
             #     Default is 10, minimum is 1, maximum is 1000.
             #   @param page_token [::String]
-            #     Optional. A token identifying a page of results the server should return.
+            #     Optional. A pagination token returned from a previous request. Provide this
+            #     token to retrieve the next page of results.
+            #
+            #     When paginating, the rest of the request must match the request that
+            #     generated the page token.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::SecurityCenterManagement::V1::SecurityHealthAnalyticsCustomModule>]
@@ -549,8 +561,10 @@ module Google
             end
             ##
-            # Returns a list of all resident SecurityHealthAnalyticsCustomModules under
-            # the given CRM parent and all of the parent's CRM descendants.
+            # Returns a list of all resident
+            # {::Google::Cloud::SecurityCenterManagement::V1::SecurityHealthAnalyticsCustomModule SecurityHealthAnalyticsCustomModule}
+            # resources under the given organization, folder, or project and all of its
+            # descendants.
             #
             # @overload list_descendant_security_health_analytics_custom_modules(request, options = nil)
             #   Pass arguments to `list_descendant_security_health_analytics_custom_modules` via a request object, either of type
@@ -569,7 +583,7 @@ module Google
             #
             #   @param parent [::String]
             #     Required. Name of the parent organization, folder, or project in which to
-            #     list custom modules, specified in one of the following formats:
+            #     list custom modules, in one of the following formats:
             #
             #     * `organizations/{organization}/locations/{location}`
             #     * `folders/{folder}/locations/{location}`
@@ -578,7 +592,11 @@ module Google
             #     Optional. The maximum number of results to return in a single response.
             #     Default is 10, minimum is 1, maximum is 1000.
             #   @param page_token [::String]
-            #     Optional. A token identifying a page of results the server should return.
+            #     Optional. A pagination token returned from a previous request. Provide this
+            #     token to retrieve the next page of results.
+            #
+            #     When paginating, the rest of the request must match the request that
+            #     generated the page token.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::SecurityCenterManagement::V1::SecurityHealthAnalyticsCustomModule>]
@@ -651,7 +669,8 @@ module Google
             end
             ##
-            # Retrieves a SecurityHealthAnalyticsCustomModule.
+            # Retrieves a
+            # {::Google::Cloud::SecurityCenterManagement::V1::SecurityHealthAnalyticsCustomModule SecurityHealthAnalyticsCustomModule}.
             #
             # @overload get_security_health_analytics_custom_module(request, options = nil)
             #   Pass arguments to `get_security_health_analytics_custom_module` via a request object, either of type
@@ -669,7 +688,8 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. Name of the resource
+            #     Required. Name of the resource, in the format
+            #     `projects/{project}/locations/{location}/securityHealthAnalyticsCustomModules/{custom_module}`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::SecurityCenterManagement::V1::SecurityHealthAnalyticsCustomModule]
@@ -737,10 +757,12 @@ module Google
             end
             ##
-            # Creates a resident SecurityHealthAnalyticsCustomModule at the scope of the
-            # given CRM parent, and also creates inherited
-            # SecurityHealthAnalyticsCustomModules for all CRM descendants of the given
-            # parent. These modules are enabled by default.
+            # Creates a resident
+            # {::Google::Cloud::SecurityCenterManagement::V1::SecurityHealthAnalyticsCustomModule SecurityHealthAnalyticsCustomModule}
+            # at the scope of the given organization, folder, or project, and also
+            # creates inherited `SecurityHealthAnalyticsCustomModule` resources for all
+            # folders and projects that are descendants of the given parent. These
+            # modules are enabled by default.
             #
             # @overload create_security_health_analytics_custom_module(request, options = nil)
             #   Pass arguments to `create_security_health_analytics_custom_module` via a request object, either of type
@@ -759,22 +781,27 @@ module Google
             #
             #   @param parent [::String]
             #     Required. Name of the parent organization, folder, or project of the
-            #     module, specified in one of the following formats:
+            #     module, in one of the following formats:
             #
             #     * `organizations/{organization}/locations/{location}`
             #     * `folders/{folder}/locations/{location}`
             #     * `projects/{project}/locations/{location}`
             #   @param security_health_analytics_custom_module [::Google::Cloud::SecurityCenterManagement::V1::SecurityHealthAnalyticsCustomModule, ::Hash]
-            #     Required. The resource being created
+            #     Required. The resource being created.
             #   @param validate_only [::Boolean]
-            #     Optional. When set to true, only validations (including IAM checks) will
-            #     done for the request (no module will be created). An OK response indicates
-            #     the request is valid while an error response indicates the request is
-            #     invalid. Note that a subsequent request to actually create the module could
-            #     still fail because:
-            #      1. the state could have changed (e.g. IAM permission lost) or
-            #      2. A failure occurred during creation of the module.
-            #     Defaults to false.
+            #     Optional. When set to `true`, the request will be validated (including IAM
+            #     checks), but no module will be created. An `OK` response indicates that the
+            #     request is valid, while an error response indicates that the request is
+            #     invalid.
+            #
+            #     If the request is valid, a subsequent request to create the module could
+            #     still fail for one of the following reasons:
+            #
+            #     *  The state of your cloud resources changed; for example, you lost a
+            #        required IAM permission
+            #     *  An error occurred during creation of the module
+            #
+            #     Defaults to `false`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::SecurityCenterManagement::V1::SecurityHealthAnalyticsCustomModule]
@@ -842,11 +869,13 @@ module Google
             end
             ##
-            # Updates the SecurityHealthAnalyticsCustomModule under the given name based
-            # on the given update mask. Updating the enablement state is supported on
-            # both resident and inherited modules (though resident modules cannot have an
-            # enablement state of "inherited"). Updating the display name and custom
-            # config of a module is supported on resident modules only.
+            # Updates the
+            # {::Google::Cloud::SecurityCenterManagement::V1::SecurityHealthAnalyticsCustomModule SecurityHealthAnalyticsCustomModule}
+            # under the given name based on the given update mask. Updating the
+            # enablement state is supported on both resident and inherited modules
+            # (though resident modules cannot have an enablement state of "inherited").
+            # Updating the display name and custom configuration of a module is supported
+            # on resident modules only.
             #
             # @overload update_security_health_analytics_custom_module(request, options = nil)
             #   Pass arguments to `update_security_health_analytics_custom_module` via a request object, either of type
@@ -864,20 +893,29 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
-            #     Required. The list of fields to be updated. The only fields that can be
-            #     updated are `enablement_state` and `custom_config`. If empty or set to the
-            #     wildcard value `*`, both `enablement_state` and `custom_config` are
-            #     updated.
+            #     Required. The fields to update. The following values are valid:
+            #
+            #     * `custom_config`
+            #     * `enablement_state`
+            #
+            #     If you omit this field or set it to the wildcard value `*`, then all
+            #     eligible fields are updated.
             #   @param security_health_analytics_custom_module [::Google::Cloud::SecurityCenterManagement::V1::SecurityHealthAnalyticsCustomModule, ::Hash]
-            #     Required. The resource being updated
+            #     Required. The resource being updated.
             #   @param validate_only [::Boolean]
-            #     Optional. When set to true, only validations (including IAM checks) will
-            #     done for the request (module will not be updated). An OK response indicates
-            #     the request is valid while an error response indicates the request is
-            #     invalid. Note that a subsequent request to actually update the module could
-            #     still fail because 1. the state could have changed (e.g. IAM permission
-            #     lost) or
-            #     2. A failure occurred while trying to update the module.
+            #     Optional. When set to `true`, the request will be validated (including IAM
+            #     checks), but no module will be updated. An `OK` response indicates that the
+            #     request is valid, while an error response indicates that the request is
+            #     invalid.
+            #
+            #     If the request is valid, a subsequent request to update the module could
+            #     still fail for one of the following reasons:
+            #
+            #     *  The state of your cloud resources changed; for example, you lost a
+            #        required IAM permission
+            #     *  An error occurred during creation of the module
+            #
+            #     Defaults to `false`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::SecurityCenterManagement::V1::SecurityHealthAnalyticsCustomModule]
@@ -945,9 +983,10 @@ module Google
             end
             ##
-            # Deletes the specified SecurityHealthAnalyticsCustomModule and all of its
-            # descendants in the CRM hierarchy. This method is only supported for
-            # resident custom modules.
+            # Deletes the specified
+            # {::Google::Cloud::SecurityCenterManagement::V1::SecurityHealthAnalyticsCustomModule SecurityHealthAnalyticsCustomModule}
+            # and all of its descendants in the resource hierarchy. This method is only
+            # supported for resident custom modules.
             #
             # @overload delete_security_health_analytics_custom_module(request, options = nil)
             #   Pass arguments to `delete_security_health_analytics_custom_module` via a request object, either of type
@@ -965,21 +1004,26 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The resource name of the SHA custom module.
-            #
-            #     Its format is:
+            #     Required. The resource name of the SHA custom module, in one of the
+            #     following formats:
             #
-            #       * `organizations/{organization}/locations/{location}/securityHealthAnalyticsCustomModules/{security_health_analytics_custom_module}`.
-            #       * `folders/{folder}/locations/{location}/securityHealthAnalyticsCustomModules/{security_health_analytics_custom_module}`.
-            #       * `projects/{project}/locations/{location}/securityHealthAnalyticsCustomModules/{security_health_analytics_custom_module}`.
+            #       * `organizations/{organization}/locations/{location}/securityHealthAnalyticsCustomModules/{custom_module}`
+            #       * `folders/{folder}/locations/{location}/securityHealthAnalyticsCustomModules/{custom_module}`
+            #       * `projects/{project}/locations/{location}/securityHealthAnalyticsCustomModules/{custom_module}`
             #   @param validate_only [::Boolean]
-            #     Optional. When set to true, only validations (including IAM checks) will
-            #     done for the request (module will not be deleted). An OK response indicates
-            #     the request is valid while an error response indicates the request is
-            #     invalid. Note that a subsequent request to actually delete the module could
-            #     still fail because 1. the state could have changed (e.g. IAM permission
-            #     lost) or
-            #     2. A failure occurred while trying to delete the module.
+            #     Optional. When set to `true`, the request will be validated (including IAM
+            #     checks), but no module will be deleted. An `OK` response indicates that the
+            #     request is valid, while an error response indicates that the request is
+            #     invalid.
+            #
+            #     If the request is valid, a subsequent request to delete the module could
+            #     still fail for one of the following reasons:
+            #
+            #     *  The state of your cloud resources changed; for example, you lost a
+            #        required IAM permission
+            #     *  An error occurred during deletion of the module
+            #
+            #     Defaults to `false`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -1047,7 +1091,9 @@ module Google
             end
             ##
-            # Simulates a given SecurityHealthAnalyticsCustomModule and Resource.
+            # Simulates the result of using a
+            # {::Google::Cloud::SecurityCenterManagement::V1::SecurityHealthAnalyticsCustomModule SecurityHealthAnalyticsCustomModule}
+            # to check a resource.
             #
             # @overload simulate_security_health_analytics_custom_module(request, options = nil)
             #   Pass arguments to `simulate_security_health_analytics_custom_module` via a request object, either of type
@@ -1066,10 +1112,9 @@ module Google
             #
             #   @param parent [::String]
             #     Required. The relative resource name of the organization, project, or
-            #     folder. For more information about relative resource names, see [Relative
-            #     Resource
-            #     Name](https://cloud.google.com/apis/design/resource_names#relative_resource_name)
-            #     Example: `organizations/{organization_id}`.
+            #     folder. For more information about relative resource names, see [AIP-122:
+            #     Resource names](https://google.aip.dev/122). Example:
+            #     `organizations/{organization_id}`.
             #   @param custom_config [::Google::Cloud::SecurityCenterManagement::V1::CustomConfig, ::Hash]
             #     Required. The custom configuration that you need to test.
             #   @param resource [::Google::Cloud::SecurityCenterManagement::V1::SimulateSecurityHealthAnalyticsCustomModuleRequest::SimulatedResource, ::Hash]
@@ -1161,16 +1206,21 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. Name of parent to list effective custom modules. Its format is
-            #     `organizations/{organization}/locations/{location}`,
-            #     `folders/{folder}/locations/{location}`,
-            #     or
-            #     `projects/{project}/locations/{location}`
+            #     Required. Name of parent to list effective custom modules, in one of the
+            #     following formats:
+            #
+            #     * `organizations/{organization}/locations/{location}`
+            #     * `folders/{folder}/locations/{location}`
+            #     * `projects/{project}/locations/{location}`
             #   @param page_size [::Integer]
             #     Optional. The maximum number of results to return in a single response.
             #     Default is 10, minimum is 1, maximum is 1000.
             #   @param page_token [::String]
-            #     Optional. The value returned by the last call indicating a continuation
+            #     Optional. A pagination token returned from a previous request. Provide this
+            #     token to retrieve the next page of results.
+            #
+            #     When paginating, the rest of the request must match the request that
+            #     generated the page token.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::SecurityCenterManagement::V1::EffectiveEventThreatDetectionCustomModule>]
@@ -1243,13 +1293,18 @@ module Google
             end
             ##
-            # Gets an effective ETD custom module. Retrieves the effective 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 the effective Event Threat Detection custom module at the given level.
+            #
+            # The difference between an
+            # {::Google::Cloud::SecurityCenterManagement::V1::EffectiveEventThreatDetectionCustomModule EffectiveEventThreatDetectionCustomModule}
+            # and an
+            # {::Google::Cloud::SecurityCenterManagement::V1::EventThreatDetectionCustomModule EventThreatDetectionCustomModule}
+            # is that the fields for an `EffectiveEventThreatDetectionCustomModule` are
+            # computed from ancestors if needed. For example, the enablement state for an
+            # `EventThreatDetectionCustomModule` can be `ENABLED`, `DISABLED`, or
+            # `INHERITED`. In contrast, the enablement state for an
+            # `EffectiveEventThreatDetectionCustomModule` is always computed as `ENABLED`
+            # or `DISABLED`.
             #
             # @overload get_effective_event_threat_detection_custom_module(request, options = nil)
             #   Pass arguments to `get_effective_event_threat_detection_custom_module` via a request object, either of type
@@ -1267,13 +1322,12 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The resource name of the ETD custom module.
-            #
-            #     Its format is:
+            #     Required. The resource name of the Event Threat Detection custom module, in
+            #     one of the following formats:
             #
-            #       * `organizations/{organization}/locations/{location}/effectiveEventThreatDetectionCustomModules/{effective_event_threat_detection_custom_module}`.
-            #       * `folders/{folder}/locations/{location}/effectiveEventThreatDetectionCustomModules/{effective_event_threat_detection_custom_module}`.
-            #       * `projects/{project}/locations/{location}/effectiveEventThreatDetectionCustomModules/{effective_event_threat_detection_custom_module}`.
+            #     * `organizations/{organization}/locations/{location}/effectiveEventThreatDetectionCustomModules/{custom_module}`
+            #     * `folders/{folder}/locations/{location}/effectiveEventThreatDetectionCustomModules/{custom_module}`
+            #     * `projects/{project}/locations/{location}/effectiveEventThreatDetectionCustomModules/{custom_module}`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::SecurityCenterManagement::V1::EffectiveEventThreatDetectionCustomModule]
@@ -1341,9 +1395,9 @@ module Google
             end
             ##
-            # 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.
+            # Lists all Event Threat Detection custom modules for the given organization,
+            # folder, or project. This includes resident modules defined at the scope of
+            # the parent along with modules inherited from ancestors.
             #
             # @overload list_event_threat_detection_custom_modules(request, options = nil)
             #   Pass arguments to `list_event_threat_detection_custom_modules` via a request object, either of type
@@ -1361,23 +1415,22 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. Name of parent to list custom modules. Its format is
-            #     `organizations/{organization}/locations/{location}`,
-            #     `folders/{folder}/locations/{location}`,
-            #     or
-            #     `projects/{project}/locations/{location}`
+            #     Required. Name of parent to list custom modules, in one of the following
+            #     formats:
+            #
+            #     * `organizations/{organization}/locations/{location}`
+            #     * `folders/{folder}/locations/{location}`
+            #     * `projects/{project}/locations/{location}`
             #   @param page_size [::Integer]
             #     Optional. The maximum number of modules to return. The service may return
-            #     fewer than this value. If unspecified, at most 10 configs will be returned.
+            #     fewer than this value. If unspecified, at most 10 modules will be returned.
             #     The maximum value is 1000; values above 1000 will be coerced to 1000.
             #   @param page_token [::String]
-            #     Optional. A page token, received from a previous
-            #     `ListEventThreatDetectionCustomModules` call. Provide this to retrieve the
-            #     subsequent page.
+            #     Optional. A pagination token returned from a previous request. Provide this
+            #     token to retrieve the next page of results.
             #
-            #     When paginating, all other parameters provided to
-            #     `ListEventThreatDetectionCustomModules` must match the call that provided
-            #     the page token.
+            #     When paginating, the rest of the request must match the request that
+            #     generated the page token.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::SecurityCenterManagement::V1::EventThreatDetectionCustomModule>]
@@ -1450,8 +1503,8 @@ module Google
             end
             ##
-            # Lists all resident Event Threat Detection custom modules under the
-            # given Resource Manager parent and its descendants.
+            # Lists all resident Event Threat Detection custom modules for the given
+            # organization, folder, or project and its descendants.
             #
             # @overload list_descendant_event_threat_detection_custom_modules(request, options = nil)
             #   Pass arguments to `list_descendant_event_threat_detection_custom_modules` via a request object, either of type
@@ -1469,17 +1522,22 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. Name of parent to list custom modules. Its format is
-            #     `organizations/{organization}/locations/{location}`,
-            #     `folders/{folder}/locations/{location}`,
-            #     or
-            #     `projects/{project}/locations/{location}`
+            #     Required. Name of parent to list custom modules, in one of the following
+            #     formats:
+            #
+            #     * `organizations/{organization}/locations/{location}`
+            #     * `folders/{folder}/locations/{location}`
+            #     * `projects/{project}/locations/{location}`
             #   @param page_size [::Integer]
             #     Optional. The maximum number of modules to return. The service may return
             #     fewer than this value. If unspecified, at most 10 configs will be returned.
             #     The maximum value is 1000; values above 1000 will be coerced to 1000.
             #   @param page_token [::String]
-            #     Optional. A token identifying a page of results the server should return.
+            #     Optional. A pagination token returned from a previous request. Provide this
+            #     token to retrieve the next page of results.
+            #
+            #     When paginating, the rest of the request must match the request that
+            #     generated the page token.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::SecurityCenterManagement::V1::EventThreatDetectionCustomModule>]
@@ -1570,13 +1628,12 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The resource name of the ETD custom module.
-            #
-            #     Its format is:
+            #     Required. The resource name of the Event Threat Detection custom module, in
+            #     one of the following formats:
             #
-            #       * `organizations/{organization}/locations/{location}/eventThreatDetectionCustomModules/{event_threat_detection_custom_module}`.
-            #       * `folders/{folder}/locations/{location}/eventThreatDetectionCustomModules/{event_threat_detection_custom_module}`.
-            #       * `projects/{project}/locations/{location}/eventThreatDetectionCustomModules/{event_threat_detection_custom_module}`.
+            #     * `organizations/{organization}/locations/{location}/eventThreatDetectionCustomModules/{custom_module}`
+            #     * `folders/{folder}/locations/{location}/eventThreatDetectionCustomModules/{custom_module}`
+            #     * `projects/{project}/locations/{location}/eventThreatDetectionCustomModules/{custom_module}`
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::SecurityCenterManagement::V1::EventThreatDetectionCustomModule]
@@ -1645,9 +1702,9 @@ module Google
             ##
             # 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.
+            # given organization, folder, or project, and creates inherited custom
+            # modules for all descendants of the given parent. These modules are enabled
+            # by default.
             #
             # @overload create_event_threat_detection_custom_module(request, options = nil)
             #   Pass arguments to `create_event_threat_detection_custom_module` via a request object, either of type
@@ -1665,23 +1722,29 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. Name of parent for the module. Its format is
-            #     `organizations/{organization}/locations/{location}`,
-            #     `folders/{folder}/locations/{location}`,
-            #     or
-            #     `projects/{project}/locations/{location}`
+            #     Required. Name of parent for the module, in one of the following formats:
+            #
+            #     * `organizations/{organization}/locations/{location}`
+            #     * `folders/{folder}/locations/{location}`
+            #     * `projects/{project}/locations/{location}`
             #   @param event_threat_detection_custom_module [::Google::Cloud::SecurityCenterManagement::V1::EventThreatDetectionCustomModule, ::Hash]
             #     Required. The module to create. The
-            #     event_threat_detection_custom_module.name will be ignored and server
-            #     generated.
+            #     {::Google::Cloud::SecurityCenterManagement::V1::EventThreatDetectionCustomModule#name EventThreatDetectionCustomModule.name}
+            #     field is ignored; Security Command Center generates the name.
             #   @param validate_only [::Boolean]
-            #     Optional. When set to true, only validations (including IAM checks) will
-            #     done for the request (no module will be created). An OK response indicates
-            #     the request is valid while an error response indicates the request is
-            #     invalid. Note that a subsequent request to actually create the module could
-            #     still fail because 1. the state could have changed (e.g. IAM permission
-            #     lost) or
-            #     2. A failure occurred during creation of the module.
+            #     Optional. When set to `true`, the request will be validated (including IAM
+            #     checks), but no module will be created. An `OK` response indicates that the
+            #     request is valid, while an error response indicates that the request is
+            #     invalid.
+            #
+            #     If the request is valid, a subsequent request to create the module could
+            #     still fail for one of the following reasons:
+            #
+            #     *  The state of your cloud resources changed; for example, you lost a
+            #        required IAM permission
+            #     *  An error occurred during creation of the module
+            #
+            #     Defaults to `false`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::SecurityCenterManagement::V1::EventThreatDetectionCustomModule]
@@ -1772,21 +1835,23 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
-            #     Required. Field mask is used to specify the fields to be overwritten in the
-            #     EventThreatDetectionCustomModule resource by the update.
-            #     The fields specified in the update_mask are relative to the resource, not
-            #     the full request. A field will be overwritten if it is in the mask. If the
-            #     user does not provide a mask then all fields will be overwritten.
+            #     Required. The fields to update. If omitted, then all fields are updated.
             #   @param event_threat_detection_custom_module [::Google::Cloud::SecurityCenterManagement::V1::EventThreatDetectionCustomModule, ::Hash]
-            #     Required. The module being updated
+            #     Required. The module being updated.
             #   @param validate_only [::Boolean]
-            #     Optional. When set to true, only validations (including IAM checks) will
-            #     done for the request (module will not be updated). An OK response indicates
-            #     the request is valid while an error response indicates the request is
-            #     invalid. Note that a subsequent request to actually update the module could
-            #     still fail because 1. the state could have changed (e.g. IAM permission
-            #     lost) or
-            #     2. A failure occurred while trying to update the module.
+            #     Optional. When set to `true`, the request will be validated (including IAM
+            #     checks), but no module will be updated. An `OK` response indicates that the
+            #     request is valid, while an error response indicates that the request is
+            #     invalid.
+            #
+            #     If the request is valid, a subsequent request to update the module could
+            #     still fail for one of the following reasons:
+            #
+            #     *  The state of your cloud resources changed; for example, you lost a
+            #        required IAM permission
+            #     *  An error occurred during creation of the module
+            #
+            #     Defaults to `false`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::SecurityCenterManagement::V1::EventThreatDetectionCustomModule]
@@ -1855,8 +1920,8 @@ module Google
             ##
             # 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.
+            # descendants in the resource hierarchy. This method is only supported for
+            # resident custom modules.
             #
             # @overload delete_event_threat_detection_custom_module(request, options = nil)
             #   Pass arguments to `delete_event_threat_detection_custom_module` via a request object, either of type
@@ -1874,21 +1939,26 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The resource name of the ETD custom module.
+            #     Required. The resource name of the Event Threat Detection custom module, in
+            #     one of the following formats:
             #
-            #     Its format is:
-            #
-            #       * `organizations/{organization}/locations/{location}/eventThreatDetectionCustomModules/{event_threat_detection_custom_module}`.
-            #       * `folders/{folder}/locations/{location}/eventThreatDetectionCustomModules/{event_threat_detection_custom_module}`.
-            #       * `projects/{project}/locations/{location}/eventThreatDetectionCustomModules/{event_threat_detection_custom_module}`.
+            #     * `organizations/{organization}/locations/{location}/eventThreatDetectionCustomModules/{custom_module}`
+            #     * `folders/{folder}/locations/{location}/eventThreatDetectionCustomModules/{custom_module}`
+            #     * `projects/{project}/locations/{location}/eventThreatDetectionCustomModules/{custom_module}`
             #   @param validate_only [::Boolean]
-            #     Optional. When set to true, only validations (including IAM checks) will
-            #     done for the request (module will not be deleted). An OK response indicates
-            #     the request is valid while an error response indicates the request is
-            #     invalid. Note that a subsequent request to actually delete the module could
-            #     still fail because 1. the state could have changed (e.g. IAM permission
-            #     lost) or
-            #     2. A failure occurred while trying to delete the module.
+            #     Optional. When set to `true`, the request will be validated (including IAM
+            #     checks), but no module will be deleted. An `OK` response indicates that the
+            #     request is valid, while an error response indicates that the request is
+            #     invalid.
+            #
+            #     If the request is valid, a subsequent request to delete the module could
+            #     still fail for one of the following reasons:
+            #
+            #     *  The state of your cloud resources changed; for example, you lost a
+            #        required IAM permission
+            #     *  An error occurred during creation of the module
+            #
+            #     Defaults to `false`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Protobuf::Empty]
@@ -1974,16 +2044,15 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. Resource name of the parent to validate the Custom Module under.
+            #     Required. Resource name of the parent to validate the custom modules under,
+            #     in one of the following formats:
             #
-            #     Its format is:
-            #
-            #       * `organizations/{organization}/locations/{location}`.
+            #     * `organizations/{organization}/locations/{location}`
             #   @param raw_text [::String]
             #     Required. The raw text of the module's contents. Used to generate error
             #     messages.
             #   @param type [::String]
-            #     Required. The type of the module (e.g. CONFIGURABLE_BAD_IP).
+            #     Required. The type of the module. For example, `CONFIGURABLE_BAD_IP`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::SecurityCenterManagement::V1::ValidateEventThreatDetectionCustomModuleResponse]
@@ -2069,24 +2138,23 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param name [::String]
-            #     Required. The Security Command Center service to retrieve.
+            #     Required. The Security Command Center service to retrieve, in one of the
+            #     following formats:
             #
-            #     Formats:
+            #     * organizations/\\{organization}/locations/\\{location}/securityCenterServices/\\{service}
+            #     * folders/\\{folder}/locations/\\{location}/securityCenterServices/\\{service}
+            #     * projects/\\{project}/locations/\\{location}/securityCenterServices/\\{service}
             #
-            #       * organizations/\\{organization}/locations/\\{location}/securityCenterServices/\\{service}
-            #       * folders/\\{folder}/locations/\\{location}/securityCenterServices/\\{service}
-            #       * projects/\\{project}/locations/\\{location}/securityCenterServices/\\{service}
+            #     The following values are valid for `{service}`:
             #
-            #     The possible values for id \\{service} are:
-            #
-            #       * container-threat-detection
-            #       * event-threat-detection
-            #       * security-health-analytics
-            #       * vm-threat-detection
-            #       * web-security-scanner
+            #     * `container-threat-detection`
+            #     * `event-threat-detection`
+            #     * `security-health-analytics`
+            #     * `vm-threat-detection`
+            #     * `web-security-scanner`
             #   @param show_eligible_modules_only [::Boolean]
-            #     Flag that, when set, will be used to filter the ModuleSettings that are
-            #     in scope. The default setting is that all modules will be shown.
+            #     Set to `true` to show only modules that are in scope. By default, all
+            #     modules are shown.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::SecurityCenterManagement::V1::SecurityCenterService]
@@ -2173,21 +2241,24 @@ module Google
             #   the default parameter values, pass an empty Hash as a request object (see above).
             #
             #   @param parent [::String]
-            #     Required. The name of the parent to list Security Command Center services.
-            #
-            #     Formats:
+            #     Required. The name of the parent to list Security Command Center services,
+            #     in one of the following formats:
             #
-            #       * organizations/\\{organization}/locations/\\{location}
-            #       * folders/\\{folder}/locations/\\{location}
-            #       * projects/\\{project}/locations/\\{location}
+            #     * `organizations/{organization}/locations/{location}`
+            #     * `folders/{folder}/locations/{location}`
+            #     * `projects/{project}/locations/{location}`
             #   @param page_size [::Integer]
             #     Optional. The maximum number of results to return in a single response.
             #     Default is 10, minimum is 1, maximum is 1000.
             #   @param page_token [::String]
-            #     Optional. The value returned by the last call indicating a continuation.
+            #     Optional. A pagination token returned from a previous request. Provide this
+            #     token to retrieve the next page of results.
+            #
+            #     When paginating, the rest of the request must match the request that
+            #     generated the page token.
             #   @param show_eligible_modules_only [::Boolean]
-            #     Flag that, when set, will be used to filter the ModuleSettings that are
-            #     in scope. The default setting is that all modules will be shown.
+            #     Flag that, when set, is used to filter the module settings that are shown.
+            #     The default setting is that all modules are shown.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Gapic::PagedEnumerable<::Google::Cloud::SecurityCenterManagement::V1::SecurityCenterService>]
@@ -2280,18 +2351,26 @@ module Google
             #   @param security_center_service [::Google::Cloud::SecurityCenterManagement::V1::SecurityCenterService, ::Hash]
             #     Required. The updated service.
             #   @param update_mask [::Google::Protobuf::FieldMask, ::Hash]
-            #     Required. The list of fields to be updated. Possible values:
+            #     Required. The fields to update. Accepts the following values:
             #
-            #       * "intended_enablement_state"
-            #       * "modules"
+            #     * `intended_enablement_state`
+            #     * `modules`
+            #
+            #     If omitted, then all eligible fields are updated.
             #   @param validate_only [::Boolean]
-            #     Optional. When set to true, only validations (including IAM checks) will be
-            #     done for the request (service will not be updated). An OK response
-            #     indicates that the request is valid, while an error response indicates that
-            #     the request is invalid. Note that a subsequent request to actually update
-            #     the service could still fail for one of the following reasons:
-            #     - The state could have changed (e.g. IAM permission lost).
-            #     - A failure occurred while trying to delete the module.
+            #     Optional. When set to `true`, the request will be validated (including IAM
+            #     checks), but no service will be updated. An `OK` response indicates that
+            #     the request is valid, while an error response indicates that the request is
+            #     invalid.
+            #
+            #     If the request is valid, a subsequent request to update the service could
+            #     still fail for one of the following reasons:
+            #
+            #     *  The state of your cloud resources changed; for example, you lost a
+            #        required IAM permission
+            #     *  An error occurred during update of the service
+            #
+            #     Defaults to `false`.
             #
             # @yield [response, operation] Access the result along with the RPC operation
             # @yieldparam response [::Google::Cloud::SecurityCenterManagement::V1::SecurityCenterService]