Class PortsImpl

java.lang.Object
com.eqixiac.equinix.fabric.client.implementation.PortsImpl
All Implemented Interfaces:
Ports
public class PortsImpl extends Object implements Ports
Author:
ianjones

  • Constructor Details

    • PortsImpl

      public PortsImpl()

  • Method Details

    • list

      public List<Port> list()
      Description copied from interface: Ports
      Lists all ports accessible to the current account (GET /fabric/v4/ports). Spec 4.34.0 declares no offset on this GET and the live service returns every item in one response (for GET /ports: limit 999, offset and limit ignored, observed 2026-11-11), so this is a plain list, not a multi-page one.
      Specified by:
      list in interface Ports
      Returns:
      the ports

    • search

      public PaginatedFilteredList<Port> search()
      Description copied from interface: Ports
      Searches for ports using default filter and sort criteria.
      Specified by:
      search in interface Ports
      Returns:
      a paginated, filtered list of matching ports

    • search

      public PaginatedFilteredList<Port> search(FilterPropertyList filter)
      Description copied from interface: Ports
      Searches for ports matching the specified filter criteria.
      Specified by:
      search in interface Ports
      Parameters:
      filter - the filter criteria to apply
      Returns:
      a paginated, filtered list of matching ports

    • search

      public PaginatedFilteredList<Port> search(SortPropertyList sort)
      Description copied from interface: Ports
      Searches for ports with the specified sort order.
      Specified by:
      search in interface Ports
      Parameters:
      sort - the sort criteria to apply
      Returns:
      a paginated, filtered list of matching ports

    • search

      public PaginatedFilteredList<Port> search(FilterPropertyList filter, SortPropertyList sort)
      Description copied from interface: Ports
      Searches for ports matching the specified filter and sort criteria.
      Specified by:
      search in interface Ports
      Parameters:
      filter - the filter criteria to apply
      sort - the sort criteria to apply
      Returns:
      a paginated, filtered list of matching ports

    • getByUuid

      public Port getByUuid(String uuid)
      Description copied from interface: Ports
      Retrieves a single port by its unique identifier.
      Specified by:
      getByUuid in interface Ports
      Parameters:
      uuid - the unique identifier of the port
      Returns:
      the port matching the given UUID

    • getVlans

      public List<PortVlan> getVlans(String portUuid)
      Description copied from interface: Ports
      Lists the VLANs (link protocols) configured on a port.
      Specified by:
      getVlans in interface Ports
      Parameters:
      portUuid - the unique identifier of the port
      Returns:
      the list of VLANs configured on the port

    • define

      public PortOperator.PortBuilder define()
      Description copied from interface: Ports
      Begins the fluent builder for creating a new port (POST /fabric/v4/ports). Configure the returned builder, then call create().
      Specified by:
      define in interface Ports
      Returns:
      a builder for configuring the new port

    • delete

      public Port delete(String uuid)
      Description copied from interface: Ports
      Deletes a port by its unique identifier (DELETE /fabric/v4/ports/{uuid}).
      Specified by:
      delete in interface Ports
      Parameters:
      uuid - the unique identifier of the port to delete
      Returns:
      the deleted port as returned by the server

    • delete

      public Port delete(String uuid, boolean dryRun)
      Description copied from interface: Ports
      Deletes a port by its unique identifier, optionally as a validate-only dry run (DELETE /fabric/v4/ports/{uuid}?dryRun=true; spec: "option to verify that API calls will succeed"; boolean, default false).

      With dryRun = true nothing is deleted: the API responds 200 (rather than the real delete's 202 Accepted) with the existing port entity - uuid, name and all - that WOULD be deleted. With dryRun = false this behaves exactly like Ports.delete(String).

      Specified by:
      delete in interface Ports
      Parameters:
      uuid - the unique identifier of the port to delete
      dryRun - true to only verify that the delete would succeed, without deleting
      Returns:
      the deleted port - or, on a dry run, the port that would be deleted

    • update

      public PortOperator.PortUpdater update(String uuid)
      Description copied from interface: Ports
      Begins a fluent update of an existing port (PATCH /fabric/v4/ports/{uuid}). Configure the returned updater, then call save().
      Specified by:
      update in interface Ports
      Parameters:
      uuid - the unique identifier of the port to update
      Returns:
      an updater for applying changes to the port

    • addToLag

      public PhysicalPortsResponseJson addToLag(String portId, List<PhysicalPort> physicalPorts)
      Description copied from interface: Ports
      Adds physical ports to a virtual port's Link Aggregation Group (POST /fabric/v4/ports/{portId}/physicalPorts/bulk).
      Specified by:
      addToLag in interface Ports
      Parameters:
      portId - the virtual port uuid
      physicalPorts - the physical ports to add to the LAG
      Returns:
      the full set of physical ports backing the virtual port after the addition