Class ConnectionOperator.ConnectionUpdater

java.lang.Object
com.eqixiac.equinix.fabric.model.json.creators.ConnectionOperator.ConnectionUpdater
Enclosing class:
ConnectionOperator
public class ConnectionOperator.ConnectionUpdater extends Object
Fluent updater for an existing connection. Typed setters record RFC 6902 replace operations (the API accepts a JSON Patch array at PATCH /connections/{uuid}); use patch(PatchOperation) for any path not covered by a typed setter (e.g. notifications, A-side migration). Call save() to apply, optionally after dryRun() to only validate the update.

  • Constructor Details

    • ConnectionUpdater

      protected ConnectionUpdater(String uuid)

  • Method Details

    • name

      public ConnectionOperator.ConnectionUpdater name(String name)

    • bandwidth

      public ConnectionOperator.ConnectionUpdater bandwidth(Integer bandwidth)

    • termLength

      public ConnectionOperator.ConnectionUpdater termLength(Integer termLength)
      Replaces the order term length (/order/termLength), e.g. to upgrade an on-demand connection to a term-based connection (Fabric release R2025.5).
      Parameters:
      termLength - the new term length in months (for example 12, 24 or 36)
      Returns:
      this updater

    • vlanTag

      public ConnectionOperator.ConnectionUpdater vlanTag(Side side, int vlanTag)
      Edits the VLAN tag of an EVPL connection side (Fabric release "EVPL VLAN edit"): replaces /{aSide|zSide}/accessPoint/linkProtocol/vlanTag.

      Provenance: the release notes announce the feature, but spec 4.34.0 publishes no example for it; the path follows the connection's own linkProtocol shape and is unverified live (no net-new connection may be created for testing). Run it with dryRun() first.

      Parameters:
      side - the side whose VLAN changes
      vlanTag - the new DOT1Q VLAN tag (2-4092)
      Returns:
      this updater

    • vlanTags

      public ConnectionOperator.ConnectionUpdater vlanTags(Side side, int vlanSTag, int vlanCTag)
      Edits the QinQ VLAN tags of a connection side: replaces .../linkProtocol/vlanSTag and .../linkProtocol/vlanCTag. Same provenance and dry-run advice as vlanTag(Side, int).
      Parameters:
      side - the side whose VLANs change
      vlanSTag - the new outer (service) tag
      vlanCTag - the new inner (customer) tag
      Returns:
      this updater

    • patch

      public ConnectionOperator.ConnectionUpdater patch(PatchOperation operation)

    • dryRun

      public ConnectionOperator.ConnectionUpdater dryRun()
      Marks this update as a dry run: save() sends the same JSON Patch to PATCH /fabric/v4/connections/{uuid} with the dryRun=true query parameter — per the Fabric v4 spec, an "option to verify that API calls will succeed". Nothing is persisted: the API responds 200 (the real update responds 202) with a simulation of the post-update connection, which save() returns.
      Returns:
      this updater

    • save

      public Connection save()