docs: updated description of finding severity field (#237)

* changes without context autosynth cannot find the source of changes triggered by earlier changes in this repository, or by version upgrades to tools such as linters. * docs: updated description of finding severity field PiperOrigin-RevId: 332497859 Source-Author: Google APIs <noreply@google.com> Source-Date: Fri Sep 18 12:02:05 2020 -0700 Source-Repo: googleapis/googleapis Source-Sha: 8d73f9486fc193a150f6c907dfb9f49431aff3ff Source-Link: googleapis/googleapis@8d73f94
googleapis · Sep 21, 2020 · 574b243 · 574b243
1 parent fcbc007
commit 574b243
Show file tree

Hide file tree

Showing 14 changed files with 452 additions and 414 deletions.
diff --git a/README.md b/README.md
@@ -17,7 +17,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>libraries-bom</artifactId>
-      <version>9.1.0</version>
+      <version>10.1.0</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>

diff --git a/...ycenter/src/main/java/com/google/cloud/securitycenter/v1p1beta1/SecurityCenterClient.java b/...ycenter/src/main/java/com/google/cloud/securitycenter/v1p1beta1/SecurityCenterClient.java
@@ -1164,7 +1164,7 @@ public final UnaryCallable<GroupAssetsRequest, GroupAssetsResponse> groupAssetsC
    *     (including `state_change`). The string value should follow SQL syntax: comma separated list
    *     of fields. For example: "parent,resource_name".
    *     <p>The following fields are supported:
-   *     <p>&#42; resource_name &#42; category &#42; state &#42; parent
+   *     <p>&#42; resource_name &#42; category &#42; state &#42; parent &#42; severity
    *     <p>The following fields are supported when compare_duration is set:
    *     <p>&#42; state_change
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails
@@ -1204,7 +1204,7 @@ public final GroupFindingsPagedResponse groupFindings(SourceName parent, String
    *     (including `state_change`). The string value should follow SQL syntax: comma separated list
    *     of fields. For example: "parent,resource_name".
    *     <p>The following fields are supported:
-   *     <p>&#42; resource_name &#42; category &#42; state &#42; parent
+   *     <p>&#42; resource_name &#42; category &#42; state &#42; parent &#42; severity
    *     <p>The following fields are supported when compare_duration is set:
    *     <p>&#42; state_change
    * @throws com.google.api.gax.rpc.ApiException if the remote call fails

diff --git a/.../main/java/com/google/cloud/securitycenter/v1p1beta1/CreateNotificationConfigRequest.java b/.../main/java/com/google/cloud/securitycenter/v1p1beta1/CreateNotificationConfigRequest.java
@@ -200,8 +200,7 @@ public com.google.protobuf.ByteString getParentBytes() {
    *
    *
    * <pre>
-   * 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.
    * </pre>
@@ -226,8 +225,7 @@ public java.lang.String getConfigId() {
    *
    *
    * <pre>
-   * 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.
    * </pre>
@@ -810,8 +808,7 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
      *
      *
      * <pre>
-     * 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.
      * </pre>
@@ -835,8 +832,7 @@ public java.lang.String getConfigId() {
      *
      *
      * <pre>
-     * 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.
      * </pre>
@@ -860,8 +856,7 @@ public com.google.protobuf.ByteString getConfigIdBytes() {
      *
      *
      * <pre>
-     * 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.
      * </pre>
@@ -884,8 +879,7 @@ public Builder setConfigId(java.lang.String value) {
      *
      *
      * <pre>
-     * 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.
      * </pre>
@@ -904,8 +898,7 @@ public Builder clearConfigId() {
      *
      *
      * <pre>
-     * 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.
      * </pre>

diff --git a/...a/com/google/cloud/securitycenter/v1p1beta1/CreateNotificationConfigRequestOrBuilder.java b/...a/com/google/cloud/securitycenter/v1p1beta1/CreateNotificationConfigRequestOrBuilder.java
@@ -58,8 +58,7 @@ public interface CreateNotificationConfigRequestOrBuilder
    *
    *
    * <pre>
-   * 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.
    * </pre>
@@ -73,8 +72,7 @@ public interface CreateNotificationConfigRequestOrBuilder
    *
    *
    * <pre>
-   * 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.
    * </pre>

diff --git a/...ritycenter-v1p1beta1/src/main/java/com/google/cloud/securitycenter/v1p1beta1/Finding.java b/...ritycenter-v1p1beta1/src/main/java/com/google/cloud/securitycenter/v1p1beta1/Finding.java
@@ -405,7 +405,8 @@ private State(int value) {
    *
    *
    * <pre>
-   * The severity of the finding.
+   * The severity of the finding. This field is managed by the source that
+   * writes the finding.
    * </pre>
    *
    * Protobuf enum {@code google.cloud.securitycenter.v1p1beta1.Finding.Severity}
@@ -1208,7 +1209,8 @@ public com.google.protobuf.TimestampOrBuilder getCreateTimeOrBuilder() {
    *
    *
    * <pre>
-   * The severity of the finding.
+   * The severity of the finding. This field is managed by the source that
+   * writes the finding.
    * </pre>
    *
    * <code>.google.cloud.securitycenter.v1p1beta1.Finding.Severity severity = 13;</code>
@@ -1223,7 +1225,8 @@ public int getSeverityValue() {
    *
    *
    * <pre>
-   * The severity of the finding.
+   * The severity of the finding. This field is managed by the source that
+   * writes the finding.
    * </pre>
    *
    * <code>.google.cloud.securitycenter.v1p1beta1.Finding.Severity severity = 13;</code>
@@ -3307,7 +3310,8 @@ public com.google.protobuf.TimestampOrBuilder getCreateTimeOrBuilder() {
      *
      *
      * <pre>
-     * The severity of the finding.
+     * The severity of the finding. This field is managed by the source that
+     * writes the finding.
      * </pre>
      *
      * <code>.google.cloud.securitycenter.v1p1beta1.Finding.Severity severity = 13;</code>
@@ -3322,7 +3326,8 @@ public int getSeverityValue() {
      *
      *
      * <pre>
-     * The severity of the finding.
+     * The severity of the finding. This field is managed by the source that
+     * writes the finding.
      * </pre>
      *
      * <code>.google.cloud.securitycenter.v1p1beta1.Finding.Severity severity = 13;</code>
@@ -3340,7 +3345,8 @@ public Builder setSeverityValue(int value) {
      *
      *
      * <pre>
-     * The severity of the finding.
+     * The severity of the finding. This field is managed by the source that
+     * writes the finding.
      * </pre>
      *
      * <code>.google.cloud.securitycenter.v1p1beta1.Finding.Severity severity = 13;</code>
@@ -3360,7 +3366,8 @@ public com.google.cloud.securitycenter.v1p1beta1.Finding.Severity getSeverity()
      *
      *
      * <pre>
-     * The severity of the finding.
+     * The severity of the finding. This field is managed by the source that
+     * writes the finding.
      * </pre>
      *
      * <code>.google.cloud.securitycenter.v1p1beta1.Finding.Severity severity = 13;</code>
@@ -3381,7 +3388,8 @@ public Builder setSeverity(com.google.cloud.securitycenter.v1p1beta1.Finding.Sev
      *
      *
      * <pre>
-     * The severity of the finding.
+     * The severity of the finding. This field is managed by the source that
+     * writes the finding.
      * </pre>
      *
      * <code>.google.cloud.securitycenter.v1p1beta1.Finding.Severity severity = 13;</code>

diff --git a/...r-v1p1beta1/src/main/java/com/google/cloud/securitycenter/v1p1beta1/FindingOrBuilder.java b/...r-v1p1beta1/src/main/java/com/google/cloud/securitycenter/v1p1beta1/FindingOrBuilder.java
@@ -408,7 +408,8 @@ com.google.protobuf.Value getSourcePropertiesOrDefault(
    *
    *
    * <pre>
-   * The severity of the finding.
+   * The severity of the finding. This field is managed by the source that
+   * writes the finding.
    * </pre>
    *
    * <code>.google.cloud.securitycenter.v1p1beta1.Finding.Severity severity = 13;</code>
@@ -420,7 +421,8 @@ com.google.protobuf.Value getSourcePropertiesOrDefault(
    *
    *
    * <pre>
-   * The severity of the finding.
+   * The severity of the finding. This field is managed by the source that
+   * writes the finding.
    * </pre>
    *
    * <code>.google.cloud.securitycenter.v1p1beta1.Finding.Severity severity = 13;</code>

diff --git a/...p1beta1/src/main/java/com/google/cloud/securitycenter/v1p1beta1/GroupFindingsRequest.java b/...p1beta1/src/main/java/com/google/cloud/securitycenter/v1p1beta1/GroupFindingsRequest.java
@@ -260,6 +260,7 @@ public com.google.protobuf.ByteString getParentBytes() {
    * * category: `=`, `:`
    * * external_uri: `=`, `:`
    * * event_time: `=`, `&gt;`, `&lt;`, `&gt;=`, `&lt;=`
+   * * severity: `=`, `:`
    *   Usage: This should be milliseconds since epoch or an RFC3339 string.
    *   Examples:
    *     `event_time = "2019-06-10T16:07:18-07:00"`
@@ -318,6 +319,7 @@ public java.lang.String getFilter() {
    * * category: `=`, `:`
    * * external_uri: `=`, `:`
    * * event_time: `=`, `&gt;`, `&lt;`, `&gt;=`, `&lt;=`
+   * * severity: `=`, `:`
    *   Usage: This should be milliseconds since epoch or an RFC3339 string.
    *   Examples:
    *     `event_time = "2019-06-10T16:07:18-07:00"`
@@ -362,6 +364,7 @@ public com.google.protobuf.ByteString getFilterBytes() {
    * * category
    * * state
    * * parent
+   * * severity
    * The following fields are supported when compare_duration is set:
    * * state_change
    * </pre>
@@ -394,6 +397,7 @@ public java.lang.String getGroupBy() {
    * * category
    * * state
    * * parent
+   * * severity
    * The following fields are supported when compare_duration is set:
    * * state_change
    * </pre>
@@ -1270,6 +1274,7 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) {
      * * category: `=`, `:`
      * * external_uri: `=`, `:`
      * * event_time: `=`, `&gt;`, `&lt;`, `&gt;=`, `&lt;=`
+     * * severity: `=`, `:`
      *   Usage: This should be milliseconds since epoch or an RFC3339 string.
      *   Examples:
      *     `event_time = "2019-06-10T16:07:18-07:00"`
@@ -1327,6 +1332,7 @@ public java.lang.String getFilter() {
      * * category: `=`, `:`
      * * external_uri: `=`, `:`
      * * event_time: `=`, `&gt;`, `&lt;`, `&gt;=`, `&lt;=`
+     * * severity: `=`, `:`
      *   Usage: This should be milliseconds since epoch or an RFC3339 string.
      *   Examples:
      *     `event_time = "2019-06-10T16:07:18-07:00"`
@@ -1384,6 +1390,7 @@ public com.google.protobuf.ByteString getFilterBytes() {
      * * category: `=`, `:`
      * * external_uri: `=`, `:`
      * * event_time: `=`, `&gt;`, `&lt;`, `&gt;=`, `&lt;=`
+     * * severity: `=`, `:`
      *   Usage: This should be milliseconds since epoch or an RFC3339 string.
      *   Examples:
      *     `event_time = "2019-06-10T16:07:18-07:00"`
@@ -1440,6 +1447,7 @@ public Builder setFilter(java.lang.String value) {
      * * category: `=`, `:`
      * * external_uri: `=`, `:`
      * * event_time: `=`, `&gt;`, `&lt;`, `&gt;=`, `&lt;=`
+     * * severity: `=`, `:`
      *   Usage: This should be milliseconds since epoch or an RFC3339 string.
      *   Examples:
      *     `event_time = "2019-06-10T16:07:18-07:00"`
@@ -1492,6 +1500,7 @@ public Builder clearFilter() {
      * * category: `=`, `:`
      * * external_uri: `=`, `:`
      * * event_time: `=`, `&gt;`, `&lt;`, `&gt;=`, `&lt;=`
+     * * severity: `=`, `:`
      *   Usage: This should be milliseconds since epoch or an RFC3339 string.
      *   Examples:
      *     `event_time = "2019-06-10T16:07:18-07:00"`
@@ -1534,6 +1543,7 @@ public Builder setFilterBytes(com.google.protobuf.ByteString value) {
      * * category
      * * state
      * * parent
+     * * severity
      * The following fields are supported when compare_duration is set:
      * * state_change
      * </pre>
@@ -1565,6 +1575,7 @@ public java.lang.String getGroupBy() {
      * * category
      * * state
      * * parent
+     * * severity
      * The following fields are supported when compare_duration is set:
      * * state_change
      * </pre>
@@ -1596,6 +1607,7 @@ public com.google.protobuf.ByteString getGroupByBytes() {
      * * category
      * * state
      * * parent
+     * * severity
      * The following fields are supported when compare_duration is set:
      * * state_change
      * </pre>
@@ -1626,6 +1638,7 @@ public Builder setGroupBy(java.lang.String value) {
      * * category
      * * state
      * * parent
+     * * severity
      * The following fields are supported when compare_duration is set:
      * * state_change
      * </pre>
@@ -1652,6 +1665,7 @@ public Builder clearGroupBy() {
      * * category
      * * state
      * * parent
+     * * severity
      * The following fields are supported when compare_duration is set:
      * * state_change
      * </pre>

diff --git a/...rc/main/java/com/google/cloud/securitycenter/v1p1beta1/GroupFindingsRequestOrBuilder.java b/...rc/main/java/com/google/cloud/securitycenter/v1p1beta1/GroupFindingsRequestOrBuilder.java
@@ -87,6 +87,7 @@ public interface GroupFindingsRequestOrBuilder
    * * category: `=`, `:`
    * * external_uri: `=`, `:`
    * * event_time: `=`, `&gt;`, `&lt;`, `&gt;=`, `&lt;=`
+   * * severity: `=`, `:`
    *   Usage: This should be milliseconds since epoch or an RFC3339 string.
    *   Examples:
    *     `event_time = "2019-06-10T16:07:18-07:00"`
@@ -134,6 +135,7 @@ public interface GroupFindingsRequestOrBuilder
    * * category: `=`, `:`
    * * external_uri: `=`, `:`
    * * event_time: `=`, `&gt;`, `&lt;`, `&gt;=`, `&lt;=`
+   * * severity: `=`, `:`
    *   Usage: This should be milliseconds since epoch or an RFC3339 string.
    *   Examples:
    *     `event_time = "2019-06-10T16:07:18-07:00"`
@@ -165,6 +167,7 @@ public interface GroupFindingsRequestOrBuilder
    * * category
    * * state
    * * parent
+   * * severity
    * The following fields are supported when compare_duration is set:
    * * state_change
    * </pre>
@@ -186,6 +189,7 @@ public interface GroupFindingsRequestOrBuilder
    * * category
    * * state
    * * parent
+   * * severity
    * The following fields are supported when compare_duration is set:
    * * state_change
    * </pre>