doc: add deprecation notice on generated commands

cmd/scw/testdata/test-all-usage-instance-image-create-usage.golden

@@ -10,20 +10,22 @@ EXAMPLES:
     scw instance image create name=foobar root-volume=11111111-1111-1111-1111-111111111111 arch=x86_64
 
 ARGS:
-  [name=<generated>]                             Name of the image
-  snapshot-id                                    UUID of the snapshot that will be used as root volume in the image
-  arch                                           Architecture of the image (x86_64 | arm)
-  [default-bootscript]                           Default bootscript of the image
-  [additional-snapshots.{key}.id]                UUID of the snapshot to add
-  [additional-snapshots.{key}.name]              Name of the additional snapshot
-  [additional-snapshots.{key}.size]              Size of the additional snapshot
-  [additional-snapshots.{key}.volume-type]       Underlying volume type of the additional snapshot (l_ssd | b_ssd)
-  [additional-snapshots.{key}.project-id]        Project ID that own the additional snapshot
+  [name=<generated>]                         Name of the image
+  snapshot-id                                UUID of the snapshot that will be used as root volume in the image
+  arch                                       Architecture of the image (x86_64 | arm)
+  [default-bootscript]                       Default bootscript of the image
+  [additional-snapshots.{key}.id]            UUID of the snapshot to add
+  [additional-snapshots.{key}.name]          Name of the additional snapshot
+  [additional-snapshots.{key}.size]          Size of the additional snapshot
+  [additional-snapshots.{key}.volume-type]   Underlying volume type of the additional snapshot (l_ssd | b_ssd)
+  [additional-snapshots.{key}.project-id]    Project ID that own the additional snapshot
+  [project-id]                               Project ID to use. If none is passed the default project ID will be used
+  [public]                                   True to create a public image
+  [organization-id]                          Organization ID to use. If none is passed the default organization ID will be used
+  [zone=fr-par-1]                            Zone to target. If none is passed will use default zone from the config (fr-par-1 | nl-ams-1)
+
+DEPRECATED ARGS:
   [additional-snapshots.{key}.organization-id]   Organization ID that own the additional snapshot
-  [project-id]                                   Project ID to use. If none is passed the default project ID will be used
-  [public]                                       True to create a public image
-  [organization-id]                              Organization ID to use. If none is passed the default organization ID will be used
-  [zone=fr-par-1]                                Zone to target. If none is passed will use default zone from the config (fr-par-1 | nl-ams-1)
 
 FLAGS:
   -h, --help   help for create

cmd/scw/testdata/test-all-usage-instance-security-group-create-usage.golden

@@ -25,14 +25,16 @@ ARGS:
   name=<generated>                   Name of the security group
   [description]                      Description of the security group
   [project-id]                       Project ID to use. If none is passed the default project ID will be used
-  [organization-default=false]       Whether this security group becomes the default security group for new instances
   [project-default=false]            Whether this security group becomes the default security group for new instances
   [stateful=true]                    Whether the security group is stateful or not
   [inbound-default-policy=accept]    Default policy for inbound rules (accept | drop)
   [outbound-default-policy=accept]   Default policy for outbound rules (accept | drop)
   [organization-id]                  Organization ID to use. If none is passed the default organization ID will be used
   [zone=fr-par-1]                    Zone to target. If none is passed will use default zone from the config (fr-par-1 | nl-ams-1)
 
+DEPRECATED ARGS:
+  [organization-default=false]   Whether this security group becomes the default security group for new instances
+
 FLAGS:
   -h, --help   help for create
 

cmd/scw/testdata/test-all-usage-iot-device-list-usage.golden

@@ -9,12 +9,14 @@ ARGS:
   [order-by]          Ordering of requested devices (name_asc | name_desc | status_asc | status_desc | hub_id_asc | hub_id_desc | created_at_asc | created_at_desc | updated_at_asc | updated_at_desc | allow_insecure_asc | allow_insecure_desc)
   [name]              Filter on the name
   [hub-id]            Filter on the hub
-  [enabled]           Deprecated, ignored filter
   [allow-insecure]    Filter on the allow_insecure flag
-  [is-connected]      Deprecated, ignored filter
   [organization-id]   Filter on the organization
   [region=fr-par]     Region to target. If none is passed will use default region from the config (fr-par)
 
+DEPRECATED ARGS:
+  [enabled]        Deprecated, ignored filter
+  [is-connected]   Deprecated, ignored filter
+
 FLAGS:
   -h, --help   help for list
 

cmd/scw/testdata/test-all-usage-lb-backend-create-usage.golden

@@ -26,14 +26,16 @@ ARGS:
   [health-check.check-delay]           
   lb-id                                Load balancer ID
   server-ip.{index}                    Backend server IP addresses list (IPv4 or IPv6)
-  [send-proxy-v2]                      Deprecated in favor of proxy_protocol field !
   [timeout-server]                     Maximum server connection inactivity time
   [timeout-connect]                    Maximum initical server connection establishment time
   [timeout-tunnel]                     Maximum tunnel inactivity time
   [on-marked-down-action]              Modify what occurs when a backend server is marked down (on_marked_down_action_none | shutdown_sessions)
   [proxy-protocol]                     PROXY protocol, forward client's address (must be supported by backend servers software) (proxy_protocol_unknown | proxy_protocol_none | proxy_protocol_v1 | proxy_protocol_v2 | proxy_protocol_v2_ssl | proxy_protocol_v2_ssl_cn)
   [region=fr-par]                      Region to target. If none is passed will use default region from the config (fr-par | nl-ams)
 
+DEPRECATED ARGS:
+  [send-proxy-v2]   Deprecated in favor of proxy_protocol field !
+
 FLAGS:
   -h, --help   help for create
 

cmd/scw/testdata/test-all-usage-lb-backend-update-usage.golden

@@ -13,14 +13,16 @@ ARGS:
   [forward-port-algorithm]         (roundrobin | leastconn)
   [sticky-sessions]                (none | cookie | table)
   [sticky-sessions-cookie-name]   
-  [send-proxy-v2]                 
   [timeout-server]                
   [timeout-connect]               
   [timeout-tunnel]                
   [on-marked-down-action]          (on_marked_down_action_none | shutdown_sessions)
   [proxy-protocol]                 (proxy_protocol_unknown | proxy_protocol_none | proxy_protocol_v1 | proxy_protocol_v2 | proxy_protocol_v2_ssl | proxy_protocol_v2_ssl_cn)
   [region=fr-par]                 Region to target. If none is passed will use default region from the config (fr-par | nl-ams)
 
+DEPRECATED ARGS:
+  [send-proxy-v2]   
+
 FLAGS:
   -h, --help   help for update
 

cmd/scw/testdata/test-all-usage-lb-frontend-create-usage.golden

@@ -11,10 +11,12 @@ ARGS:
   lb-id                       Load balancer ID
   backend-id                  Backend ID
   [timeout-client]            Set the maximum inactivity time on the client side
-  [certificate-id]            Certificate ID, deprecated in favor of certificate_ids array !
   [certificate-ids.{index}]   List of certificate IDs to bind on the frontend
   [region=fr-par]             Region to target. If none is passed will use default region from the config (fr-par | nl-ams)
 
+DEPRECATED ARGS:
+  [certificate-id]   Certificate ID, deprecated in favor of certificate_ids array !
+
 FLAGS:
   -h, --help   help for create
 

cmd/scw/testdata/test-all-usage-lb-frontend-update-usage.golden

@@ -11,10 +11,12 @@ ARGS:
   inbound-port                TCP port to listen on the front side
   backend-id                  Backend ID
   [timeout-client]            Client session maximum inactivity time
-  [certificate-id]            Certificate ID, deprecated in favor of `certificate_ids` array!
   [certificate-ids.{index}]   List of certificate IDs to bind on the frontend
   [region=fr-par]             Region to target. If none is passed will use default region from the config (fr-par | nl-ams)
 
+DEPRECATED ARGS:
+  [certificate-id]   Certificate ID, deprecated in favor of `certificate_ids` array!
+
 FLAGS:
   -h, --help   help for update
 

internal/namespaces/account/v2alpha1/account_cli.go

@@ -52,27 +52,32 @@ func accountSSHKeyList() *core.Command {
 		Namespace: "account",
 		Resource:  "ssh-key",
 		Verb:      "list",
-		ArgsType:  reflect.TypeOf(account.ListSSHKeysRequest{}),
+		// Deprecated:    false,
+		ArgsType: reflect.TypeOf(account.ListSSHKeysRequest{}),
 		ArgSpecs: core.ArgSpecs{
 			{
 				Name:       "order-by",
 				Required:   false,
+				Deprecated: false,
 				Positional: false,
 				EnumValues: []string{"created_at_asc", "created_at_desc", "updated_at_asc", "updated_at_desc", "name_asc", "name_desc"},
 			},
 			{
 				Name:       "name",
 				Required:   false,
+				Deprecated: false,
 				Positional: false,
 			},
 			{
 				Name:       "project-id",
 				Required:   false,
+				Deprecated: false,
 				Positional: false,
 			},
 			{
 				Name:       "organization-id",
 				Required:   false,
+				Deprecated: false,
 				Positional: false,
 			},
 		},
@@ -127,18 +132,21 @@ func accountSSHKeyAdd() *core.Command {
 		Namespace: "account",
 		Resource:  "ssh-key",
 		Verb:      "add",
-		ArgsType:  reflect.TypeOf(account.CreateSSHKeyRequest{}),
+		// Deprecated:    false,
+		ArgsType: reflect.TypeOf(account.CreateSSHKeyRequest{}),
 		ArgSpecs: core.ArgSpecs{
 			{
 				Name:       "name",
 				Short:      `The name of the SSH key`,
 				Required:   false,
+				Deprecated: false,
 				Positional: false,
 			},
 			{
 				Name:       "public-key",
 				Short:      `SSH public key. Currently ssh-rsa, ssh-dss (DSA), ssh-ed25519 and ecdsa keys with NIST curves are supported`,
 				Required:   true,
+				Deprecated: false,
 				Positional: false,
 			},
 			core.ProjectIDArgSpec(),
@@ -178,12 +186,14 @@ func accountSSHKeyGet() *core.Command {
 		Namespace: "account",
 		Resource:  "ssh-key",
 		Verb:      "get",
-		ArgsType:  reflect.TypeOf(account.GetSSHKeyRequest{}),
+		// Deprecated:    false,
+		ArgsType: reflect.TypeOf(account.GetSSHKeyRequest{}),
 		ArgSpecs: core.ArgSpecs{
 			{
 				Name:       "ssh-key-id",
 				Short:      `The ID of the SSH key`,
 				Required:   true,
+				Deprecated: false,
 				Positional: true,
 			},
 		},
@@ -205,17 +215,20 @@ func accountSSHKeyUpdate() *core.Command {
 		Namespace: "account",
 		Resource:  "ssh-key",
 		Verb:      "update",
-		ArgsType:  reflect.TypeOf(account.UpdateSSHKeyRequest{}),
+		// Deprecated:    false,
+		ArgsType: reflect.TypeOf(account.UpdateSSHKeyRequest{}),
 		ArgSpecs: core.ArgSpecs{
 			{
 				Name:       "ssh-key-id",
 				Required:   true,
+				Deprecated: false,
 				Positional: true,
 			},
 			{
 				Name:       "name",
 				Short:      `Name of the SSH key`,
 				Required:   false,
+				Deprecated: false,
 				Positional: false,
 			},
 		},
@@ -237,11 +250,13 @@ func accountSSHKeyRemove() *core.Command {
 		Namespace: "account",
 		Resource:  "ssh-key",
 		Verb:      "remove",
-		ArgsType:  reflect.TypeOf(account.DeleteSSHKeyRequest{}),
+		// Deprecated:    false,
+		ArgsType: reflect.TypeOf(account.DeleteSSHKeyRequest{}),
 		ArgSpecs: core.ArgSpecs{
 			{
 				Name:       "ssh-key-id",
 				Required:   true,
+				Deprecated: false,
 				Positional: true,
 			},
 		},