diff --git a/.githooks/pre-commit b/.githooks/pre-commit index 1f6b58e4be..bfdab324ea 100755 --- a/.githooks/pre-commit +++ b/.githooks/pre-commit @@ -177,6 +177,21 @@ then fi fi +# Check integration tests. +if [ $NUM_JAVA_FILES_CHANGED -gt 0 ] \ + || [ $NUM_INTEGRATION_GOLDEN_FILES_CHANGED -gt 0 ] \ + || [ $NUM_INTEGRATION_BAZEL_FILES_CHANGED -gt 0 ] +then + echo_status "Checking integration tests..." + bazel --batch test --disk_cache="$BAZEL_CACHE_DIR" //test/integration/... + TEST_STATUS=$? + if [ $TEST_STATUS != 0 ] + then + echo_error "Tests failed." "Please fix them and try again." + exit 1 + fi +fi + # Check and fix Bazel format. if [ $NUM_BAZEL_FILES_CHANGED -gt 0 ] then diff --git a/src/main/java/com/google/api/generator/engine/ast/JavaDocComment.java b/src/main/java/com/google/api/generator/engine/ast/JavaDocComment.java index 7b3dc48729..804cf1c0ca 100644 --- a/src/main/java/com/google/api/generator/engine/ast/JavaDocComment.java +++ b/src/main/java/com/google/api/generator/engine/ast/JavaDocComment.java @@ -22,6 +22,7 @@ import java.util.Arrays; import java.util.List; import java.util.stream.Collectors; +import java.util.stream.Stream; @AutoValue public abstract class JavaDocComment implements Comment { @@ -44,6 +45,8 @@ public void accept(AstNodeVisitor visitor) { @AutoValue.Builder public abstract static class Builder { + static final String PARAM_INDENT = " "; + // The lack of a getter for these local variables in the external class is WAI. String throwsType = null; String throwsDescription = null; @@ -67,7 +70,7 @@ public Builder setDeprecated(String deprecatedText) { } public Builder addParam(String name, String description) { - paramsList.add(String.format("@param %s %s", name, description)); + paramsList.add(String.format("@param %s %s", name, processParamComment(description))); return this; } @@ -135,5 +138,42 @@ public JavaDocComment build() { setComment(String.join("\n", componentsList)); return autoBuild(); } + + // TODO(miraleung): Refactor param paragraph parsing to be more robust. + private static String processParamComment(String rawComment) { + StringBuilder processedCommentBuilder = new StringBuilder(); + String[] descriptionParagraphs = rawComment.split("\\n\\n"); + for (int i = 0; i < descriptionParagraphs.length; i++) { + boolean startsWithItemizedList = descriptionParagraphs[i].startsWith(" * "); + // Split by listed items, then join newlines. + List listItems = + Stream.of(descriptionParagraphs[i].split("\\n \\*")) + .map(s -> s.replace("\n", "")) + .collect(Collectors.toList()); + if (startsWithItemizedList) { + // Remove the first asterisk. + listItems.set(0, listItems.get(0).substring(2)); + } + if (!startsWithItemizedList) { + if (i == 0) { + processedCommentBuilder.append(String.format("%s", listItems.get(0))); + } else { + processedCommentBuilder.append( + String.format("%s

%s", PARAM_INDENT, listItems.get(0))); + } + } + if (listItems.size() > 1 || startsWithItemizedList) { + processedCommentBuilder.append( + String.format( + "%s

", + PARAM_INDENT, + listItems.subList(startsWithItemizedList ? 0 : 1, listItems.size()).stream() + .map(li -> String.format("%s
  • %s", PARAM_INDENT, li)) + .reduce("", String::concat), + PARAM_INDENT)); + } + } + return processedCommentBuilder.toString(); + } } } diff --git a/src/main/java/com/google/api/generator/engine/escaper/MetacharEscaper.java b/src/main/java/com/google/api/generator/engine/escaper/MetacharEscaper.java index 948c257ae4..3b4a1943fb 100644 --- a/src/main/java/com/google/api/generator/engine/escaper/MetacharEscaper.java +++ b/src/main/java/com/google/api/generator/engine/escaper/MetacharEscaper.java @@ -29,7 +29,6 @@ public class MetacharEscaper extends Escaper { .addEscape('\b', "\\b") .addEscape('\r', "\\r") .addEscape('\f', "\\f") - .addEscape('\n', "\\n") .addEscape('\\', "\\\\") .build(); diff --git a/src/main/java/com/google/api/generator/gapic/composer/ServiceClientCommentComposer.java b/src/main/java/com/google/api/generator/gapic/composer/ServiceClientCommentComposer.java index d36f6c3ac6..1a0f8f2b0f 100644 --- a/src/main/java/com/google/api/generator/gapic/composer/ServiceClientCommentComposer.java +++ b/src/main/java/com/google/api/generator/gapic/composer/ServiceClientCommentComposer.java @@ -169,9 +169,7 @@ static List createRpcMethodHeaderComment( for (MethodArgument argument : methodArguments) { // TODO(miraleung): Remove the newline replacement when we support CommonMark. String description = - argument.field().hasDescription() - ? argument.field().description().replace("\n", "") - : EMPTY_STRING; + argument.field().hasDescription() ? argument.field().description() : EMPTY_STRING; methodJavadocBuilder.addParam(argument.name(), description); } } diff --git a/src/test/java/com/google/api/generator/engine/ast/JavaDocCommentTest.java b/src/test/java/com/google/api/generator/engine/ast/JavaDocCommentTest.java index 6d6d9649b9..df72d8531f 100644 --- a/src/test/java/com/google/api/generator/engine/ast/JavaDocCommentTest.java +++ b/src/test/java/com/google/api/generator/engine/ast/JavaDocCommentTest.java @@ -37,14 +37,18 @@ public void createJavaDocComment_specialCharacter() { .addComment("Service comment may include special characters: \\ \t\b\r&\"\f\n`'@*/") .addParagraph("title: GetBigBook: ") .addSampleCode( - "ApiFuture future = libraryClient.createShelfCallable().futureCall(request);") + "ApiFuture future =" + + " libraryClient.createShelfCallable().futureCall(request);") .setThrows("Exception", "This is an exception.") .build(); String expected = - "Service comment may include special characters: \\\\ \\t\\b\\r&\"\\f\\n`'{@literal @}*/\n" + "Service comment may include special characters: \\\\ \\t\\b\\r" + + "&\"\\f\n" + + "`'{@literal @}*/\n" + "

    title: GetBigBook: \n" + "

    \n"
    -            + "ApiFuture<Shelf> future = libraryClient.createShelfCallable().futureCall(request);\n"
    +            + "ApiFuture<Shelf> future ="
    +            + " libraryClient.createShelfCallable().futureCall(request);\n"
                 + "
    \n" + "@throws Exception This is an exception."; assertEquals(javaDocComment.comment(), expected); diff --git a/src/test/java/com/google/api/generator/engine/writer/JavaWriterVisitorTest.java b/src/test/java/com/google/api/generator/engine/writer/JavaWriterVisitorTest.java index 10a08f6811..dac3d20756 100644 --- a/src/test/java/com/google/api/generator/engine/writer/JavaWriterVisitorTest.java +++ b/src/test/java/com/google/api/generator/engine/writer/JavaWriterVisitorTest.java @@ -595,8 +595,8 @@ public void writeLineComment_specialChar() { String expected = "// usage: gradle run -PmainClass=com.google.example.examples.library.v1.Hopper" + " [--args='[--shelf\n" - + "// \"Novel\\\\\"`\\b\\t\\n" - + "\\r" + + "// \"Novel\\\\\"`\\b\\t\n" + + "// \\r" + "\"]']\n"; lineComment.accept(writerVisitor); assertEquals(writerVisitor.write(), expected); diff --git a/test/integration/goldens/asset/AssetServiceClient.java b/test/integration/goldens/asset/AssetServiceClient.java index 9c2ed0b961..8ddd807279 100644 --- a/test/integration/goldens/asset/AssetServiceClient.java +++ b/test/integration/goldens/asset/AssetServiceClient.java @@ -473,10 +473,15 @@ public final UnaryCallable deleteFeedCallable() { * @param scope Required. A scope can be a project, a folder, or an organization. The search is * limited to the resources within the `scope`. The caller must be granted the * [`cloudasset.assets.searchAllResources`](http://cloud.google.com/asset-inventory/docs/access-control#required_permissions) - * permission on the desired scope. The allowed values are: * projects/{PROJECT_ID} (e.g., - * "projects/foo-bar") * projects/{PROJECT_NUMBER} (e.g., "projects/12345678") * - * folders/{FOLDER_NUMBER} (e.g., "folders/1234567") * organizations/{ORGANIZATION_NUMBER} - * (e.g., "organizations/123456") + * permission on the desired scope. + *

    The allowed values are: + *

      + *
    • projects/{PROJECT_ID} (e.g., "projects/foo-bar") + *
    • projects/{PROJECT_NUMBER} (e.g., "projects/12345678") + *
    • folders/{FOLDER_NUMBER} (e.g., "folders/1234567") + *
    • organizations/{ORGANIZATION_NUMBER} (e.g., "organizations/123456") + *
    + * * @param query Optional. The query statement. See [how to construct a * query](http://cloud.google.com/asset-inventory/docs/searching-resources#how_to_construct_a_query) * for more information. If not specified or empty, it will search all the resources within @@ -484,20 +489,31 @@ public final UnaryCallable deleteFeedCallable() { * binding, including its members, roles, and Cloud IAM conditions. The returned Cloud IAM * policies will only contain the bindings that match your query. To learn more about the IAM * policy structure, see [IAM policy - * doc](https://cloud.google.com/iam/docs/policies#structure). Examples: * `name:Important` to - * find Cloud resources whose name contains "Important" as a word. * `displayName:Impor*` to - * find Cloud resources whose display name contains "Impor" as a prefix. * `description:*por*` - * to find Cloud resources whose description contains "por" as a substring. * - * `location:us-west*` to find Cloud resources whose location is prefixed with "us-west". * - * `labels:prod` to find Cloud resources whose labels contain "prod" as a key or value. * - * `labels.env:prod` to find Cloud resources that have a label "env" and its value is "prod". - * * `labels.env:*` to find Cloud resources that have a label "env". * `Important` to find - * Cloud resources that contain "Important" as a word in any of the searchable fields. * - * `Impor*` to find Cloud resources that contain "Impor" as a prefix in any of the searchable - * fields. * `*por*` to find Cloud resources that contain "por" as a substring in any of the - * searchable fields. * `Important location:(us-west1 OR global)` to find Cloud resources that - * contain "Important" as a word in any of the searchable fields and are also located in the - * "us-west1" region or the "global" location. + * doc](https://cloud.google.com/iam/docs/policies#structure). + *

    Examples: + *

      + *
    • `name:Important` to find Cloud resources whose name contains "Important" as a word. + *
    • `displayName:Impor*` to find Cloud resources whose display name contains "Impor" as a + * prefix. + *
    • `description:*por*` to find Cloud resources whose description contains "por" as a + * substring. + *
    • `location:us-west*` to find Cloud resources whose location is prefixed with + * "us-west". + *
    • `labels:prod` to find Cloud resources whose labels contain "prod" as a key or value. + *
    • `labels.env:prod` to find Cloud resources that have a label "env" and its value is + * "prod". + *
    • `labels.env:*` to find Cloud resources that have a label "env". + *
    • `Important` to find Cloud resources that contain "Important" as a word in any of the + * searchable fields. + *
    • `Impor*` to find Cloud resources that contain "Impor" as a prefix in any of the + * searchable fields. + *
    • `*por*` to find Cloud resources that contain "por" as a substring in any of the + * searchable fields. + *
    • `Important location:(us-west1 OR global)` to find Cloud resources that contain + * "Important" as a word in any of the searchable fields and are also located in the + * "us-west1" region or the "global" location. + *
    + * * @param asset_types Optional. A list of asset types that this request searches for. If empty, it * will search all the [searchable asset * types](https://cloud.google.com/asset-inventory/docs/supported-asset-types#searchable_asset_types). @@ -567,26 +583,38 @@ public final SearchAllResourcesPagedResponse searchAllResources( * @param scope Required. A scope can be a project, a folder, or an organization. The search is * limited to the IAM policies within the `scope`. The caller must be granted the * [`cloudasset.assets.searchAllIamPolicies`](http://cloud.google.com/asset-inventory/docs/access-control#required_permissions) - * permission on the desired scope. The allowed values are: * projects/{PROJECT_ID} (e.g., - * "projects/foo-bar") * projects/{PROJECT_NUMBER} (e.g., "projects/12345678") * - * folders/{FOLDER_NUMBER} (e.g., "folders/1234567") * organizations/{ORGANIZATION_NUMBER} - * (e.g., "organizations/123456") + * permission on the desired scope. + *

    The allowed values are: + *

      + *
    • projects/{PROJECT_ID} (e.g., "projects/foo-bar") + *
    • projects/{PROJECT_NUMBER} (e.g., "projects/12345678") + *
    • folders/{FOLDER_NUMBER} (e.g., "folders/1234567") + *
    • organizations/{ORGANIZATION_NUMBER} (e.g., "organizations/123456") + *
    + * * @param query Optional. The query statement. See [how to construct a * query](https://cloud.google.com/asset-inventory/docs/searching-iam-policies#how_to_construct_a_query) * for more information. If not specified or empty, it will search all the IAM policies within - * the specified `scope`. Examples: * `policy:amy@gmail.com` to find IAM policy bindings that - * specify user "amy@gmail.com". * `policy:roles/compute.admin` to find IAM policy bindings - * that specify the Compute Admin role. * `policy.role.permissions:storage.buckets.update` to - * find IAM policy bindings that specify a role containing "storage.buckets.update" - * permission. Note that if callers don't have `iam.roles.get` access to a role's included - * permissions, policy bindings that specify this role will be dropped from the search - * results. * `resource:organizations/123456` to find IAM policy bindings that are set on - * "organizations/123456". * `Important` to find IAM policy bindings that contain "Important" - * as a word in any of the searchable fields (except for the included permissions). * `*por*` - * to find IAM policy bindings that contain "por" as a substring in any of the searchable - * fields (except for the included permissions). * `resource:(instance1 OR instance2) - * policy:amy` to find IAM policy bindings that are set on resources "instance1" or - * "instance2" and also specify user "amy". + * the specified `scope`. + *

    Examples: + *

      + *
    • `policy:amy@gmail.com` to find IAM policy bindings that specify user "amy@gmail.com". + *
    • `policy:roles/compute.admin` to find IAM policy bindings that specify the Compute + * Admin role. + *
    • `policy.role.permissions:storage.buckets.update` to find IAM policy bindings that + * specify a role containing "storage.buckets.update" permission. Note that if callers + * don't have `iam.roles.get` access to a role's included permissions, policy bindings + * that specify this role will be dropped from the search results. + *
    • `resource:organizations/123456` to find IAM policy bindings that are set on + * "organizations/123456". + *
    • `Important` to find IAM policy bindings that contain "Important" as a word in any of + * the searchable fields (except for the included permissions). + *
    • `*por*` to find IAM policy bindings that contain "por" as a substring in any of the + * searchable fields (except for the included permissions). + *
    • `resource:(instance1 OR instance2) policy:amy` to find IAM policy bindings that are + * set on resources "instance1" or "instance2" and also specify user "amy". + *
    + * * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final SearchAllIamPoliciesPagedResponse searchAllIamPolicies(String scope, String query) { diff --git a/test/integration/goldens/logging/ConfigServiceV2Client.java b/test/integration/goldens/logging/ConfigServiceV2Client.java index bfecf0d814..b6516172fc 100644 --- a/test/integration/goldens/logging/ConfigServiceV2Client.java +++ b/test/integration/goldens/logging/ConfigServiceV2Client.java @@ -136,12 +136,12 @@ public ConfigServiceV2Stub getStub() { *

    Sample code: * * @param parent Required. The parent resource whose buckets are to be listed: - * "projects/[PROJECT_ID]/locations/[LOCATION_ID]" + *

    "projects/[PROJECT_ID]/locations/[LOCATION_ID]" * "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]" - * "folders/[FOLDER_ID]/locations/[LOCATION_ID]" Note: The locations portion of the resource - * must be specified, but supplying the character `-` in place of [LOCATION_ID] will return - * all buckets. + * "folders/[FOLDER_ID]/locations/[LOCATION_ID]" + *

    Note: The locations portion of the resource must be specified, but supplying the + * character `-` in place of [LOCATION_ID] will return all buckets. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ListBucketsPagedResponse listBuckets(BillingAccountLocationName parent) { @@ -159,12 +159,12 @@ public final ListBucketsPagedResponse listBuckets(BillingAccountLocationName par *

    Sample code: * * @param parent Required. The parent resource whose buckets are to be listed: - * "projects/[PROJECT_ID]/locations/[LOCATION_ID]" + *

    "projects/[PROJECT_ID]/locations/[LOCATION_ID]" * "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]" - * "folders/[FOLDER_ID]/locations/[LOCATION_ID]" Note: The locations portion of the resource - * must be specified, but supplying the character `-` in place of [LOCATION_ID] will return - * all buckets. + * "folders/[FOLDER_ID]/locations/[LOCATION_ID]" + *

    Note: The locations portion of the resource must be specified, but supplying the + * character `-` in place of [LOCATION_ID] will return all buckets. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ListBucketsPagedResponse listBuckets(FolderLocationName parent) { @@ -182,12 +182,12 @@ public final ListBucketsPagedResponse listBuckets(FolderLocationName parent) { *

    Sample code: * * @param parent Required. The parent resource whose buckets are to be listed: - * "projects/[PROJECT_ID]/locations/[LOCATION_ID]" + *

    "projects/[PROJECT_ID]/locations/[LOCATION_ID]" * "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]" - * "folders/[FOLDER_ID]/locations/[LOCATION_ID]" Note: The locations portion of the resource - * must be specified, but supplying the character `-` in place of [LOCATION_ID] will return - * all buckets. + * "folders/[FOLDER_ID]/locations/[LOCATION_ID]" + *

    Note: The locations portion of the resource must be specified, but supplying the + * character `-` in place of [LOCATION_ID] will return all buckets. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ListBucketsPagedResponse listBuckets(LocationName parent) { @@ -205,12 +205,12 @@ public final ListBucketsPagedResponse listBuckets(LocationName parent) { *

    Sample code: * * @param parent Required. The parent resource whose buckets are to be listed: - * "projects/[PROJECT_ID]/locations/[LOCATION_ID]" + *

    "projects/[PROJECT_ID]/locations/[LOCATION_ID]" * "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]" - * "folders/[FOLDER_ID]/locations/[LOCATION_ID]" Note: The locations portion of the resource - * must be specified, but supplying the character `-` in place of [LOCATION_ID] will return - * all buckets. + * "folders/[FOLDER_ID]/locations/[LOCATION_ID]" + *

    Note: The locations portion of the resource must be specified, but supplying the + * character `-` in place of [LOCATION_ID] will return all buckets. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ListBucketsPagedResponse listBuckets(OrganizationLocationName parent) { @@ -228,12 +228,12 @@ public final ListBucketsPagedResponse listBuckets(OrganizationLocationName paren *

    Sample code: * * @param parent Required. The parent resource whose buckets are to be listed: - * "projects/[PROJECT_ID]/locations/[LOCATION_ID]" + *

    "projects/[PROJECT_ID]/locations/[LOCATION_ID]" * "organizations/[ORGANIZATION_ID]/locations/[LOCATION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/locations/[LOCATION_ID]" - * "folders/[FOLDER_ID]/locations/[LOCATION_ID]" Note: The locations portion of the resource - * must be specified, but supplying the character `-` in place of [LOCATION_ID] will return - * all buckets. + * "folders/[FOLDER_ID]/locations/[LOCATION_ID]" + *

    Note: The locations portion of the resource must be specified, but supplying the + * character `-` in place of [LOCATION_ID] will return all buckets. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ListBucketsPagedResponse listBuckets(String parent) { @@ -346,7 +346,7 @@ public final UnaryCallable updateBucketCallable( *

    Sample code: * * @param parent Required. The parent resource whose sinks are to be listed: - * "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -365,7 +365,7 @@ public final ListSinksPagedResponse listSinks(BillingAccountName parent) { *

    Sample code: * * @param parent Required. The parent resource whose sinks are to be listed: - * "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -384,7 +384,7 @@ public final ListSinksPagedResponse listSinks(FolderName parent) { *

    Sample code: * * @param parent Required. The parent resource whose sinks are to be listed: - * "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -403,7 +403,7 @@ public final ListSinksPagedResponse listSinks(OrganizationName parent) { *

    Sample code: * * @param parent Required. The parent resource whose sinks are to be listed: - * "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -422,7 +422,7 @@ public final ListSinksPagedResponse listSinks(ProjectName parent) { *

    Sample code: * * @param parent Required. The parent resource whose sinks are to be listed: - * "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -471,9 +471,11 @@ public final UnaryCallable listSinksCallabl *

    Sample code: * * @param sink_name Required. The resource name of the sink: - * "projects/[PROJECT_ID]/sinks/[SINK_ID]" "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" + *

    "projects/[PROJECT_ID]/sinks/[SINK_ID]" + * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - * "folders/[FOLDER_ID]/sinks/[SINK_ID]" Example: `"projects/my-project-id/sinks/my-sink-id"`. + * "folders/[FOLDER_ID]/sinks/[SINK_ID]" + *

    Example: `"projects/my-project-id/sinks/my-sink-id"`. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final LogSink getSink(LogSinkName sinkName) { @@ -491,9 +493,11 @@ public final LogSink getSink(LogSinkName sinkName) { *

    Sample code: * * @param sink_name Required. The resource name of the sink: - * "projects/[PROJECT_ID]/sinks/[SINK_ID]" "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" + *

    "projects/[PROJECT_ID]/sinks/[SINK_ID]" + * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - * "folders/[FOLDER_ID]/sinks/[SINK_ID]" Example: `"projects/my-project-id/sinks/my-sink-id"`. + * "folders/[FOLDER_ID]/sinks/[SINK_ID]" + *

    Example: `"projects/my-project-id/sinks/my-sink-id"`. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final LogSink getSink(String sinkName) { @@ -533,10 +537,10 @@ public final UnaryCallable getSinkCallable() { * *

    Sample code: * - * @param parent Required. The resource in which to create the sink: "projects/[PROJECT_ID]" - * "organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" - * "folders/[FOLDER_ID]" Examples: `"projects/my-logging-project"`, - * `"organizations/123456789"`. + * @param parent Required. The resource in which to create the sink: + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" + *

    Examples: `"projects/my-logging-project"`, `"organizations/123456789"`. * @param sink Required. The new sink, whose `name` parameter is a sink identifier that is not * already in use. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -559,10 +563,10 @@ public final LogSink createSink(BillingAccountName parent, LogSink sink) { * *

    Sample code: * - * @param parent Required. The resource in which to create the sink: "projects/[PROJECT_ID]" - * "organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" - * "folders/[FOLDER_ID]" Examples: `"projects/my-logging-project"`, - * `"organizations/123456789"`. + * @param parent Required. The resource in which to create the sink: + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" + *

    Examples: `"projects/my-logging-project"`, `"organizations/123456789"`. * @param sink Required. The new sink, whose `name` parameter is a sink identifier that is not * already in use. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -585,10 +589,10 @@ public final LogSink createSink(FolderName parent, LogSink sink) { * *

    Sample code: * - * @param parent Required. The resource in which to create the sink: "projects/[PROJECT_ID]" - * "organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" - * "folders/[FOLDER_ID]" Examples: `"projects/my-logging-project"`, - * `"organizations/123456789"`. + * @param parent Required. The resource in which to create the sink: + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" + *

    Examples: `"projects/my-logging-project"`, `"organizations/123456789"`. * @param sink Required. The new sink, whose `name` parameter is a sink identifier that is not * already in use. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -611,10 +615,10 @@ public final LogSink createSink(OrganizationName parent, LogSink sink) { * *

    Sample code: * - * @param parent Required. The resource in which to create the sink: "projects/[PROJECT_ID]" - * "organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" - * "folders/[FOLDER_ID]" Examples: `"projects/my-logging-project"`, - * `"organizations/123456789"`. + * @param parent Required. The resource in which to create the sink: + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" + *

    Examples: `"projects/my-logging-project"`, `"organizations/123456789"`. * @param sink Required. The new sink, whose `name` parameter is a sink identifier that is not * already in use. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -637,10 +641,10 @@ public final LogSink createSink(ProjectName parent, LogSink sink) { * *

    Sample code: * - * @param parent Required. The resource in which to create the sink: "projects/[PROJECT_ID]" - * "organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" - * "folders/[FOLDER_ID]" Examples: `"projects/my-logging-project"`, - * `"organizations/123456789"`. + * @param parent Required. The resource in which to create the sink: + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" + *

    Examples: `"projects/my-logging-project"`, `"organizations/123456789"`. * @param sink Required. The new sink, whose `name` parameter is a sink identifier that is not * already in use. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -691,10 +695,12 @@ public final UnaryCallable createSinkCallable() { *

    Sample code: * * @param sink_name Required. The full resource name of the sink to update, including the parent - * resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" + * resource and the sink identifier: + *

    "projects/[PROJECT_ID]/sinks/[SINK_ID]" * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - * "folders/[FOLDER_ID]/sinks/[SINK_ID]" Example: `"projects/my-project-id/sinks/my-sink-id"`. + * "folders/[FOLDER_ID]/sinks/[SINK_ID]" + *

    Example: `"projects/my-project-id/sinks/my-sink-id"`. * @param sink Required. The updated sink, whose name is the same identifier that appears as part * of `sink_name`. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -719,10 +725,12 @@ public final LogSink updateSink(LogSinkName sinkName, LogSink sink) { *

    Sample code: * * @param sink_name Required. The full resource name of the sink to update, including the parent - * resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" + * resource and the sink identifier: + *

    "projects/[PROJECT_ID]/sinks/[SINK_ID]" * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - * "folders/[FOLDER_ID]/sinks/[SINK_ID]" Example: `"projects/my-project-id/sinks/my-sink-id"`. + * "folders/[FOLDER_ID]/sinks/[SINK_ID]" + *

    Example: `"projects/my-project-id/sinks/my-sink-id"`. * @param sink Required. The updated sink, whose name is the same identifier that appears as part * of `sink_name`. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -744,21 +752,23 @@ public final LogSink updateSink(String sinkName, LogSink sink) { *

    Sample code: * * @param sink_name Required. The full resource name of the sink to update, including the parent - * resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" + * resource and the sink identifier: + *

    "projects/[PROJECT_ID]/sinks/[SINK_ID]" * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - * "folders/[FOLDER_ID]/sinks/[SINK_ID]" Example: `"projects/my-project-id/sinks/my-sink-id"`. + * "folders/[FOLDER_ID]/sinks/[SINK_ID]" + *

    Example: `"projects/my-project-id/sinks/my-sink-id"`. * @param sink Required. The updated sink, whose name is the same identifier that appears as part * of `sink_name`. * @param update_mask Optional. Field mask that specifies the fields in `sink` that need an * update. A sink field will be overwritten if, and only if, it is in the update mask. `name` - * and output only fields cannot be updated. An empty updateMask is temporarily treated as - * using the following mask for backwards compatibility purposes: - * destination,filter,includeChildren At some point in the future, behavior will be removed - * and specifying an empty updateMask will be an error. For a detailed `FieldMask` definition, - * see + * and output only fields cannot be updated. + *

    An empty updateMask is temporarily treated as using the following mask for backwards + * compatibility purposes: destination,filter,includeChildren At some point in the future, + * behavior will be removed and specifying an empty updateMask will be an error. + *

    For a detailed `FieldMask` definition, see * https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask - * Example: `updateMask=filter`. + *

    Example: `updateMask=filter`. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final LogSink updateSink(LogSinkName sinkName, LogSink sink, FieldMask updateMask) { @@ -782,21 +792,23 @@ public final LogSink updateSink(LogSinkName sinkName, LogSink sink, FieldMask up *

    Sample code: * * @param sink_name Required. The full resource name of the sink to update, including the parent - * resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" + * resource and the sink identifier: + *

    "projects/[PROJECT_ID]/sinks/[SINK_ID]" * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - * "folders/[FOLDER_ID]/sinks/[SINK_ID]" Example: `"projects/my-project-id/sinks/my-sink-id"`. + * "folders/[FOLDER_ID]/sinks/[SINK_ID]" + *

    Example: `"projects/my-project-id/sinks/my-sink-id"`. * @param sink Required. The updated sink, whose name is the same identifier that appears as part * of `sink_name`. * @param update_mask Optional. Field mask that specifies the fields in `sink` that need an * update. A sink field will be overwritten if, and only if, it is in the update mask. `name` - * and output only fields cannot be updated. An empty updateMask is temporarily treated as - * using the following mask for backwards compatibility purposes: - * destination,filter,includeChildren At some point in the future, behavior will be removed - * and specifying an empty updateMask will be an error. For a detailed `FieldMask` definition, - * see + * and output only fields cannot be updated. + *

    An empty updateMask is temporarily treated as using the following mask for backwards + * compatibility purposes: destination,filter,includeChildren At some point in the future, + * behavior will be removed and specifying an empty updateMask will be an error. + *

    For a detailed `FieldMask` definition, see * https://developers.google.com/protocol-buffers/docs/reference/google.protobuf#google.protobuf.FieldMask - * Example: `updateMask=filter`. + *

    Example: `updateMask=filter`. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final LogSink updateSink(String sinkName, LogSink sink, FieldMask updateMask) { @@ -848,10 +860,12 @@ public final UnaryCallable updateSinkCallable() { *

    Sample code: * * @param sink_name Required. The full resource name of the sink to delete, including the parent - * resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" + * resource and the sink identifier: + *

    "projects/[PROJECT_ID]/sinks/[SINK_ID]" * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - * "folders/[FOLDER_ID]/sinks/[SINK_ID]" Example: `"projects/my-project-id/sinks/my-sink-id"`. + * "folders/[FOLDER_ID]/sinks/[SINK_ID]" + *

    Example: `"projects/my-project-id/sinks/my-sink-id"`. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final Empty deleteSink(LogSinkName sinkName) { @@ -870,10 +884,12 @@ public final Empty deleteSink(LogSinkName sinkName) { *

    Sample code: * * @param sink_name Required. The full resource name of the sink to delete, including the parent - * resource and the sink identifier: "projects/[PROJECT_ID]/sinks/[SINK_ID]" + * resource and the sink identifier: + *

    "projects/[PROJECT_ID]/sinks/[SINK_ID]" * "organizations/[ORGANIZATION_ID]/sinks/[SINK_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/sinks/[SINK_ID]" - * "folders/[FOLDER_ID]/sinks/[SINK_ID]" Example: `"projects/my-project-id/sinks/my-sink-id"`. + * "folders/[FOLDER_ID]/sinks/[SINK_ID]" + *

    Example: `"projects/my-project-id/sinks/my-sink-id"`. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final Empty deleteSink(String sinkName) { @@ -913,7 +929,7 @@ public final UnaryCallable deleteSinkCallable() { *

    Sample code: * * @param parent Required. The parent resource whose exclusions are to be listed. - * "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -932,7 +948,7 @@ public final ListExclusionsPagedResponse listExclusions(BillingAccountName paren *

    Sample code: * * @param parent Required. The parent resource whose exclusions are to be listed. - * "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -951,7 +967,7 @@ public final ListExclusionsPagedResponse listExclusions(FolderName parent) { *

    Sample code: * * @param parent Required. The parent resource whose exclusions are to be listed. - * "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -970,7 +986,7 @@ public final ListExclusionsPagedResponse listExclusions(OrganizationName parent) *

    Sample code: * * @param parent Required. The parent resource whose exclusions are to be listed. - * "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -989,7 +1005,7 @@ public final ListExclusionsPagedResponse listExclusions(ProjectName parent) { *

    Sample code: * * @param parent Required. The parent resource whose exclusions are to be listed. - * "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -1040,11 +1056,11 @@ public final ListExclusionsPagedResponse listExclusions(ListExclusionsRequest re *

    Sample code: * * @param name Required. The resource name of an existing exclusion: - * "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" + *

    "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" * "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - * "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: - * `"projects/my-project-id/exclusions/my-exclusion-id"`. + * "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" + *

    Example: `"projects/my-project-id/exclusions/my-exclusion-id"`. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final LogExclusion getExclusion(LogExclusionName name) { @@ -1062,11 +1078,11 @@ public final LogExclusion getExclusion(LogExclusionName name) { *

    Sample code: * * @param name Required. The resource name of an existing exclusion: - * "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" + *

    "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" * "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - * "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: - * `"projects/my-project-id/exclusions/my-exclusion-id"`. + * "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" + *

    Example: `"projects/my-project-id/exclusions/my-exclusion-id"`. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final LogExclusion getExclusion(String name) { @@ -1105,9 +1121,9 @@ public final UnaryCallable getExclusionCallab *

    Sample code: * * @param parent Required. The parent resource in which to create the exclusion: - * "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" - * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: - * `"projects/my-logging-project"`, `"organizations/123456789"`. + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" + *

    Examples: `"projects/my-logging-project"`, `"organizations/123456789"`. * @param exclusion Required. The new exclusion, whose `name` parameter is an exclusion name that * is not already used in the parent resource. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -1129,9 +1145,9 @@ public final LogExclusion createExclusion(BillingAccountName parent, LogExclusio *

    Sample code: * * @param parent Required. The parent resource in which to create the exclusion: - * "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" - * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: - * `"projects/my-logging-project"`, `"organizations/123456789"`. + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" + *

    Examples: `"projects/my-logging-project"`, `"organizations/123456789"`. * @param exclusion Required. The new exclusion, whose `name` parameter is an exclusion name that * is not already used in the parent resource. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -1153,9 +1169,9 @@ public final LogExclusion createExclusion(FolderName parent, LogExclusion exclus *

    Sample code: * * @param parent Required. The parent resource in which to create the exclusion: - * "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" - * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: - * `"projects/my-logging-project"`, `"organizations/123456789"`. + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" + *

    Examples: `"projects/my-logging-project"`, `"organizations/123456789"`. * @param exclusion Required. The new exclusion, whose `name` parameter is an exclusion name that * is not already used in the parent resource. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -1177,9 +1193,9 @@ public final LogExclusion createExclusion(OrganizationName parent, LogExclusion *

    Sample code: * * @param parent Required. The parent resource in which to create the exclusion: - * "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" - * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: - * `"projects/my-logging-project"`, `"organizations/123456789"`. + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" + *

    Examples: `"projects/my-logging-project"`, `"organizations/123456789"`. * @param exclusion Required. The new exclusion, whose `name` parameter is an exclusion name that * is not already used in the parent resource. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -1201,9 +1217,9 @@ public final LogExclusion createExclusion(ProjectName parent, LogExclusion exclu *

    Sample code: * * @param parent Required. The parent resource in which to create the exclusion: - * "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" - * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Examples: - * `"projects/my-logging-project"`, `"organizations/123456789"`. + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" + *

    Examples: `"projects/my-logging-project"`, `"organizations/123456789"`. * @param exclusion Required. The new exclusion, whose `name` parameter is an exclusion name that * is not already used in the parent resource. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -1246,19 +1262,19 @@ public final UnaryCallable createExclusion *

    Sample code: * * @param name Required. The resource name of the exclusion to update: - * "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" + *

    "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" * "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - * "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: - * `"projects/my-project-id/exclusions/my-exclusion-id"`. + * "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" + *

    Example: `"projects/my-project-id/exclusions/my-exclusion-id"`. * @param exclusion Required. New values for the existing exclusion. Only the fields specified in * `update_mask` are relevant. * @param update_mask Required. A non-empty list of fields to change in the existing exclusion. * New values for the fields are taken from the corresponding fields in the * [LogExclusion][google.logging.v2.LogExclusion] included in this request. Fields not - * mentioned in `update_mask` are not changed and are ignored in the request. For example, to - * change the filter and description of an exclusion, specify an `update_mask` of - * `"filter,description"`. + * mentioned in `update_mask` are not changed and are ignored in the request. + *

    For example, to change the filter and description of an exclusion, specify an + * `update_mask` of `"filter,description"`. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final LogExclusion updateExclusion( @@ -1279,19 +1295,19 @@ public final LogExclusion updateExclusion( *

    Sample code: * * @param name Required. The resource name of the exclusion to update: - * "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" + *

    "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" * "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - * "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: - * `"projects/my-project-id/exclusions/my-exclusion-id"`. + * "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" + *

    Example: `"projects/my-project-id/exclusions/my-exclusion-id"`. * @param exclusion Required. New values for the existing exclusion. Only the fields specified in * `update_mask` are relevant. * @param update_mask Required. A non-empty list of fields to change in the existing exclusion. * New values for the fields are taken from the corresponding fields in the * [LogExclusion][google.logging.v2.LogExclusion] included in this request. Fields not - * mentioned in `update_mask` are not changed and are ignored in the request. For example, to - * change the filter and description of an exclusion, specify an `update_mask` of - * `"filter,description"`. + * mentioned in `update_mask` are not changed and are ignored in the request. + *

    For example, to change the filter and description of an exclusion, specify an + * `update_mask` of `"filter,description"`. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final LogExclusion updateExclusion( @@ -1335,11 +1351,11 @@ public final UnaryCallable updateExclusion *

    Sample code: * * @param name Required. The resource name of an existing exclusion to delete: - * "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" + *

    "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" * "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - * "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: - * `"projects/my-project-id/exclusions/my-exclusion-id"`. + * "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" + *

    Example: `"projects/my-project-id/exclusions/my-exclusion-id"`. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final Empty deleteExclusion(LogExclusionName name) { @@ -1357,11 +1373,11 @@ public final Empty deleteExclusion(LogExclusionName name) { *

    Sample code: * * @param name Required. The resource name of an existing exclusion to delete: - * "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" + *

    "projects/[PROJECT_ID]/exclusions/[EXCLUSION_ID]" * "organizations/[ORGANIZATION_ID]/exclusions/[EXCLUSION_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/exclusions/[EXCLUSION_ID]" - * "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" Example: - * `"projects/my-project-id/exclusions/my-exclusion-id"`. + * "folders/[FOLDER_ID]/exclusions/[EXCLUSION_ID]" + *

    Example: `"projects/my-project-id/exclusions/my-exclusion-id"`. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final Empty deleteExclusion(String name) { diff --git a/test/integration/goldens/logging/LoggingServiceV2Client.java b/test/integration/goldens/logging/LoggingServiceV2Client.java index 9f9406c0d2..d90cbfadf6 100644 --- a/test/integration/goldens/logging/LoggingServiceV2Client.java +++ b/test/integration/goldens/logging/LoggingServiceV2Client.java @@ -140,9 +140,9 @@ public LoggingServiceV2Stub getStub() { *

    Sample code: * * @param log_name Required. The resource name of the log to delete: - * "projects/[PROJECT_ID]/logs/[LOG_ID]" "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" + *

    "projects/[PROJECT_ID]/logs/[LOG_ID]" "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]" "folders/[FOLDER_ID]/logs/[LOG_ID]" - * `[LOG_ID]` must be URL-encoded. For example, `"projects/my-project-id/logs/syslog"`, + *

    `[LOG_ID]` must be URL-encoded. For example, `"projects/my-project-id/logs/syslog"`, * `"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"`. For more * information about log names, see [LogEntry][google.logging.v2.LogEntry]. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -164,9 +164,9 @@ public final Empty deleteLog(LogName logName) { *

    Sample code: * * @param log_name Required. The resource name of the log to delete: - * "projects/[PROJECT_ID]/logs/[LOG_ID]" "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" + *

    "projects/[PROJECT_ID]/logs/[LOG_ID]" "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]" "folders/[FOLDER_ID]/logs/[LOG_ID]" - * `[LOG_ID]` must be URL-encoded. For example, `"projects/my-project-id/logs/syslog"`, + *

    `[LOG_ID]` must be URL-encoded. For example, `"projects/my-project-id/logs/syslog"`, * `"organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity"`. For more * information about log names, see [LogEntry][google.logging.v2.LogEntry]. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -213,18 +213,20 @@ public final UnaryCallable deleteLogCallable() { *

    Sample code: * * @param log_name Optional. A default log resource name that is assigned to all log entries in - * `entries` that do not specify a value for `log_name`: "projects/[PROJECT_ID]/logs/[LOG_ID]" - * "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" + * `entries` that do not specify a value for `log_name`: + *

    "projects/[PROJECT_ID]/logs/[LOG_ID]" "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]" "folders/[FOLDER_ID]/logs/[LOG_ID]" - * `[LOG_ID]` must be URL-encoded. For example: "projects/my-project-id/logs/syslog" - * "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity" The - * permission `logging.logEntries.create` is needed on each project, organization, billing - * account, or folder that is receiving new log entries, whether the resource is specified in - * `logName` or in an individual log entry. + *

    `[LOG_ID]` must be URL-encoded. For example: + *

    "projects/my-project-id/logs/syslog" + * "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity" + *

    The permission `logging.logEntries.create` is needed on each project, organization, + * billing account, or folder that is receiving new log entries, whether the resource is + * specified in `logName` or in an individual log entry. * @param resource Optional. A default monitored resource object that is assigned to all log - * entries in `entries` that do not specify a value for `resource`. Example: { "type": - * "gce_instance", "labels": { "zone": "us-central1-a", "instance_id": "00000000000000000000" - * }} See [LogEntry][google.logging.v2.LogEntry]. + * entries in `entries` that do not specify a value for `resource`. Example: + *

    { "type": "gce_instance", "labels": { "zone": "us-central1-a", "instance_id": + * "00000000000000000000" }} + *

    See [LogEntry][google.logging.v2.LogEntry]. * @param labels Optional. Default labels that are added to the `labels` field of all log entries * in `entries`. If a log entry already has a label with the same key as a label in this * parameter, then the log entry's label is not changed. See @@ -233,16 +235,18 @@ public final UnaryCallable deleteLogCallable() { * list does not matter. Values supplied in this method's `log_name`, `resource`, and `labels` * fields are copied into those log entries in this list that do not include values for their * corresponding fields. For more information, see the [LogEntry][google.logging.v2.LogEntry] - * type. If the `timestamp` or `insert_id` fields are missing in log entries, then this method + * type. + *

    If the `timestamp` or `insert_id` fields are missing in log entries, then this method * supplies the current time or a unique identifier, respectively. The supplied values are * chosen so that, among the log entries that did not supply their own values, the entries * earlier in the list will sort before the entries later in the list. See the `entries.list` - * method. Log entries with timestamps that are more than the [logs retention + * method. + *

    Log entries with timestamps that are more than the [logs retention * period](https://cloud.google.com/logging/quota-policy) in the past or more than 24 hours in * the future will not be available when calling `entries.list`. However, those log entries * can still be [exported with - * LogSinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs). To improve - * throughput and to avoid exceeding the [quota + * LogSinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs). + *

    To improve throughput and to avoid exceeding the [quota * limit](https://cloud.google.com/logging/quota-policy) for calls to `entries.write`, you * should try to include several log entries in this list, rather than calling this method for * each individual log entry. @@ -273,18 +277,20 @@ public final WriteLogEntriesResponse writeLogEntries( *

    Sample code: * * @param log_name Optional. A default log resource name that is assigned to all log entries in - * `entries` that do not specify a value for `log_name`: "projects/[PROJECT_ID]/logs/[LOG_ID]" - * "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" + * `entries` that do not specify a value for `log_name`: + *

    "projects/[PROJECT_ID]/logs/[LOG_ID]" "organizations/[ORGANIZATION_ID]/logs/[LOG_ID]" * "billingAccounts/[BILLING_ACCOUNT_ID]/logs/[LOG_ID]" "folders/[FOLDER_ID]/logs/[LOG_ID]" - * `[LOG_ID]` must be URL-encoded. For example: "projects/my-project-id/logs/syslog" - * "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity" The - * permission `logging.logEntries.create` is needed on each project, organization, billing - * account, or folder that is receiving new log entries, whether the resource is specified in - * `logName` or in an individual log entry. + *

    `[LOG_ID]` must be URL-encoded. For example: + *

    "projects/my-project-id/logs/syslog" + * "organizations/1234567890/logs/cloudresourcemanager.googleapis.com%2Factivity" + *

    The permission `logging.logEntries.create` is needed on each project, organization, + * billing account, or folder that is receiving new log entries, whether the resource is + * specified in `logName` or in an individual log entry. * @param resource Optional. A default monitored resource object that is assigned to all log - * entries in `entries` that do not specify a value for `resource`. Example: { "type": - * "gce_instance", "labels": { "zone": "us-central1-a", "instance_id": "00000000000000000000" - * }} See [LogEntry][google.logging.v2.LogEntry]. + * entries in `entries` that do not specify a value for `resource`. Example: + *

    { "type": "gce_instance", "labels": { "zone": "us-central1-a", "instance_id": + * "00000000000000000000" }} + *

    See [LogEntry][google.logging.v2.LogEntry]. * @param labels Optional. Default labels that are added to the `labels` field of all log entries * in `entries`. If a log entry already has a label with the same key as a label in this * parameter, then the log entry's label is not changed. See @@ -293,16 +299,18 @@ public final WriteLogEntriesResponse writeLogEntries( * list does not matter. Values supplied in this method's `log_name`, `resource`, and `labels` * fields are copied into those log entries in this list that do not include values for their * corresponding fields. For more information, see the [LogEntry][google.logging.v2.LogEntry] - * type. If the `timestamp` or `insert_id` fields are missing in log entries, then this method + * type. + *

    If the `timestamp` or `insert_id` fields are missing in log entries, then this method * supplies the current time or a unique identifier, respectively. The supplied values are * chosen so that, among the log entries that did not supply their own values, the entries * earlier in the list will sort before the entries later in the list. See the `entries.list` - * method. Log entries with timestamps that are more than the [logs retention + * method. + *

    Log entries with timestamps that are more than the [logs retention * period](https://cloud.google.com/logging/quota-policy) in the past or more than 24 hours in * the future will not be available when calling `entries.list`. However, those log entries * can still be [exported with - * LogSinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs). To improve - * throughput and to avoid exceeding the [quota + * LogSinks](https://cloud.google.com/logging/docs/api/tasks/exporting-logs). + *

    To improve throughput and to avoid exceeding the [quota * limit](https://cloud.google.com/logging/quota-policy) for calls to `entries.write`, you * should try to include several log entries in this list, rather than calling this method for * each individual log entry. @@ -362,9 +370,10 @@ public final WriteLogEntriesResponse writeLogEntries(WriteLogEntriesRequest requ *

    Sample code: * * @param resource_names Required. Names of one or more parent resources from which to retrieve - * log entries: "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" - * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" Projects listed in the - * `project_ids` field are added to this list. + * log entries: + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" + *

    Projects listed in the `project_ids` field are added to this list. * @param filter Optional. A filter that chooses which log entries to return. See [Advanced Logs * Queries](https://cloud.google.com/logging/docs/view/advanced-queries). Only log entries * that match the filter are returned. An empty filter matches all log entries in the @@ -475,9 +484,9 @@ public final ListMonitoredResourceDescriptorsPagedResponse listMonitoredResource * *

    Sample code: * - * @param parent Required. The resource name that owns the logs: "projects/[PROJECT_ID]" - * "organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" - * "folders/[FOLDER_ID]" + * @param parent Required. The resource name that owns the logs: + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ListLogsPagedResponse listLogs(BillingAccountName parent) { @@ -495,9 +504,9 @@ public final ListLogsPagedResponse listLogs(BillingAccountName parent) { * *

    Sample code: * - * @param parent Required. The resource name that owns the logs: "projects/[PROJECT_ID]" - * "organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" - * "folders/[FOLDER_ID]" + * @param parent Required. The resource name that owns the logs: + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ListLogsPagedResponse listLogs(FolderName parent) { @@ -515,9 +524,9 @@ public final ListLogsPagedResponse listLogs(FolderName parent) { * *

    Sample code: * - * @param parent Required. The resource name that owns the logs: "projects/[PROJECT_ID]" - * "organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" - * "folders/[FOLDER_ID]" + * @param parent Required. The resource name that owns the logs: + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ListLogsPagedResponse listLogs(OrganizationName parent) { @@ -535,9 +544,9 @@ public final ListLogsPagedResponse listLogs(OrganizationName parent) { * *

    Sample code: * - * @param parent Required. The resource name that owns the logs: "projects/[PROJECT_ID]" - * "organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" - * "folders/[FOLDER_ID]" + * @param parent Required. The resource name that owns the logs: + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ListLogsPagedResponse listLogs(ProjectName parent) { @@ -555,9 +564,9 @@ public final ListLogsPagedResponse listLogs(ProjectName parent) { * *

    Sample code: * - * @param parent Required. The resource name that owns the logs: "projects/[PROJECT_ID]" - * "organizations/[ORGANIZATION_ID]" "billingAccounts/[BILLING_ACCOUNT_ID]" - * "folders/[FOLDER_ID]" + * @param parent Required. The resource name that owns the logs: + *

    "projects/[PROJECT_ID]" "organizations/[ORGANIZATION_ID]" + * "billingAccounts/[BILLING_ACCOUNT_ID]" "folders/[FOLDER_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ListLogsPagedResponse listLogs(String parent) { diff --git a/test/integration/goldens/logging/MetricsServiceV2Client.java b/test/integration/goldens/logging/MetricsServiceV2Client.java index 01fb3da302..19f6aef98d 100644 --- a/test/integration/goldens/logging/MetricsServiceV2Client.java +++ b/test/integration/goldens/logging/MetricsServiceV2Client.java @@ -134,7 +134,8 @@ public MetricsServiceV2Stub getStub() { * *

    Sample code: * - * @param parent Required. The name of the project containing the metrics: "projects/[PROJECT_ID]" + * @param parent Required. The name of the project containing the metrics: + *

    "projects/[PROJECT_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ListLogMetricsPagedResponse listLogMetrics(ProjectName parent) { @@ -151,7 +152,8 @@ public final ListLogMetricsPagedResponse listLogMetrics(ProjectName parent) { * *

    Sample code: * - * @param parent Required. The name of the project containing the metrics: "projects/[PROJECT_ID]" + * @param parent Required. The name of the project containing the metrics: + *

    "projects/[PROJECT_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final ListLogMetricsPagedResponse listLogMetrics(String parent) { @@ -201,7 +203,7 @@ public final ListLogMetricsPagedResponse listLogMetrics(ListLogMetricsRequest re *

    Sample code: * * @param metric_name Required. The resource name of the desired metric: - * "projects/[PROJECT_ID]/metrics/[METRIC_ID]" + *

    "projects/[PROJECT_ID]/metrics/[METRIC_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final LogMetric getLogMetric(LogMetricName metricName) { @@ -219,7 +221,7 @@ public final LogMetric getLogMetric(LogMetricName metricName) { *

    Sample code: * * @param metric_name Required. The resource name of the desired metric: - * "projects/[PROJECT_ID]/metrics/[METRIC_ID]" + *

    "projects/[PROJECT_ID]/metrics/[METRIC_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final LogMetric getLogMetric(String metricName) { @@ -258,7 +260,8 @@ public final UnaryCallable getLogMetricCallable( *

    Sample code: * * @param parent Required. The resource name of the project in which to create the metric: - * "projects/[PROJECT_ID]" The new metric must be provided in the request. + *

    "projects/[PROJECT_ID]" + *

    The new metric must be provided in the request. * @param metric Required. The new logs-based metric, which must not have an identifier that * already exists. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -279,7 +282,8 @@ public final LogMetric createLogMetric(ProjectName parent, LogMetric metric) { *

    Sample code: * * @param parent Required. The resource name of the project in which to create the metric: - * "projects/[PROJECT_ID]" The new metric must be provided in the request. + *

    "projects/[PROJECT_ID]" + *

    The new metric must be provided in the request. * @param metric Required. The new logs-based metric, which must not have an identifier that * already exists. * @throws com.google.api.gax.rpc.ApiException if the remote call fails @@ -320,9 +324,10 @@ public final UnaryCallable createLogMetricCal *

    Sample code: * * @param metric_name Required. The resource name of the metric to update: - * "projects/[PROJECT_ID]/metrics/[METRIC_ID]" The updated metric must be provided in the - * request and it's `name` field must be the same as `[METRIC_ID]` If the metric does not - * exist in `[PROJECT_ID]`, then a new metric is created. + *

    "projects/[PROJECT_ID]/metrics/[METRIC_ID]" + *

    The updated metric must be provided in the request and it's `name` field must be the + * same as `[METRIC_ID]` If the metric does not exist in `[PROJECT_ID]`, then a new metric is + * created. * @param metric Required. The updated metric. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -342,9 +347,10 @@ public final LogMetric updateLogMetric(LogMetricName metricName, LogMetric metri *

    Sample code: * * @param metric_name Required. The resource name of the metric to update: - * "projects/[PROJECT_ID]/metrics/[METRIC_ID]" The updated metric must be provided in the - * request and it's `name` field must be the same as `[METRIC_ID]` If the metric does not - * exist in `[PROJECT_ID]`, then a new metric is created. + *

    "projects/[PROJECT_ID]/metrics/[METRIC_ID]" + *

    The updated metric must be provided in the request and it's `name` field must be the + * same as `[METRIC_ID]` If the metric does not exist in `[PROJECT_ID]`, then a new metric is + * created. * @param metric Required. The updated metric. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -384,7 +390,7 @@ public final UnaryCallable updateLogMetricCal *

    Sample code: * * @param metric_name Required. The resource name of the metric to delete: - * "projects/[PROJECT_ID]/metrics/[METRIC_ID]" + *

    "projects/[PROJECT_ID]/metrics/[METRIC_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final Empty deleteLogMetric(LogMetricName metricName) { @@ -402,7 +408,7 @@ public final Empty deleteLogMetric(LogMetricName metricName) { *

    Sample code: * * @param metric_name Required. The resource name of the metric to delete: - * "projects/[PROJECT_ID]/metrics/[METRIC_ID]" + *

    "projects/[PROJECT_ID]/metrics/[METRIC_ID]" * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ public final Empty deleteLogMetric(String metricName) { diff --git a/test/integration/goldens/redis/CloudRedisClient.java b/test/integration/goldens/redis/CloudRedisClient.java index 158d71fc5b..2afd0b3b6e 100644 --- a/test/integration/goldens/redis/CloudRedisClient.java +++ b/test/integration/goldens/redis/CloudRedisClient.java @@ -355,9 +355,15 @@ public final UnaryCallable getInstanceCallable() { * @param parent Required. The resource name of the instance location using the form: * `projects/{project_id}/locations/{location_id}` where `location_id` refers to a GCP region. * @param instance_id Required. The logical name of the Redis instance in the customer project - * with the following restrictions: * Must contain only lowercase letters, numbers, and - * hyphens. * Must start with a letter. * Must be between 1-40 characters. * Must end with a - * number or a letter. * Must be unique within the customer project / location + * with the following restrictions: + *

      + *
    • Must contain only lowercase letters, numbers, and hyphens. + *
    • Must start with a letter. + *
    • Must be between 1-40 characters. + *
    • Must end with a number or a letter. + *
    • Must be unique within the customer project / location + *
    + * * @param instance Required. A Redis [Instance] resource * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -392,9 +398,15 @@ public final OperationFuture createInstanceAsync( * @param parent Required. The resource name of the instance location using the form: * `projects/{project_id}/locations/{location_id}` where `location_id` refers to a GCP region. * @param instance_id Required. The logical name of the Redis instance in the customer project - * with the following restrictions: * Must contain only lowercase letters, numbers, and - * hyphens. * Must start with a letter. * Must be between 1-40 characters. * Must end with a - * number or a letter. * Must be unique within the customer project / location + * with the following restrictions: + *
      + *
    • Must contain only lowercase letters, numbers, and hyphens. + *
    • Must start with a letter. + *
    • Must be between 1-40 characters. + *
    • Must end with a number or a letter. + *
    • Must be unique within the customer project / location + *
    + * * @param instance Required. A Redis [Instance] resource * @throws com.google.api.gax.rpc.ApiException if the remote call fails */ @@ -489,8 +501,8 @@ public final UnaryCallable createInstanceCalla * * @param update_mask Required. Mask of fields to update. At least one path must be supplied in * this field. The elements of the repeated paths field may only include these fields from - * [Instance][google.cloud.redis.v1.Instance]: * `displayName` * `labels` * `memorySizeGb` * - * `redisConfig` + * [Instance][google.cloud.redis.v1.Instance]: + *

    * `displayName` * `labels` * `memorySizeGb` * `redisConfig` * @param instance Required. Update description. Only fields specified in update_mask are updated. * @throws com.google.api.gax.rpc.ApiException if the remote call fails */