Actions du serveur
Pour faciliter la gestion de vos serveurs, Equinix Metal™ fournit certaines commandes et fonctionnalités de base via la console, la CLI et l'API.
Redémarrer
Il peut être nécessaire de redémarrer un serveur pour installer des mises à jour ou après avoir configuré le système d'exploitation. Si nécessaire, vous pouvez envoyer la commande de redémarrage depuis la console Equinix Metal, l'interface de ligne de commande (CLI) ou l'API.
- Console
- CLI
- API
Cliquez sur le menu déroulant Actions puis sur Redémarrer. Une fois le redémarrage du serveur confirmé, le message « Opération du serveur réussie » devrait s'afficher.
Redémarrez un serveur avec la commande metal device reboot.
metal device reboot --id <device_uuid>
Vous pouvez redémarrer un serveur avec une requête POST au point de terminaison /devices/{id}/actions et spécifier le type d'action comme "reboot".
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/devices/{id}/actions" \
-d '{
"type": "reboot"
}'
Le serveur sera temporairement indisponible pendant son redémarrage, mais devrait être de nouveau accessible après quelques minutes, ou le temps nécessaire au redémarrage. Les actions de redémarrage effectuées depuis la console, l'interface de ligne de commande (CLI) et l'API sont enregistrées et affichées dans l'onglet « Chronologie » du serveur.
Mise hors tension et sous tension
Vous pouvez conserver un serveur provisionné dans votre projet, mais dans un état hors tension.
Remarque: la mise hors tension d'un serveur n'interrompt pas sa facturation. Vous devez déprovisionner un serveur pour arrêter toute facturation.
- Console
- CLI
- API
Pour éteindre un serveur, cliquez sur le menu déroulant Actions et sélectionnez Éteindre.
Lorsque vous confirmez que vous voulez éteindre le serveur, vous devriez recevoir un message « Action serveur réussie » et l’état du serveur sera mis à jour à Arrêté.
Pour activer un serveur, cliquez sur le menu Actions puis sur Mettre sous tension.
Une fois que vous aurez confirmé que vous voulez mettre le serveur sous tension, vous devriez recevoir un message « Action serveur réussie » et l’état du serveur passera d’abord à Démarrage puis à En cours d’exécution.
Pour éteindre un serveur, utilisez la commande metal device stop.
metal device stop --id <device_uuid>
Pour mettre un serveur sous tension, utilisez la commande metal device start.
metal device start --id <device_uuid>
Vous pouvez éteindre un serveur avec une requête POST au point de terminaison /devices/{id}/actions et spécifier le type d'action comme "power_off".
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/devices/{id}/actions" \
-d '{
"type": "power_off"
}'
De même, vous pouvez mettre sous tension un serveur avec une requête POST au point de terminaison /devices/{id}/actions et spécifier le type d'action comme "power_on".
curl -X POST \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/devices/{id}/actions" \
-d '{
"type": "power_on"
}'
Les actions de mise hors tension et de mise sous tension initiées depuis la console, l'interface de ligne de commande (CLI) et l'API sont enregistrées et répertoriées dans l'onglet Chronologie du serveur.
Verrouiller l'appareil et déverrouiller l'appareil
Vous pouvez verrouiller un appareil pour empêcher toute modification destructrice sur un serveur provisionné. Le verrouillage d'un appareil empêche:
- Suppression ou déprovisionnement de l'appareil.
- Lancement d'une Réinstallation de l'appareil.
- La suppression ou la mise hors service d'une instance avec un
"termination time"défini, même si le délai de fin de vie est atteint, est impossible. Le délai de fin de vie d'un serveur Spot Market ne peut pas être modifié par le verrouillage du périphérique.
Les actions de verrouillage et de déverrouillage sont enregistrées et répertoriées dans l'onglet Chronologie du serveur.
- Console
- CLI
- API
Pour verrouiller ou déverrouiller un serveur, cliquez sur l'icône de verrouillage située à côté du menu déroulant Actions du serveur.
Pour verrouiller ou déverrouiller un appareil, utilisez la commande metal device update et utilisez l'indicateur --locked.
Pour verrouiller:
metal device update -i <device_id> --locked true
Pour déverrouiller:
metal device update -i <device_id> --locked false
Pour verrouiller ou déverrouiller un serveur, envoyez une requête PUT au point de terminaison /devices/{id} avec l'état du champ "locked" spécifié dans le corps de la requête.
Pour verrouiller:
curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: $API_TOKEN" \
"https://api.equinix.com/metal/v1/devices/{id}" \
-d '{
"locked": true
}'
Pour déverrouiller:
curl -X PUT \
-H "Content-Type: application/json" \
-H "X-Auth-Token: $API_TOKEN" \
"https://api.equinix.com/metal/v1/devices/{id}" \
-d '{
"locked": false
}'
Sauvetage, réinstallation et console OOB
Les autres éléments du menu Actions du serveur ont chacun leur propre page de documentation expliquant leur utilisation, avec des exemples dans la section Récupération.