feat(2021-10-19): Updated the sdk as per the 2021-10-19 api spec (#32)

Author: uibm

modules/examples/src/main/java/com/ibm/cloud/is/vpc/v1/VPCExamples.java

@@ -229,6 +229,7 @@
 import com.ibm.cloud.is.vpc.v1.model.InstanceGroupManager;
 import com.ibm.cloud.is.vpc.v1.model.InstanceGroupManagerAction;
 import com.ibm.cloud.is.vpc.v1.model.InstanceGroupManagerActionPatch;
+import com.ibm.cloud.is.vpc.v1.model.InstanceGroupManagerActionPrototypeScheduledActionPrototypeByCronSpecByGroup;
 import com.ibm.cloud.is.vpc.v1.model.InstanceGroupManagerActionsCollection;
 import com.ibm.cloud.is.vpc.v1.model.InstanceGroupManagerCollection;
 import com.ibm.cloud.is.vpc.v1.model.InstanceGroupManagerPatch;
@@ -483,8 +484,6 @@
 import com.ibm.cloud.is.vpc.v1.model.Zone;
 import com.ibm.cloud.is.vpc.v1.model.ZoneCollection;
 import com.ibm.cloud.is.vpc.v1.model.ZoneIdentityByName;
-import com.ibm.cloud.is.vpc.v1.model.InstanceGroupManagerActionPrototypeScheduledActionPrototypeByCronSpecByGroup;
-
 import com.ibm.cloud.sdk.core.http.Response;
 import com.ibm.cloud.sdk.core.service.exception.ServiceResponseException;
 import com.ibm.cloud.sdk.core.util.CredentialUtils;

modules/vpc/src/main/java/com/ibm/cloud/is/vpc/v1/Vpc.java

@@ -12,7 +12,7 @@
  */
 
 /*
- * IBM OpenAPI SDK Code Generator Version: 3.38.0-07189efd-20210827-205025
+ * IBM OpenAPI SDK Code Generator Version: 3.39.0-748eb4ca-20210917-165907
  */
 
 package com.ibm.cloud.is.vpc.v1;
@@ -414,15 +414,15 @@
  * The IBM Cloud Virtual Private Cloud (VPC) API can be used to programmatically provision and manage infrastructure
  * resources, including virtual server instances, subnets, volumes, and load balancers.
  *
- * API Version: 2021-09-07
+ * API Version: 2021-10-19
  */
 public class Vpc extends BaseService {
 
   public static final String DEFAULT_SERVICE_NAME = "vpc";
 
   public static final String DEFAULT_SERVICE_URL = "https://us-south.iaas.cloud.ibm.com/v1";
 
-  private String version = "2021-09-07";
+  private String version = "2021-10-19";
 
   private Long generation = Long.valueOf("2");
 
@@ -752,8 +752,9 @@ public ServiceCall<DefaultRoutingTable> getVpcDefaultRoutingTable(GetVpcDefaultR
   /**
    * Retrieve a VPC's default security group.
    *
-   * This request retrieves the default security group for the VPC specified by the identifier in the URL. The default
-   * security group is applied to any new network interfaces in the VPC that do not specify a security group.
+   * This request retrieves the default security group for the VPC specified by the identifier in the URL. Resources
+   * that optionally allow a security group to be specified upon creation will be attached to this security group if a
+   * security group is not specified.
    *
    * @param getVpcDefaultSecurityGroupOptions the {@link GetVpcDefaultSecurityGroupOptions} containing the options for the call
    * @return a {@link ServiceCall} with a result of type {@link DefaultSecurityGroup}
@@ -6526,7 +6527,8 @@ public ServiceCall<IKEPolicy> createIkePolicy(CreateIkePolicyOptions createIkePo
   /**
    * Delete an IKE policy.
    *
-   * This request deletes an IKE policy. This operation cannot be reversed.
+   * This request deletes an IKE policy. This operation cannot be reversed. For this request to succeed, there must not
+   * be any VPN gateway connections using this policy.
    *
    * @param deleteIkePolicyOptions the {@link DeleteIkePolicyOptions} containing the options for the call
    * @return a {@link ServiceCall} with a void result
@@ -6709,7 +6711,8 @@ public ServiceCall<IPsecPolicy> createIpsecPolicy(CreateIpsecPolicyOptions creat
   /**
    * Delete an IPsec policy.
    *
-   * This request deletes an IPsec policy. This operation cannot be reversed.
+   * This request deletes an IPsec policy. This operation cannot be reversed. For this request to succeed, there must
+   * not be any VPN gateway connections using this policy.
    *
    * @param deleteIpsecPolicyOptions the {@link DeleteIpsecPolicyOptions} containing the options for the call
    * @return a {@link ServiceCall} with a void result
@@ -6885,8 +6888,9 @@ public ServiceCall<VPNGateway> createVpnGateway(CreateVpnGatewayOptions createVp
   /**
    * Delete a VPN gateway.
    *
-   * This request deletes a VPN gateway. A VPN gateway with a `status` of `pending` cannot be deleted. This operation
-   * deletes all VPN gateway connections associated with this VPN gateway.  This operation cannot be reversed.
+   * This request deletes a VPN gateway. This operation cannot be reversed. For this request to succeed, the VPN gateway
+   * must not have a `status` of `pending`, and there must not be any VPC routes using the VPN gateway's connections as
+   * a next hop.
    *
    * @param deleteVpnGatewayOptions the {@link DeleteVpnGatewayOptions} containing the options for the call
    * @return a {@link ServiceCall} with a void result
@@ -7019,7 +7023,8 @@ public ServiceCall<VPNGatewayConnection> createVpnGatewayConnection(CreateVpnGat
   /**
    * Delete a VPN gateway connection.
    *
-   * This request deletes a VPN gateway connection. This operation cannot be reversed.
+   * This request deletes a VPN gateway connection. This operation cannot be reversed. For this request to succeed,
+   * there must not be VPC routes using this VPN connection as a next hop.
    *
    * @param deleteVpnGatewayConnectionOptions the {@link DeleteVpnGatewayConnectionOptions} containing the options for the call
    * @return a {@link ServiceCall} with a void result
@@ -7466,6 +7471,9 @@ public ServiceCall<LoadBalancer> createLoadBalancer(CreateLoadBalancerOptions cr
     if (createLoadBalancerOptions.resourceGroup() != null) {
       contentJson.add("resource_group", com.ibm.cloud.sdk.core.util.GsonSingleton.getGson().toJsonTree(createLoadBalancerOptions.resourceGroup()));
     }
+    if (createLoadBalancerOptions.routeMode() != null) {
+      contentJson.addProperty("route_mode", createLoadBalancerOptions.routeMode());
+    }
     if (createLoadBalancerOptions.securityGroups() != null) {
       contentJson.add("security_groups", com.ibm.cloud.sdk.core.util.GsonSingleton.getGson().toJsonTree(createLoadBalancerOptions.securityGroups()));
     }
@@ -7626,7 +7634,6 @@ public ServiceCall<LoadBalancerListener> createLoadBalancerListener(CreateLoadBa
     builder.query("version", String.valueOf(this.version));
     builder.query("generation", String.valueOf(this.generation));
     final JsonObject contentJson = new JsonObject();
-    contentJson.addProperty("port", createLoadBalancerListenerOptions.port());
     contentJson.addProperty("protocol", createLoadBalancerListenerOptions.protocol());
     if (createLoadBalancerListenerOptions.acceptProxyProtocol() != null) {
       contentJson.addProperty("accept_proxy_protocol", createLoadBalancerListenerOptions.acceptProxyProtocol());
@@ -7646,6 +7653,15 @@ public ServiceCall<LoadBalancerListener> createLoadBalancerListener(CreateLoadBa
     if (createLoadBalancerListenerOptions.policies() != null) {
       contentJson.add("policies", com.ibm.cloud.sdk.core.util.GsonSingleton.getGson().toJsonTree(createLoadBalancerListenerOptions.policies()));
     }
+    if (createLoadBalancerListenerOptions.port() != null) {
+      contentJson.addProperty("port", createLoadBalancerListenerOptions.port());
+    }
+    if (createLoadBalancerListenerOptions.portMax() != null) {
+      contentJson.addProperty("port_max", createLoadBalancerListenerOptions.portMax());
+    }
+    if (createLoadBalancerListenerOptions.portMin() != null) {
+      contentJson.addProperty("port_min", createLoadBalancerListenerOptions.portMin());
+    }
     builder.bodyJson(contentJson);
     ResponseConverter<LoadBalancerListener> responseConverter =
       ResponseConverterUtils.getValue(new com.google.gson.reflect.TypeToken<LoadBalancerListener>() { }.getType());
@@ -8752,8 +8768,9 @@ public ServiceCall<FlowLogCollector> createFlowLogCollector(CreateFlowLogCollect
   /**
    * Delete a flow log collector.
    *
-   * This request stops and deletes a flow log collector. Collected flow logs remain available within the flow log
-   * collector's bucket.
+   * This request stops and deletes a flow log collector. This operation cannot be reversed.
+   *
+   * Collected flow logs remain available within the flow log collector's Cloud Object Storage bucket.
    *
    * @param deleteFlowLogCollectorOptions the {@link DeleteFlowLogCollectorOptions} containing the options for the call
    * @return a {@link ServiceCall} with a void result

modules/vpc/src/main/java/com/ibm/cloud/is/vpc/v1/model/CreateKeyOptions.java

@@ -138,8 +138,9 @@ public Builder newBuilder() {
   /**
    * Gets the publicKey.
    *
-   * A unique public SSH key to import, encoded in PEM format. The key (prior to encoding) must be either 2048 or 4096
-   * bits long.
+   * A unique public SSH key to import, in OpenSSH format (consisting of three space-separated fields: the algorithm
+   * name, base64-encoded key, and a comment). The algorithm and comment fields may be omitted, as only the key field is
+   * imported.
    *
    * @return the publicKey
    */

modules/vpc/src/main/java/com/ibm/cloud/is/vpc/v1/model/CreateLoadBalancerListenerOptions.java

@@ -39,39 +39,45 @@ public interface Protocol {
   }
 
   protected String loadBalancerId;
-  protected Long port;
   protected String protocol;
   protected Boolean acceptProxyProtocol;
   protected CertificateInstanceIdentity certificateInstance;
   protected Long connectionLimit;
   protected LoadBalancerPoolIdentity defaultPool;
   protected LoadBalancerListenerHTTPSRedirectPrototype httpsRedirect;
   protected List<LoadBalancerListenerPolicyPrototype> policies;
+  protected Long port;
+  protected Long portMax;
+  protected Long portMin;
 
   /**
    * Builder.
    */
   public static class Builder {
     private String loadBalancerId;
-    private Long port;
     private String protocol;
     private Boolean acceptProxyProtocol;
     private CertificateInstanceIdentity certificateInstance;
     private Long connectionLimit;
     private LoadBalancerPoolIdentity defaultPool;
     private LoadBalancerListenerHTTPSRedirectPrototype httpsRedirect;
     private List<LoadBalancerListenerPolicyPrototype> policies;
+    private Long port;
+    private Long portMax;
+    private Long portMin;
 
     private Builder(CreateLoadBalancerListenerOptions createLoadBalancerListenerOptions) {
       this.loadBalancerId = createLoadBalancerListenerOptions.loadBalancerId;
-      this.port = createLoadBalancerListenerOptions.port;
       this.protocol = createLoadBalancerListenerOptions.protocol;
       this.acceptProxyProtocol = createLoadBalancerListenerOptions.acceptProxyProtocol;
       this.certificateInstance = createLoadBalancerListenerOptions.certificateInstance;
       this.connectionLimit = createLoadBalancerListenerOptions.connectionLimit;
       this.defaultPool = createLoadBalancerListenerOptions.defaultPool;
       this.httpsRedirect = createLoadBalancerListenerOptions.httpsRedirect;
       this.policies = createLoadBalancerListenerOptions.policies;
+      this.port = createLoadBalancerListenerOptions.port;
+      this.portMax = createLoadBalancerListenerOptions.portMax;
+      this.portMin = createLoadBalancerListenerOptions.portMin;
     }
 
     /**
@@ -84,12 +90,10 @@ public Builder() {
      * Instantiates a new builder with required properties.
      *
      * @param loadBalancerId the loadBalancerId
-     * @param port the port
      * @param protocol the protocol
      */
-    public Builder(String loadBalancerId, Long port, String protocol) {
+    public Builder(String loadBalancerId, String protocol) {
       this.loadBalancerId = loadBalancerId;
-      this.port = port;
       this.protocol = protocol;
     }
 
@@ -129,17 +133,6 @@ public Builder loadBalancerId(String loadBalancerId) {
       return this;
     }
 
-    /**
-     * Set the port.
-     *
-     * @param port the port
-     * @return the CreateLoadBalancerListenerOptions builder
-     */
-    public Builder port(long port) {
-      this.port = port;
-      return this;
-    }
-
     /**
      * Set the protocol.
      *
@@ -217,24 +210,57 @@ public Builder policies(List<LoadBalancerListenerPolicyPrototype> policies) {
       this.policies = policies;
       return this;
     }
+
+    /**
+     * Set the port.
+     *
+     * @param port the port
+     * @return the CreateLoadBalancerListenerOptions builder
+     */
+    public Builder port(long port) {
+      this.port = port;
+      return this;
+    }
+
+    /**
+     * Set the portMax.
+     *
+     * @param portMax the portMax
+     * @return the CreateLoadBalancerListenerOptions builder
+     */
+    public Builder portMax(long portMax) {
+      this.portMax = portMax;
+      return this;
+    }
+
+    /**
+     * Set the portMin.
+     *
+     * @param portMin the portMin
+     * @return the CreateLoadBalancerListenerOptions builder
+     */
+    public Builder portMin(long portMin) {
+      this.portMin = portMin;
+      return this;
+    }
   }
 
   protected CreateLoadBalancerListenerOptions(Builder builder) {
     com.ibm.cloud.sdk.core.util.Validator.notEmpty(builder.loadBalancerId,
       "loadBalancerId cannot be empty");
-    com.ibm.cloud.sdk.core.util.Validator.notNull(builder.port,
-      "port cannot be null");
     com.ibm.cloud.sdk.core.util.Validator.notNull(builder.protocol,
       "protocol cannot be null");
     loadBalancerId = builder.loadBalancerId;
-    port = builder.port;
     protocol = builder.protocol;
     acceptProxyProtocol = builder.acceptProxyProtocol;
     certificateInstance = builder.certificateInstance;
     connectionLimit = builder.connectionLimit;
     defaultPool = builder.defaultPool;
     httpsRedirect = builder.httpsRedirect;
     policies = builder.policies;
+    port = builder.port;
+    portMax = builder.portMax;
+    portMin = builder.portMin;
   }
 
   /**
@@ -257,18 +283,6 @@ public String loadBalancerId() {
     return loadBalancerId;
   }
 
-  /**
-   * Gets the port.
-   *
-   * The listener port number. Each listener in the load balancer must have a unique
-   * `port` and `protocol` combination.
-   *
-   * @return the port
-   */
-  public Long port() {
-    return port;
-  }
-
   /**
    * Gets the protocol.
    *
@@ -360,5 +374,49 @@ public LoadBalancerListenerHTTPSRedirectPrototype httpsRedirect() {
   public List<LoadBalancerListenerPolicyPrototype> policies() {
     return policies;
   }
+
+  /**
+   * Gets the port.
+   *
+   * The listener port number, or the inclusive lower bound of the port range. Each listener in the load balancer must
+   * have a unique `port` and `protocol` combination.
+   *
+   * Not supported for load balancers operating with route mode enabled.
+   *
+   * @return the port
+   */
+  public Long port() {
+    return port;
+  }
+
+  /**
+   * Gets the portMax.
+   *
+   * The inclusive upper bound of the range of ports used by this listener. Must not be less than `port_min`.
+   *
+   * At present, only load balancers operating with route mode enabled support different values for `port_min` and
+   * `port_max`.  When route mode is enabled, only a value of
+   * `65535` is supported for `port_max`.
+   *
+   * @return the portMax
+   */
+  public Long portMax() {
+    return portMax;
+  }
+
+  /**
+   * Gets the portMin.
+   *
+   * The inclusive lower bound of the range of ports used by this listener. Must not be greater than `port_max`.
+   *
+   * At present, only load balancers operating with route mode enabled support different values for `port_min` and
+   * `port_max`.  When route mode is enabled, only a value of
+   * `1` is supported for `port_min`.
+   *
+   * @return the portMin
+   */
+  public Long portMin() {
+    return portMin;
+  }
 }