Modification d'une instance de service

Une fois votre service Precision Time créé et son statut « Provisionné », vous pouvez modifier sa configuration. Avant de mettre à jour un service nouvellement approvisionné, vous devez patienter 6 heures. Pendant ce délai, la base de données de facturation met à jour ses enregistrements afin de fournir des tarifs précis.

Pour consulter et modifier les services Precision Time, vous devez disposer du rôle EPT Service Admin.

Pour accéder aux informations sur le service Precision Time dans le portail client, connectez-vous et accédez à votre inventaire Precision Time.

Pour accéder aux informations du service Precision Time via l'API, vous devez fournir votre identifiant client et votre clé secrète pour l'authentification OAuth2. Consultez la section Authentification API pour savoir comment appeler l'API OAuth afin de valider et d'authentifier vos identifiants.

avertissement

Tout changement à la configuration pourrait perturber le service.

Nom du service

Portal

Cliquez sur Modifier à côté du nom du service.

Entrez un nouveau nom et cliquez sur Soumettre.

API

Pour mettre à jour le nom d'un service de temps, envoyez une requête PATCH au point de terminaison /fabric/v4/timeServices/{serviceId}.

Dans le corps de la requête, précisez:

• op - replace.
• path - /name.
• value - The new name for your service.

Exemple de requête cURL:

curl -X  
PATCH 'https: //api.equinix.com/fabric/v4/timeServices/<service_id>'
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '[  
{
    "op": "replace",
    "path": "/name",
    "value": "<new-service-name>"
}
]'

Forfait de services

remarque

Si une instance de service Precision Time a été créée manuellement par un représentant commercial d'Equinix, vous devez le contacter pour modifier le niveau de service. Il n'est pas possible de modifier le niveau de service par le portail ou l'API.

Portal

Cliquez sur Modifier dans la section Détails du forfait. Modifiez le forfait, puis consultez et acceptez le nouveau prix. Cliquez ensuite sur Soumettre.

API

Pour mettre à jour votre progiciel de service, envoyez une requête PATCH au point de terminaison /fabric/v4/timeServices/{serviceId}.

Dans le corps de la requête, précisez:

• op - replace.
• path - /package/code.
• value - The new package code: NTP_STANDARD, NTP_ENTERPRISE, PTP_STANDARD, or PTP_ENTERPRISE.

curl -X  
PATCH 'https://api.equinix.com/fabric/v4/timeServices/<service_id>'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '[
  {
    "op": "replace",
    "path": "/package/code",
    "value": "<new_package_code>"
  }
]'

Détails de l'actif

Cliquez sur « Modifier » dans les détails de l'actif. Seuls les services provisionnés peuvent être modifiés.

Le panneau « Modifier les détails de l’actif de précision temporelle » s’affichera. Seuls les ports admissibles apparaîtront en fonction de la région métropolitaine, de l’encapsulation, de l’ID VLAN précédent et du type de port.

• Sélectionnez le port désiré et cliquez sur Suivant.
• L'ID du VLAN précédemment sélectionné s'affichera.
• Cliquez sur Enregistrer. Les informations de connexion du port seront mises à jour.

Détails du réseau

Portal

Cliquez sur Modifier dans la section Détails du réseau pour mettre à jour l'adresse IP principale, l'adresse IP secondaire, le masque de réseau et l'interface IP de la passerelle.

API

Pour mettre à jour les détails réseau d'un service, envoyez une requête PATCH au point de terminaison /fabric/v4/timeServices/{serviceId}.

Dans le corps de la requête, précisez:

• op - replace.
• path - /ipv4.
• value - Specify new values for the primary IP address, secondary IP address, network mask, and gateway IP address.

Exemple de requête cURL:

curl -X  
PATCH 'https://api.equinix.com/fabric/v4/timeServices/3a58dd05-f46d-4b1d-a154-2e85c396ea62'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '[
  {
    "op": "replace",
    "path": "/ipv4",
    "value": {
      "primary": "192.168.254.241",
      "secondary": "192.168.254.242",
      "networkMask": "255.255.255.240",
      "defaultGateway": "192.168.254.254"
    }
  }
]'

Détails de configuration avancés PTP

Vous pouvez modifier les détails de configuration avancée PTP suivants:

• Échelle de temps:

  • ARB - Génère des horodatages au format UTC avec un décalage UTC de 0. (Ceci est le comportement par défaut.)
  • PTP - Génère des horodatages au format TAI avec la valeur de décalage UTC actuelle.

• Domaine - Entrez une valeur de domaine PTP pour le serveur de temps. Toutes les horloges synchronisées avec ce serveur doivent être configurées avec la même valeur de domaine. La plage de valeurs est de 0 (valeur par défaut) à 127.

• Priorité 1 et Priorité 2 - Entrez une valeur entre 0 et 248. Les valeurs les plus basses indiquent une priorité plus élevée.

• Intervalle d'annonce des journaux - Choisissez une option dans la liste déroulante. Cette valeur logarithmique contrôle la fréquence d'envoi des paquets d'annonce PTP par le serveur PTP. La valeur par défaut est 1, ce qui correspond à 1 paquet toutes les 2 secondes.

• Intervalle de synchronisation des journaux - Choisissez une option dans la liste déroulante. Cette valeur logarithmique contrôle le débit des paquets de synchronisation PTP. La valeur par défaut est -4, ce qui correspond à 16 paquets par seconde.

• Intervalle de requête de délai logarithmique - Choisissez une option dans la liste déroulante. Cette valeur logarithmique contrôle le débit des paquets PTP DelayReq. Ce paramètre peut aussi devoir être spécifié sur le client PTP. La valeur par défaut est -4, ce qui correspond à 16 paquets par seconde.

• Mode de transport - Choisissez Multicast (par défaut), Unicast ou Hybride.

Portal

Cliquez sur Modifier dans la section Détails de configuration avancés pour mettre à jour les paramètres PTP.

API

Pour mettre à jour les détails de configuration PTP de votre service, envoyez une requête PATCH au point de terminaison /fabric/v4/timeServices/{serviceId}.

Dans le corps de la requête, précisez:

• op - replace.
• path - /ptpAdvancedConfiguration.
• value - An object containing your new configuration details.

Exemple de requête cURL:

curl -X  
PATCH 'https://api.equinix.com/fabric/v4/timeServices/<service_id>'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '[
  {
    "op": "replace",
    "path": "/ptpAdvancedConfiguration",
    "value": {
      "timeScale": "PTP",
      "domain": 20,
      "priority1": 20,
      "priority2": 20,
      "logAnnounceInterval": 1,
      "logSyncInterval": -4,
      "logDelayReqInterval": -4,
      "transportMode": "UNICAST",
      "grantTime": 300
    }
  }
]'

Détails de configuration avancée NTP

remarque

La modification de la configuration avancée NTP n'est prise en charge que pour NTP Enterprise.

Vous pouvez modifier les détails de configuration avancée NTP suivants:

• Type MD5 - Sélectionnez le type de chaîne de clé, ASCII ou HEX.

• Numéro de clé MD5 - Entrez le numéro de clé. Les nombres entiers entre 1 et 65535 sont valides.

• Clé MD5 - Entrez une clé contenant entre 10 et 40 caractères:

Portal

Cliquez sur Modifier dans la section Détails de configuration avancés pour ajouter ou mettre à jour des clés.

Une fois toutes vos modifications effectuées, cliquez sur Soumettre.

Le numéro de commande de service est mis à jour et, au besoin, l'instance est reconfigurée et réapprovisionnée.

API

Pour mettre à jour les détails de configuration NTP de votre service, envoyez une requête PATCH au point de terminaison /fabric/v4/timeServices/{serviceId}.

Dans le corps de la requête, précisez:

• op - replace.
• path - /ntpAdvancedConfiguration.
• value - An object containing your new configuration details.

Exemple de requête cURL:

curl -X  
PATCH 'https://api.equinix.com/fabric/v4/timeServices/<service_id>'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '[
  {
    "op": "replace",
    "path": "/ntpAdvancedConfiguration",
    "value": [
      {
        "type": "ASCII",
        "keyNumber": 65534,
        "key": "base64-encoded-ascii"
      },
      {
        "type": "HEX",
        "keyNumber": 65535,
        "key": "base64-encoded-hex"
      }
    ]
  }
]'