Adresses IP Anycast globales

Les adresses IP Equinix Metal™ Global Anycast sont des adresses IPv4 publiques extraites de l'espace IP appartenant à Equinix Metal et qui peuvent être annoncées à partir de tout ou partie des métros d' Equinix Metal.

Les adresses IP Anycast globales peuvent être utilisées:

• en les attribuant comme adresse IP élastique à un seul serveur dans plusieurs métropoles.
• OU en les annonçant via BGP local à partir de plusieurs serveurs dans plusieurs métropoles.

Si une adresse IP Global Anycast n'est pas acheminée vers ou annoncée depuis un serveur dans un Metro, l'adresse IP sera inaccessible.

Equinix Metal vous permet de réserver les tailles de sous-réseau suivantes d'adresses IP Global Anycast.

Global Anycast Subnet Size	Usable IP Addresses
/32	1 IPv4 address
/31	2 IPv4 addresses
/30	4 IPv4 addresses

Les adresses IP Anycast globales sont facturées à l'utilisation, à un tarif fixe par IP et par heure. La bande passante est facturée au tarif sortant standard et au tarif entrant par Go. Les tarifs sont disponibles dans la console Equinix Metal .

Demande d'adresses IP Anycast globales

Console

Dans la section Réseau de votre projet, ouvrez la page Adresse IP.

Les adresses IP actuelles de votre projet devraient être affichées. Pour demander des adresses IP Anycast globales, cliquez sur + Ajouter.

Dans le menu déroulant Demander les adresses IP, sélectionnez IPv4 globale et la Quantité (taille) du sous-réseau réservé. Vous trouverez également des champs pour les Étiquettes et une Description. Le champ JSON personnalisé est destiné aux données personnalisées que vous souhaitez inclure dans les métadonnées de votre serveur (../server-metadata/metadata.md).

Utilisez le champ Commentaires pour contacter le soutien et fournir toute information pertinente concernant votre demande. Veuillez noter que si vous prévoyez de demander plusieurs sous-réseaux, ou plusieurs grands sous-réseaux, des quotas sont en vigueur au niveau du projet. Le soutien pourrait vous contacter pour vous poser des questions concernant votre demande.

CLI

Pour demander une adresse IP Anycast globale, utilisez la commande metal ip request et spécifiez le --type comme global_ipv4.

metal ip request --project-id <project_id> --type global_ipv4 --quantity <int>

API

Pour demander des adresses IP supplémentaires dans l'API, envoyez une 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": "global_ipv4",
    "quantity": 4,
    "fail_on_approval_required": "false"
}'

Paramètres corporels

• "type" (required) - To request a Global Anycast IP address, use "global_ipv4".
• "quantity" (required) - The quantity parameter should be the number of IPs in the subnet. Valid values are 1, 2, and 4 for Global Anycast IP addresses.
• "fail_on_approval_required" (optional) - If you submit a request that exceeds the maximum number of IP addresses available to your project, you can automatically have the request fail with HTTP status 422 instead of triggering the review process by providing the fail_on_approval_required parameter set to true in the request.

Une liste complète des champs et des options des paramètres du corps est disponible dans la référence API.

Gestion des adresses IP Anycast globales

Console

La page IPs de votre projet contient une liste de tous les sous-réseaux et adresses IP Anycast de gestion, réservés et globaux.

CLI

Dans l'interface de ligne de commande (CLI), toutes les informations relatives aux sous-réseaux de gestion, réservés et Anycast globaux ainsi qu'aux adresses IP d'un projet sont disponibles à partir de la commande metal ip get.

`metal ip get -p <project-uuid>`

API

Pour obtenir une liste des sous-réseaux et adresses IP Anycast de gestion, réservés et globaux de votre projet, envoyez une requête GET au point de terminaison /projects/{id}/ips.

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/projects/{id}/ips"

La réponse contient un identifiant de réservation dans le champ « id ». (L'exemple de réponse est tronqué.)

{
"ip_addresses": [
    {
    "id": "804c4112-c00a-486c-9c54-0918dd1894b2",
    "address_family": 4,
    "netmask": "255.255.255.254",
    "created_at": "2022-09-21T13:14:55Z",
    "public": true,
    "cidr": 31,
    "management": false,
    "manageable": true,
    "enabled": true,
    "global_ip": true,
    "assignments": [],
    "network": "147....",
    "address": "147....",
    "gateway": "147....",
    "type": "global_ipv4"
    ....
    },
    ....
]
}

Annoncer votre adresse IP

Une fois que votre bloc d'adresses IPv4 Anycast global vous a été attribué, vous avez deux options: attribuer vos nouvelles adresses IP à un serveur en tant qu'Elastic IPs, ou les annoncer avec BGP.

Si vous choisissez de lier des adresses IP Anycast globales à une adresse IP élastique, vous pouvez attribuer des adresses individuelles à un seul serveur dans chaque métropole. Cependant, si vous tentez d'attribuer la même adresse IP à plusieurs serveurs dans la même métropole, vous obtiendrez une erreur.

Si vous choisissez d'annoncer vos adresses IP Anycast globales via BGP, vous devrez configurer BGP local. BGP permet d'attribuer votre adresse IP Anycast globale à plusieurs serveurs dans chaque région métropolitaine ; son utilisation est donc recommandée pour les applications à haute disponibilité.

Statut IP Anycast global

Console

Pour voir l'état de votre bloc d'adresses IP Anycast global, accédez à la page IP de votre projet et ouvrez le menu Actions de la réservation d'adresses IP que vous souhaitez gérer. Cliquez sur Mettre à jour le bloc.

Un cercle gris indique qu'aucune adresse IP du bloc n'est attribuée à l'installation ou annoncée via BGP. Un cercle vert indique qu'une adresse IP du bloc est attribuée ou annoncée à cette installation. Si vous n'annoncez pas ou ne liez pas d'adresse IP Global Anycast dans une installation, nous acheminerons ce trafic vers l'installation la plus proche où l'adresse IP est attribuée ou annoncée. Cela entraîne des frais, d'où la facturation des transferts entrants.

CLI

Pour vérifier les sous-réseaux et adresses IP disponibles dans votre bloc d'adresses IP Anycast global, utilisez la commande metal ip available. L'identifiant --reservation-id peut être obtenu à partir de la commande metal ip get -p <project-uuid>.

metal ip available --reservation-id <reservation_UUID> --cidr <size_of_subnet>

API

Vous pouvez vérifier l'état des sous-réseaux et des adresses IP dans chacun des sous-réseaux Anycast de gestion, réservés et globaux de votre projet en envoyant une requête GET au point de terminaison /ips/{id}. L'UUID de réservation du sous-réseau ou de l'adresse IP doit être indiqué dans le chemin.

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/ips/{id}"

La réponse inclut l'identifiant de réservation du bloc d'adresses IP dans l'objet "assignments". (La réponse d'exemple est tronquée.)

{
"ip_addresses": [
    {
    "id": "804c4112-c00a-486c-9c54-0918dd1894b2",
    "address_family": 4,
    "netmask": "255.255.255.254",
    "global_ip": true,
        "assignments": [
        {
            "href": "/metal/v1/ips/4cc7f67b-522e-4b6c-82a5-3b2505cf326a"
        }
        ],
    ....
    "type": "global_ipv4"
    },
    ....
]
}

Suppression d'une réservation IP Anycast globale

La suppression d'une réservation supprime le sous-réseau de votre projet. Vous ne pourrez plus utiliser les adresses IP de vos serveurs.

Console

Pour supprimer une réservation, allez à la page IP de votre projet et sélectionnez le bloc d'adresses IP Anycast global. Cliquez sur Supprimer.

CLI

Pour supprimer une réservation IP Anycast globale, utilisez la commande metal ip remove.

metal ip remove --id <reservation-id>

API

Pour supprimer une réservation d'adresse IP via l'API, envoyez une requête DELETE au point de terminaison /ips/{id}. id correspond à l'UUID de la réservation.

curl -X DELETE \
-H "Content-Type: application/json" \
-H "X-Auth-Token: <API_TOKEN>" \
"https://api.equinix.com/metal/v1/ips/{id}"