From 8313e78b3fa363068af9da4a2f43868bcb17e81d Mon Sep 17 00:00:00 2001 From: "gcf-owl-bot[bot]" <78513119+gcf-owl-bot[bot]@users.noreply.github.com> Date: Tue, 28 Nov 2023 10:28:08 -0500 Subject: [PATCH] docs: [securitycenter] Modify documentation of SimulateSecurityHealthAnalyticsCustomModuleRequest (#10075) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit * docs: Modify documentation of SimulateSecurityHealthAnalyticsCustomModuleRequest PiperOrigin-RevId: 584348542 Source-Link: https://github.com/googleapis/googleapis/commit/d2efcaad87da74c61c93d881da582e75b73a02dd Source-Link: https://github.com/googleapis/googleapis-gen/commit/6fb846a100194eada9f667417dd142da12e784b7 Copy-Tag: eyJwIjoiamF2YS1zZWN1cml0eWNlbnRlci8uT3dsQm90LnlhbWwiLCJoIjoiNmZiODQ2YTEwMDE5NGVhZGE5ZjY2NzQxN2RkMTQyZGExMmU3ODRiNyJ9 * 🦉 Updates from OwlBot post-processor See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md --------- Co-authored-by: Owl Bot --- java-securitycenter/README.md | 4 +- .../v1/SecurityCenterClient.java | 9 +- ...ityHealthAnalyticsCustomModuleRequest.java | 179 +++++++++--------- ...AnalyticsCustomModuleRequestOrBuilder.java | 22 +-- ...tyHealthAnalyticsCustomModuleResponse.java | 8 +- .../v1/securitycenter_service.proto | 27 +-- 6 files changed, 130 insertions(+), 119 deletions(-) diff --git a/java-securitycenter/README.md b/java-securitycenter/README.md index 8d3d6c381b3d..80abc2af418d 100644 --- a/java-securitycenter/README.md +++ b/java-securitycenter/README.md @@ -20,7 +20,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file: com.google.cloud libraries-bom - 26.25.0 + 26.27.0 pom import @@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates. [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html [stability-image]: https://img.shields.io/badge/stability-stable-green [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-securitycenter.svg -[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-securitycenter/2.36.0 +[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-securitycenter/2.38.0 [authentication]: https://github.com/googleapis/google-cloud-java#authentication [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles diff --git a/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1/SecurityCenterClient.java b/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1/SecurityCenterClient.java index 6219a9b9f7e1..30cd5128a1ec 100644 --- a/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1/SecurityCenterClient.java +++ b/java-securitycenter/google-cloud-securitycenter/src/main/java/com/google/cloud/securitycenter/v1/SecurityCenterClient.java @@ -5592,10 +5592,11 @@ public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsReq * } * } * - * @param parent Required. The relative resource name of the organization, project, or folder. - * See: https://cloud.google.com/apis/design/resource_names#relative_resource_name An example - * is: "organizations/{organization_id}". - * @param customConfig Required. The user specified custom configuration to test. + * @param parent 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}` + * @param customConfig Required. The custom configuration that you need to test. * @param resource Required. Resource data to simulate custom module against. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ diff --git a/java-securitycenter/proto-google-cloud-securitycenter-v1/src/main/java/com/google/cloud/securitycenter/v1/SimulateSecurityHealthAnalyticsCustomModuleRequest.java b/java-securitycenter/proto-google-cloud-securitycenter-v1/src/main/java/com/google/cloud/securitycenter/v1/SimulateSecurityHealthAnalyticsCustomModuleRequest.java index 25a77ee9f654..e222a1d78f24 100644 --- a/java-securitycenter/proto-google-cloud-securitycenter-v1/src/main/java/com/google/cloud/securitycenter/v1/SimulateSecurityHealthAnalyticsCustomModuleRequest.java +++ b/java-securitycenter/proto-google-cloud-securitycenter-v1/src/main/java/com/google/cloud/securitycenter/v1/SimulateSecurityHealthAnalyticsCustomModuleRequest.java @@ -77,7 +77,8 @@ public interface SimulatedResourceOrBuilder * * * 
-     * Required. The type of the resource, e.g. `compute.googleapis.com/Disk`.
+     * Required. The type of the resource, for example,
+     * `compute.googleapis.com/Disk`.
      *
* * string resource_type = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -89,7 +90,8 @@ public interface SimulatedResourceOrBuilder * * * 
-     * Required. The type of the resource, e.g. `compute.googleapis.com/Disk`.
+     * Required. The type of the resource, for example,
+     * `compute.googleapis.com/Disk`.
      *
* * string resource_type = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -102,8 +104,8 @@ public interface SimulatedResourceOrBuilder * * * 
-     * Optional. A representation of the GCP resource. Should match the GCP
-     * resource JSON format.
+     * Optional. A representation of the Google Cloud resource. Should match the
+     * Google Cloud resource JSON format.
      *
* * .google.protobuf.Struct resource_data = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -116,8 +118,8 @@ public interface SimulatedResourceOrBuilder * * * 
-     * Optional. A representation of the GCP resource. Should match the GCP
-     * resource JSON format.
+     * Optional. A representation of the Google Cloud resource. Should match the
+     * Google Cloud resource JSON format.
      *
* * .google.protobuf.Struct resource_data = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -130,8 +132,8 @@ public interface SimulatedResourceOrBuilder * * * 
-     * Optional. A representation of the GCP resource. Should match the GCP
-     * resource JSON format.
+     * Optional. A representation of the Google Cloud resource. Should match the
+     * Google Cloud resource JSON format.
      *
* * .google.protobuf.Struct resource_data = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -181,9 +183,9 @@ public interface SimulatedResourceOrBuilder * * * 
-   * Manually constructed resource. If the custom module only evaluates against
-   * the resource data, the iam_policy_data field can be omitted, and vice
-   * versa.
+   * Manually constructed resource name. If the custom module evaluates against
+   * only the resource data, you can omit the `iam_policy_data` field. If it
+   * evaluates only the `iam_policy_data` field, you can omit the resource data.
    *
* * Protobuf type {@code @@ -234,7 +236,8 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() { * * * 
-     * Required. The type of the resource, e.g. `compute.googleapis.com/Disk`.
+     * Required. The type of the resource, for example,
+     * `compute.googleapis.com/Disk`.
      *
* * string resource_type = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -257,7 +260,8 @@ public java.lang.String getResourceType() { * * * 
-     * Required. The type of the resource, e.g. `compute.googleapis.com/Disk`.
+     * Required. The type of the resource, for example,
+     * `compute.googleapis.com/Disk`.
      *
* * string resource_type = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -283,8 +287,8 @@ public com.google.protobuf.ByteString getResourceTypeBytes() { * * * 
-     * Optional. A representation of the GCP resource. Should match the GCP
-     * resource JSON format.
+     * Optional. A representation of the Google Cloud resource. Should match the
+     * Google Cloud resource JSON format.
      *
* * .google.protobuf.Struct resource_data = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -300,8 +304,8 @@ public boolean hasResourceData() { * * * 
-     * Optional. A representation of the GCP resource. Should match the GCP
-     * resource JSON format.
+     * Optional. A representation of the Google Cloud resource. Should match the
+     * Google Cloud resource JSON format.
      *
* * .google.protobuf.Struct resource_data = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -319,8 +323,8 @@ public com.google.protobuf.Struct getResourceData() { * * * 
-     * Optional. A representation of the GCP resource. Should match the GCP
-     * resource JSON format.
+     * Optional. A representation of the Google Cloud resource. Should match the
+     * Google Cloud resource JSON format.
      *
* * .google.protobuf.Struct resource_data = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -606,9 +610,9 @@ protected Builder newBuilderForType( * * * 
-     * Manually constructed resource. If the custom module only evaluates against
-     * the resource data, the iam_policy_data field can be omitted, and vice
-     * versa.
+     * Manually constructed resource name. If the custom module evaluates against
+     * only the resource data, you can omit the `iam_policy_data` field. If it
+     * evaluates only the `iam_policy_data` field, you can omit the resource data.
      *
* * Protobuf type {@code @@ -862,7 +866,8 @@ public Builder mergeFrom( * * * 
-       * Required. The type of the resource, e.g. `compute.googleapis.com/Disk`.
+       * Required. The type of the resource, for example,
+       * `compute.googleapis.com/Disk`.
        *
* * string resource_type = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -884,7 +889,8 @@ public java.lang.String getResourceType() { * * * 
-       * Required. The type of the resource, e.g. `compute.googleapis.com/Disk`.
+       * Required. The type of the resource, for example,
+       * `compute.googleapis.com/Disk`.
        *
* * string resource_type = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -906,7 +912,8 @@ public com.google.protobuf.ByteString getResourceTypeBytes() { * * * 
-       * Required. The type of the resource, e.g. `compute.googleapis.com/Disk`.
+       * Required. The type of the resource, for example,
+       * `compute.googleapis.com/Disk`.
        *
* * string resource_type = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -927,7 +934,8 @@ public Builder setResourceType(java.lang.String value) { * * * 
-       * Required. The type of the resource, e.g. `compute.googleapis.com/Disk`.
+       * Required. The type of the resource, for example,
+       * `compute.googleapis.com/Disk`.
        *
* * string resource_type = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -944,7 +952,8 @@ public Builder clearResourceType() { * * * 
-       * Required. The type of the resource, e.g. `compute.googleapis.com/Disk`.
+       * Required. The type of the resource, for example,
+       * `compute.googleapis.com/Disk`.
        *
* * string resource_type = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -973,8 +982,8 @@ public Builder setResourceTypeBytes(com.google.protobuf.ByteString value) { * * * 
-       * Optional. A representation of the GCP resource. Should match the GCP
-       * resource JSON format.
+       * Optional. A representation of the Google Cloud resource. Should match the
+       * Google Cloud resource JSON format.
        *
* * .google.protobuf.Struct resource_data = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -989,8 +998,8 @@ public boolean hasResourceData() { * * * 
-       * Optional. A representation of the GCP resource. Should match the GCP
-       * resource JSON format.
+       * Optional. A representation of the Google Cloud resource. Should match the
+       * Google Cloud resource JSON format.
        *
* * .google.protobuf.Struct resource_data = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -1011,8 +1020,8 @@ public com.google.protobuf.Struct getResourceData() { * * * 
-       * Optional. A representation of the GCP resource. Should match the GCP
-       * resource JSON format.
+       * Optional. A representation of the Google Cloud resource. Should match the
+       * Google Cloud resource JSON format.
        *
* * .google.protobuf.Struct resource_data = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -1035,8 +1044,8 @@ public Builder setResourceData(com.google.protobuf.Struct value) { * * * 
-       * Optional. A representation of the GCP resource. Should match the GCP
-       * resource JSON format.
+       * Optional. A representation of the Google Cloud resource. Should match the
+       * Google Cloud resource JSON format.
        *
* * .google.protobuf.Struct resource_data = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -1056,8 +1065,8 @@ public Builder setResourceData(com.google.protobuf.Struct.Builder builderForValu * * * 
-       * Optional. A representation of the GCP resource. Should match the GCP
-       * resource JSON format.
+       * Optional. A representation of the Google Cloud resource. Should match the
+       * Google Cloud resource JSON format.
        *
* * .google.protobuf.Struct resource_data = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -1083,8 +1092,8 @@ public Builder mergeResourceData(com.google.protobuf.Struct value) { * * * 
-       * Optional. A representation of the GCP resource. Should match the GCP
-       * resource JSON format.
+       * Optional. A representation of the Google Cloud resource. Should match the
+       * Google Cloud resource JSON format.
        *
* * .google.protobuf.Struct resource_data = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -1104,8 +1113,8 @@ public Builder clearResourceData() { * * * 
-       * Optional. A representation of the GCP resource. Should match the GCP
-       * resource JSON format.
+       * Optional. A representation of the Google Cloud resource. Should match the
+       * Google Cloud resource JSON format.
        *
* * .google.protobuf.Struct resource_data = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -1120,8 +1129,8 @@ public com.google.protobuf.Struct.Builder getResourceDataBuilder() { * * * 
-       * Optional. A representation of the GCP resource. Should match the GCP
-       * resource JSON format.
+       * Optional. A representation of the Google Cloud resource. Should match the
+       * Google Cloud resource JSON format.
        *
* * .google.protobuf.Struct resource_data = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -1140,8 +1149,8 @@ public com.google.protobuf.StructOrBuilder getResourceDataOrBuilder() { * * * 
-       * Optional. A representation of the GCP resource. Should match the GCP
-       * resource JSON format.
+       * Optional. A representation of the Google Cloud resource. Should match the
+       * Google Cloud resource JSON format.
        *
* * .google.protobuf.Struct resource_data = 2 [(.google.api.field_behavior) = OPTIONAL]; @@ -1437,10 +1446,10 @@ public com.google.protobuf.Parser getParserForType() { * * 
    * Required. The relative resource name of the organization, project, or
-   * folder. See:
-   * https://cloud.google.com/apis/design/resource_names#relative_resource_name
-   * An example is:
-   * "organizations/{organization_id}".
+   * 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}`
    *
* * string parent = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -1464,10 +1473,10 @@ public java.lang.String getParent() { * * 
    * Required. The relative resource name of the organization, project, or
-   * folder. See:
-   * https://cloud.google.com/apis/design/resource_names#relative_resource_name
-   * An example is:
-   * "organizations/{organization_id}".
+   * 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}`
    *
* * string parent = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -1493,7 +1502,7 @@ public com.google.protobuf.ByteString getParentBytes() { * * * 
-   * Required. The user specified custom configuration to test.
+   * Required. The custom configuration that you need to test.
    *
* * @@ -1510,7 +1519,7 @@ public boolean hasCustomConfig() { * * * 
-   * Required. The user specified custom configuration to test.
+   * Required. The custom configuration that you need to test.
    *
* * @@ -1529,7 +1538,7 @@ public com.google.cloud.securitycenter.v1.CustomConfig getCustomConfig() { * * * 
-   * Required. The user specified custom configuration to test.
+   * Required. The custom configuration that you need to test.
    *
* * @@ -2061,10 +2070,10 @@ public Builder mergeFrom( * * 
      * Required. The relative resource name of the organization, project, or
-     * folder. See:
-     * https://cloud.google.com/apis/design/resource_names#relative_resource_name
-     * An example is:
-     * "organizations/{organization_id}".
+     * 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}`
      *
* * string parent = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -2087,10 +2096,10 @@ public java.lang.String getParent() { * * 
      * Required. The relative resource name of the organization, project, or
-     * folder. See:
-     * https://cloud.google.com/apis/design/resource_names#relative_resource_name
-     * An example is:
-     * "organizations/{organization_id}".
+     * 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}`
      *
* * string parent = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -2113,10 +2122,10 @@ public com.google.protobuf.ByteString getParentBytes() { * * 
      * Required. The relative resource name of the organization, project, or
-     * folder. See:
-     * https://cloud.google.com/apis/design/resource_names#relative_resource_name
-     * An example is:
-     * "organizations/{organization_id}".
+     * 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}`
      *
* * string parent = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -2138,10 +2147,10 @@ public Builder setParent(java.lang.String value) { * * 
      * Required. The relative resource name of the organization, project, or
-     * folder. See:
-     * https://cloud.google.com/apis/design/resource_names#relative_resource_name
-     * An example is:
-     * "organizations/{organization_id}".
+     * 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}`
      *
* * string parent = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -2159,10 +2168,10 @@ public Builder clearParent() { * * 
      * Required. The relative resource name of the organization, project, or
-     * folder. See:
-     * https://cloud.google.com/apis/design/resource_names#relative_resource_name
-     * An example is:
-     * "organizations/{organization_id}".
+     * 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}`
      *
* * string parent = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -2191,7 +2200,7 @@ public Builder setParentBytes(com.google.protobuf.ByteString value) { * * * 
-     * Required. The user specified custom configuration to test.
+     * Required. The custom configuration that you need to test.
      *
* * @@ -2207,7 +2216,7 @@ public boolean hasCustomConfig() { * * * 
-     * Required. The user specified custom configuration to test.
+     * Required. The custom configuration that you need to test.
      *
* * @@ -2229,7 +2238,7 @@ public com.google.cloud.securitycenter.v1.CustomConfig getCustomConfig() { * * * 
-     * Required. The user specified custom configuration to test.
+     * Required. The custom configuration that you need to test.
      *
* * @@ -2253,7 +2262,7 @@ public Builder setCustomConfig(com.google.cloud.securitycenter.v1.CustomConfig v * * * 
-     * Required. The user specified custom configuration to test.
+     * Required. The custom configuration that you need to test.
      *
* * @@ -2275,7 +2284,7 @@ public Builder setCustomConfig( * * * 
-     * Required. The user specified custom configuration to test.
+     * Required. The custom configuration that you need to test.
      *
* * @@ -2303,7 +2312,7 @@ public Builder mergeCustomConfig(com.google.cloud.securitycenter.v1.CustomConfig * * * 
-     * Required. The user specified custom configuration to test.
+     * Required. The custom configuration that you need to test.
      *
* * @@ -2324,7 +2333,7 @@ public Builder clearCustomConfig() { * * * 
-     * Required. The user specified custom configuration to test.
+     * Required. The custom configuration that you need to test.
      *
* * @@ -2340,7 +2349,7 @@ public com.google.cloud.securitycenter.v1.CustomConfig.Builder getCustomConfigBu * * * 
-     * Required. The user specified custom configuration to test.
+     * Required. The custom configuration that you need to test.
      *
* * @@ -2360,7 +2369,7 @@ public com.google.cloud.securitycenter.v1.CustomConfigOrBuilder getCustomConfigO * * * 
-     * Required. The user specified custom configuration to test.
+     * Required. The custom configuration that you need to test.
      *
* * diff --git a/java-securitycenter/proto-google-cloud-securitycenter-v1/src/main/java/com/google/cloud/securitycenter/v1/SimulateSecurityHealthAnalyticsCustomModuleRequestOrBuilder.java b/java-securitycenter/proto-google-cloud-securitycenter-v1/src/main/java/com/google/cloud/securitycenter/v1/SimulateSecurityHealthAnalyticsCustomModuleRequestOrBuilder.java index 399b498ee384..9b34a85dbaa5 100644 --- a/java-securitycenter/proto-google-cloud-securitycenter-v1/src/main/java/com/google/cloud/securitycenter/v1/SimulateSecurityHealthAnalyticsCustomModuleRequestOrBuilder.java +++ b/java-securitycenter/proto-google-cloud-securitycenter-v1/src/main/java/com/google/cloud/securitycenter/v1/SimulateSecurityHealthAnalyticsCustomModuleRequestOrBuilder.java @@ -28,10 +28,10 @@ public interface SimulateSecurityHealthAnalyticsCustomModuleRequestOrBuilder * * 
    * Required. The relative resource name of the organization, project, or
-   * folder. See:
-   * https://cloud.google.com/apis/design/resource_names#relative_resource_name
-   * An example is:
-   * "organizations/{organization_id}".
+   * 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}`
    *
* * string parent = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -44,10 +44,10 @@ public interface SimulateSecurityHealthAnalyticsCustomModuleRequestOrBuilder * * 
    * Required. The relative resource name of the organization, project, or
-   * folder. See:
-   * https://cloud.google.com/apis/design/resource_names#relative_resource_name
-   * An example is:
-   * "organizations/{organization_id}".
+   * 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}`
    *
* * string parent = 1 [(.google.api.field_behavior) = REQUIRED]; @@ -60,7 +60,7 @@ public interface SimulateSecurityHealthAnalyticsCustomModuleRequestOrBuilder * * * 
-   * Required. The user specified custom configuration to test.
+   * Required. The custom configuration that you need to test.
    *
* * @@ -74,7 +74,7 @@ public interface SimulateSecurityHealthAnalyticsCustomModuleRequestOrBuilder * * * 
-   * Required. The user specified custom configuration to test.
+   * Required. The custom configuration that you need to test.
    *
* * @@ -88,7 +88,7 @@ public interface SimulateSecurityHealthAnalyticsCustomModuleRequestOrBuilder * * * 
-   * Required. The user specified custom configuration to test.
+   * Required. The custom configuration that you need to test.
    *
* * diff --git a/java-securitycenter/proto-google-cloud-securitycenter-v1/src/main/java/com/google/cloud/securitycenter/v1/SimulateSecurityHealthAnalyticsCustomModuleResponse.java b/java-securitycenter/proto-google-cloud-securitycenter-v1/src/main/java/com/google/cloud/securitycenter/v1/SimulateSecurityHealthAnalyticsCustomModuleResponse.java index 314755c282ae..d71dc9b8c31c 100644 --- a/java-securitycenter/proto-google-cloud-securitycenter-v1/src/main/java/com/google/cloud/securitycenter/v1/SimulateSecurityHealthAnalyticsCustomModuleResponse.java +++ b/java-securitycenter/proto-google-cloud-securitycenter-v1/src/main/java/com/google/cloud/securitycenter/v1/SimulateSecurityHealthAnalyticsCustomModuleResponse.java @@ -22,8 +22,8 @@ * * * 
- * Response message for simulating a SecurityHealthAnalyticsCustomModule against
- * a given resource.
+ * Response message for simulating a `SecurityHealthAnalyticsCustomModule`
+ * against a given resource.
  *
* * Protobuf type {@code @@ -1904,8 +1904,8 @@ protected Builder newBuilderForType(com.google.protobuf.GeneratedMessageV3.Build * * * 
-   * Response message for simulating a SecurityHealthAnalyticsCustomModule against
-   * a given resource.
+   * Response message for simulating a `SecurityHealthAnalyticsCustomModule`
+   * against a given resource.
    *
* * Protobuf type {@code diff --git a/java-securitycenter/proto-google-cloud-securitycenter-v1/src/main/proto/google/cloud/securitycenter/v1/securitycenter_service.proto b/java-securitycenter/proto-google-cloud-securitycenter-v1/src/main/proto/google/cloud/securitycenter/v1/securitycenter_service.proto index 78c20386be2b..11ae0a2813ad 100644 --- a/java-securitycenter/proto-google-cloud-securitycenter-v1/src/main/proto/google/cloud/securitycenter/v1/securitycenter_service.proto +++ b/java-securitycenter/proto-google-cloud-securitycenter-v1/src/main/proto/google/cloud/securitycenter/v1/securitycenter_service.proto @@ -2054,15 +2054,16 @@ message RunAssetDiscoveryRequest { // Request message to simulate a CustomConfig against a given test resource. // Maximum size of the request is 4 MB by default. message SimulateSecurityHealthAnalyticsCustomModuleRequest { - // Manually constructed resource. If the custom module only evaluates against - // the resource data, the iam_policy_data field can be omitted, and vice - // versa. + // Manually constructed resource name. If the custom module evaluates against + // only the resource data, you can omit the `iam_policy_data` field. If it + // evaluates only the `iam_policy_data` field, you can omit the resource data. message SimulatedResource { - // Required. The type of the resource, e.g. `compute.googleapis.com/Disk`. + // Required. The type of the resource, for example, + // `compute.googleapis.com/Disk`. string resource_type = 1 [(google.api.field_behavior) = REQUIRED]; - // Optional. A representation of the GCP resource. Should match the GCP - // resource JSON format. + // Optional. A representation of the Google Cloud resource. Should match the + // Google Cloud resource JSON format. google.protobuf.Struct resource_data = 2 [(google.api.field_behavior) = OPTIONAL]; @@ -2072,21 +2073,21 @@ message SimulateSecurityHealthAnalyticsCustomModuleRequest { } // Required. The relative resource name of the organization, project, or - // folder. See: - // https://cloud.google.com/apis/design/resource_names#relative_resource_name - // An example is: - // "organizations/{organization_id}". + // 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}` string parent = 1 [(google.api.field_behavior) = REQUIRED]; - // Required. The user specified custom configuration to test. + // Required. The custom configuration that you need to test. CustomConfig custom_config = 2 [(google.api.field_behavior) = REQUIRED]; // Required. Resource data to simulate custom module against. SimulatedResource resource = 3 [(google.api.field_behavior) = REQUIRED]; } -// Response message for simulating a SecurityHealthAnalyticsCustomModule against -// a given resource. +// Response message for simulating a `SecurityHealthAnalyticsCustomModule` +// against a given resource. message SimulateSecurityHealthAnalyticsCustomModuleResponse { // Possible test result. message SimulatedResult {