docs: [container] Operation.Type is now documented in detail (#9351)

* feat: Add support for updating additional pod IPv4 ranges for Standard and Autopilot clusters

PiperOrigin-RevId: 524333419

Source-Link: googleapis/googleapis@813f189

Source-Link: https://github.com/googleapis/googleapis-gen/commit/dbfd75eb6e6eb228712d5fb5de980dae72a3a8c0
Copy-Tag: eyJwIjoiamF2YS1jb250YWluZXIvLk93bEJvdC55YW1sIiwiaCI6ImRiZmQ3NWViNmU2ZWIyMjg3MTJkNWZiNWRlOTgwZGFlNzJhM2E4YzAifQ==

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* feat: Add support for updating additional pod IPv4 ranges for Standard and Autopilot clusters

PiperOrigin-RevId: 524334945

Source-Link: googleapis/googleapis@46ae6df

Source-Link: https://github.com/googleapis/googleapis-gen/commit/45daacfdbd622abb91daa2e6a11d04eba306040f
Copy-Tag: eyJwIjoiamF2YS1jb250YWluZXIvLk93bEJvdC55YW1sIiwiaCI6IjQ1ZGFhY2ZkYmQ2MjJhYmI5MWRhYTJlNmExMWQwNGViYTMwNjA0MGYifQ==

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* docs: Operation.Type is now documented in detail
docs: Operation.self_link and Operation.target_link given examples
feat: Cluster resizes will now have their own operation type (RESIZE_CLUSTER) instead of reusing REPAIR_CLUSTER; they will start using this in the near future

PiperOrigin-RevId: 526025502

Source-Link: googleapis/googleapis@4273180

Source-Link: https://github.com/googleapis/googleapis-gen/commit/772e2cd48f561e1f0a4d172e9f9285ad9e1c1210
Copy-Tag: eyJwIjoiamF2YS1jb250YWluZXIvLk93bEJvdC55YW1sIiwiaCI6Ijc3MmUyY2Q0OGY1NjFlMWYwYTRkMTcyZTlmOTI4NWFkOWUxYzEyMTAifQ==

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* docs: minor formatting in docstring

PiperOrigin-RevId: 526164785

Source-Link: googleapis/googleapis@7a1cb37

Source-Link: https://github.com/googleapis/googleapis-gen/commit/c79afdf9cdca7434b5972b53af48ece5f89186c1
Copy-Tag: eyJwIjoiamF2YS1jb250YWluZXIvLk93bEJvdC55YW1sIiwiaCI6ImM3OWFmZGY5Y2RjYTc0MzRiNTk3MmI1M2FmNDhlY2U1Zjg5MTg2YzEifQ==

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

* docs: Operation.Type is now documented in detail
docs: Operation.self_link and Operation.target_link given examples
feat: Cluster resizes will now have their own operation type (RESIZE_CLUSTER) instead of reusing REPAIR_CLUSTER; they will start using this in the near future

PiperOrigin-RevId: 526970355

Source-Link: googleapis/googleapis@83fd1f9

Source-Link: https://github.com/googleapis/googleapis-gen/commit/5a191c3aa2c526a59eea597c7ddda79481b8e858
Copy-Tag: eyJwIjoiamF2YS1jb250YWluZXIvLk93bEJvdC55YW1sIiwiaCI6IjVhMTkxYzNhYTJjNTI2YTU5ZWVhNTk3YzdkZGRhNzk0ODFiOGU4NTgifQ==

* 🦉 Updates from OwlBot post-processor

See https://github.com/googleapis/repo-automation-bots/blob/main/packages/owl-bot/README.md

---------

Co-authored-by: Owl Bot <gcf-owl-bot[bot]@users.noreply.github.com>

java-container/README.md

@@ -20,7 +20,7 @@ If you are using Maven with [BOM][libraries-bom], add this to your pom.xml file:
     <dependency>
       <groupId>com.google.cloud</groupId>
       <artifactId>libraries-bom</artifactId>
-      <version>26.12.0</version>
+      <version>26.13.0</version>
       <type>pom</type>
       <scope>import</scope>
     </dependency>
@@ -195,7 +195,7 @@ Java is a registered trademark of Oracle and/or its affiliates.
 [kokoro-badge-link-5]: http://storage.googleapis.com/cloud-devrel-public/java/badges/google-cloud-java/java11.html
 [stability-image]: https://img.shields.io/badge/stability-stable-green
 [maven-version-image]: https://img.shields.io/maven-central/v/com.google.cloud/google-cloud-container.svg
-[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-container/2.17.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-container/2.18.0
 [authentication]: https://github.com/googleapis/google-cloud-java#authentication
 [auth-scopes]: https://developers.google.com/identity/protocols/oauth2/scopes
 [predefined-iam-roles]: https://cloud.google.com/iam/docs/understanding-roles#predefined_roles

java-container/proto-google-cloud-container-v1/src/main/java/com/google/container/v1/AdditionalPodRangesConfig.java

@@ -38,7 +38,9 @@ private AdditionalPodRangesConfig(com.google.protobuf.GeneratedMessageV3.Builder
     super(builder);
   }
 
-  private AdditionalPodRangesConfig() {}
+  private AdditionalPodRangesConfig() {
+    podRangeNames_ = com.google.protobuf.LazyStringArrayList.EMPTY;
+  }
 
   @java.lang.Override
   @SuppressWarnings({"unused"})
@@ -66,6 +68,69 @@ public static final com.google.protobuf.Descriptors.Descriptor getDescriptor() {
             com.google.container.v1.AdditionalPodRangesConfig.Builder.class);
   }
 
+  public static final int POD_RANGE_NAMES_FIELD_NUMBER = 1;
+
+  @SuppressWarnings("serial")
+  private com.google.protobuf.LazyStringList podRangeNames_;
+  /**
+   *
+   *
+   * <pre>
+   * Name for pod secondary ipv4 range which has the actual range defined ahead.
+   * </pre>
+   *
+   * <code>repeated string pod_range_names = 1;</code>
+   *
+   * @return A list containing the podRangeNames.
+   */
+  public com.google.protobuf.ProtocolStringList getPodRangeNamesList() {
+    return podRangeNames_;
+  }
+  /**
+   *
+   *
+   * <pre>
+   * Name for pod secondary ipv4 range which has the actual range defined ahead.
+   * </pre>
+   *
+   * <code>repeated string pod_range_names = 1;</code>
+   *
+   * @return The count of podRangeNames.
+   */
+  public int getPodRangeNamesCount() {
+    return podRangeNames_.size();
+  }
+  /**
+   *
+   *
+   * <pre>
+   * Name for pod secondary ipv4 range which has the actual range defined ahead.
+   * </pre>
+   *
+   * <code>repeated string pod_range_names = 1;</code>
+   *
+   * @param index The index of the element to return.
+   * @return The podRangeNames at the given index.
+   */
+  public java.lang.String getPodRangeNames(int index) {
+    return podRangeNames_.get(index);
+  }
+  /**
+   *
+   *
+   * <pre>
+   * Name for pod secondary ipv4 range which has the actual range defined ahead.
+   * </pre>
+   *
+   * <code>repeated string pod_range_names = 1;</code>
+   *
+   * @param index The index of the value to return.
+   * @return The bytes of the podRangeNames at the given index.
+   */
+  public com.google.protobuf.ByteString getPodRangeNamesBytes(int index) {
+    return podRangeNames_.getByteString(index);
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -80,6 +145,9 @@ public final boolean isInitialized() {
 
   @java.lang.Override
   public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io.IOException {
+    for (int i = 0; i < podRangeNames_.size(); i++) {
+      com.google.protobuf.GeneratedMessageV3.writeString(output, 1, podRangeNames_.getRaw(i));
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -89,6 +157,14 @@ public int getSerializedSize() {
     if (size != -1) return size;
 
     size = 0;
+    {
+      int dataSize = 0;
+      for (int i = 0; i < podRangeNames_.size(); i++) {
+        dataSize += computeStringSizeNoTag(podRangeNames_.getRaw(i));
+      }
+      size += dataSize;
+      size += 1 * getPodRangeNamesList().size();
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -105,6 +181,7 @@ public boolean equals(final java.lang.Object obj) {
     com.google.container.v1.AdditionalPodRangesConfig other =
         (com.google.container.v1.AdditionalPodRangesConfig) obj;
 
+    if (!getPodRangeNamesList().equals(other.getPodRangeNamesList())) return false;
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -116,6 +193,10 @@ public int hashCode() {
     }
     int hash = 41;
     hash = (19 * hash) + getDescriptor().hashCode();
+    if (getPodRangeNamesCount() > 0) {
+      hash = (37 * hash) + POD_RANGE_NAMES_FIELD_NUMBER;
+      hash = (53 * hash) + getPodRangeNamesList().hashCode();
+    }
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -255,6 +336,9 @@ private Builder(com.google.protobuf.GeneratedMessageV3.BuilderParent parent) {
     @java.lang.Override
     public Builder clear() {
       super.clear();
+      bitField0_ = 0;
+      podRangeNames_ = com.google.protobuf.LazyStringArrayList.EMPTY;
+      bitField0_ = (bitField0_ & ~0x00000001);
       return this;
     }
 
@@ -282,10 +366,27 @@ public com.google.container.v1.AdditionalPodRangesConfig build() {
     public com.google.container.v1.AdditionalPodRangesConfig buildPartial() {
       com.google.container.v1.AdditionalPodRangesConfig result =
           new com.google.container.v1.AdditionalPodRangesConfig(this);
+      buildPartialRepeatedFields(result);
+      if (bitField0_ != 0) {
+        buildPartial0(result);
+      }
       onBuilt();
       return result;
     }
 
+    private void buildPartialRepeatedFields(
+        com.google.container.v1.AdditionalPodRangesConfig result) {
+      if (((bitField0_ & 0x00000001) != 0)) {
+        podRangeNames_ = podRangeNames_.getUnmodifiableView();
+        bitField0_ = (bitField0_ & ~0x00000001);
+      }
+      result.podRangeNames_ = podRangeNames_;
+    }
+
+    private void buildPartial0(com.google.container.v1.AdditionalPodRangesConfig result) {
+      int from_bitField0_ = bitField0_;
+    }
+
     @java.lang.Override
     public Builder clone() {
       return super.clone();
@@ -332,6 +433,16 @@ public Builder mergeFrom(com.google.protobuf.Message other) {
     public Builder mergeFrom(com.google.container.v1.AdditionalPodRangesConfig other) {
       if (other == com.google.container.v1.AdditionalPodRangesConfig.getDefaultInstance())
         return this;
+      if (!other.podRangeNames_.isEmpty()) {
+        if (podRangeNames_.isEmpty()) {
+          podRangeNames_ = other.podRangeNames_;
+          bitField0_ = (bitField0_ & ~0x00000001);
+        } else {
+          ensurePodRangeNamesIsMutable();
+          podRangeNames_.addAll(other.podRangeNames_);
+        }
+        onChanged();
+      }
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -358,6 +469,13 @@ public Builder mergeFrom(
             case 0:
               done = true;
               break;
+            case 10:
+              {
+                java.lang.String s = input.readStringRequireUtf8();
+                ensurePodRangeNamesIsMutable();
+                podRangeNames_.add(s);
+                break;
+              } // case 10
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -375,6 +493,176 @@ public Builder mergeFrom(
       return this;
     }
 
+    private int bitField0_;
+
+    private com.google.protobuf.LazyStringList podRangeNames_ =
+        com.google.protobuf.LazyStringArrayList.EMPTY;
+
+    private void ensurePodRangeNamesIsMutable() {
+      if (!((bitField0_ & 0x00000001) != 0)) {
+        podRangeNames_ = new com.google.protobuf.LazyStringArrayList(podRangeNames_);
+        bitField0_ |= 0x00000001;
+      }
+    }
+    /**
+     *
+     *
+     * <pre>
+     * Name for pod secondary ipv4 range which has the actual range defined ahead.
+     * </pre>
+     *
+     * <code>repeated string pod_range_names = 1;</code>
+     *
+     * @return A list containing the podRangeNames.
+     */
+    public com.google.protobuf.ProtocolStringList getPodRangeNamesList() {
+      return podRangeNames_.getUnmodifiableView();
+    }
+    /**
+     *
+     *
+     * <pre>
+     * Name for pod secondary ipv4 range which has the actual range defined ahead.
+     * </pre>
+     *
+     * <code>repeated string pod_range_names = 1;</code>
+     *
+     * @return The count of podRangeNames.
+     */
+    public int getPodRangeNamesCount() {
+      return podRangeNames_.size();
+    }
+    /**
+     *
+     *
+     * <pre>
+     * Name for pod secondary ipv4 range which has the actual range defined ahead.
+     * </pre>
+     *
+     * <code>repeated string pod_range_names = 1;</code>
+     *
+     * @param index The index of the element to return.
+     * @return The podRangeNames at the given index.
+     */
+    public java.lang.String getPodRangeNames(int index) {
+      return podRangeNames_.get(index);
+    }
+    /**
+     *
+     *
+     * <pre>
+     * Name for pod secondary ipv4 range which has the actual range defined ahead.
+     * </pre>
+     *
+     * <code>repeated string pod_range_names = 1;</code>
+     *
+     * @param index The index of the value to return.
+     * @return The bytes of the podRangeNames at the given index.
+     */
+    public com.google.protobuf.ByteString getPodRangeNamesBytes(int index) {
+      return podRangeNames_.getByteString(index);
+    }
+    /**
+     *
+     *
+     * <pre>
+     * Name for pod secondary ipv4 range which has the actual range defined ahead.
+     * </pre>
+     *
+     * <code>repeated string pod_range_names = 1;</code>
+     *
+     * @param index The index to set the value at.
+     * @param value The podRangeNames to set.
+     * @return This builder for chaining.
+     */
+    public Builder setPodRangeNames(int index, java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      ensurePodRangeNamesIsMutable();
+      podRangeNames_.set(index, value);
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * <pre>
+     * Name for pod secondary ipv4 range which has the actual range defined ahead.
+     * </pre>
+     *
+     * <code>repeated string pod_range_names = 1;</code>
+     *
+     * @param value The podRangeNames to add.
+     * @return This builder for chaining.
+     */
+    public Builder addPodRangeNames(java.lang.String value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      ensurePodRangeNamesIsMutable();
+      podRangeNames_.add(value);
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * <pre>
+     * Name for pod secondary ipv4 range which has the actual range defined ahead.
+     * </pre>
+     *
+     * <code>repeated string pod_range_names = 1;</code>
+     *
+     * @param values The podRangeNames to add.
+     * @return This builder for chaining.
+     */
+    public Builder addAllPodRangeNames(java.lang.Iterable<java.lang.String> values) {
+      ensurePodRangeNamesIsMutable();
+      com.google.protobuf.AbstractMessageLite.Builder.addAll(values, podRangeNames_);
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * <pre>
+     * Name for pod secondary ipv4 range which has the actual range defined ahead.
+     * </pre>
+     *
+     * <code>repeated string pod_range_names = 1;</code>
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearPodRangeNames() {
+      podRangeNames_ = com.google.protobuf.LazyStringArrayList.EMPTY;
+      bitField0_ = (bitField0_ & ~0x00000001);
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * <pre>
+     * Name for pod secondary ipv4 range which has the actual range defined ahead.
+     * </pre>
+     *
+     * <code>repeated string pod_range_names = 1;</code>
+     *
+     * @param value The bytes of the podRangeNames to add.
+     * @return This builder for chaining.
+     */
+    public Builder addPodRangeNamesBytes(com.google.protobuf.ByteString value) {
+      if (value == null) {
+        throw new NullPointerException();
+      }
+      checkByteStringIsUtf8(value);
+      ensurePodRangeNamesIsMutable();
+      podRangeNames_.add(value);
+      onChanged();
+      return this;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);