From 8d73f9486fc193a150f6c907dfb9f49431aff3ff Mon Sep 17 00:00:00 2001
From: Google APIs <noreply@google.com>
Date: Fri, 18 Sep 2020 12:02:05 -0700
Subject: [PATCH] docs: updated description of finding severity field

PiperOrigin-RevId: 332497859
---
 .../securitycenter/v1p1beta1/finding.proto    |  6 ++++--
 .../v1p1beta1/securitycenter_service.proto    | 21 +++++++++++--------
 2 files changed, 16 insertions(+), 11 deletions(-)

diff --git a/google/cloud/securitycenter/v1p1beta1/finding.proto b/google/cloud/securitycenter/v1p1beta1/finding.proto
index 49f8159f..551f1cee 100644
--- a/google/cloud/securitycenter/v1p1beta1/finding.proto
+++ b/google/cloud/securitycenter/v1p1beta1/finding.proto
@@ -55,7 +55,8 @@ message Finding {
     INACTIVE = 2;
   }
 
-  // The severity of the finding.
+  // The severity of the finding. This field is managed by the source that
+  // writes the finding.
   enum Severity {
     // No severity specified. The default value.
     SEVERITY_UNSPECIFIED = 0;
@@ -128,6 +129,7 @@ message Finding {
   // The time at which the finding was created in Security Command Center.
   google.protobuf.Timestamp create_time = 10;
 
-  // The severity of the finding.
+  // The severity of the finding. This field is managed by the source that
+  // writes the finding.
   Severity severity = 13;
 }
diff --git a/google/cloud/securitycenter/v1p1beta1/securitycenter_service.proto b/google/cloud/securitycenter/v1p1beta1/securitycenter_service.proto
index 69d864c6..f8f1580f 100644
--- a/google/cloud/securitycenter/v1p1beta1/securitycenter_service.proto
+++ b/google/cloud/securitycenter/v1p1beta1/securitycenter_service.proto
@@ -16,6 +16,7 @@ syntax = "proto3";
 
 package google.cloud.securitycenter.v1p1beta1;
 
+import public "google/cloud/securitycenter/v1p1beta1/notification_message.proto";
 import public "google/cloud/securitycenter/v1p1beta1/run_asset_discovery_response.proto";
 import "google/api/annotations.proto";
 import "google/api/client.proto";
@@ -307,8 +308,7 @@ message CreateNotificationConfigRequest {
     }
   ];
 
-  // Required.
-  // Unique identifier provided by the client within the parent scope.
+  // Required. Unique identifier provided by the client within the parent scope.
   // It must be between 1 and 128 characters, and contains alphanumeric
   // characters, underscores or hyphens only.
   string config_id = 2 [(google.api.field_behavior) = REQUIRED];
@@ -586,6 +586,7 @@ message GroupFindingsRequest {
   // * category: `=`, `:`
   // * external_uri: `=`, `:`
   // * event_time: `=`, `>`, `<`, `>=`, `<=`
+  // * severity: `=`, `:`
   //
   //   Usage: This should be milliseconds since epoch or an RFC3339 string.
   //   Examples:
@@ -614,6 +615,7 @@ message GroupFindingsRequest {
   // * category
   // * state
   // * parent
+  // * severity
   //
   // The following fields are supported when compare_duration is set:
   //
@@ -988,13 +990,14 @@ message ListFindingsRequest {
   //
   // The following field and operator combinations are supported:
   //
-  // name: `=`
-  // parent: `=`, `:`
-  // resource_name: `=`, `:`
-  // state: `=`, `:`
-  // category: `=`, `:`
-  // external_uri: `=`, `:`
-  // event_time: `=`, `>`, `<`, `>=`, `<=`
+  // * name: `=`
+  // * parent: `=`, `:`
+  // * resource_name: `=`, `:`
+  // * state: `=`, `:`
+  // * category: `=`, `:`
+  // * external_uri: `=`, `:`
+  // * event_time: `=`, `>`, `<`, `>=`, `<=`
+  // * severity: `=`, `:`
   //
   //   Usage: This should be milliseconds since epoch or an RFC3339 string.
   //   Examples: