Modifier une instance de service

Une fois que vous avez créé un service Precision Time et que son état est " provisionné ", vous pouvez modifier sa configuration. Avant de mettre à jour un service nouvellement provisionné, vous devez attendre 6 heures. Pendant ce temps d'attente, la base de données des factures met à jour ses enregistrements pour fournir des prix exacts.

Pour afficher et modifier les services Precision Time, vous devez avoir le rôle EPT Service Admin.

Pour accéder aux informations sur les services Precision Time dans le Customer Portal, [connectez-vous] (https://portal.equinix.com/) et naviguez jusqu'à votre [inventaire Precision Time] (ept-view-update-service.mdx).

Pour accéder aux informations du service Precision Time dans l'API, vous devez soumettre votre identifiant et votre secret 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.

avertissement

La modification de la configuration peut perturber le service.

Nom du service

Portal

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

Saisissez un nouveau nom et cliquez sur Submit.

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 demande, 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>"
}
]'

Paquet de services

note

Si une instance de service Precision Time a été créée manuellement par un représentant commercial d'Equinix, vous devez contacter ce dernier pour modifier le niveau de service. Vous ne pourrez pas changer de niveau de service en utilisant le portail ou l'API.

Portal

Cliquez sur Edit dans la section Package Details. Modifiez le forfait, puis consultez et acceptez le nouveau prix. Cliquez sur Submit.

API

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

Dans le corps de la demande, 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 Editer dans les détails de l'actif. Seuls les services provisionnés peuvent être modifiés.

Le tiroir Edit Precision Time Asset Details s'affiche. Seuls les ports éligibles apparaissent en fonction du métro, de l'encapsulation, de l'ID VLAN précédent et du type de port.

• Sélectionnez le port souhaité et cliquez sur Next.
• L'ID VLAN précédemment sélectionné s'affiche.
• Cliquez sur Save. Les détails de la connexion portuaire seront mis à jour.

Détails du réseau

Portal

Cliquez sur Edit dans la section Network Details pour mettre à jour l'IP primaire, l'IP secondaire, le masque de réseau et l'interface IP de la passerelle.

API

Pour mettre à jour les détails du réseau d'un service, envoyez une requête PATCH au point de terminaison [/fabric/v4/timeServices/{serviceId}](/api-catalog/fabricv4/#tag/Precision Time/operation/updateTimeServicesById).

Dans le corps de la demande, 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 la configuration avancée du protocole 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. (C'est la valeur par défaut.)
  • PTP - Génère des horodatages au format TAI avec la valeur actuelle du décalage UTC.

• Domain - Entrez une valeur de domaine PTP pour le serveur de temps. Toutes les horloges qui se synchronisent avec ce serveur doivent être configurées avec la même valeur de domaine. La plage est comprise entre 0 (valeur par défaut) et 127.

• Priorité 1 et Priorité 2 - Saisissez une valeur comprise entre 0 et 248. Les valeurs inférieures indiquent une priorité plus élevée.

• Log Announce Interval - Choisissez une option dans la liste déroulante. Cette valeur logarithmique contrôle le taux de paquets d'annonce PTP provenant du serveur PTP. La valeur par défaut est 1, ce qui correspond à un paquet toutes les 2 secondes.

• Log Sync Interval - Choisissez une option dans la liste déroulante. Cette valeur logarithmique contrôle le taux de paquets PTP Sync. La valeur par défaut est -4, ce qui correspond à 16 paquets par seconde.

• Log Delay Req Interval - Choisissez une option dans la liste déroulante. Cette valeur logarithmique contrôle le taux de paquets PTP DelayReq. Il se peut que ce paramètre doive également être spécifié sur le client PTP. La valeur par défaut est -4, ce qui correspond à 16 paquets par seconde.

• Transport Mode - Choisissez Multicast (par défaut), Unicast ou Hybrid.

Portal

Cliquez sur Edit dans la section Advanced Configuration Details pour mettre à jour les paramètres PTP.

API

Pour mettre à jour les détails de la configuration PTP de votre service, envoyez une requête PATCH au point de terminaison [/fabric/v4/timeServices/{serviceId}](/api-catalog/fabricv4/#tag/Precision Time/operation/updateTimeServicesById).

Dans le corps de la demande, 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 la configuration avancée de NTP

note

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

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

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

• Numéro de clé MD5 - Saisissez le numéro de clé. Les nombres entiers de 1 à 65535 sont valables.

• Clé MD5 - Saisissez une clé contenant de 10 à 40 caractères :

Portal

Cliquez sur Edit dans la section Advanced Configuration Details pour ajouter ou mettre à jour des clés.

Une fois que vous avez effectué toutes vos modifications, cliquez sur Submit.

Le numéro d'ordre de service est mis à jour et, si nécessaire, l'instance est reconfigurée et reprovisionnée.

API

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

Dans le corps de la demande, 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"
      }
    ]
  }
]'