Skip to main content

Creating a Time Service

Prerequisites

Authenticate - Submit your user credentials, Client ID, and Client Secret for OAuth2 authentication. Refer to API Authentication for instructions on how to call the OAuth API to validate and authenticate your credentials.

Create an NTP Standard Service

To create an NTP Standard Service, send a POST request to the /fabric/v4/timeServices endpoint. Specify the type as NTP, the code as NTP_Standard, your connection ID, and your network IP address details in the body of the request.

Sample cURL Request:

curl -X  
POST 'https://api.equinix.com/fabric/v4/timeServices'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
    "name": "EPT-Single-Service",
    "type": "NTP",
    "connections": [
    {
        "uuid": "06dbb0e3-e55d-4090-8aff-fc5654abaad0"
    }
    ],
    "package": {
    "code": "NTP_STANDARD"
    },
    "ipv4": {
    "primary": "192.168.0.2",
    "secondary": "192.168.0.3",
    "networkMask": "255.255.255.240",
    "defaultGateway": "192.168.0.1"
    }
}'

The parameters included in the request body are specific to this example. For a full list of parameters and their descriptions, see the API Reference.

Sample Response:

{  
    "href": "https://api.equinix.com/fabric/v4/timeServices/a8ba52de-faae-43b5-b0b1-6904d37ee011",
    "uuid": "a8ba52de-faae-43b5-b0b1-6904d37ee011",
    "name": "EPT-Single-Service",
    "type": "NTP",
    "state": "PROVISIONING",
    "connections": [
        {
        "href": "https://api.equinix.com/fabric/v4/connections/a8ba52de-faae-43b5-b0b1-6904d37ee011",
        "uuid": "06dbb0e3-e55d-4090-8aff-fc5654abaad0"
        }
    ],
    "package": {
        "href": "https://api.equinix.com/fabric/v4/timeServicePackages/NTP_STANDARD",
        "code": "NTP_STANDARD"
    },
    "ipv4": {
        "primary": "192.168.0.2",
        "secondary": "192.168.0.3",
        "networkMask": "255.255.255.240",
        "defaultGateway": "192.168.0.1"
    },
    "account": {
        "accountNumber": 123456
    }
}

Response payload includes configuration parameters defined in the request body. For a full list of possible parameters and their descriptions, see the API Reference.

Create a PTP Standard Service

To create an PTP Standard Service, send a POST request to the /fabric/v4/timeServices endpoint. Specify the type as PTP, the code as PTP_Standard, your connection ID, and your network IP address details in the body of the request.

curl -X  
POST 'https://api.equinix.com/fabric/v4/timeServices'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
    "name": "EPT-Single-Service",
    "type": "PTP",
    "connections": [
    {
        "uuid": "06dbb0e3-e55d-4090-8aff-fc5654abaad0"
    }
    ],
    "package": {
    "code": "PTP_STANDARD"
    },
    "ipv4": {
    "primary": "192.168.0.2",
    "secondary": "192.168.0.3",
    "networkMask": "255.255.255.240",
    "defaultGateway": "192.168.0.1"
    }
}'

Create a PTP Service with Advanced Configuration

To create an NTP Standard Service, send a POST request to the /fabric/v4/timeServices endpoint. Specify the type as PTP, the code as PTP_Standard, your connection ID, and your network IP address details in the body of the request. Use the advanceConfiguration object to specify options like priority, announce interval, or sync interval. A full list of the advanced configuration options is available in the API Reference.

curl -X  
POST 'https://api.equinix.com/fabric/v4/timeServices'
-H 'content-type: application/json'
-H 'authorization: Bearer <token>'
-d '{
    "name": "EPT-Single-Service",
    "type": "PTP",
    "connections": [
     {
        "uuid": "06dbb0e3-e55d-4090-8aff-fc5654abaad0"
     }
    ],
    "package": {
     "code": "PTP_STANDARD"
    },
    "ipv4": {
     "primary": "192.168.0.2",
     "secondary": "192.168.0.3",
     "networkMask": "255.255.255.240",
     "defaultGateway": "192.168.0.1"
    },
    "advanceConfiguration": {
    "ptp": {
      "tailScale": true,
      "domain": 10,
      "priority1": 5,
      "priority2": 7,
      "logAnnounceInterval": 0,
      "logSyncInterval": 0,
      "logDelayReqInterval": 0
    }
}'