From 928729d2f53bf9e92060a36712aee6f3a78f3ce7 Mon Sep 17 00:00:00 2001 From: "gcf-owl-bot[bot]" <78513119+gcf-owl-bot[bot]@users.noreply.github.com> Date: Fri, 9 Sep 2022 16:44:30 +0000 Subject: [PATCH 1/5] chore(bazel): Update WORKSPACE files for rules_gapic, gax_java, generator_java versions (#460) - [ ] Regenerate this pull request now. PiperOrigin-RevId: 472750037 Source-Link: https://github.com/googleapis/googleapis/commit/88f2ea3f53b9712f2e04f28f06210f6f77fa7e24 Source-Link: https://github.com/googleapis/googleapis-gen/commit/230a5588306aae18fe8f2a57f14d4039ad72c901 Copy-Tag: eyJwIjoiLmdpdGh1Yi8uT3dsQm90LnlhbWwiLCJoIjoiMjMwYTU1ODgzMDZhYWUxOGZlOGYyYTU3ZjE0ZDQwMzlhZDcyYzkwMSJ9 --- .../v1/CloudFunctionsServiceClient.java | 273 +++++++++++----- .../v1/CloudFunctionsServiceSettings.java | 7 +- .../cloud/functions/v1/package-info.java | 7 +- .../CloudFunctionsServiceStubSettings.java | 7 +- .../HttpJsonCloudFunctionsServiceStub.java | 14 +- .../functions/v2/FunctionServiceClient.java | 308 +++++++++++++----- .../functions/v2/FunctionServiceSettings.java | 12 +- .../cloud/functions/v2/package-info.java | 7 +- .../v2/stub/FunctionServiceStubSettings.java | 12 +- .../v2/stub/HttpJsonFunctionServiceStub.java | 12 +- .../v2alpha/FunctionServiceClient.java | 308 +++++++++++++----- .../v2alpha/FunctionServiceSettings.java | 12 +- .../cloud/functions/v2alpha/package-info.java | 7 +- .../stub/FunctionServiceStubSettings.java | 12 +- .../stub/HttpJsonFunctionServiceStub.java | 12 +- .../v2beta/FunctionServiceClient.java | 308 +++++++++++++----- .../v2beta/FunctionServiceSettings.java | 12 +- .../cloud/functions/v2beta/package-info.java | 7 +- .../stub/FunctionServiceStubSettings.java | 12 +- .../stub/HttpJsonFunctionServiceStub.java | 12 +- .../callfunction/AsyncCallFunction.java | 7 +- .../callfunction/SyncCallFunction.java | 7 +- ...ncCallFunctionCloudfunctionnameString.java | 7 +- .../SyncCallFunctionStringString.java | 7 +- .../SyncCreateSetCredentialsProvider.java | 7 +- .../SyncCreateSetCredentialsProvider1.java | 7 +- .../create/SyncCreateSetEndpoint.java | 7 +- .../createfunction/AsyncCreateFunction.java | 7 +- .../AsyncCreateFunctionLRO.java | 7 +- .../createfunction/SyncCreateFunction.java | 7 +- ...eateFunctionLocationnameCloudfunction.java | 7 +- ...SyncCreateFunctionStringCloudfunction.java | 7 +- .../deletefunction/AsyncDeleteFunction.java | 7 +- .../AsyncDeleteFunctionLRO.java | 7 +- .../deletefunction/SyncDeleteFunction.java | 7 +- .../SyncDeleteFunctionCloudfunctionname.java | 7 +- .../SyncDeleteFunctionString.java | 7 +- .../AsyncGenerateDownloadUrl.java | 7 +- .../SyncGenerateDownloadUrl.java | 7 +- .../AsyncGenerateUploadUrl.java | 7 +- .../SyncGenerateUploadUrl.java | 7 +- .../getfunction/AsyncGetFunction.java | 7 +- .../getfunction/SyncGetFunction.java | 7 +- .../SyncGetFunctionCloudfunctionname.java | 7 +- .../getfunction/SyncGetFunctionString.java | 7 +- .../getiampolicy/AsyncGetIamPolicy.java | 7 +- .../getiampolicy/SyncGetIamPolicy.java | 7 +- .../listfunctions/AsyncListFunctions.java | 7 +- .../AsyncListFunctionsPaged.java | 7 +- .../listfunctions/SyncListFunctions.java | 7 +- .../setiampolicy/AsyncSetIamPolicy.java | 7 +- .../setiampolicy/SyncSetIamPolicy.java | 7 +- .../AsyncTestIamPermissions.java | 7 +- .../SyncTestIamPermissions.java | 7 +- .../updatefunction/AsyncUpdateFunction.java | 7 +- .../AsyncUpdateFunctionLRO.java | 7 +- .../updatefunction/SyncUpdateFunction.java | 7 +- .../SyncUpdateFunctionCloudfunction.java | 7 +- .../getfunction/SyncGetFunction.java | 7 +- .../getfunction/SyncGetFunction.java | 7 +- .../SyncCreateSetCredentialsProvider.java | 7 +- .../SyncCreateSetCredentialsProvider1.java | 7 +- .../create/SyncCreateSetEndpoint.java | 7 +- .../createfunction/AsyncCreateFunction.java | 7 +- .../AsyncCreateFunctionLRO.java | 7 +- .../createfunction/SyncCreateFunction.java | 7 +- ...ateFunctionLocationnameFunctionString.java | 7 +- ...yncCreateFunctionStringFunctionString.java | 7 +- .../deletefunction/AsyncDeleteFunction.java | 7 +- .../AsyncDeleteFunctionLRO.java | 7 +- .../deletefunction/SyncDeleteFunction.java | 7 +- .../SyncDeleteFunctionFunctionname.java | 7 +- .../SyncDeleteFunctionString.java | 7 +- .../AsyncGenerateDownloadUrl.java | 7 +- .../SyncGenerateDownloadUrl.java | 7 +- .../AsyncGenerateUploadUrl.java | 7 +- .../SyncGenerateUploadUrl.java | 7 +- .../getfunction/AsyncGetFunction.java | 7 +- .../getfunction/SyncGetFunction.java | 7 +- .../SyncGetFunctionFunctionname.java | 7 +- .../getfunction/SyncGetFunctionString.java | 7 +- .../getiampolicy/AsyncGetIamPolicy.java | 7 +- .../getiampolicy/SyncGetIamPolicy.java | 7 +- .../listfunctions/AsyncListFunctions.java | 7 +- .../AsyncListFunctionsPaged.java | 7 +- .../listfunctions/SyncListFunctions.java | 7 +- .../SyncListFunctionsLocationname.java | 7 +- .../SyncListFunctionsString.java | 7 +- .../listlocations/AsyncListLocations.java | 7 +- .../AsyncListLocationsPaged.java | 7 +- .../listlocations/SyncListLocations.java | 7 +- .../listruntimes/AsyncListRuntimes.java | 7 +- .../listruntimes/SyncListRuntimes.java | 7 +- .../SyncListRuntimesLocationname.java | 7 +- .../listruntimes/SyncListRuntimesString.java | 7 +- .../setiampolicy/AsyncSetIamPolicy.java | 7 +- .../setiampolicy/SyncSetIamPolicy.java | 7 +- .../AsyncTestIamPermissions.java | 7 +- .../SyncTestIamPermissions.java | 7 +- .../updatefunction/AsyncUpdateFunction.java | 7 +- .../AsyncUpdateFunctionLRO.java | 7 +- .../updatefunction/SyncUpdateFunction.java | 7 +- .../SyncUpdateFunctionFunctionFieldmask.java | 7 +- .../getfunction/SyncGetFunction.java | 12 +- .../getfunction/SyncGetFunction.java | 12 +- 105 files changed, 1373 insertions(+), 593 deletions(-) diff --git a/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/CloudFunctionsServiceClient.java b/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/CloudFunctionsServiceClient.java index 89cb411e..46af423f 100644 --- a/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/CloudFunctionsServiceClient.java +++ b/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/CloudFunctionsServiceClient.java @@ -51,8 +51,11 @@ * calls that map to API methods. Sample code to get started: * *
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* CloudFunctionName name = CloudFunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]");
@@ -90,8 +93,11 @@
* To customize credentials:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* CloudFunctionsServiceSettings cloudFunctionsServiceSettings =
* CloudFunctionsServiceSettings.newBuilder()
* .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
@@ -103,8 +109,11 @@
* To customize the endpoint:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* CloudFunctionsServiceSettings cloudFunctionsServiceSettings =
* CloudFunctionsServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
* CloudFunctionsServiceClient cloudFunctionsServiceClient =
@@ -115,8 +124,11 @@
* the wire:
*
* {@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* CloudFunctionsServiceSettings cloudFunctionsServiceSettings =
* CloudFunctionsServiceSettings.newBuilder()
* .setTransportChannelProvider(
@@ -210,8 +222,11 @@ public final OperationsClient getHttpJsonOperationsClient() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* ListFunctionsRequest request =
@@ -241,8 +256,11 @@ public final ListFunctionsPagedResponse listFunctions(ListFunctionsRequest reque
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* ListFunctionsRequest request =
@@ -272,8 +290,11 @@ public final ListFunctionsPagedResponse listFunctions(ListFunctionsRequest reque
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* ListFunctionsRequest request =
@@ -309,8 +330,11 @@ public final UnaryCallable listFunc
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* CloudFunctionName name = CloudFunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]");
@@ -334,8 +358,11 @@ public final CloudFunction getFunction(CloudFunctionName name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* String name = CloudFunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]").toString();
@@ -358,8 +385,11 @@ public final CloudFunction getFunction(String name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* GetFunctionRequest request =
@@ -384,8 +414,11 @@ public final CloudFunction getFunction(GetFunctionRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* GetFunctionRequest request =
@@ -411,8 +444,11 @@ public final UnaryCallable getFunctionCallabl
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* LocationName location = LocationName.of("[PROJECT]", "[LOCATION]");
@@ -445,8 +481,11 @@ public final OperationFuture createFunctionA
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* String location = LocationName.of("[PROJECT]", "[LOCATION]").toString();
@@ -476,8 +515,11 @@ public final OperationFuture createFunctionA
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* CreateFunctionRequest request =
@@ -505,8 +547,11 @@ public final OperationFuture createFunctionA
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* CreateFunctionRequest request =
@@ -534,8 +579,11 @@ public final OperationFuture createFunctionA
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* CreateFunctionRequest request =
@@ -561,8 +609,11 @@ public final UnaryCallable createFunctionCalla
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* CloudFunction function = CloudFunction.newBuilder().build();
@@ -587,8 +638,11 @@ public final OperationFuture updateFunctionA
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* UpdateFunctionRequest request =
@@ -615,8 +669,11 @@ public final OperationFuture updateFunctionA
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* UpdateFunctionRequest request =
@@ -643,8 +700,11 @@ public final OperationFuture updateFunctionA
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* UpdateFunctionRequest request =
@@ -671,8 +731,11 @@ public final UnaryCallable updateFunctionCalla
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* CloudFunctionName name = CloudFunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]");
@@ -698,8 +761,11 @@ public final OperationFuture deleteFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* String name = CloudFunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]").toString();
@@ -723,8 +789,11 @@ public final OperationFuture deleteFunctionAsync(Str
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* DeleteFunctionRequest request =
@@ -751,8 +820,11 @@ public final OperationFuture deleteFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* DeleteFunctionRequest request =
@@ -779,8 +851,11 @@ public final OperationFuture deleteFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* DeleteFunctionRequest request =
@@ -807,8 +882,11 @@ public final UnaryCallable deleteFunctionCalla
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* CloudFunctionName name = CloudFunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]");
@@ -839,8 +917,11 @@ public final CallFunctionResponse callFunction(CloudFunctionName name, String da
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* String name = CloudFunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]").toString();
@@ -868,8 +949,11 @@ public final CallFunctionResponse callFunction(String name, String data) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* CallFunctionRequest request =
@@ -897,8 +981,11 @@ public final CallFunctionResponse callFunction(CallFunctionRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* CallFunctionRequest request =
@@ -951,8 +1038,11 @@ public final UnaryCallable callFuncti
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* GenerateUploadUrlRequest request =
@@ -1007,8 +1097,11 @@ public final GenerateUploadUrlResponse generateUploadUrl(GenerateUploadUrlReques
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* GenerateUploadUrlRequest request =
@@ -1039,8 +1132,11 @@ public final GenerateUploadUrlResponse generateUploadUrl(GenerateUploadUrlReques
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* GenerateDownloadUrlRequest request =
@@ -1069,8 +1165,11 @@ public final GenerateDownloadUrlResponse generateDownloadUrl(GenerateDownloadUrl
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* GenerateDownloadUrlRequest request =
@@ -1097,8 +1196,11 @@ public final GenerateDownloadUrlResponse generateDownloadUrl(GenerateDownloadUrl
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* SetIamPolicyRequest request =
@@ -1125,8 +1227,11 @@ public final Policy setIamPolicy(SetIamPolicyRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* SetIamPolicyRequest request =
@@ -1154,8 +1259,11 @@ public final UnaryCallable setIamPolicyCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* GetIamPolicyRequest request =
@@ -1182,8 +1290,11 @@ public final Policy getIamPolicy(GetIamPolicyRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* GetIamPolicyRequest request =
@@ -1210,8 +1321,11 @@ public final UnaryCallable getIamPolicyCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* TestIamPermissionsRequest request =
@@ -1238,8 +1352,11 @@ public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsReq
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* TestIamPermissionsRequest request =
diff --git a/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/CloudFunctionsServiceSettings.java b/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/CloudFunctionsServiceSettings.java
index b7b948fe..977121e2 100644
--- a/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/CloudFunctionsServiceSettings.java
+++ b/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/CloudFunctionsServiceSettings.java
@@ -62,8 +62,11 @@
* For example, to set the total timeout of getFunction to 30 seconds:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* CloudFunctionsServiceSettings.Builder cloudFunctionsServiceSettingsBuilder =
* CloudFunctionsServiceSettings.newBuilder();
* cloudFunctionsServiceSettingsBuilder
diff --git a/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/package-info.java b/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/package-info.java
index 2f0560c1..b51d7ba3 100644
--- a/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/package-info.java
+++ b/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/package-info.java
@@ -26,8 +26,11 @@
* Sample for CloudFunctionsServiceClient:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (CloudFunctionsServiceClient cloudFunctionsServiceClient =
* CloudFunctionsServiceClient.create()) {
* CloudFunctionName name = CloudFunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]");
diff --git a/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/stub/CloudFunctionsServiceStubSettings.java b/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/stub/CloudFunctionsServiceStubSettings.java
index b7280156..432ebcaa 100644
--- a/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/stub/CloudFunctionsServiceStubSettings.java
+++ b/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/stub/CloudFunctionsServiceStubSettings.java
@@ -96,8 +96,11 @@
* For example, to set the total timeout of getFunction to 30 seconds:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* CloudFunctionsServiceStubSettings.Builder cloudFunctionsServiceSettingsBuilder =
* CloudFunctionsServiceStubSettings.newBuilder();
* cloudFunctionsServiceSettingsBuilder
diff --git a/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/stub/HttpJsonCloudFunctionsServiceStub.java b/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/stub/HttpJsonCloudFunctionsServiceStub.java
index 2b76d736..581e734f 100644
--- a/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/stub/HttpJsonCloudFunctionsServiceStub.java
+++ b/google-cloud-functions/src/main/java/com/google/cloud/functions/v1/stub/HttpJsonCloudFunctionsServiceStub.java
@@ -174,7 +174,7 @@ public class HttpJsonCloudFunctionsServiceStub extends CloudFunctionsServiceStub
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("function", request.getFunction()))
+ .toBody("function", request.getFunction(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -215,7 +215,7 @@ public class HttpJsonCloudFunctionsServiceStub extends CloudFunctionsServiceStub
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("function", request.getFunction()))
+ .toBody("function", request.getFunction(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -290,7 +290,7 @@ public class HttpJsonCloudFunctionsServiceStub extends CloudFunctionsServiceStub
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearName().build()))
+ .toBody("*", request.toBuilder().clearName().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -327,7 +327,7 @@ public class HttpJsonCloudFunctionsServiceStub extends CloudFunctionsServiceStub
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearParent().build()))
+ .toBody("*", request.toBuilder().clearParent().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -364,7 +364,7 @@ public class HttpJsonCloudFunctionsServiceStub extends CloudFunctionsServiceStub
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearName().build()))
+ .toBody("*", request.toBuilder().clearName().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -400,7 +400,7 @@ public class HttpJsonCloudFunctionsServiceStub extends CloudFunctionsServiceStub
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearResource().build()))
+ .toBody("*", request.toBuilder().clearResource().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -471,7 +471,7 @@ public class HttpJsonCloudFunctionsServiceStub extends CloudFunctionsServiceStub
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearResource().build()))
+ .toBody("*", request.toBuilder().clearResource().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
diff --git a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/FunctionServiceClient.java b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/FunctionServiceClient.java
index 5140d636..67c7ef4a 100644
--- a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/FunctionServiceClient.java
+++ b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/FunctionServiceClient.java
@@ -60,8 +60,11 @@
* calls that map to API methods. Sample code to get started:
*
* {@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* FunctionName name = FunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]");
* Function response = functionServiceClient.getFunction(name);
@@ -98,8 +101,11 @@
* To customize credentials:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* FunctionServiceSettings functionServiceSettings =
* FunctionServiceSettings.newBuilder()
* .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
@@ -111,8 +117,11 @@
* To customize the endpoint:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* FunctionServiceSettings functionServiceSettings =
* FunctionServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
* FunctionServiceClient functionServiceClient =
@@ -123,8 +132,11 @@
* the wire:
*
* {@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* FunctionServiceSettings functionServiceSettings =
* FunctionServiceSettings.newBuilder()
* .setTransportChannelProvider(
@@ -218,8 +230,11 @@ public final OperationsClient getHttpJsonOperationsClient() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* FunctionName name = FunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]");
* Function response = functionServiceClient.getFunction(name);
@@ -242,8 +257,11 @@ public final Function getFunction(FunctionName name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* String name = FunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]").toString();
* Function response = functionServiceClient.getFunction(name);
@@ -265,8 +283,11 @@ public final Function getFunction(String name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* GetFunctionRequest request =
* GetFunctionRequest.newBuilder()
@@ -290,8 +311,11 @@ public final Function getFunction(GetFunctionRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* GetFunctionRequest request =
* GetFunctionRequest.newBuilder()
@@ -314,8 +338,11 @@ public final UnaryCallable getFunctionCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
* for (Function element : functionServiceClient.listFunctions(parent).iterateAll()) {
@@ -346,8 +373,11 @@ public final ListFunctionsPagedResponse listFunctions(LocationName parent) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
* for (Function element : functionServiceClient.listFunctions(parent).iterateAll()) {
@@ -375,8 +405,11 @@ public final ListFunctionsPagedResponse listFunctions(String parent) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListFunctionsRequest request =
* ListFunctionsRequest.newBuilder()
@@ -406,8 +439,11 @@ public final ListFunctionsPagedResponse listFunctions(ListFunctionsRequest reque
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListFunctionsRequest request =
* ListFunctionsRequest.newBuilder()
@@ -438,8 +474,11 @@ public final ListFunctionsPagedResponse listFunctions(ListFunctionsRequest reque
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListFunctionsRequest request =
* ListFunctionsRequest.newBuilder()
@@ -477,8 +516,11 @@ public final UnaryCallable listFunc
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
* Function function = Function.newBuilder().build();
@@ -515,8 +557,11 @@ public final OperationFuture createFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
* Function function = Function.newBuilder().build();
@@ -553,8 +598,11 @@ public final OperationFuture createFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* CreateFunctionRequest request =
* CreateFunctionRequest.newBuilder()
@@ -582,8 +630,11 @@ public final OperationFuture createFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* CreateFunctionRequest request =
* CreateFunctionRequest.newBuilder()
@@ -611,8 +662,11 @@ public final OperationFuture createFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* CreateFunctionRequest request =
* CreateFunctionRequest.newBuilder()
@@ -638,8 +692,11 @@ public final UnaryCallable createFunctionCalla
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* Function function = Function.newBuilder().build();
* FieldMask updateMask = FieldMask.newBuilder().build();
@@ -666,8 +723,11 @@ public final OperationFuture updateFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* UpdateFunctionRequest request =
* UpdateFunctionRequest.newBuilder()
@@ -693,8 +753,11 @@ public final OperationFuture updateFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* UpdateFunctionRequest request =
* UpdateFunctionRequest.newBuilder()
@@ -720,8 +783,11 @@ public final OperationFuture updateFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* UpdateFunctionRequest request =
* UpdateFunctionRequest.newBuilder()
@@ -747,8 +813,11 @@ public final UnaryCallable updateFunctionCalla
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* FunctionName name = FunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]");
* functionServiceClient.deleteFunctionAsync(name).get();
@@ -772,8 +841,11 @@ public final OperationFuture deleteFunctionAsync(Funct
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* String name = FunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]").toString();
* functionServiceClient.deleteFunctionAsync(name).get();
@@ -796,8 +868,11 @@ public final OperationFuture deleteFunctionAsync(Strin
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* DeleteFunctionRequest request =
* DeleteFunctionRequest.newBuilder()
@@ -823,8 +898,11 @@ public final OperationFuture deleteFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* DeleteFunctionRequest request =
* DeleteFunctionRequest.newBuilder()
@@ -850,8 +928,11 @@ public final OperationFuture deleteFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* DeleteFunctionRequest request =
* DeleteFunctionRequest.newBuilder()
@@ -900,8 +981,11 @@ public final UnaryCallable deleteFunctionCalla
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* GenerateUploadUrlRequest request =
* GenerateUploadUrlRequest.newBuilder()
@@ -950,8 +1034,11 @@ public final GenerateUploadUrlResponse generateUploadUrl(GenerateUploadUrlReques
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* GenerateUploadUrlRequest request =
* GenerateUploadUrlRequest.newBuilder()
@@ -978,8 +1065,11 @@ public final GenerateUploadUrlResponse generateUploadUrl(GenerateUploadUrlReques
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* GenerateDownloadUrlRequest request =
* GenerateDownloadUrlRequest.newBuilder()
@@ -1005,8 +1095,11 @@ public final GenerateDownloadUrlResponse generateDownloadUrl(GenerateDownloadUrl
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* GenerateDownloadUrlRequest request =
* GenerateDownloadUrlRequest.newBuilder()
@@ -1031,8 +1124,11 @@ public final GenerateDownloadUrlResponse generateDownloadUrl(GenerateDownloadUrl
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
* ListRuntimesResponse response = functionServiceClient.listRuntimes(parent);
@@ -1058,8 +1154,11 @@ public final ListRuntimesResponse listRuntimes(LocationName parent) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
* ListRuntimesResponse response = functionServiceClient.listRuntimes(parent);
@@ -1082,8 +1181,11 @@ public final ListRuntimesResponse listRuntimes(String parent) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListRuntimesRequest request =
* ListRuntimesRequest.newBuilder()
@@ -1108,8 +1210,11 @@ public final ListRuntimesResponse listRuntimes(ListRuntimesRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListRuntimesRequest request =
* ListRuntimesRequest.newBuilder()
@@ -1134,8 +1239,11 @@ public final UnaryCallable listRuntim
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListLocationsRequest request =
* ListLocationsRequest.newBuilder()
@@ -1164,8 +1272,11 @@ public final ListLocationsPagedResponse listLocations(ListLocationsRequest reque
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListLocationsRequest request =
* ListLocationsRequest.newBuilder()
@@ -1195,8 +1306,11 @@ public final ListLocationsPagedResponse listLocations(ListLocationsRequest reque
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListLocationsRequest request =
* ListLocationsRequest.newBuilder()
@@ -1234,8 +1348,11 @@ public final UnaryCallable listLoca
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* SetIamPolicyRequest request =
* SetIamPolicyRequest.newBuilder()
@@ -1263,8 +1380,11 @@ public final Policy setIamPolicy(SetIamPolicyRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* SetIamPolicyRequest request =
* SetIamPolicyRequest.newBuilder()
@@ -1290,8 +1410,11 @@ public final UnaryCallable setIamPolicyCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* GetIamPolicyRequest request =
* GetIamPolicyRequest.newBuilder()
@@ -1317,8 +1440,11 @@ public final Policy getIamPolicy(GetIamPolicyRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* GetIamPolicyRequest request =
* GetIamPolicyRequest.newBuilder()
@@ -1347,8 +1473,11 @@ public final UnaryCallable getIamPolicyCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* TestIamPermissionsRequest request =
* TestIamPermissionsRequest.newBuilder()
@@ -1378,8 +1507,11 @@ public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsReq
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* TestIamPermissionsRequest request =
* TestIamPermissionsRequest.newBuilder()
diff --git a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/FunctionServiceSettings.java b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/FunctionServiceSettings.java
index af930bf9..f8a60518 100644
--- a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/FunctionServiceSettings.java
+++ b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/FunctionServiceSettings.java
@@ -65,17 +65,17 @@
* For example, to set the total timeout of getFunction to 30 seconds:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* FunctionServiceSettings.Builder functionServiceSettingsBuilder =
* FunctionServiceSettings.newBuilder();
* functionServiceSettingsBuilder
* .getFunctionSettings()
* .setRetrySettings(
- * functionServiceSettingsBuilder
- * .getFunctionSettings()
- * .getRetrySettings()
- * .toBuilder()
+ * functionServiceSettingsBuilder.getFunctionSettings().getRetrySettings().toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30))
* .build());
* FunctionServiceSettings functionServiceSettings = functionServiceSettingsBuilder.build();
diff --git a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/package-info.java b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/package-info.java
index 5fa55e94..2cce1d34 100644
--- a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/package-info.java
+++ b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/package-info.java
@@ -31,8 +31,11 @@
* Sample for FunctionServiceClient:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* FunctionName name = FunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]");
* Function response = functionServiceClient.getFunction(name);
diff --git a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/stub/FunctionServiceStubSettings.java b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/stub/FunctionServiceStubSettings.java
index 14d9b30d..6a7a58c8 100644
--- a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/stub/FunctionServiceStubSettings.java
+++ b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/stub/FunctionServiceStubSettings.java
@@ -100,17 +100,17 @@
* For example, to set the total timeout of getFunction to 30 seconds:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* FunctionServiceStubSettings.Builder functionServiceSettingsBuilder =
* FunctionServiceStubSettings.newBuilder();
* functionServiceSettingsBuilder
* .getFunctionSettings()
* .setRetrySettings(
- * functionServiceSettingsBuilder
- * .getFunctionSettings()
- * .getRetrySettings()
- * .toBuilder()
+ * functionServiceSettingsBuilder.getFunctionSettings().getRetrySettings().toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30))
* .build());
* FunctionServiceStubSettings functionServiceSettings = functionServiceSettingsBuilder.build();
diff --git a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/stub/HttpJsonFunctionServiceStub.java b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/stub/HttpJsonFunctionServiceStub.java
index f96e4318..f9675163 100644
--- a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/stub/HttpJsonFunctionServiceStub.java
+++ b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2/stub/HttpJsonFunctionServiceStub.java
@@ -180,7 +180,7 @@ public class HttpJsonFunctionServiceStub extends FunctionServiceStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("function", request.getFunction()))
+ .toBody("function", request.getFunction(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -221,7 +221,7 @@ public class HttpJsonFunctionServiceStub extends FunctionServiceStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("function", request.getFunction()))
+ .toBody("function", request.getFunction(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -296,7 +296,7 @@ public class HttpJsonFunctionServiceStub extends FunctionServiceStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearParent().build()))
+ .toBody("*", request.toBuilder().clearParent().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -332,7 +332,7 @@ public class HttpJsonFunctionServiceStub extends FunctionServiceStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearName().build()))
+ .toBody("*", request.toBuilder().clearName().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -435,7 +435,7 @@ public class HttpJsonFunctionServiceStub extends FunctionServiceStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearResource().build()))
+ .toBody("*", request.toBuilder().clearResource().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -504,7 +504,7 @@ public class HttpJsonFunctionServiceStub extends FunctionServiceStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearResource().build()))
+ .toBody("*", request.toBuilder().clearResource().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
diff --git a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/FunctionServiceClient.java b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/FunctionServiceClient.java
index c4e4823a..06453d88 100644
--- a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/FunctionServiceClient.java
+++ b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/FunctionServiceClient.java
@@ -60,8 +60,11 @@
* calls that map to API methods. Sample code to get started:
*
* {@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* FunctionName name = FunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]");
* Function response = functionServiceClient.getFunction(name);
@@ -98,8 +101,11 @@
* To customize credentials:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* FunctionServiceSettings functionServiceSettings =
* FunctionServiceSettings.newBuilder()
* .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
@@ -111,8 +117,11 @@
* To customize the endpoint:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* FunctionServiceSettings functionServiceSettings =
* FunctionServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
* FunctionServiceClient functionServiceClient =
@@ -123,8 +132,11 @@
* the wire:
*
* {@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* FunctionServiceSettings functionServiceSettings =
* FunctionServiceSettings.newBuilder()
* .setTransportChannelProvider(
@@ -219,8 +231,11 @@ public final OperationsClient getHttpJsonOperationsClient() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* FunctionName name = FunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]");
* Function response = functionServiceClient.getFunction(name);
@@ -243,8 +258,11 @@ public final Function getFunction(FunctionName name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* String name = FunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]").toString();
* Function response = functionServiceClient.getFunction(name);
@@ -266,8 +284,11 @@ public final Function getFunction(String name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* GetFunctionRequest request =
* GetFunctionRequest.newBuilder()
@@ -291,8 +312,11 @@ public final Function getFunction(GetFunctionRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* GetFunctionRequest request =
* GetFunctionRequest.newBuilder()
@@ -315,8 +339,11 @@ public final UnaryCallable getFunctionCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
* for (Function element : functionServiceClient.listFunctions(parent).iterateAll()) {
@@ -347,8 +374,11 @@ public final ListFunctionsPagedResponse listFunctions(LocationName parent) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
* for (Function element : functionServiceClient.listFunctions(parent).iterateAll()) {
@@ -376,8 +406,11 @@ public final ListFunctionsPagedResponse listFunctions(String parent) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListFunctionsRequest request =
* ListFunctionsRequest.newBuilder()
@@ -407,8 +440,11 @@ public final ListFunctionsPagedResponse listFunctions(ListFunctionsRequest reque
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListFunctionsRequest request =
* ListFunctionsRequest.newBuilder()
@@ -439,8 +475,11 @@ public final ListFunctionsPagedResponse listFunctions(ListFunctionsRequest reque
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListFunctionsRequest request =
* ListFunctionsRequest.newBuilder()
@@ -478,8 +517,11 @@ public final UnaryCallable listFunc
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
* Function function = Function.newBuilder().build();
@@ -516,8 +558,11 @@ public final OperationFuture createFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
* Function function = Function.newBuilder().build();
@@ -554,8 +599,11 @@ public final OperationFuture createFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* CreateFunctionRequest request =
* CreateFunctionRequest.newBuilder()
@@ -583,8 +631,11 @@ public final OperationFuture createFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* CreateFunctionRequest request =
* CreateFunctionRequest.newBuilder()
@@ -612,8 +663,11 @@ public final OperationFuture createFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* CreateFunctionRequest request =
* CreateFunctionRequest.newBuilder()
@@ -639,8 +693,11 @@ public final UnaryCallable createFunctionCalla
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* Function function = Function.newBuilder().build();
* FieldMask updateMask = FieldMask.newBuilder().build();
@@ -667,8 +724,11 @@ public final OperationFuture updateFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* UpdateFunctionRequest request =
* UpdateFunctionRequest.newBuilder()
@@ -694,8 +754,11 @@ public final OperationFuture updateFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* UpdateFunctionRequest request =
* UpdateFunctionRequest.newBuilder()
@@ -721,8 +784,11 @@ public final OperationFuture updateFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* UpdateFunctionRequest request =
* UpdateFunctionRequest.newBuilder()
@@ -748,8 +814,11 @@ public final UnaryCallable updateFunctionCalla
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* FunctionName name = FunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]");
* functionServiceClient.deleteFunctionAsync(name).get();
@@ -773,8 +842,11 @@ public final OperationFuture deleteFunctionAsync(Funct
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* String name = FunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]").toString();
* functionServiceClient.deleteFunctionAsync(name).get();
@@ -797,8 +869,11 @@ public final OperationFuture deleteFunctionAsync(Strin
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* DeleteFunctionRequest request =
* DeleteFunctionRequest.newBuilder()
@@ -824,8 +899,11 @@ public final OperationFuture deleteFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* DeleteFunctionRequest request =
* DeleteFunctionRequest.newBuilder()
@@ -851,8 +929,11 @@ public final OperationFuture deleteFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* DeleteFunctionRequest request =
* DeleteFunctionRequest.newBuilder()
@@ -901,8 +982,11 @@ public final UnaryCallable deleteFunctionCalla
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* GenerateUploadUrlRequest request =
* GenerateUploadUrlRequest.newBuilder()
@@ -951,8 +1035,11 @@ public final GenerateUploadUrlResponse generateUploadUrl(GenerateUploadUrlReques
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* GenerateUploadUrlRequest request =
* GenerateUploadUrlRequest.newBuilder()
@@ -979,8 +1066,11 @@ public final GenerateUploadUrlResponse generateUploadUrl(GenerateUploadUrlReques
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* GenerateDownloadUrlRequest request =
* GenerateDownloadUrlRequest.newBuilder()
@@ -1006,8 +1096,11 @@ public final GenerateDownloadUrlResponse generateDownloadUrl(GenerateDownloadUrl
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* GenerateDownloadUrlRequest request =
* GenerateDownloadUrlRequest.newBuilder()
@@ -1032,8 +1125,11 @@ public final GenerateDownloadUrlResponse generateDownloadUrl(GenerateDownloadUrl
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
* ListRuntimesResponse response = functionServiceClient.listRuntimes(parent);
@@ -1059,8 +1155,11 @@ public final ListRuntimesResponse listRuntimes(LocationName parent) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
* ListRuntimesResponse response = functionServiceClient.listRuntimes(parent);
@@ -1083,8 +1182,11 @@ public final ListRuntimesResponse listRuntimes(String parent) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListRuntimesRequest request =
* ListRuntimesRequest.newBuilder()
@@ -1109,8 +1211,11 @@ public final ListRuntimesResponse listRuntimes(ListRuntimesRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListRuntimesRequest request =
* ListRuntimesRequest.newBuilder()
@@ -1135,8 +1240,11 @@ public final UnaryCallable listRuntim
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListLocationsRequest request =
* ListLocationsRequest.newBuilder()
@@ -1165,8 +1273,11 @@ public final ListLocationsPagedResponse listLocations(ListLocationsRequest reque
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListLocationsRequest request =
* ListLocationsRequest.newBuilder()
@@ -1196,8 +1307,11 @@ public final ListLocationsPagedResponse listLocations(ListLocationsRequest reque
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListLocationsRequest request =
* ListLocationsRequest.newBuilder()
@@ -1235,8 +1349,11 @@ public final UnaryCallable listLoca
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* SetIamPolicyRequest request =
* SetIamPolicyRequest.newBuilder()
@@ -1264,8 +1381,11 @@ public final Policy setIamPolicy(SetIamPolicyRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* SetIamPolicyRequest request =
* SetIamPolicyRequest.newBuilder()
@@ -1291,8 +1411,11 @@ public final UnaryCallable setIamPolicyCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* GetIamPolicyRequest request =
* GetIamPolicyRequest.newBuilder()
@@ -1318,8 +1441,11 @@ public final Policy getIamPolicy(GetIamPolicyRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* GetIamPolicyRequest request =
* GetIamPolicyRequest.newBuilder()
@@ -1348,8 +1474,11 @@ public final UnaryCallable getIamPolicyCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* TestIamPermissionsRequest request =
* TestIamPermissionsRequest.newBuilder()
@@ -1379,8 +1508,11 @@ public final TestIamPermissionsResponse testIamPermissions(TestIamPermissionsReq
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* TestIamPermissionsRequest request =
* TestIamPermissionsRequest.newBuilder()
diff --git a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/FunctionServiceSettings.java b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/FunctionServiceSettings.java
index e7cb6d98..aae713ae 100644
--- a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/FunctionServiceSettings.java
+++ b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/FunctionServiceSettings.java
@@ -65,17 +65,17 @@
* For example, to set the total timeout of getFunction to 30 seconds:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* FunctionServiceSettings.Builder functionServiceSettingsBuilder =
* FunctionServiceSettings.newBuilder();
* functionServiceSettingsBuilder
* .getFunctionSettings()
* .setRetrySettings(
- * functionServiceSettingsBuilder
- * .getFunctionSettings()
- * .getRetrySettings()
- * .toBuilder()
+ * functionServiceSettingsBuilder.getFunctionSettings().getRetrySettings().toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30))
* .build());
* FunctionServiceSettings functionServiceSettings = functionServiceSettingsBuilder.build();
diff --git a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/package-info.java b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/package-info.java
index 212cdf5b..182ac31b 100644
--- a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/package-info.java
+++ b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/package-info.java
@@ -31,8 +31,11 @@
* Sample for FunctionServiceClient:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* FunctionName name = FunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]");
* Function response = functionServiceClient.getFunction(name);
diff --git a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/stub/FunctionServiceStubSettings.java b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/stub/FunctionServiceStubSettings.java
index 55f82c08..f18fea98 100644
--- a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/stub/FunctionServiceStubSettings.java
+++ b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/stub/FunctionServiceStubSettings.java
@@ -100,17 +100,17 @@
* For example, to set the total timeout of getFunction to 30 seconds:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* FunctionServiceStubSettings.Builder functionServiceSettingsBuilder =
* FunctionServiceStubSettings.newBuilder();
* functionServiceSettingsBuilder
* .getFunctionSettings()
* .setRetrySettings(
- * functionServiceSettingsBuilder
- * .getFunctionSettings()
- * .getRetrySettings()
- * .toBuilder()
+ * functionServiceSettingsBuilder.getFunctionSettings().getRetrySettings().toBuilder()
* .setTotalTimeout(Duration.ofSeconds(30))
* .build());
* FunctionServiceStubSettings functionServiceSettings = functionServiceSettingsBuilder.build();
diff --git a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/stub/HttpJsonFunctionServiceStub.java b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/stub/HttpJsonFunctionServiceStub.java
index cbd0c128..a0b062bf 100644
--- a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/stub/HttpJsonFunctionServiceStub.java
+++ b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2alpha/stub/HttpJsonFunctionServiceStub.java
@@ -180,7 +180,7 @@ public class HttpJsonFunctionServiceStub extends FunctionServiceStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("function", request.getFunction()))
+ .toBody("function", request.getFunction(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -221,7 +221,7 @@ public class HttpJsonFunctionServiceStub extends FunctionServiceStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("function", request.getFunction()))
+ .toBody("function", request.getFunction(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -296,7 +296,7 @@ public class HttpJsonFunctionServiceStub extends FunctionServiceStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearParent().build()))
+ .toBody("*", request.toBuilder().clearParent().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -333,7 +333,7 @@ public class HttpJsonFunctionServiceStub extends FunctionServiceStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearName().build()))
+ .toBody("*", request.toBuilder().clearName().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -436,7 +436,7 @@ public class HttpJsonFunctionServiceStub extends FunctionServiceStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearResource().build()))
+ .toBody("*", request.toBuilder().clearResource().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
@@ -505,7 +505,7 @@ public class HttpJsonFunctionServiceStub extends FunctionServiceStub {
.setRequestBodyExtractor(
request ->
ProtoRestSerializer.create()
- .toBody("*", request.toBuilder().clearResource().build()))
+ .toBody("*", request.toBuilder().clearResource().build(), false))
.build())
.setResponseParser(
ProtoMessageResponseParser.newBuilder()
diff --git a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2beta/FunctionServiceClient.java b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2beta/FunctionServiceClient.java
index dc8cc17d..5b3ee0f0 100644
--- a/google-cloud-functions/src/main/java/com/google/cloud/functions/v2beta/FunctionServiceClient.java
+++ b/google-cloud-functions/src/main/java/com/google/cloud/functions/v2beta/FunctionServiceClient.java
@@ -60,8 +60,11 @@
* calls that map to API methods. Sample code to get started:
*
* {@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* FunctionName name = FunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]");
* Function response = functionServiceClient.getFunction(name);
@@ -98,8 +101,11 @@
* To customize credentials:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* FunctionServiceSettings functionServiceSettings =
* FunctionServiceSettings.newBuilder()
* .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))
@@ -111,8 +117,11 @@
* To customize the endpoint:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* FunctionServiceSettings functionServiceSettings =
* FunctionServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
* FunctionServiceClient functionServiceClient =
@@ -123,8 +132,11 @@
* the wire:
*
* {@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* FunctionServiceSettings functionServiceSettings =
* FunctionServiceSettings.newBuilder()
* .setTransportChannelProvider(
@@ -219,8 +231,11 @@ public final OperationsClient getHttpJsonOperationsClient() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* FunctionName name = FunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]");
* Function response = functionServiceClient.getFunction(name);
@@ -243,8 +258,11 @@ public final Function getFunction(FunctionName name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* String name = FunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]").toString();
* Function response = functionServiceClient.getFunction(name);
@@ -266,8 +284,11 @@ public final Function getFunction(String name) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* GetFunctionRequest request =
* GetFunctionRequest.newBuilder()
@@ -291,8 +312,11 @@ public final Function getFunction(GetFunctionRequest request) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* GetFunctionRequest request =
* GetFunctionRequest.newBuilder()
@@ -315,8 +339,11 @@ public final UnaryCallable getFunctionCallable() {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
* for (Function element : functionServiceClient.listFunctions(parent).iterateAll()) {
@@ -347,8 +374,11 @@ public final ListFunctionsPagedResponse listFunctions(LocationName parent) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
* for (Function element : functionServiceClient.listFunctions(parent).iterateAll()) {
@@ -376,8 +406,11 @@ public final ListFunctionsPagedResponse listFunctions(String parent) {
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListFunctionsRequest request =
* ListFunctionsRequest.newBuilder()
@@ -407,8 +440,11 @@ public final ListFunctionsPagedResponse listFunctions(ListFunctionsRequest reque
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListFunctionsRequest request =
* ListFunctionsRequest.newBuilder()
@@ -439,8 +475,11 @@ public final ListFunctionsPagedResponse listFunctions(ListFunctionsRequest reque
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* ListFunctionsRequest request =
* ListFunctionsRequest.newBuilder()
@@ -478,8 +517,11 @@ public final UnaryCallable listFunc
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* LocationName parent = LocationName.of("[PROJECT]", "[LOCATION]");
* Function function = Function.newBuilder().build();
@@ -516,8 +558,11 @@ public final OperationFuture createFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* String parent = LocationName.of("[PROJECT]", "[LOCATION]").toString();
* Function function = Function.newBuilder().build();
@@ -554,8 +599,11 @@ public final OperationFuture createFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* CreateFunctionRequest request =
* CreateFunctionRequest.newBuilder()
@@ -583,8 +631,11 @@ public final OperationFuture createFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* CreateFunctionRequest request =
* CreateFunctionRequest.newBuilder()
@@ -612,8 +663,11 @@ public final OperationFuture createFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* CreateFunctionRequest request =
* CreateFunctionRequest.newBuilder()
@@ -639,8 +693,11 @@ public final UnaryCallable createFunctionCalla
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* Function function = Function.newBuilder().build();
* FieldMask updateMask = FieldMask.newBuilder().build();
@@ -667,8 +724,11 @@ public final OperationFuture updateFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* UpdateFunctionRequest request =
* UpdateFunctionRequest.newBuilder()
@@ -694,8 +754,11 @@ public final OperationFuture updateFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* UpdateFunctionRequest request =
* UpdateFunctionRequest.newBuilder()
@@ -721,8 +784,11 @@ public final OperationFuture updateFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* UpdateFunctionRequest request =
* UpdateFunctionRequest.newBuilder()
@@ -748,8 +814,11 @@ public final UnaryCallable updateFunctionCalla
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* FunctionName name = FunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]");
* functionServiceClient.deleteFunctionAsync(name).get();
@@ -773,8 +842,11 @@ public final OperationFuture deleteFunctionAsync(Funct
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* String name = FunctionName.of("[PROJECT]", "[LOCATION]", "[FUNCTION]").toString();
* functionServiceClient.deleteFunctionAsync(name).get();
@@ -797,8 +869,11 @@ public final OperationFuture deleteFunctionAsync(Strin
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* DeleteFunctionRequest request =
* DeleteFunctionRequest.newBuilder()
@@ -824,8 +899,11 @@ public final OperationFuture deleteFunctionAsync(
* Sample code:
*
*
{@code
- * // This snippet has been automatically generated for illustrative purposes only.
- * // It may require modifications to work in your environment.
+ * // This snippet has been automatically generated and should be regarded as a code template only.
+ * // It will require modifications to work:
+ * // - It may require correct/in-range values for request initialization.
+ * // - It may require specifying regional endpoints when creating the service client as shown in
+ * // https://cloud.google.com/java/docs/setup#configure_endpoints_for_the_client_library
* try (FunctionServiceClient functionServiceClient = FunctionServiceClient.create()) {
* DeleteFunctionRequest request =
* DeleteFunctionRequest.newBuilder()
@@ -851,8 +929,11 @@ public final OperationFuture deleteFunctionAsync(
*