Création d'un service horaire
Conditions préalables
Authentifier - Soumettez vos informations d'identification de l'utilisateur, l'ID du client et le secret du client pour l'authentification OAuth2. Reportez-vous à API Authentication pour savoir comment appeler l'API OAuth afin de valider et d'authentifier vos informations d'identification.
Créer un service standard NTP
Pour créer un service standard NTP, envoyez une requête POST au point de terminaison [/fabric/v4/timeServices](/api-catalog/fabricv4/#tag/Precision Time/operation/createTimeServices). Spécifiez le type comme étant NTP, le code comme étant NTP_Standard, votre ID de connexion, et les détails de votre adresse IP 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 spécifiques à cet exemple. Pour obtenir la liste complète des paramètres et leur description, consultez la [Référence API](/api-catalog/fabricv4/#tag/Precision Time/operation/createTimeServices).
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 comprend les paramètres de configuration définis dans le corps de la demande. Pour obtenir la liste complète des paramètres possibles et leur description, consultez la [Référence API](/api-catalog/fabricv4/#tag/Precision Time/operation/createTimeServices).
Créer un service standard PTP
Pour créer un service standard PTP, envoyez une requête POST au point de terminaison /fabric/v4/timeServices. Spécifiez le type comme étant PTP, le code comme étant PTP_Standard, votre ID de connexion, et les détails de votre adresse IP 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 standard NTP, envoyez une requête POST au point de terminaison [/fabric/v4/timeServices](/api-catalog/fabricv4/#tag/Precision Time/operation/createTimeServices). Spécifiez le type comme étant PTP, le code comme étant PTP_Standard, votre ID de connexion, et les détails de votre adresse IP dans le corps de la requête. Utilisez l'objet advanceConfiguration pour spécifier des options comme la priorité, l'intervalle d'annonce ou l'intervalle de synchronisation. Une liste complète des options de configuration avancée est disponible dans la [Référence API] (/api-catalog/fabricv4/#tag/Precision Time/operation/createTimeServices).
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
}
}'