docs: [container] improve API documentation for Binary Authorization (#…

…10063)

* feat: add Provisioning Request API
feat: add AutopilotConversionStatus
docs: Improve NodePool documentation

PiperOrigin-RevId: 583137228

Source-Link: googleapis/googleapis@04b0501

Source-Link: https://github.com/googleapis/googleapis-gen/commit/c577f12068d7f6121b0e73456ddb8bfe738d0e6e
Copy-Tag: eyJwIjoiamF2YS1jb250YWluZXIvLk93bEJvdC55YW1sIiwiaCI6ImM1NzdmMTIwNjhkN2Y2MTIxYjBlNzM0NTZkZGI4YmZlNzM4ZDBlNmUifQ==

* 🦉 Updates from OwlBot post-processor

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

* feat: add Provisioning Request API

PiperOrigin-RevId: 583194664

Source-Link: googleapis/googleapis@a241916

Source-Link: https://github.com/googleapis/googleapis-gen/commit/a0607176f3635b80bcfb224c7876737736c3b184
Copy-Tag: eyJwIjoiamF2YS1jb250YWluZXIvLk93bEJvdC55YW1sIiwiaCI6ImEwNjA3MTc2ZjM2MzViODBiY2ZiMjI0Yzc4NzY3Mzc3MzZjM2IxODQifQ==

* 🦉 Updates from OwlBot post-processor

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

* feat: add enable_relay field to advanced_datapath_observability_config

---
feat: Enable Enterprise Flag to allow configuring Advanced Vuln Insights
PiperOrigin-RevId: 584402755

Source-Link: googleapis/googleapis@d6ac5d8

Source-Link: https://github.com/googleapis/googleapis-gen/commit/62528b5b0dcd84129a181229cbf8afe8ff82c660
Copy-Tag: eyJwIjoiamF2YS1jb250YWluZXIvLk93bEJvdC55YW1sIiwiaCI6IjYyNTI4YjViMGRjZDg0MTI5YTE4MTIyOWNiZjhhZmU4ZmY4MmM2NjAifQ==

* 🦉 Updates from OwlBot post-processor

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

* feat: add enable_relay field to advanced_datapath_observability_config

PiperOrigin-RevId: 584749992

Source-Link: googleapis/googleapis@0e3b813

Source-Link: https://github.com/googleapis/googleapis-gen/commit/d49e220cc164f34768262aa766c947caa0e63729
Copy-Tag: eyJwIjoiamF2YS1jb250YWluZXIvLk93bEJvdC55YW1sIiwiaCI6ImQ0OWUyMjBjYzE2NGYzNDc2ODI2MmFhNzY2Yzk0N2NhYTBlNjM3MjkifQ==

* 🦉 Updates from OwlBot post-processor

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

* docs: improve API documentation for Binary Authorization

PiperOrigin-RevId: 584927082

Source-Link: googleapis/googleapis@0be2364

Source-Link: https://github.com/googleapis/googleapis-gen/commit/3a1de01c0d1e1b07e3bd4d22594771acd889e580
Copy-Tag: eyJwIjoiamF2YS1jb250YWluZXIvLk93bEJvdC55YW1sIiwiaCI6IjNhMWRlMDFjMGQxZTFiMDdlM2JkNGQyMjU5NDc3MWFjZDg4OWU1ODAifQ==

* 🦉 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.26.0</version>
+      <version>26.27.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.32.0
+[maven-version-link]: https://central.sonatype.com/artifact/com.google.cloud/google-cloud-container/2.33.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/google-cloud-container/src/main/resources/META-INF/native-image/com.google.cloud.container.v1/reflect-config.json

@@ -2501,6 +2501,24 @@
     "allDeclaredClasses": true,
     "allPublicClasses": true
   },
+  {
+    "name": "com.google.container.v1.NodePool$QueuedProvisioning",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
+  {
+    "name": "com.google.container.v1.NodePool$QueuedProvisioning$Builder",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
   {
     "name": "com.google.container.v1.NodePool$Status",
     "queryAllDeclaredConstructors": true,

java-container/google-cloud-container/src/main/resources/META-INF/native-image/com.google.cloud.container.v1beta1/reflect-config.json

@@ -593,6 +593,33 @@
     "allDeclaredClasses": true,
     "allPublicClasses": true
   },
+  {
+    "name": "com.google.container.v1beta1.AutopilotConversionStatus",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
+  {
+    "name": "com.google.container.v1beta1.AutopilotConversionStatus$Builder",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
+  {
+    "name": "com.google.container.v1beta1.AutopilotConversionStatus$State",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
   {
     "name": "com.google.container.v1beta1.AutoprovisioningNodePoolDefaults",
     "queryAllDeclaredConstructors": true,
@@ -2753,6 +2780,24 @@
     "allDeclaredClasses": true,
     "allPublicClasses": true
   },
+  {
+    "name": "com.google.container.v1beta1.NodePool$QueuedProvisioning",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
+  {
+    "name": "com.google.container.v1beta1.NodePool$QueuedProvisioning$Builder",
+    "queryAllDeclaredConstructors": true,
+    "queryAllPublicConstructors": true,
+    "queryAllDeclaredMethods": true,
+    "allPublicMethods": true,
+    "allDeclaredClasses": true,
+    "allPublicClasses": true
+  },
   {
     "name": "com.google.container.v1beta1.NodePool$Status",
     "queryAllDeclaredConstructors": true,

java-container/google-cloud-container/src/test/java/com/google/cloud/container/v1/ClusterManagerClientTest.java

@@ -2094,6 +2094,7 @@ public void getNodePoolTest() throws Exception {
             .setPlacementPolicy(NodePool.PlacementPolicy.newBuilder().build())
             .setUpdateInfo(NodePool.UpdateInfo.newBuilder().build())
             .setEtag("etag3123477")
+            .setQueuedProvisioning(NodePool.QueuedProvisioning.newBuilder().build())
             .setBestEffortProvisioning(BestEffortProvisioning.newBuilder().build())
             .build();
     mockClusterManager.addResponse(expectedResponse);
@@ -2150,6 +2151,7 @@ public void getNodePoolTest2() throws Exception {
             .setPlacementPolicy(NodePool.PlacementPolicy.newBuilder().build())
             .setUpdateInfo(NodePool.UpdateInfo.newBuilder().build())
             .setEtag("etag3123477")
+            .setQueuedProvisioning(NodePool.QueuedProvisioning.newBuilder().build())
             .setBestEffortProvisioning(BestEffortProvisioning.newBuilder().build())
             .build();
     mockClusterManager.addResponse(expectedResponse);

java-container/google-cloud-container/src/test/java/com/google/cloud/container/v1beta1/ClusterManagerClientTest.java

@@ -1389,6 +1389,7 @@ public void getNodePoolTest() throws Exception {
             .setPlacementPolicy(NodePool.PlacementPolicy.newBuilder().build())
             .setUpdateInfo(NodePool.UpdateInfo.newBuilder().build())
             .setEtag("etag3123477")
+            .setQueuedProvisioning(NodePool.QueuedProvisioning.newBuilder().build())
             .setBestEffortProvisioning(BestEffortProvisioning.newBuilder().build())
             .build();
     mockClusterManager.addResponse(expectedResponse);

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

@@ -246,6 +246,7 @@ private RelayMode(int value) {
     // @@protoc_insertion_point(enum_scope:google.container.v1.AdvancedDatapathObservabilityConfig.RelayMode)
   }
 
+  private int bitField0_;
   public static final int ENABLE_METRICS_FIELD_NUMBER = 1;
   private boolean enableMetrics_ = false;
   /**
@@ -301,6 +302,39 @@ public com.google.container.v1.AdvancedDatapathObservabilityConfig.RelayMode get
         : result;
   }
 
+  public static final int ENABLE_RELAY_FIELD_NUMBER = 3;
+  private boolean enableRelay_ = false;
+  /**
+   *
+   *
+   * <pre>
+   * Enable Relay component
+   * </pre>
+   *
+   * <code>optional bool enable_relay = 3;</code>
+   *
+   * @return Whether the enableRelay field is set.
+   */
+  @java.lang.Override
+  public boolean hasEnableRelay() {
+    return ((bitField0_ & 0x00000001) != 0);
+  }
+  /**
+   *
+   *
+   * <pre>
+   * Enable Relay component
+   * </pre>
+   *
+   * <code>optional bool enable_relay = 3;</code>
+   *
+   * @return The enableRelay.
+   */
+  @java.lang.Override
+  public boolean getEnableRelay() {
+    return enableRelay_;
+  }
+
   private byte memoizedIsInitialized = -1;
 
   @java.lang.Override
@@ -324,6 +358,9 @@ public void writeTo(com.google.protobuf.CodedOutputStream output) throws java.io
             .getNumber()) {
       output.writeEnum(2, relayMode_);
     }
+    if (((bitField0_ & 0x00000001) != 0)) {
+      output.writeBool(3, enableRelay_);
+    }
     getUnknownFields().writeTo(output);
   }
 
@@ -342,6 +379,9 @@ public int getSerializedSize() {
             .getNumber()) {
       size += com.google.protobuf.CodedOutputStream.computeEnumSize(2, relayMode_);
     }
+    if (((bitField0_ & 0x00000001) != 0)) {
+      size += com.google.protobuf.CodedOutputStream.computeBoolSize(3, enableRelay_);
+    }
     size += getUnknownFields().getSerializedSize();
     memoizedSize = size;
     return size;
@@ -360,6 +400,10 @@ public boolean equals(final java.lang.Object obj) {
 
     if (getEnableMetrics() != other.getEnableMetrics()) return false;
     if (relayMode_ != other.relayMode_) return false;
+    if (hasEnableRelay() != other.hasEnableRelay()) return false;
+    if (hasEnableRelay()) {
+      if (getEnableRelay() != other.getEnableRelay()) return false;
+    }
     if (!getUnknownFields().equals(other.getUnknownFields())) return false;
     return true;
   }
@@ -375,6 +419,10 @@ public int hashCode() {
     hash = (53 * hash) + com.google.protobuf.Internal.hashBoolean(getEnableMetrics());
     hash = (37 * hash) + RELAY_MODE_FIELD_NUMBER;
     hash = (53 * hash) + relayMode_;
+    if (hasEnableRelay()) {
+      hash = (37 * hash) + ENABLE_RELAY_FIELD_NUMBER;
+      hash = (53 * hash) + com.google.protobuf.Internal.hashBoolean(getEnableRelay());
+    }
     hash = (29 * hash) + getUnknownFields().hashCode();
     memoizedHashCode = hash;
     return hash;
@@ -518,6 +566,7 @@ public Builder clear() {
       bitField0_ = 0;
       enableMetrics_ = false;
       relayMode_ = 0;
+      enableRelay_ = false;
       return this;
     }
 
@@ -560,6 +609,12 @@ private void buildPartial0(com.google.container.v1.AdvancedDatapathObservability
       if (((from_bitField0_ & 0x00000002) != 0)) {
         result.relayMode_ = relayMode_;
       }
+      int to_bitField0_ = 0;
+      if (((from_bitField0_ & 0x00000004) != 0)) {
+        result.enableRelay_ = enableRelay_;
+        to_bitField0_ |= 0x00000001;
+      }
+      result.bitField0_ |= to_bitField0_;
     }
 
     @java.lang.Override
@@ -614,6 +669,9 @@ public Builder mergeFrom(com.google.container.v1.AdvancedDatapathObservabilityCo
       if (other.relayMode_ != 0) {
         setRelayModeValue(other.getRelayModeValue());
       }
+      if (other.hasEnableRelay()) {
+        setEnableRelay(other.getEnableRelay());
+      }
       this.mergeUnknownFields(other.getUnknownFields());
       onChanged();
       return this;
@@ -652,6 +710,12 @@ public Builder mergeFrom(
                 bitField0_ |= 0x00000002;
                 break;
               } // case 16
+            case 24:
+              {
+                enableRelay_ = input.readBool();
+                bitField0_ |= 0x00000004;
+                break;
+              } // case 24
             default:
               {
                 if (!super.parseUnknownField(input, extensionRegistry, tag)) {
@@ -823,6 +887,74 @@ public Builder clearRelayMode() {
       return this;
     }
 
+    private boolean enableRelay_;
+    /**
+     *
+     *
+     * <pre>
+     * Enable Relay component
+     * </pre>
+     *
+     * <code>optional bool enable_relay = 3;</code>
+     *
+     * @return Whether the enableRelay field is set.
+     */
+    @java.lang.Override
+    public boolean hasEnableRelay() {
+      return ((bitField0_ & 0x00000004) != 0);
+    }
+    /**
+     *
+     *
+     * <pre>
+     * Enable Relay component
+     * </pre>
+     *
+     * <code>optional bool enable_relay = 3;</code>
+     *
+     * @return The enableRelay.
+     */
+    @java.lang.Override
+    public boolean getEnableRelay() {
+      return enableRelay_;
+    }
+    /**
+     *
+     *
+     * <pre>
+     * Enable Relay component
+     * </pre>
+     *
+     * <code>optional bool enable_relay = 3;</code>
+     *
+     * @param value The enableRelay to set.
+     * @return This builder for chaining.
+     */
+    public Builder setEnableRelay(boolean value) {
+
+      enableRelay_ = value;
+      bitField0_ |= 0x00000004;
+      onChanged();
+      return this;
+    }
+    /**
+     *
+     *
+     * <pre>
+     * Enable Relay component
+     * </pre>
+     *
+     * <code>optional bool enable_relay = 3;</code>
+     *
+     * @return This builder for chaining.
+     */
+    public Builder clearEnableRelay() {
+      bitField0_ = (bitField0_ & ~0x00000004);
+      enableRelay_ = false;
+      onChanged();
+      return this;
+    }
+
     @java.lang.Override
     public final Builder setUnknownFields(final com.google.protobuf.UnknownFieldSet unknownFields) {
       return super.setUnknownFields(unknownFields);

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

@@ -60,4 +60,29 @@ public interface AdvancedDatapathObservabilityConfigOrBuilder
    * @return The relayMode.
    */
   com.google.container.v1.AdvancedDatapathObservabilityConfig.RelayMode getRelayMode();
+
+  /**
+   *
+   *
+   * <pre>
+   * Enable Relay component
+   * </pre>
+   *
+   * <code>optional bool enable_relay = 3;</code>
+   *
+   * @return Whether the enableRelay field is set.
+   */
+  boolean hasEnableRelay();
+  /**
+   *
+   *
+   * <pre>
+   * Enable Relay component
+   * </pre>
+   *
+   * <code>optional bool enable_relay = 3;</code>
+   *
+   * @return The enableRelay.
+   */
+  boolean getEnableRelay();
 }