update doc

Author: Codelax

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

@@ -1,16 +1,16 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Perform an action on a server
+Perform a raw API action on a server
 
 USAGE:
   scw instance server action <server-id ...> [arg=value ...]
 
 EXAMPLES:
   Start a server in the default zone with a given id
-    scw instance server action 11111111-1111-1111-1111-111111111111 action=start
+    scw instance server action 11111111-1111-1111-1111-111111111111 action=poweron
 
 ARGS:
-  action            The action to perform
+  action            The raw API action to perform, as listed with 'scw instance server list-actions'
   server-id         ID of the server affected by the action.
   [zone=fr-par-1]   Zone to target. If none is passed will use default zone from the config
 

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

@@ -8,7 +8,7 @@ USAGE:
   scw instance server <command>
 
 AVAILABLE COMMANDS:
-  action           Perform an action on a server
+  action           Perform a raw API action on a server
   attach-ip        Attach an IP to a server
   attach-volume    Attach a volume to a server
   backup           Backup server

docs/commands/instance.md

@@ -48,7 +48,7 @@ Instance API.
   - [Update all the rules of a security group](#update-all-the-rules-of-a-security-group)
   - [Update security group](#update-security-group)
 - [Instance management commands](#instance-management-commands)
-  - [Perform an action on a server](#perform-an-action-on-a-server)
+  - [Perform a raw API action on a server](#perform-a-raw-api-action-on-a-server)
   - [Attach an IP to a server](#attach-an-ip-to-a-server)
   - [Attach a volume to a server](#attach-a-volume-to-a-server)
   - [Backup server](#backup-server)
@@ -1562,7 +1562,7 @@ Scaleway offers various Instance types including **Virtual Instances** and **ded
 
 
 
-### Perform an action on a server
+### Perform a raw API action on a server
 
 
 
@@ -1577,7 +1577,7 @@ scw instance server action <server-id ...> [arg=value ...]
 
 | Name |   | Description |
 |------|---|-------------|
-| action | Required | The action to perform |
+| action | Required | The raw API action to perform, as listed with 'scw instance server list-actions' |
 | server-id | Required | ID of the server affected by the action. |
 | zone | Default: `fr-par-1` | Zone to target. If none is passed will use default zone from the config |
 
@@ -1587,7 +1587,7 @@ scw instance server action <server-id ...> [arg=value ...]
 
 Start a server in the default zone with a given id
 ```
-scw instance server action 11111111-1111-1111-1111-111111111111 action=start
+scw instance server action 11111111-1111-1111-1111-111111111111 action=poweron
 ```
 
 

internal/namespaces/instance/v1/custom_server_action.go

@@ -482,12 +482,12 @@ func serverActionCommand() *core.Command {
 	argSpecs := serverActionArgSpecs
 	argSpecs.AddBefore("server-id", &core.ArgSpec{
 		Name:     "action",
-		Short:    "The action to perform",
+		Short:    "The raw API action to perform, as listed with 'scw instance server list-actions'",
 		Required: true,
 	})
 
 	return &core.Command{
-		Short:     `Perform an action on a server`,
+		Short:     `Perform a raw API action on a server`,
 		Namespace: "instance",
 		Resource:  "server",
 		Verb:      "action",
@@ -512,7 +512,7 @@ func serverActionCommand() *core.Command {
 		Examples: []*core.Example{
 			{
 				Short:    "Start a server in the default zone with a given id",
-				ArgsJSON: `{"action":"start", "server_id": "11111111-1111-1111-1111-111111111111"}`,
+				ArgsJSON: `{"action":"poweron", "server_id": "11111111-1111-1111-1111-111111111111"}`,
 			},
 		},
 		SeeAlsos: []*core.SeeAlso{