docs: update documentation for UpdateSecurityHealthAnalyticsCustomModule update_mask field

Google APIs · copybara-github · commit 5a5e3d62e215 · 2024-01-12T14:45:55.000-08:00
---
docs: Add description

---
chore: update go_package and Go importpath
PiperOrigin-RevId: 597960211
diff --git a/google/cloud/securitycentermanagement/v1/security_center_management.proto b/google/cloud/securitycentermanagement/v1/security_center_management.proto
@@ -765,11 +765,10 @@ message CreateSecurityHealthAnalyticsCustomModuleRequest {
 
 // Message for updating a SecurityHealthAnalyticsCustomModule
 message UpdateSecurityHealthAnalyticsCustomModuleRequest {
-  // Required. Field mask is used to specify the fields to be overwritten in the
-  // SecurityHealthAnalyticsCustomModule 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 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.
   google.protobuf.FieldMask update_mask = 1
       [(google.api.field_behavior) = REQUIRED];
 
diff --git a/google/cloud/securitycentermanagement/v1/securitycentermanagement_v1.yaml b/google/cloud/securitycentermanagement/v1/securitycentermanagement_v1.yaml
@@ -8,6 +8,11 @@ apis:
 - name: google.cloud.securitycentermanagement.v1.SecurityCenterManagement
 
 documentation:
+  summary: |-
+    Management API for the Security Command Center, a built-in security and
+    risk management solution for Google Cloud. Use this API to
+    programmatically update the settings and configuration of Security Command
+    Center.
   rules:
   - selector: google.cloud.location.Locations.GetLocation
     description: Gets information about a location.
@@ -38,7 +43,7 @@ authentication:
         https://www.googleapis.com/auth/cloud-platform
 
 publishing:
-  new_issue_uri: https://issuetracker.google.com/issues/new?component=190865&template=1161103
+  new_issue_uri: https://issuetracker.google.com/issues/new?component=709980
   documentation_uri: https://cloud.google.com/securitycentermanagement/docs/overview
   api_short_name: securitycentermanagement
   github_label: 'api: securitycentermanagement'
