fix(doc): add example in vpc_route and add information about mapping_id in baremetal

Author: Laure-di

docs/resources/baremetal_server.md

@@ -316,6 +316,7 @@ In addition to all arguments above, the following attributes are exported:
 - `os_name` - The name of the os.
 - `private_network` - The private networks attached to the server.
     - `id` - The ID of the private network.
+    - `mapping_id` - The ID of the Server-to-Private Network mapping.
     - `vlan` - The VLAN ID associated to the private network.
     - `status` - The private network status.
     - `created_at` - The date and time of the creation of the private network.

docs/resources/vpc_route.md

@@ -10,7 +10,7 @@ For more information, see [the main documentation](https://www.scaleway.com/en/d
 
 ## Example Usage
 
-### Basic
+### With Instance
 
 ```terraform
 resource "scaleway_vpc" "vpc01" {
@@ -45,6 +45,64 @@ resource "scaleway_vpc_route" "rt01" {
 }
 ```
 
+### With Baremetal
+
+```terraform
+resource "scaleway_vpc" "vpc01" {
+  name = "tf-vpc-vpn"
+}
+
+resource "scaleway_vpc_private_network" "pn01" {
+  name = "tf-pn-vpn"
+  ipv4_subnet {
+    subnet = "172.16.64.0/22"
+  }
+  vpc_id = scaleway_vpc.vpc01.id
+}
+
+data "scaleway_baremetal_os" "my_os" {
+  zone    = "fr-par-2"
+  name    = "Ubuntu"
+  version = "22.04 LTS (Jammy Jellyfish)"
+}
+
+data "scaleway_baremetal_offer" "my_offer" {
+  zone = "fr-par-2"
+  name = "EM-B112X-SSD"
+}
+
+data "scaleway_baremetal_option" "private_network" {
+  zone = "fr-par-2"
+  name = "Private Network"
+}
+
+data "scaleway_iam_ssh_key" "my_key" {
+  name = "main"
+}
+
+resource "scaleway_baremetal_server" "my_server" {
+  zone        = "fr-par-2"
+  offer       = data.scaleway_baremetal_offer.my_offer.offer_id
+  os          = data.scaleway_baremetal_os.my_os.os_id
+  ssh_key_ids = [data.scaleway_iam_ssh_key.my_key.id]
+
+  options {
+    id = data.scaleway_baremetal_option.private_network.option_id
+  }
+  private_network {
+    id = scaleway_vpc_private_network.pn01.id
+  }
+}
+
+resource "scaleway_vpc_route" "rt01" {
+  vpc_id              = scaleway_vpc.vpc01.id
+  description         = "tf-route-vpn"
+  tags                = ["tf", "route"]
+  destination         = "10.0.0.0/24"
+  nexthop_resource_id = scaleway_baremetal_server.my_server.private_network.0.mapping_id
+}
+```
+
 ## Argument Reference
 
 The following arguments are supported: