Equinix Fabric API v4 | Equinix Product Documentation

Update Router

Request

This API provides capability to update user's Cloud Router

Security

BearerAuth

Path

routerIdstring, (uuid)required

Cloud Router UUID

Example:557400f8-d360-11e9-bb65-2a2ae2dbcce4

Bodyapplication/json-patch+jsonrequired

Array [

opstringrequired

Handy shortcut for operation name

Enum:"replace""add""remove"

pathstringrequired

path inside document leading to updated parameter

valueanyrequired

new value for updated parameter

]

Payload

[
  {
    "op": "replace",
    "path": "/package/code",
    "value": "PREMIUM"
  }
]

Responses

Fabric Cloud Router object

Bodyapplication/json

typestring

Value:"XF_ROUTER"

namestring, (string)

Customer-provided Cloud Router name

Example:"test-fg-1"

locationobject(SimplifiedLocationWithoutIBX)

packageobject(CloudRouterPostRequestPackage)

Fabric Cloud Router Package Type

orderobject(Order)

projectobject(Project)

accountobject(SimplifiedAccount)

notificationsArray of objects(SimplifiedNotification)

Preferences for notifications on connection configuration or status changes

marketplaceSubscriptionobject(marketplaceSubscription)

Equinix Fabric Entity for Marketplace Subscription

hrefstring, (uri)read-only

Cloud Routers URI

Example:"https://api.equinix.com/fabric/v4/routers/3c9b8e7a2-f3b1-4576-a4a9-1366a63df170"

uuidstring, (uuid)

Equinix-assigned access point identifier

Example:"c9b8e7a2-f3b1-4576-a4a9-1366a63df170"

statestring(CloudRouterAccessPointState)

Access point lifecycle state

Enum:"PROVISIONED""PROVISIONING""DEPROVISIONING""DEPROVISIONED""REPROVISIONING""NOT_PROVISIONED""NOT_DEPROVISIONED"

Example:"PROVISIONED"

equinixAsninteger, (int64)

Equinix ASN

Example:30000

connectionsCountinteger, >= 0

Number of connections associated with this Access point

changeLogobject(Changelog)

Change log

changeobject(CloudRouterChange)

Current state of latest CloudRouter change

Response

{
  "href": "https://api.equinix.com/fabric/v4/routers/201b7346-a9eb-42fe-ae7a-08148c71928d",
  "uuid": "201b7346-a9eb-42fe-ae7a-08148c71928d",
  "state": "PROVISIONED",
  "type": "XF_ROUTER",
  "name": "My-Cloud-Router",
  "location": {
    "metroHref": "https://api.equinix.com/fabric/v4/metros/HH",
    "metroCode": "HH"
  },
  "equinixAsn": 30000,
  "package": {
    "href": "https://api.equinix.com/fabric/v4/routerPackages/STANDARD",
    "code": "STANDARD"
  },
  "order": {
    "purchaseOrderNumber": "1-129105284100"
  },
  "project": {
    "projectId": "123456"
  },
  "notifications": [
    { … }
  ],
  "account": {
    "accountNumber": 123
  },
  "connectionsCount": 0,
  "change": {
    "uuid": "3c9b8e7a2-f3b1-4576-a4a9-1366a63df170",
    "type": "ROUTER_UPDATE",
    "status": "REQUESTED",
    "createdDateTime": "2022-04-19T04:20:55.471Z",
    "updatedDateTime": "2022-04-19T04:20:55.471Z",
    "data": [ … ]
  },
  "changeLog": {
    "createdBy": "abc@xyz.com",
    "createdByFullName": "abc",
    "createdByEmail": "abc@xyz.com",
    "createdDateTime": "2021-09-24T06:59:46Z",
    "updatedBy": "abc@xyz.com",
    "updatedByFullName": "abc",
    "updatedByEmail": "abc@xyz.com",
    "updatedDateTime": "2021-09-24T06:59:46Z",
    "deletedBy": "abc@xyz.com",
    "deletedByFullName": "abc",
    "deletedByEmail": "abc@xyz.com",
    "deletedDateTime": "2021-09-24T06:59:46Z"
  }
}