Equinix Fabric API v4 | Equinix Product Documentation

Update Internet Exchange Service

Request

The API provides capability to update Internet Exchange Service

Security

BearerAuth

Path

exchangeServiceIdstring, (uuid)required

Internet Exchange Service Id

Example:a8ba52de-faae-43b5-b0b1-6904d37ee011

Bodyapplication/json-patch+jsonrequired

Array [

opstring(ExchangeServiceOpEnum)required

the operation to be performed

Enum:"replace""add"

pathstring(ExchangeServicePath)required

A JSON Pointer path.

/name - Name of the Internet Exchange Service
/description - Description of the Internet Exchange Service
routingProtocol/macAddress - MAC Address
routingProtocol/bgpIpv4/domainName - Domain Name for BGP IPv4
routingProtocol/bgpIpv4/asSet - AS Set for BGP IPv4
routingProtocol/bgpIpv4/md5AuthKey - MD5 Auth Key for BGP IPv4
routingProtocol/bgpIpv4/rcMd5AuthKey - RC MD5 Auth Key for BGP IPv4
routingProtocol/bgpIpv4/ipPrefixes - IP Prefixes for BGP IPv4
routingProtocol/bgpIpv6/mlpeEnabled - MLPE Enabled for BGP IPv4
routingProtocol/bgpIpv6/domainName- Domain Name for BGP IPv6
routingProtocol/bgpIpv6/asSet- AS Set for BGP IPv6
routingProtocol/bgpIpv6/md5AuthKey - MD5 Auth Key for BGP IPv6
routingProtocol/bgpIpv6/rcMd5AuthKey - RC MD5 Auth Key for BGP IPv6
routingProtocol/bgpIpv6/ipPrefixes - IP Prefixes for BGP IPv6
routingProtocol/bgpIpv6/mlpeEnabled - MLPE Enabled for BGP IPv6

valueanyrequired

value to replace with

]

Payload

[
  {
    "op": "replace",
    "path": "/routingProtocol/macAddress",
    "value": "00:1A:2B:3C:4D:5E"
  }
]

Responses

Successful operation

Bodyapplication/json

hrefstring

Internet Exchange Service URI

Example:"https://api.equinix.com/fabric/v4/exchangeServices/a8ba52de-faae-43b5-b0b1-6904d37ee011"

uuidstring, (uuid)

Internet Exchange Service identifier

Example:"a8ba52de-faae-43b5-b0b1-6904d37ee011"

typestring

Internet Exchange Service Type

Default:"IX"

Value:"IX"

Example:"IX"

namestring

Name

Example:"ix_exchange_service"

bandwidthinteger

bandwidth in Mbps

Example:400000

descriptionstring

Description

Example:"ix_exchange_service"

statestring

State

Enum:"PROVISIONING""PROVISIONING_FAILED""PENDING_ACTIVATION""ACTIVATING""ACTIVATING_FAILED""PROVISIONED""REPROVISIONING""REPROVISIONING_FAILED""DEPROVISIONING""DEPROVISIONED"

Example:"PROVISIONING"

locationobject(SimplifiedLocation)

publicPeeringConnectionobject(PublicPeeringConnectionResponse)

routingProtocolobject(RoutingProtocolResponse)

orderobject(ExchangeServiceOrder)

Ordering and billing reference details for this Exchange Service.

projectobject(Project)

accountobject(SimplifiedAccount)

notificationsArray of objects(ExchangeServiceNotification)

Preferences for notifications on Internet Exchange Service configuration or status changes

changelogobject(PlatformChangelog)

Change log

additionalInfoobject(ExchangeServiceAdditionalInfo)

Additional information regarding the specified Exchange Service

Response

{
  "href": "https://api.equinix.com/fabric/v4/exchangeServices/a8ba52de-faae-43b5-b0b1-6904d37ee011",
  "uuid": "a8ba52de-faae-43b5-b0b1-6904d37ee011",
  "type": "IX",
  "name": "ix_exchange_service",
  "bandwidth": 400000,
  "description": "ix_exchange_service",
  "state": "REPROVISIONING",
  "location": {
    "metroHref": "https://api.equinix.com/fabric/v4/metros/SV",
    "metroCode": "SV"
  },
  "publicPeeringConnection": {
    "type": "IX_VC",
    "href": "https://api.equinix.com/fabric/v4/connections/b44c6e6c-2c36-4488-b3f1-47064357b5b4",
    "uuid": "b44c6e6c-2c36-4488-b3f1-47064357b5b4"
  },
  "routingProtocol": {
    "customerAsn": 5555,
    "macAddress": "00:11:22:33:44:55",
    "vlan": 99,
    "routeServerAsn": 24115,
    "bgpIpv4": { … },
    "bgpIpv6": { … },
    "routeCollector": { … }
  },
  "order": {
    "purchaseOrderNumber": "1-3456576",
    "orderNumber": "1-139105284200"
  },
  "project": {
    "projectId": "e275485c-7072-439f-943a-c923548b2be5"
  },
  "account": {
    "accountNumber": 100179
  },
  "notifications": [
    { … }
  ],
  "changelog": {
    "updatedBy": "12345",
    "updatedDateTime": "2025-08-30T07:21:39Z"
  }
}