Adresses IP Anycast globales

Les IP Global Anycast d'Equinix Metal™ sont des adresses IPv4 publiques tirées de l'espace IP appartenant à Equinix Metal et qui peuvent être annoncées à partir de n'importe quel ou de tous les Metros d'Equinix Metal.

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

• en les attribuant en tant qu'adresse IP élastique à un seul serveur dans plusieurs Metros.
• OU en les annonçant via Local BGP à partir de plusieurs serveurs dans plusieurs métropoles.

Si une adresse IP Global Anycast n'est pas acheminée ou annoncée par un serveur dans un métro, 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 Global Anycast sont facturées sur la base de l'utilisation à un taux fixe par IP et par heure. La bande passante est facturée au tarif sortant standard et au tarif entrant par gigaoctet. Les tarifs sont disponibles dans la console Metal d'Equinix.

Demande d'adresses IP Anycast globales

Console

Dans la section Networking de votre projet, ouvrez la page IPs.

Les adresses IP actuelles de votre projet doivent être listées. Pour demander des adresses IP Anycast globales, cliquez sur + Ajouter un nouveau.

Dans le menu déroulant Request IP Addresses, choisissez Global IPv4 et la Quantity (taille) du sous-réseau réservé. Il y a également des champs pour les Tags et une Description pour votre usage. Le champ Custom JSON 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 support avec toute information pertinente pour votre demande. Si vous prévoyez de demander plusieurs sous-réseaux ou plusieurs grands sous-réseaux, sachez que des quotas sont en place au niveau du projet. Le service d'assistance peut vous contacter pour vous poser des questions sur 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 du corps

• "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 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 IPs de gestion, réservés et d'Anycast global.

CLI

Dans la CLI, tous les sous-réseaux de gestion, réservés et d'Anycast global ainsi que les informations sur les adresses IP d'un projet sont disponibles à partir de la commande metal ip get.

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

API

Pour obtenir la liste des sous-réseaux et IP de gestion, réservés et d'Anycast global de votre projet, envoyez une requête GET au point d'extrémité /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 son adresse IP

Une fois que votre bloc d'adresses IPv4 Global Anycast vous a été attribué, vous avez deux options : attribuer vos nouvelles adresses IP à un serveur en tant qu'IP élastiques, ou en les annonçant avec BGP.

Si vous choisissez de lier les adresses IP Global Anycast en tant qu'adresse IP élastique, vous pouvez attribuer des adresses individuelles à un seul serveur dans chaque Metro. Cependant, si vous tentez d'attribuer la même adresse IP à plus d'un serveur dans le même Metro, vous obtiendrez une erreur.

Si vous choisissez d'annoncer vos IP Anycast globales avec BGP, vous devrez mettre en place et configurer BGP local. Vous pouvez utiliser BGP pour attribuer votre adresse IP Anycast globale à plusieurs serveurs dans chaque Metro, c'est pourquoi nous recommandons l'utilisation de BGP pour les applications à haute disponibilité.

État de l'IP Anycast global

Console

Pour voir l'état de votre bloc IP Global Anycast, naviguez sur la page IPs de votre projet et ouvrez le menu Actions de la réservation IP que vous souhaitez gérer. Cliquez sur Update Block.

Un cercle gris indique qu'une IP du bloc n'est pas attribuée dans l'établissement ou annoncée via BGP. Un cercle vert indique qu'une IP du bloc est assignée ou annoncée dans cette installation. Si vous n'annoncez pas ou ne liez pas une IP Global Anycast dans une installation, nous acheminerons ce trafic vers l'installation la plus proche où l'IP est assignée ou annoncée. Cette opération est coûteuse, c'est pourquoi le transfert entrant est payant.

CLI

Pour vérifier les sous-réseaux et les adresses IP disponibles dans votre bloc IP Anycast global, utilisez la commande metal ip available. Le --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 de gestion, réservés et Anycast global 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 est indiqué dans le chemin d'accès.

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 comprend l'ID de réservation du bloc d'adresses IP dans l'objet "assignments". (L'exemple de réponse est tronqué.)

{
"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 pour vos serveurs.

Console

Pour supprimer une réservation, accédez à la page IPs de votre projet et sélectionnez le bloc Global Anycast IP. Cliquez sur Delete.

CLI

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

metal ip remove --id <reservation-id>

API

Pour supprimer une réservation d'IP via l'API, envoyez une requête DELETE au point de terminaison /ips/{id}. Le id est 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}"