Enum Class CloudToCloudStrategy

java.lang.Object
java.lang.Enum<CloudToCloudStrategy>
com.eqixiac.equinix.design.optimizer.wizard.enums.CloudToCloudStrategy
All Implemented Interfaces:
Serializable, Comparable<CloudToCloudStrategy>, Constable
public enum CloudToCloudStrategy extends Enum<CloudToCloudStrategy>
How the Deployment Wizard treats a flow between two clouds. A flow exists when one workload declares a dependency on two or more clouds (WorkloadSpec.getDependsOnProviders()); each pair of those clouds is one flow.

Beta: the native provider-to-provider links this lever plans for reached general availability in 2026 and are described by a bundled catalog (MulticloudEnvironmentCatalog) that goes stale as providers add regions.

A native link has no Equinix A-side and no Fabric request body. Under every strategy the wizard plans and prices it and never provisions it.

Effect of each strategy on the plan
StrategyEquinix connections for the flowNative links on the plan No catalog environment for the pair
EQUINIX_ONLYplannednone; the catalog is not read no effect
COMPAREplannedone ALTERNATIVE per matched pair no link is attached
NATIVE_WHEN_AVAILABLEomitted only where the replacement rule allows REPLACEMENT where a connection was omitted, otherwise ALTERNATIVEno link is attached
NATIVE_ONLYas NATIVE_WHEN_AVAILABLE as NATIVE_WHEN_AVAILABLE, plus one UNAVAILABLE entry per pair without a usable environmentLayer-1 validation error; the plan is invalid

Replacement rule (NATIVE_WHEN_AVAILABLE, NATIVE_ONLY)

The Cloud Router to cloud connection at a metro is omitted only when all of the following hold. Otherwise it is planned exactly as under EQUINIX_ONLY, at the same bandwidth.

  1. The matched environment's status is GA and it publishes a size that covers the requested bandwidth.
  2. The optimization request declares no user site. The wizard does not model which site reaches which cloud, so any site is assumed to reach every cloud through the metro.
  3. The cloud is not a request-level provider requirement (OptimizationRequest.getProviders()).
  4. Every workload that depends on the cloud and would use this metro's connection (placed at this metro, placed at a metro where the cloud is unavailable, or unplaced) depends on well-known clouds only, and each of its flows involving the cloud has a GA environment with a covering size.
  5. No other workload is sized onto the connection (under BandwidthStrategy.AGGREGATED every workload at the metro is), and its bandwidth was not set by the custom bandwidth map.

The metro's Cloud Router is never omitted: the wizard plans one per recommended metro. When a replacement leaves it without a provider connection, the link's reasoning says so.

  • Enum Constant Details

    • EQUINIX_ONLY

      public static final CloudToCloudStrategy EQUINIX_ONLY
      Plan the Equinix path only. The multicloud environment catalog is not consulted, no native link is attached, and the plan, its pricing and its rendered output are those of a wizard without this lever.

    • NATIVE_WHEN_AVAILABLE

      public static final CloudToCloudStrategy NATIVE_WHEN_AVAILABLE
      Omit the Equinix connections for a cloud-to-cloud flow where the replacement rule in the class documentation allows, and carry the native link as a REPLACEMENT. Where the rule does not allow it (no GA environment, a user site, another consumer of the connection), the Equinix connections stay and a matched link is carried as an ALTERNATIVE with the reason.

    • NATIVE_ONLY

      public static final CloudToCloudStrategy NATIVE_ONLY
      As NATIVE_WHEN_AVAILABLE, and additionally a cloud-to-cloud flow with no usable catalog environment (none for the region pair, a status other than GA, or no size covering the requested bandwidth) is a Layer-1 validation error. The replacement rule is unchanged: a connection another consumer still needs stays on the plan and is not an error.

    • COMPARE

      public static final CloudToCloudStrategy COMPARE
      The default. Plan the Equinix path exactly as EQUINIX_ONLY does, and attach one ALTERNATIVE native link per cloud pair that has a catalog environment matching the planned seller regions, with two-sided pricing where published, the Equinix-path cost for the same flow, and the break-even sustained rate.

  • Method Details

    • values

      public static CloudToCloudStrategy[] values()
      Returns an array containing the constants of this enum class, in the order they are declared.
      Returns:
      an array containing the constants of this enum class, in the order they are declared

    • valueOf

      public static CloudToCloudStrategy valueOf(String name)
      Returns the enum constant of this class with the specified name. The string must match exactly an identifier used to declare an enum constant in this class. (Extraneous whitespace characters are not permitted.)
      Parameters:
      name - the name of the enum constant to be returned.
      Returns:
      the enum constant with the specified name
      Throws:
      IllegalArgumentException - if this enum class has no constant with the specified name
      NullPointerException - if the argument is null