Création d'un service de temps
Conditions préalables
Authentification: soumettez vos identifiants utilisateur, votre identifiant client et votre clé secrète pour l’authentification OAuth2. Consultez la documentation relative à l’authentification API (Authentification API) pour savoir comment appeler l’API OAuth afin de valider et d’authentifier vos identifiants.
Créer un service standard NTP
Pour créer un service NTP standard, envoyez une requête POST au point de terminaison /fabric/v4/timeServices. Spécifiez le type comme NTP, le code comme NTP_Standard, votre identifiant de connexion et les détails de votre adresse IP réseau dans le corps de la requête.
Exemple de requête cURL:
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"
}
}'
Les paramètres inclus dans le corps de la requête sont propres à cet exemple. Pour obtenir la liste complète des paramètres et leurs descriptions, consultez la référence de l'API.
Exemple de réponse:
{
"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
}
}
La charge utile de la réponse inclut les paramètres de configuration définis dans le corps de la requête. Pour obtenir la liste complète des paramètres possibles et leurs descriptions, consultez la référence de l'API.
Créer un service standard PTP
Pour créer un service PTP standard, envoyez une requête POST au point de terminaison /fabric/v4/timeServices. Spécifiez le type comme PTP, le code comme PTP_Standard, votre ID de connexion et les détails de votre adresse IP réseau dans le corps de la requête.
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"
}
}'
Créer un service PTP avec une configuration avancée
Pour créer un service NTP standard, envoyez une requête POST au point de terminaison /fabric/v4/timeServices. Spécifiez PTP comme type, PTP_Standard comme code, votre ID de connexion et l'adresse IP de votre réseau dans le corps de la requête. Utilisez l'objet advanceConfiguration pour définir des options telles que la priorité, l'intervalle d'annonce ou l'intervalle de synchronisation. La liste complète des options de configuration avancées est disponible dans la documentation de référence de l'API.
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
}
}'