googleapis · gcf-merge-on-green · Sep 9, 2022 · Sep 9, 2022 · Sep 9, 2022
diff --git a/README.md b/README.md
@@ -19,20 +19,20 @@ If you are using Maven, add this to your pom.xml file:
 <dependency>
   <groupId>com.google.cloud</groupId>
   <artifactId>google-cloud-shell</artifactId>
-  <version>2.2.4</version>
+  <version>2.2.5</version>
 </dependency>
 ```
 
 If you are using Gradle without BOM, add this to your dependencies:
 
 ```Groovy
-implementation 'com.google.cloud:google-cloud-shell:2.2.4'
+implementation 'com.google.cloud:google-cloud-shell:2.2.5'
 ```
 
 If you are using SBT, add this to your dependencies:
 
 ```Scala
-libraryDependencies += "com.google.cloud" % "google-cloud-shell" % "2.2.4"
+libraryDependencies += "com.google.cloud" % "google-cloud-shell" % "2.2.5"
 ```
 
 ## Authentication

diff --git a/google-cloud-shell/src/main/java/com/google/cloud/shell/v1/CloudShellServiceClient.java b/google-cloud-shell/src/main/java/com/google/cloud/shell/v1/CloudShellServiceClient.java
diff --git a/google-cloud-shell/src/main/java/com/google/cloud/shell/v1/CloudShellServiceSettings.java b/google-cloud-shell/src/main/java/com/google/cloud/shell/v1/CloudShellServiceSettings.java
@@ -52,17 +52,17 @@
  * <p>For example, to set the total timeout of getEnvironment to 30 seconds:
  *
  * <pre>{@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
  * CloudShellServiceSettings.Builder cloudShellServiceSettingsBuilder =
  *     CloudShellServiceSettings.newBuilder();
  * cloudShellServiceSettingsBuilder
  *     .getEnvironmentSettings()
  *     .setRetrySettings(
- *         cloudShellServiceSettingsBuilder
- *             .getEnvironmentSettings()
- *             .getRetrySettings()
- *             .toBuilder()
+ *         cloudShellServiceSettingsBuilder.getEnvironmentSettings().getRetrySettings().toBuilder()
  *             .setTotalTimeout(Duration.ofSeconds(30))
  *             .build());
  * CloudShellServiceSettings cloudShellServiceSettings = cloudShellServiceSettingsBuilder.build();

diff --git a/google-cloud-shell/src/main/java/com/google/cloud/shell/v1/package-info.java b/google-cloud-shell/src/main/java/com/google/cloud/shell/v1/package-info.java
@@ -28,8 +28,11 @@
  * <p>Sample for CloudShellServiceClient:
  *
  * <pre>{@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 (CloudShellServiceClient cloudShellServiceClient = CloudShellServiceClient.create()) {
  *   EnvironmentName name = EnvironmentName.of("[USER]", "[ENVIRONMENT]");
  *   Environment response = cloudShellServiceClient.getEnvironment(name);

diff --git a/...oud-shell/src/main/java/com/google/cloud/shell/v1/stub/CloudShellServiceStubSettings.java b/...oud-shell/src/main/java/com/google/cloud/shell/v1/stub/CloudShellServiceStubSettings.java
@@ -80,17 +80,17 @@
  * <p>For example, to set the total timeout of getEnvironment to 30 seconds:
  *
  * <pre>{@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
  * CloudShellServiceStubSettings.Builder cloudShellServiceSettingsBuilder =
  *     CloudShellServiceStubSettings.newBuilder();
  * cloudShellServiceSettingsBuilder
  *     .getEnvironmentSettings()
  *     .setRetrySettings(
- *         cloudShellServiceSettingsBuilder
- *             .getEnvironmentSettings()
- *             .getRetrySettings()
- *             .toBuilder()
+ *         cloudShellServiceSettingsBuilder.getEnvironmentSettings().getRetrySettings().toBuilder()
  *             .setTotalTimeout(Duration.ofSeconds(30))
  *             .build());
  * CloudShellServiceStubSettings cloudShellServiceSettings =

diff --git a/...oud-shell/src/main/java/com/google/cloud/shell/v1/stub/HttpJsonCloudShellServiceStub.java b/...oud-shell/src/main/java/com/google/cloud/shell/v1/stub/HttpJsonCloudShellServiceStub.java
@@ -136,7 +136,7 @@ public class HttpJsonCloudShellServiceStub extends CloudShellServiceStub {
                       .setRequestBodyExtractor(
                           request ->
                               ProtoRestSerializer.create()
-                                  .toBody("*", request.toBuilder().clearName().build()))
+                                  .toBody("*", request.toBuilder().clearName().build(), false))
                       .build())
               .setResponseParser(
                   ProtoMessageResponseParser.<Operation>newBuilder()
@@ -175,7 +175,7 @@ public class HttpJsonCloudShellServiceStub extends CloudShellServiceStub {
                       .setRequestBodyExtractor(
                           request ->
                               ProtoRestSerializer.create()
-                                  .toBody("*", request.toBuilder().clearName().build()))
+                                  .toBody("*", request.toBuilder().clearName().build(), false))
                       .build())
               .setResponseParser(
                   ProtoMessageResponseParser.<Operation>newBuilder()
@@ -215,7 +215,8 @@ public class HttpJsonCloudShellServiceStub extends CloudShellServiceStub {
                       .setRequestBodyExtractor(
                           request ->
                               ProtoRestSerializer.create()
-                                  .toBody("*", request.toBuilder().clearEnvironment().build()))
+                                  .toBody(
+                                      "*", request.toBuilder().clearEnvironment().build(), false))
                       .build())
               .setResponseParser(
                   ProtoMessageResponseParser.<Operation>newBuilder()
@@ -255,7 +256,8 @@ public class HttpJsonCloudShellServiceStub extends CloudShellServiceStub {
                       .setRequestBodyExtractor(
                           request ->
                               ProtoRestSerializer.create()
-                                  .toBody("*", request.toBuilder().clearEnvironment().build()))
+                                  .toBody(
+                                      "*", request.toBuilder().clearEnvironment().build(), false))
                       .build())
               .setResponseParser(
                   ProtoMessageResponseParser.<Operation>newBuilder()

diff --git a/...ted/com/google/cloud/shell/v1/cloudshellserviceclient/addpublickey/AsyncAddPublicKey.java b/...ted/com/google/cloud/shell/v1/cloudshellserviceclient/addpublickey/AsyncAddPublicKey.java
@@ -29,8 +29,11 @@ public static void main(String[] args) throws Exception {
   }
 
   public static void asyncAddPublicKey() throws Exception {
-    // 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 (CloudShellServiceClient cloudShellServiceClient = CloudShellServiceClient.create()) {
       AddPublicKeyRequest request =
           AddPublicKeyRequest.newBuilder()

diff --git a/.../com/google/cloud/shell/v1/cloudshellserviceclient/addpublickey/AsyncAddPublicKeyLRO.java b/.../com/google/cloud/shell/v1/cloudshellserviceclient/addpublickey/AsyncAddPublicKeyLRO.java
@@ -30,8 +30,11 @@ public static void main(String[] args) throws Exception {
   }
 
   public static void asyncAddPublicKeyLRO() throws Exception {
-    // 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 (CloudShellServiceClient cloudShellServiceClient = CloudShellServiceClient.create()) {
       AddPublicKeyRequest request =
           AddPublicKeyRequest.newBuilder()

diff --git a/...ated/com/google/cloud/shell/v1/cloudshellserviceclient/addpublickey/SyncAddPublicKey.java b/...ated/com/google/cloud/shell/v1/cloudshellserviceclient/addpublickey/SyncAddPublicKey.java
@@ -28,8 +28,11 @@ public static void main(String[] args) throws Exception {
   }
 
   public static void syncAddPublicKey() throws Exception {
-    // 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 (CloudShellServiceClient cloudShellServiceClient = CloudShellServiceClient.create()) {
       AddPublicKeyRequest request =
           AddPublicKeyRequest.newBuilder()

diff --git a/...loud/shell/v1/cloudshellserviceclient/authorizeenvironment/AsyncAuthorizeEnvironment.java b/...loud/shell/v1/cloudshellserviceclient/authorizeenvironment/AsyncAuthorizeEnvironment.java
@@ -30,8 +30,11 @@ public static void main(String[] args) throws Exception {
   }
 
   public static void asyncAuthorizeEnvironment() throws Exception {
-    // 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 (CloudShellServiceClient cloudShellServiceClient = CloudShellServiceClient.create()) {
       AuthorizeEnvironmentRequest request =
           AuthorizeEnvironmentRequest.newBuilder()

diff --git a/...d/shell/v1/cloudshellserviceclient/authorizeenvironment/AsyncAuthorizeEnvironmentLRO.java b/...d/shell/v1/cloudshellserviceclient/authorizeenvironment/AsyncAuthorizeEnvironmentLRO.java
@@ -31,8 +31,11 @@ public static void main(String[] args) throws Exception {
   }
 
   public static void asyncAuthorizeEnvironmentLRO() throws Exception {
-    // 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 (CloudShellServiceClient cloudShellServiceClient = CloudShellServiceClient.create()) {
       AuthorizeEnvironmentRequest request =
           AuthorizeEnvironmentRequest.newBuilder()

diff --git a/...cloud/shell/v1/cloudshellserviceclient/authorizeenvironment/SyncAuthorizeEnvironment.java b/...cloud/shell/v1/cloudshellserviceclient/authorizeenvironment/SyncAuthorizeEnvironment.java
@@ -29,8 +29,11 @@ public static void main(String[] args) throws Exception {
   }
 
   public static void syncAuthorizeEnvironment() throws Exception {
-    // 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 (CloudShellServiceClient cloudShellServiceClient = CloudShellServiceClient.create()) {
       AuthorizeEnvironmentRequest request =
           AuthorizeEnvironmentRequest.newBuilder()

diff --git a/...oogle/cloud/shell/v1/cloudshellserviceclient/create/SyncCreateSetCredentialsProvider.java b/...oogle/cloud/shell/v1/cloudshellserviceclient/create/SyncCreateSetCredentialsProvider.java
@@ -29,8 +29,11 @@ public static void main(String[] args) throws Exception {
   }
 
   public static void syncCreateSetCredentialsProvider() throws Exception {
-    // 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
     CloudShellServiceSettings cloudShellServiceSettings =
         CloudShellServiceSettings.newBuilder()
             .setCredentialsProvider(FixedCredentialsProvider.create(myCredentials))

diff --git a/...ogle/cloud/shell/v1/cloudshellserviceclient/create/SyncCreateSetCredentialsProvider1.java b/...ogle/cloud/shell/v1/cloudshellserviceclient/create/SyncCreateSetCredentialsProvider1.java
@@ -27,8 +27,11 @@ public static void main(String[] args) throws Exception {
   }
 
   public static void syncCreateSetCredentialsProvider1() throws Exception {
-    // 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
     CloudShellServiceSettings cloudShellServiceSettings =
         CloudShellServiceSettings.newBuilder()
             .setTransportChannelProvider(

diff --git a/...rated/com/google/cloud/shell/v1/cloudshellserviceclient/create/SyncCreateSetEndpoint.java b/...rated/com/google/cloud/shell/v1/cloudshellserviceclient/create/SyncCreateSetEndpoint.java
@@ -28,8 +28,11 @@ public static void main(String[] args) throws Exception {
   }
 
   public static void syncCreateSetEndpoint() throws Exception {
-    // 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
     CloudShellServiceSettings cloudShellServiceSettings =
         CloudShellServiceSettings.newBuilder().setEndpoint(myEndpoint).build();
     CloudShellServiceClient cloudShellServiceClient =

diff --git a/...com/google/cloud/shell/v1/cloudshellserviceclient/getenvironment/AsyncGetEnvironment.java b/...com/google/cloud/shell/v1/cloudshellserviceclient/getenvironment/AsyncGetEnvironment.java
@@ -30,8 +30,11 @@ public static void main(String[] args) throws Exception {
   }
 
   public static void asyncGetEnvironment() throws Exception {
-    // 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 (CloudShellServiceClient cloudShellServiceClient = CloudShellServiceClient.create()) {
       GetEnvironmentRequest request =
           GetEnvironmentRequest.newBuilder()

diff --git a/.../com/google/cloud/shell/v1/cloudshellserviceclient/getenvironment/SyncGetEnvironment.java b/.../com/google/cloud/shell/v1/cloudshellserviceclient/getenvironment/SyncGetEnvironment.java
@@ -29,8 +29,11 @@ public static void main(String[] args) throws Exception {
   }
 
   public static void syncGetEnvironment() throws Exception {
-    // 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 (CloudShellServiceClient cloudShellServiceClient = CloudShellServiceClient.create()) {
       GetEnvironmentRequest request =
           GetEnvironmentRequest.newBuilder()

diff --git a/...ud/shell/v1/cloudshellserviceclient/getenvironment/SyncGetEnvironmentEnvironmentname.java b/...ud/shell/v1/cloudshellserviceclient/getenvironment/SyncGetEnvironmentEnvironmentname.java
@@ -28,8 +28,11 @@ public static void main(String[] args) throws Exception {
   }
 
   public static void syncGetEnvironmentEnvironmentname() throws Exception {
-    // 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 (CloudShellServiceClient cloudShellServiceClient = CloudShellServiceClient.create()) {
       EnvironmentName name = EnvironmentName.of("[USER]", "[ENVIRONMENT]");
       Environment response = cloudShellServiceClient.getEnvironment(name);

diff --git a/...oogle/cloud/shell/v1/cloudshellserviceclient/getenvironment/SyncGetEnvironmentString.java b/...oogle/cloud/shell/v1/cloudshellserviceclient/getenvironment/SyncGetEnvironmentString.java
@@ -28,8 +28,11 @@ public static void main(String[] args) throws Exception {
   }
 
   public static void syncGetEnvironmentString() throws Exception {
-    // 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 (CloudShellServiceClient cloudShellServiceClient = CloudShellServiceClient.create()) {
       String name = EnvironmentName.of("[USER]", "[ENVIRONMENT]").toString();
       Environment response = cloudShellServiceClient.getEnvironment(name);

diff --git a/...m/google/cloud/shell/v1/cloudshellserviceclient/removepublickey/AsyncRemovePublicKey.java b/...m/google/cloud/shell/v1/cloudshellserviceclient/removepublickey/AsyncRemovePublicKey.java
@@ -29,8 +29,11 @@ public static void main(String[] args) throws Exception {
   }
 
   public static void asyncRemovePublicKey() throws Exception {
-    // 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 (CloudShellServiceClient cloudShellServiceClient = CloudShellServiceClient.create()) {
       RemovePublicKeyRequest request =
           RemovePublicKeyRequest.newBuilder()

diff --git a/...oogle/cloud/shell/v1/cloudshellserviceclient/removepublickey/AsyncRemovePublicKeyLRO.java b/...oogle/cloud/shell/v1/cloudshellserviceclient/removepublickey/AsyncRemovePublicKeyLRO.java
@@ -30,8 +30,11 @@ public static void main(String[] args) throws Exception {
   }
 
   public static void asyncRemovePublicKeyLRO() throws Exception {
-    // 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 (CloudShellServiceClient cloudShellServiceClient = CloudShellServiceClient.create()) {
       RemovePublicKeyRequest request =
           RemovePublicKeyRequest.newBuilder()