Interface TroubleTicketOrders

All Known Implementing Classes:
TroubleTicketOrdersImpl
public interface TroubleTicketOrders
Client interface for submitting trouble tickets in the Equinix Customer Portal.

Backed by the Trouble Ticket v1 API at /v1/orders/troubleticket. Reference data is available via getTypes() (problem categories and their codes) and getLocations() (IBX/cage locations the current user may raise tickets for); placeOrder(TroubleTicketOrderRequest) submits a ticket for an issue impacting service.

*

Which API to use. Equinix is folding Trouble Tickets into Support Cases (Customer Portal Experience Updates, 2026). New integrations should raise and track issues with SupportCases (support v2, /support/v2/tickets). TroubleTickets (tickets v2, /v2/tickets) and TroubleTicketOrders (trouble ticket v1, /v1/orders/troubleticket) remain available while the published specs still carry them; none of the three specs marks the operations deprecated (checked 2026-11-11). The "Service Restoration" order type announced with the change is not in any published Customer Portal spec yet, so the SDK does not model it.

  • Method Details

    • getTypes

      List<? extends TroubleTicketType> getTypes()
      Lists all Equinix trouble ticket problem categories and their corresponding codes.
      Returns:
      the list of supported trouble ticket types

    • getTypes

      List<? extends TroubleTicketType> getTypes(String category)
      Lists Equinix trouble ticket problem categories filtered by a single category.

      Maps to GET /v1/orders/troubleticket/types with the category query parameter (e.g. Cross Connect, Network, Power, Environment, Hardware, Security, Managed Services, Smartview).

      Parameters:
      category - the trouble ticket category to filter by, or null for all
      Returns:
      the list of supported trouble ticket types

    • getLocations

      List<? extends TroubleTicketOrderLocation> getLocations()
      Lists the IBX locations and cages where the current user may place trouble ticket orders.
      Returns:
      the list of permitted locations

    • getLocations

      List<? extends TroubleTicketOrderLocation> getLocations(Boolean detail, String ibxs, String cages)
      Lists the IBX locations and cages where the current user may place trouble ticket orders, filtered by the supplied parameters.

      Maps to GET /v1/orders/troubleticket/locations with the detail, ibxs and cages query parameters.

      Parameters:
      detail - whether to include detailed cage/account information, or null
      ibxs - the IBX codes to filter by, or null
      cages - the cage ids to filter by, or null
      Returns:
      the list of permitted locations

    • placeOrder

      OrderResponse placeOrder(TroubleTicketOrderRequest request)
      Submits a trouble ticket for an issue impacting your service.
      Parameters:
      request - the trouble ticket order body
      Returns:
      the created order response carrying the generated order number