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:
- * 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 {