Equinix Fabric API v4 | Equinix Product Documentation

Get Router

Request

This API provides capability to retrieve user's Cloud Router

Security

BearerAuth

Path

routerIdstring, (uuid)required

Cloud Router UUID

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

Payload

// No request payload

Responses

Fabric Cloud Router object

Bodyapplication/json

typestring

Enum:"IC_ROUTER""XF_ROUTER"

namestring

Customer-provided Cloud Router name

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

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

marketplaceSubscriptionobject(marketplaceSubscription)

Equinix Fabric Entity for Marketplace Subscription

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": "ae708bbb-d669-406a-845a-99b39ff65fd0"
  },
  "notifications": [
    { … }
  ],
  "account": {
    "accountNumber": 123
  },
  "connectionsCount": 0,
  "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"
  }
}