Étiquetage des appareils

Equinix Metal prend en charge l'utilisation de balises pour appliquer des étiquettes personnalisées à vos serveurs et aux blocs d'adresses IP demandés.

Balises du serveur

Console

Dans la console, vous pouvez attribuer des étiquettes à un serveur après son approvisionnement, à partir de l'onglet Étiquettes du serveur.

Entrez l'étiquette dans le champ de texte et appuyez sur TAB pour la confirmer.

Si vous entrez plusieurs étiquettes, entrez chaque étiquette individuellement, en appuyant sur TAB après chaque entrée.

Cliquez sur Ajouter des balises pour les ajouter au serveur. Toutes les balises du serveur apparaissent dans la zone Balises du serveur.

Pour supprimer une étiquette, cliquez sur le X sur l'étiquette.

CLI

Pour étiqueter votre serveur lors de la mise en service, ajoutez l'indicateur --tags à votre commande metal device create, avec une étiquette ou une liste d'étiquettes à ajouter.

metal device create -p <project_id> -m <metro> -P <plan> -H <hostname> -O <operating_system> -t <tags>

Pour modifier les étiquettes d'un serveur déjà approvisionné, utilisez l'option --tags avec la commande metal device update. Notez que toute nouvelle étiquette remplacera les étiquettes existantes ; par conséquent, si vous ajoutez une étiquette à une liste d'étiquettes, vous devrez spécifier la liste complète.

metal device update -i <device_id> -t <tags>

API

Pour étiqueter votre serveur lors de la mise en service, ajoutez le paramètre "tags" au corps de votre requête POST au point de terminaison /projects/{id}/devices.

curl -X POST \
    -H "Content-Type: application/json" \
    -H "X-Auth-Token: <API_TOKEN>" \
    "https://api.equinix.com/metal/v1/projects/{id}/devices" \
    -d '{
        "metro": "<metro_code>",
        "plan": "<server_type>",
        "operating_system": "<os_slug>"
        "tags": [
            "string"
        ]
    }'

Pour modifier les étiquettes d'un serveur déjà approvisionné, utilisez le paramètre "tags" dans le corps de votre requête PUT adressée au point de terminaison /projects/{id}/devices. Notez que toute nouvelle étiquette remplacera les étiquettes existantes ; par conséquent, si vous ajoutez une étiquette à une liste d'étiquettes, vous devrez spécifier la liste complète.

curl -X PUT \
    -H "Content-Type: application/json" \
    -H "X-Auth-Token: <API_TOKEN>" \
    "https://api.equinix.com/metal/v1/projects/{id}/devices" \
    -d '{
        "tags": [
            "string"
        ],
    }'

Balises de blocage d'adresse IP

Vous pouvez ajouter des balises à tous les blocs d’adresses IP que vous demandez.

Console

Lorsque vous demandez plusieurs adresses IP, vous pouvez ajouter des étiquettes à votre requête. Entrez votre ou vos balises dans le champ Tags, en appuyant sur TAB après chacune d'elles. Lorsque vous cliquez sur Envoyer la requête, les balises seront ajoutées au bloc d'adresse lors de leur création.

Pour modifier ou ajouter des étiquettes à un bloc d'adresses IP, ouvrez le panneau latéral Gérer le bloc et ajoutez des étiquettes dans le champ Étiquettes, en appuyant sur TAB après chaque étiquette. Pour supprimer une étiquette, cliquez sur l'astérisque .X sur l'étiquette. Cliquez sur Mettre à jour le bloc pour mettre à jour les étiquettes.

CLI

Lors de la demande d'un bloc d'adresses IP, vous pouvez ajouter des étiquettes à votre commande metal ip request.

metal ip request -p $METAL_PROJECT_ID --type <ip_address_type> --quantity <int> --metro <metro_code> --tags <tags>

API

Lors de la demande d'un bloc d'adresses IP, vous pouvez ajouter le champ "tags" à votre requête POST au point de terminaison /projects/{id}/ips.

curl -X POST \
-H 'Content-Type: application/json' \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{id}/ips" \
-d '{
    "type": "public_ipv4",
    "quantity": 4,
    "metro": "sv",
    "tags": [
        "string"
    ]
}'