doc(instance): document volume resize options (#3452)

Author: Mia-Cross

docs/resources/instance_server.md

@@ -245,7 +245,8 @@ To retrieve more information by label please use: ```scw marketplace image get l
     - `delete_on_termination` - (Defaults to `true`) Forces deletion of the root volume on instance termination.
     - `sbs_iops` - (Optional) Choose IOPS of your sbs volume, has to be used with `sbs_volume` for root volume type.
 
-~> **Important:** Updates to `root_volume.size_in_gb` will be ignored after the creation of the server.
+~> **Important:** It is not possible to change `root_volume.size_in_gb` for local volumes (`l_ssd`). Changes to this field will recreate the server.
+It is possible to increase `root_volume.size_in_gb` for SBS volumes, but they cannot be resized down without recreating the server.
 
 - `additional_volume_ids` - (Optional) The [additional volumes](https://www.scaleway.com/en/developers/api/instance/#path-volume-types-list-volume-types)
 attached to the server. Updates to this field will trigger a stop/start of the server.

docs/resources/instance_volume.md

@@ -24,6 +24,9 @@ The following arguments are supported:
 
 - `type` - (Required) The type of the volume. The possible values are: `l_ssd` (Local SSD), `scratch` (Local Scratch SSD).
 - `size_in_gb` - (Optional) The size of the volume. Only one of `size_in_gb` and `from_snapshot_id` should be specified.
+
+~> **Important:** It is not possible to resize local and scratch volumes. Updates to this field will recreate the resource.
+
 - `from_snapshot_id` - (Optional) If set, the new volume will be created from this snapshot. Only one of `size_in_gb` and `from_snapshot_id` should be specified.
 - `name` - (Optional) The name of the volume. If not provided it will be randomly generated.
 - `zone` - (Defaults to [provider](../index.md#zone) `zone`) The [zone](../guides/regions_and_zones.md#zones) in which the volume should be created.

templates/resources/instance_server.md.tmpl

@@ -246,7 +246,8 @@ To retrieve more information by label please use: ```scw marketplace image get l
     - `delete_on_termination` - (Defaults to `true`) Forces deletion of the root volume on instance termination.
     - `sbs_iops` - (Optional) Choose IOPS of your sbs volume, has to be used with `sbs_volume` for root volume type.
 
-~> **Important:** Updates to `root_volume.size_in_gb` will be ignored after the creation of the server.
+~> **Important:** It is not possible to change `root_volume.size_in_gb` for local volumes (`l_ssd`). Changes to this field will recreate the server.
+It is possible to increase `root_volume.size_in_gb` for SBS volumes, but they cannot be resized down without recreating the server.
 
 - `additional_volume_ids` - (Optional) The [additional volumes](https://www.scaleway.com/en/developers/api/instance/#path-volume-types-list-volume-types)
 attached to the server. Updates to this field will trigger a stop/start of the server.

templates/resources/instance_volume.md.tmpl

@@ -25,6 +25,9 @@ The following arguments are supported:
 
 - `type` - (Required) The type of the volume. The possible values are: `l_ssd` (Local SSD), `scratch` (Local Scratch SSD).
 - `size_in_gb` - (Optional) The size of the volume. Only one of `size_in_gb` and `from_snapshot_id` should be specified.
+
+~> **Important:** It is not possible to resize local and scratch volumes. Updates to this field will recreate the resource.
+
 - `from_snapshot_id` - (Optional) If set, the new volume will be created from this snapshot. Only one of `size_in_gb` and `from_snapshot_id` should be specified.
 - `name` - (Optional) The name of the volume. If not provided it will be randomly generated.
 - `zone` - (Defaults to [provider](../index.md#zone) `zone`) The [zone](../guides/regions_and_zones.md#zones) in which the volume should be created.