Interface PrecisionTimes

All Known Implementing Classes:
PrecisionTimesImpl
public interface PrecisionTimes
Client interface for managing Equinix Fabric Precision Time services. Precision Time provides NTP and PTP time synchronization services for connected infrastructure.

  • Method Details

    • list

      PaginatedList<PrecisionTime> list()
      Lists precision time services through POST /fabric/v4/timeServices/search with an empty filter. The specification documents /project/projectId as a mandatory filter property, so prefer search(FilterPropertyList, SortPropertyList) with a project filter; the service may reject an unfiltered search.
      Returns:
      a paginated list of precision time services

    • search

      PaginatedFilteredList<PrecisionTime> search(FilterPropertyList filter, SortPropertyList sort)
      Searches precision time services (POST /fabric/v4/timeServices/search). Filter properties: /project/projectId (mandatory per the spec), /name, /uuid, /type, /state, /account/accountNumber, /package/code.
      Parameters:
      filter - the search filter
      sort - the sort criteria, may be null
      Returns:
      the matching services, paged

    • getByUuid

      PrecisionTime getByUuid(String uuid)
      Retrieves a single precision time service by its unique identifier.
      Parameters:
      uuid - the unique identifier of the precision time service
      Returns:
      the precision time service matching the given UUID

    • define

      PrecisionTimeOperator.PrecisionTimeBuilder define()
      Begins the fluent builder for creating a new precision time service. Call methods on the returned builder to configure the service, then call create().
      Returns:
      a builder for configuring the new precision time service

    • packages

      List<TimeServicePackage> packages()
      Lists the available precision time service packages (NTP/PTP, standard/enterprise).
      Returns:
      the list of time service packages

    • packageByCode

      TimeServicePackage packageByCode(PrecisionTimePackageCode packageCode)
      Retrieves a single precision time service package by its package code.
      Parameters:
      packageCode - the package code
      Returns:
      the time service package matching the given code

    • getConnections

      List<TimeServiceConnection> getConnections(String serviceId)
      Lists the L2 connections associated with a precision time service instance.
      Parameters:
      serviceId - the unique identifier of the precision time service
      Returns:
      the list of connection links

    • fulfill

      PrecisionTime fulfill(String uuid, List<String> connectionUuids)
      Fulfills (provisions) an existing precision time service by attaching the given Fabric connections to it.
      Parameters:
      uuid - the unique identifier of the precision time service
      connectionUuids - the Fabric connection UUIDs to attach
      Returns:
      the updated precision time service

    • fulfill

      PrecisionTime fulfill(String uuid, TimeServiceFulfillRequest request)
      Fulfills (provisions) an existing precision time service with a full precisionTimeServiceRequest body, allowing the required type, name, package and ipv4 properties (and the optional NTP / PTP advanced configuration, project and order) to be supplied alongside the connections.
      Parameters:
      uuid - the unique identifier of the precision time service
      request - the fulfillment request body
      Returns:
      the updated precision time service