Equinix Internet Access API | Equinix Product Documentation

Get Equinix Internet Access Service details

Request

Get Equinix Internet Access Service details.

Security

BearerAuth

Path

serviceUuidstring, (uuid)required

Service identifier

Example:919ac898-a4b9-4f9d-b684-aa09ddc65b1b

Payload

// No request payload

Responses

Equinix Internet Access Service details response

Bodyapplication/json

hrefstring, (uri)required

Internet access URI

Example:"https://api.equinix.com/internetAccess/v1/services/2a4fb415-5a7f-436f-bae6-02f5e403deec"

uuidstring, (uuid)required

Equinix-assigned internet access identifier

Example:"df043001-bf0a-446b-a48f-bcdcca68a9f3"

typestring(ServiceType)required

SINGLE_PORT - Internet Access Service supported with one Connection originating from one AccessPoint on the ASide DUAL_PORT - Internet Access Service supported with two redundant Connections originating from two redundant AccessPoints on the Aside and terminating to two redundant Internet Routers on the ZSide

Enum:"SINGLE_PORT""DUAL_PORT"

Example:"SINGLE_PORT"

namestringrequired

Name of the service This name should only contain spaces, the characters "_", "-", letters or numbers. The name cannot start or end with a "-". This name can have only maximum of 24 characters

Example:"Internet Access"

descriptionstring

Description of the service

Example:"Internet access service"

bandwidthinteger, (int64), >= 1000required

Bandwidth of the service in Mbps

Example:1000

billingstring(ServiceBilling)required

Billing type of service

Enum:"FIXED""USAGE_BASED""BURST_BASED"

Example:"FIXED"

statestring(ServiceState)required

Enum:"DRAFT""PENDING""PROVISIONING""ACTIVE""INACTIVE""DEPROVISIONING""DEPROVISIONED""FAILED"

draftbooleanrequired

Describes if the service is a draft

Example:false

useCasestring(ServiceUseCase)required

use case of the service

Enum:"MAIN""BACKUP""MANAGEMENT_ACCESS"

Example:"MAIN"

changeobject(Change)required

changeLogobject(ChangeLog)required

connectionsArray of objects(ConnectionReadModel)required

routingProtocolsArray of objects(RoutingProtocolReadModel)required

accountobject(Account)required

projectobject(ProjectReadModel)

orderobject(OrderReadModel)required

tagsArray of strings

Example:

[
  "tag1",
  "tag2",
  "tag3"
]

linksArray of objects(Link)required

Response

{
  "href": "https://api.equinix.com/internetAccess/v1/services/2a4fb415-5a7f-436f-bae6-02f5e403deec",
  "uuid": "df043001-bf0a-446b-a48f-bcdcca68a9f3",
  "type": "SINGLE_PORT",
  "name": "Internet Access",
  "description": "Internet access service",
  "bandwidth": 1000,
  "billing": "FIXED",
  "state": "DRAFT",
  "draft": false,
  "useCase": "MAIN",
  "change": {
    "href": "string",
    "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
    "type": "SERVICE_CREATION"
  },
  "changeLog": {
    "createdBy": "1232",
    "createdByFullName": "John Doe",
    "createdByEmail": "john.doe@company.com",
    "createdDateTime": "2019-08-24T14:15:22Z",
    "updatedBy": "1234",
    "updatedByFullName": "Ryan Einstein",
    "updatedByEmail": "ryan.einstein@company.com",
    "updatedDateTime": "2019-08-24T14:15:22Z",
    "deletedBy": "1234",
    "deletedByFullName": "Ryan Einstein",
    "deletedByEmail": "ryan.einstein@company.com",
    "deletedDateTime": "2019-08-24T14:15:22Z"
  },
  "connections": [
    { … }
  ],
  "routingProtocols": [
    { … }
  ],
  "account": {
    "href": "https://api.equinix.com/internetAccess/v1/accounts/1234",
    "accountNumber": "1234533211",
    "accountName": "Company account",
    "orgId": "1232",
    "organizationName": "Equinix, Inc."
  },
  "project": {
    "href": "https://api.equinix.com/resourceManager/v1/projects/371",
    "projectId": "9713123422221",
    "projectName": "US Office",
    "parentOrganizationId": "22331",
    "parentOrganizationName": "ABC Company"
  },
  "order": {
    "href": "https://api.equinix.com/internetAccess/v1/orders/cd67f685-41b0-1b07-6de0-320a5c00abee",
    "uuid": "cd67f685-41b0-1b07-6de0-320a5c00abee",
    "type": "NEW",
    "draft": true,
    "status": "COMPLETED",
    "changeLog": { … },
    "number": "1-9234239473",
    "purchaseOrder": { … },
    "contacts": [ … ],
    "tags": [ … ],
    "links": [ … ]
  },
  "tags": [
    "tag1",
    "tag2",
    "tag3"
  ],
  "links": [
    { … }
  ]
}