docs(instance): clarify how to update server volumes (#5360)

Co-authored-by: Rémy Léone <rleone@scaleway.com>

Author: bkgood

cmd/scw/testdata/test-all-usage-instance-server-update-usage.golden

@@ -21,6 +21,9 @@ EXAMPLES:
   Put a specified Instance in the specified placement group. Instance must be off
     scw instance server server update 11111111-1111-1111-1111-111111111111 placement-group-id=11111111-1111-1111-1111-111111111111
 
+  Boot an Instance from a specific volume
+    scw instance server update 11111111-1111-1111-1111-111111111111 volumes.0.id=11111111-1111-1111-1111-111111111111 volumes.0.boot=true
+
 ARGS:
   server-id                                UUID of the Instance
   [name]                                   Name of the Instance

docs/commands/instance.md

@@ -2366,6 +2366,11 @@ Put a specified Instance in the specified placement group. Instance must be off
 scw instance server server update 11111111-1111-1111-1111-111111111111 placement-group-id=11111111-1111-1111-1111-111111111111
 ```
 
+Boot an Instance from a specific volume
+```
+scw instance server update 11111111-1111-1111-1111-111111111111 volumes.0.id=11111111-1111-1111-1111-111111111111 volumes.0.boot=true
+```
+
 
 
 

internal/namespaces/instance/v1/custom_server.go

@@ -379,6 +379,12 @@ func serverUpdateBuilder(c *core.Command) *core.Command {
 		},
 	}
 
+	// clarify how to address attached volumes, specific to the cli.
+	c.Examples = append(c.Examples, &core.Example{
+		Short: "Boot an Instance from a specific volume",
+		Raw:   `scw instance server update 11111111-1111-1111-1111-111111111111 volumes.0.id=11111111-1111-1111-1111-111111111111 volumes.0.boot=true`,
+	})
+
 	return c
 }