Créer une route

Vous pouvez créer une route dans une route table pour spécifier comment le trafic est routé pour les machines virtuelles (VM) dans les Subnets auxquels elle est associée.

Vous pouvez créer des routes avec les targets suivantes :

  • Un internet service, pour permettre aux VM avec une IP publique associée d’être directement connectées à Internet

  • Une virtual gateway, pour router le trafic vers une connexion DirectLink ou VPN

  • Un NAT service, pour permettre aux VM d’être indirectement connectées à Internet

  • Une VM

  • Une interface réseau d’une VM

  • Un Net peering, pour permettre aux VM d’envoyer du trafic vers un Net pair

Lorsque vous créez un Net access point, la route appropriée est automatiquement créée et ajoutée aux route tables que vous spécifiez. Pour en savoir plus, voir À propos des route tables et À propos des Net access points.

Créer une route avec Cockpit v2

Avant de commencer : Créez une route table. Pour en savoir plus, voir Créer une route table.

  1. Dans le dashboard Route Tables, cliquez sur l’icône de détails IconView de la route table dans laquelle vous souhaitez créer une route.
    Le volet de détails de la route table apparaît.

  2. Cliquez sur IconAddFull Créer une route.
    La boîte de dialogue CRÉER UNE ROUTE apparaît.

  3. Dans la liste Cible, sélectionnez l’ID de la ressource à utiliser comme target.
    Pour en savoir plus, voir À propos des route tables > Routes et options de routage.

  4. Dans le champ Destination, tapez la plage d’IP de destination des flux, en notation CIDR.

    Pour spécifier le CIDR 0.0.0.0/0, cliquez sur Toutes les IP.

  5. Cliquez sur Créer.
    La route est créée.

Créer une route avec OSC CLI

Avant de commencer : Créez une route table. Pour en savoir plus, voir Créer une route table.

À ce jour, cette section est disponible en anglais uniquement.

The CreateRoute command creates a route in a specified route table within a specified Net.
You must specify one of the following elements as the target:

  • Net peering

  • NAT VM

  • Internet service

  • Virtual gateway

  • NAT service

  • Network interface card (NIC)

The routing algorithm is based on the most specific match.

For more information, see About Route Tables.

Request sample: Creating a route to an Internet service
$ osc-cli api CreateRoute --profile "default" \
    --RouteTableId "rtb-12345678" \
    --DestinationIpRange "0.0.0.0/0" \
    --GatewayId "igw-12345678"

This command contains the following attributes that you need to specify:

  • DestinationIpRange: The IP range used for the destination match, in CIDR notation (for example, 10.0.0.0/24).

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • GatewayId: (optional) The ID of an internet service or virtual gateway attached to your Net.

  • NatServiceId: (optional) The ID of a NAT service.

  • NetPeeringId: (optional) The ID of a Net peering.

  • NicId: (optional) The ID of a NIC.

  • RouteTableId: The ID of the route table for which you want to create a route.

  • VmId: (optional) The ID of a NAT VM in your Net (attached to exactly one NIC).

The CreateRoute command returns the following elements:

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

  • RouteTable: Information about the route table.

    • LinkRouteTables: One or more associations between the route table and Subnets.

      • LinkRouteTableId: The ID of the association between the route table and the Net or Subnet.

      • Main: If true, the route table is the main one.

      • NetId: The ID of the Net, if the route table is not explicitly linked to a Subnet.

      • RouteTableId: The ID of the route table.

      • SubnetId: The ID of the Subnet, if the route table is explicitly linked to a Subnet.

    • NetId: The ID of the Net for the route table.

    • RoutePropagatingVirtualGateways: Information about virtual gateways propagating routes.

      • VirtualGatewayId: The ID of the virtual gateway.

    • RouteTableId: The ID of the route table.

    • Routes: One or more routes in the route table.

      • CreationMethod: The method used to create the route.

      • DestinationIpRange: The IP range used for the destination match, in CIDR notation (for example, 10.0.0.0/24).

      • DestinationServiceId: The ID of the OUTSCALE service.

      • GatewayId: The ID of the internet service or virtual gateway attached to the Net.

      • NatServiceId: The ID of a NAT service attached to the Net.

      • NetAccessPointId: The ID of the Net access point.

      • NetPeeringId: The ID of the Net peering.

      • NicId: The ID of the NIC.

      • State: The state of a route in the route table (always active).

      • VmAccountId: The account ID of the owner of the VM.

      • VmId: The ID of a VM specified in a route in the table.

    • Tags: One or more tags associated with the route table.

      • Key: The key of the tag, with a minimum of 1 character.

      • Value: The value of the tag, between 0 and 255 characters.

Result sample: Creating a route to an Internet service
{
  "RouteTable": {
    "Routes": [
      {
        "DestinationIpRange": "10.0.0.0/16",
        "CreationMethod": "CreateRouteTable",
        "State": "active"
      },
      {
        "GatewayId": "igw-12345678",
        "DestinationIpRange": "0.0.0.0/0",
        "CreationMethod": "CreateRoute",
        "State": "active"
      }
    ],
    "LinkRouteTables": [],
    "NetId": "vpc-12345678",
    "Tags": [],
    "RoutePropagatingVirtualGateways": [],
    "RouteTableId": "rtb-12345678"
  },
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  }
}

Créer une route avec oapi-cli

Avant de commencer : Créez une route table. Pour en savoir plus, voir Créer une route table.

À ce jour, cette section est disponible en anglais uniquement.

The CreateRoute command creates a route in a specified route table within a specified Net.
You must specify one of the following elements as the target:

  • Net peering

  • NAT VM

  • Internet service

  • Virtual gateway

  • NAT service

  • Network interface card (NIC)

The routing algorithm is based on the most specific match.

For more information, see About Route Tables.

Request sample: Creating a route to an Internet service
$ oapi-cli --profile "default" CreateRoute \
    --RouteTableId "rtb-12345678" \
    --DestinationIpRange "0.0.0.0/0" \
    --GatewayId "igw-12345678"

This command contains the following attributes that you need to specify:

  • DestinationIpRange: The IP range used for the destination match, in CIDR notation (for example, 10.0.0.0/24).

  • DryRun: (optional) If true, checks whether you have the required permissions to perform the action.

  • GatewayId: (optional) The ID of an internet service or virtual gateway attached to your Net.

  • NatServiceId: (optional) The ID of a NAT service.

  • NetPeeringId: (optional) The ID of a Net peering.

  • NicId: (optional) The ID of a NIC.

  • RouteTableId: The ID of the route table for which you want to create a route.

  • VmId: (optional) The ID of a NAT VM in your Net (attached to exactly one NIC).

The CreateRoute command returns the following elements:

  • ResponseContext: Information about the context of the response.

    • RequestId: The ID of the request.

  • RouteTable: Information about the route table.

    • LinkRouteTables: One or more associations between the route table and Subnets.

      • LinkRouteTableId: The ID of the association between the route table and the Net or Subnet.

      • Main: If true, the route table is the main one.

      • NetId: The ID of the Net, if the route table is not explicitly linked to a Subnet.

      • RouteTableId: The ID of the route table.

      • SubnetId: The ID of the Subnet, if the route table is explicitly linked to a Subnet.

    • NetId: The ID of the Net for the route table.

    • RoutePropagatingVirtualGateways: Information about virtual gateways propagating routes.

      • VirtualGatewayId: The ID of the virtual gateway.

    • RouteTableId: The ID of the route table.

    • Routes: One or more routes in the route table.

      • CreationMethod: The method used to create the route.

      • DestinationIpRange: The IP range used for the destination match, in CIDR notation (for example, 10.0.0.0/24).

      • DestinationServiceId: The ID of the OUTSCALE service.

      • GatewayId: The ID of the internet service or virtual gateway attached to the Net.

      • NatServiceId: The ID of a NAT service attached to the Net.

      • NetAccessPointId: The ID of the Net access point.

      • NetPeeringId: The ID of the Net peering.

      • NicId: The ID of the NIC.

      • State: The state of a route in the route table (always active).

      • VmAccountId: The account ID of the owner of the VM.

      • VmId: The ID of a VM specified in a route in the table.

    • Tags: One or more tags associated with the route table.

      • Key: The key of the tag, with a minimum of 1 character.

      • Value: The value of the tag, between 0 and 255 characters.

Result sample: Creating a route to an Internet service
{
  "RouteTable": {
    "Routes": [
      {
        "DestinationIpRange": "10.0.0.0/16",
        "CreationMethod": "CreateRouteTable",
        "State": "active"
      },
      {
        "GatewayId": "igw-12345678",
        "DestinationIpRange": "0.0.0.0/0",
        "CreationMethod": "CreateRoute",
        "State": "active"
      }
    ],
    "LinkRouteTables": [],
    "NetId": "vpc-12345678",
    "Tags": [],
    "RoutePropagatingVirtualGateways": [],
    "RouteTableId": "rtb-12345678"
  },
  "ResponseContext": {
    "RequestId": "0475ca1e-d0c5-441d-712a-da55a4175157"
  }
}

Créer une route avec AWS CLI

Avant de commencer :

Pour créer une route dans une route table, utilisez la commande create-route en suivant cette syntaxe :

Exemple de requête
$ aws ec2 create-route \
    --profile YOUR_PROFILE \
    --route-table-id rtb-87654321 \
    --destination-cidr-block 0.0.0.0/0 \
    --gateway-id igw-1234abcd \
    --instance-id NOT_SPECIFIED \
    --network-interface-id NOT_SPECIFIED \
    --vpc-peering-connection-id NOT_SPECIFIED \
    --nat-gateway-id NOT_SPECIFIED \
    --endpoint https://fcu.eu-west-2.outscale.com

Cette commande contient les attributs suivants que vous devez spécifier :

  • (optionnel) profile : Le profil nommé que vous voulez utiliser, créé pendant la configuration d’AWS CLI. Pour en savoir plus, voir Installer et configurer AWS CLI.

  • route-table-id : L’ID de la route table dans laquelle vous souhaitez créer une route.

  • destination-cidr-block : La plage d’IP de destination, en notation CIDR.

  • (optionnel) gateway-id : L’ID de l’internet gateway ou de la virtual private gateway attachée au VPC à utiliser comme target pour la route.

  • (optionnel) instance-id : L’ID d’une instance dans le VPC à utiliser comme target pour la route.

    L’instance doit avoir une seule interface réseau attachée (la principale, et aucune flexible network interface). Si l’instance a plusieurs interfaces réseau attachées, utilisez l’attribut network-interface-id afin de spécifier laquelle vous souhaitez utiliser comme target pour la route.

  • (optionnel) network-interface-id : L’ID d’une interface réseau à utiliser comme target pour la route (l’interface réseau principale ou une flexible network interface).

  • (optionnel) vpc-peering-connection-id : L’ID d’une VPC peering connection à utiliser comme target de la route.

  • (optionnel) nat-gateway-id : L’ID d’une NAT gateway à utiliser comme target de la route.

  • endpoint : Le endpoint correspondant à la Région à laquelle vous voulez envoyer la requête. Pour en savoir plus, voir Installer et configurer AWS CLI.

La commande create-route renvoie true si la requête a réussi et que la route est créée. Sinon, une erreur est renvoyée.

Pages connexes

Méthodes API correspondantes

AWS™ et Amazon Web Services™ sont des marques de commerce d'Amazon Technologies, Inc. ou de ses affiliées aux États-Unis et/ou dans les autres pays.

Exporter en PDF