google-cloud-security_center_management-v1 1.0.0 → 1.1.0

data/lib/google/cloud/security_center_management/v1/version.rb

@@ -21,7 +21,7 @@ module Google
   module Cloud
     module SecurityCenterManagement
       module V1
-        VERSION = "1.0.0"
+        VERSION = "1.1.0"
       end
     end
   end

data/lib/google/cloud/securitycentermanagement/v1/security_center_management_services_pb.rb

@@ -33,64 +33,83 @@ module Google
             self.unmarshal_class_method = :decode
             self.service_name = 'google.cloud.securitycentermanagement.v1.SecurityCenterManagement'
 
-            # 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
+            # [EffectiveSecurityHealthAnalyticsCustomModule][google.cloud.securitycentermanagement.v1.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).
             rpc :ListEffectiveSecurityHealthAnalyticsCustomModules, ::Google::Cloud::SecurityCenterManagement::V1::ListEffectiveSecurityHealthAnalyticsCustomModulesRequest, ::Google::Cloud::SecurityCenterManagement::V1::ListEffectiveSecurityHealthAnalyticsCustomModulesResponse
-            # Gets details of a single EffectiveSecurityHealthAnalyticsCustomModule.
+            # Gets details of a single
+            # [EffectiveSecurityHealthAnalyticsCustomModule][google.cloud.securitycentermanagement.v1.EffectiveSecurityHealthAnalyticsCustomModule].
             rpc :GetEffectiveSecurityHealthAnalyticsCustomModule, ::Google::Cloud::SecurityCenterManagement::V1::GetEffectiveSecurityHealthAnalyticsCustomModuleRequest, ::Google::Cloud::SecurityCenterManagement::V1::EffectiveSecurityHealthAnalyticsCustomModule
-            # 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
+            # [SecurityHealthAnalyticsCustomModule][google.cloud.securitycentermanagement.v1.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).
             rpc :ListSecurityHealthAnalyticsCustomModules, ::Google::Cloud::SecurityCenterManagement::V1::ListSecurityHealthAnalyticsCustomModulesRequest, ::Google::Cloud::SecurityCenterManagement::V1::ListSecurityHealthAnalyticsCustomModulesResponse
-            # 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
+            # [SecurityHealthAnalyticsCustomModule][google.cloud.securitycentermanagement.v1.SecurityHealthAnalyticsCustomModule]
+            # resources under the given organization, folder, or project and all of its
+            # descendants.
             rpc :ListDescendantSecurityHealthAnalyticsCustomModules, ::Google::Cloud::SecurityCenterManagement::V1::ListDescendantSecurityHealthAnalyticsCustomModulesRequest, ::Google::Cloud::SecurityCenterManagement::V1::ListDescendantSecurityHealthAnalyticsCustomModulesResponse
-            # Retrieves a SecurityHealthAnalyticsCustomModule.
+            # Retrieves a
+            # [SecurityHealthAnalyticsCustomModule][google.cloud.securitycentermanagement.v1.SecurityHealthAnalyticsCustomModule].
             rpc :GetSecurityHealthAnalyticsCustomModule, ::Google::Cloud::SecurityCenterManagement::V1::GetSecurityHealthAnalyticsCustomModuleRequest, ::Google::Cloud::SecurityCenterManagement::V1::SecurityHealthAnalyticsCustomModule
-            # 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
+            # [SecurityHealthAnalyticsCustomModule][google.cloud.securitycentermanagement.v1.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.
             rpc :CreateSecurityHealthAnalyticsCustomModule, ::Google::Cloud::SecurityCenterManagement::V1::CreateSecurityHealthAnalyticsCustomModuleRequest, ::Google::Cloud::SecurityCenterManagement::V1::SecurityHealthAnalyticsCustomModule
-            # 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
+            # [SecurityHealthAnalyticsCustomModule][google.cloud.securitycentermanagement.v1.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.
             rpc :UpdateSecurityHealthAnalyticsCustomModule, ::Google::Cloud::SecurityCenterManagement::V1::UpdateSecurityHealthAnalyticsCustomModuleRequest, ::Google::Cloud::SecurityCenterManagement::V1::SecurityHealthAnalyticsCustomModule
-            # 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
+            # [SecurityHealthAnalyticsCustomModule][google.cloud.securitycentermanagement.v1.SecurityHealthAnalyticsCustomModule]
+            # and all of its descendants in the resource hierarchy. This method is only
+            # supported for resident custom modules.
             rpc :DeleteSecurityHealthAnalyticsCustomModule, ::Google::Cloud::SecurityCenterManagement::V1::DeleteSecurityHealthAnalyticsCustomModuleRequest, ::Google::Protobuf::Empty
-            # Simulates a given SecurityHealthAnalyticsCustomModule and Resource.
+            # Simulates the result of using a
+            # [SecurityHealthAnalyticsCustomModule][google.cloud.securitycentermanagement.v1.SecurityHealthAnalyticsCustomModule]
+            # to check a resource.
             rpc :SimulateSecurityHealthAnalyticsCustomModule, ::Google::Cloud::SecurityCenterManagement::V1::SimulateSecurityHealthAnalyticsCustomModuleRequest, ::Google::Cloud::SecurityCenterManagement::V1::SimulateSecurityHealthAnalyticsCustomModuleResponse
             # 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.
             rpc :ListEffectiveEventThreatDetectionCustomModules, ::Google::Cloud::SecurityCenterManagement::V1::ListEffectiveEventThreatDetectionCustomModulesRequest, ::Google::Cloud::SecurityCenterManagement::V1::ListEffectiveEventThreatDetectionCustomModulesResponse
-            # 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
+            # [EffectiveEventThreatDetectionCustomModule][google.cloud.securitycentermanagement.v1.EffectiveEventThreatDetectionCustomModule]
+            # and an
+            # [EventThreatDetectionCustomModule][google.cloud.securitycentermanagement.v1.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`.
             rpc :GetEffectiveEventThreatDetectionCustomModule, ::Google::Cloud::SecurityCenterManagement::V1::GetEffectiveEventThreatDetectionCustomModuleRequest, ::Google::Cloud::SecurityCenterManagement::V1::EffectiveEventThreatDetectionCustomModule
-            # 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.
             rpc :ListEventThreatDetectionCustomModules, ::Google::Cloud::SecurityCenterManagement::V1::ListEventThreatDetectionCustomModulesRequest, ::Google::Cloud::SecurityCenterManagement::V1::ListEventThreatDetectionCustomModulesResponse
-            # 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.
             rpc :ListDescendantEventThreatDetectionCustomModules, ::Google::Cloud::SecurityCenterManagement::V1::ListDescendantEventThreatDetectionCustomModulesRequest, ::Google::Cloud::SecurityCenterManagement::V1::ListDescendantEventThreatDetectionCustomModulesResponse
             # Gets an Event Threat Detection custom module.
             rpc :GetEventThreatDetectionCustomModule, ::Google::Cloud::SecurityCenterManagement::V1::GetEventThreatDetectionCustomModuleRequest, ::Google::Cloud::SecurityCenterManagement::V1::EventThreatDetectionCustomModule
             # 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.
             rpc :CreateEventThreatDetectionCustomModule, ::Google::Cloud::SecurityCenterManagement::V1::CreateEventThreatDetectionCustomModuleRequest, ::Google::Cloud::SecurityCenterManagement::V1::EventThreatDetectionCustomModule
             # Updates the Event Threat Detection custom module with the given name based
             # on the given update mask. Updating the enablement state is supported for
@@ -100,8 +119,8 @@ module Google
             # of a module cannot be changed.
             rpc :UpdateEventThreatDetectionCustomModule, ::Google::Cloud::SecurityCenterManagement::V1::UpdateEventThreatDetectionCustomModuleRequest, ::Google::Cloud::SecurityCenterManagement::V1::EventThreatDetectionCustomModule
             # 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.
             rpc :DeleteEventThreatDetectionCustomModule, ::Google::Cloud::SecurityCenterManagement::V1::DeleteEventThreatDetectionCustomModuleRequest, ::Google::Protobuf::Empty
             # Validates the given Event Threat Detection custom module.
             rpc :ValidateEventThreatDetectionCustomModule, ::Google::Cloud::SecurityCenterManagement::V1::ValidateEventThreatDetectionCustomModuleRequest, ::Google::Cloud::SecurityCenterManagement::V1::ValidateEventThreatDetectionCustomModuleResponse

data/proto_docs/README.md

@@ -1,4 +1,4 @@
-# Security Center Management V1 Protocol Buffer Documentation
+# Security Command Center Management V1 Protocol Buffer Documentation
 
 These files are for the YARD documentation of the generated protobuf files.
 They are not intended to be required or loaded at runtime.

data/proto_docs/google/api/client.rb

@@ -28,6 +28,9 @@ module Google
     # @!attribute [rw] destinations
     #   @return [::Array<::Google::Api::ClientLibraryDestination>]
     #     The destination where API teams want this client library to be published.
+    # @!attribute [rw] selective_gapic_generation
+    #   @return [::Google::Api::SelectiveGapicGeneration]
+    #     Configuration for which RPCs should be generated in the GAPIC client.
     class CommonLanguageSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
@@ -196,9 +199,26 @@ module Google
     # @!attribute [rw] common
     #   @return [::Google::Api::CommonLanguageSettings]
     #     Some settings.
+    # @!attribute [rw] experimental_features
+    #   @return [::Google::Api::PythonSettings::ExperimentalFeatures]
+    #     Experimental features to be included during client library generation.
     class PythonSettings
       include ::Google::Protobuf::MessageExts
       extend ::Google::Protobuf::MessageExts::ClassMethods
+
+      # Experimental features to be included during client library generation.
+      # These fields will be deprecated once the feature graduates and is enabled
+      # by default.
+      # @!attribute [rw] rest_async_io_enabled
+      #   @return [::Boolean]
+      #     Enables generation of asynchronous REST clients if `rest` transport is
+      #     enabled. By default, asynchronous REST clients will not be generated.
+      #     This feature will be enabled by default 1 month after launching the
+      #     feature in preview packages.
+      class ExperimentalFeatures
+        include ::Google::Protobuf::MessageExts
+        extend ::Google::Protobuf::MessageExts::ClassMethods
+      end
     end
 
     # Settings for Node client libraries.
@@ -290,6 +310,13 @@ module Google
     #   @return [::String]
     #     The fully qualified name of the method, for which the options below apply.
     #     This is used to find the method to apply the options.
+    #
+    #     Example:
+    #
+    #        publishing:
+    #          method_settings:
+    #          - selector: google.storage.control.v2.StorageControl.CreateFolder
+    #            # method settings for CreateFolder...
     # @!attribute [rw] long_running
     #   @return [::Google::Api::MethodSettings::LongRunning]
     #     Describes settings to use for long-running operations when generating
@@ -298,17 +325,14 @@ module Google
     #
     #     Example of a YAML configuration::
     #
-    #      publishing:
-    #        method_settings:
+    #        publishing:
+    #          method_settings:
     #          - selector: google.cloud.speech.v2.Speech.BatchRecognize
     #            long_running:
-    #              initial_poll_delay:
-    #                seconds: 60 # 1 minute
+    #              initial_poll_delay: 60s # 1 minute
     #              poll_delay_multiplier: 1.5
-    #              max_poll_delay:
-    #                seconds: 360 # 6 minutes
-    #              total_poll_timeout:
-    #                 seconds: 54000 # 90 minutes
+    #              max_poll_delay: 360s # 6 minutes
+    #              total_poll_timeout: 54000s # 90 minutes
     # @!attribute [rw] auto_populated_fields
     #   @return [::Array<::String>]
     #     List of top-level fields of the request message, that should be
@@ -317,8 +341,8 @@ module Google
     #
     #     Example of a YAML configuration:
     #
-    #      publishing:
-    #        method_settings:
+    #        publishing:
+    #          method_settings:
     #          - selector: google.example.v1.ExampleService.CreateExample
     #            auto_populated_fields:
     #            - request_id
@@ -354,6 +378,17 @@ module Google
       end
     end
 
+    # This message is used to configure the generation of a subset of the RPCs in
+    # a service for client libraries.
+    # @!attribute [rw] methods
+    #   @return [::Array<::String>]
+    #     An allowlist of the fully qualified names of RPCs that should be included
+    #     on public client surfaces.
+    class SelectiveGapicGeneration
+      include ::Google::Protobuf::MessageExts
+      extend ::Google::Protobuf::MessageExts::ClassMethods
+    end
+
     # The organization for which the client libraries are being published.
     # Affects the url where generated docs are published, etc.
     module ClientLibraryOrganization

data/proto_docs/google/api/resource.rb

@@ -124,8 +124,13 @@ module Google
     #   @return [::String]
     #     The plural name used in the resource name and permission names, such as
     #     'projects' for the resource name of 'projects/\\{project}' and the permission
-    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. It is the same
-    #     concept of the `plural` field in k8s CRD spec
+    #     name of 'cloudresourcemanager.googleapis.com/projects.get'. One exception
+    #     to this is for Nested Collections that have stuttering names, as defined
+    #     in [AIP-122](https://google.aip.dev/122#nested-collections), where the
+    #     collection ID in the resource name pattern does not necessarily directly
+    #     match the `plural` value.
+    #
+    #     It is the same concept of the `plural` field in k8s CRD spec
     #     https://kubernetes.io/docs/tasks/access-kubernetes-api/custom-resources/custom-resource-definitions/
     #
     #     Note: The plural form is required even for singleton resources. See