docs(iam): create user spec (scaleway#4619)

Author: scaleway-bot

cmd/scw/testdata/test-all-usage-iam-user-create-usage.golden

@@ -1,6 +1,6 @@
 🎲🎲🎲 EXIT CODE: 0 🎲🎲🎲
 🟥🟥🟥 STDERR️️ 🟥🟥🟥️
-Create a new user. You must define the `organization_id` and the `email` in your request.
+Create a new user. You must define the `organization_id` in your request. If you are adding a member, enter the member's details. If you are adding a guest, you must define the `email` and not add the member attribute.
 
 USAGE:
   scw iam user create [arg=value ...]

docs/commands/iam.md

@@ -1045,7 +1045,7 @@ Users management commands.
 
 ### Create a new user
 
-Create a new user. You must define the `organization_id` and the `email` in your request.
+Create a new user. You must define the `organization_id` in your request. If you are adding a member, enter the member's details. If you are adding a guest, you must define the `email` and not add the member attribute.
 
 **Usage:**
 

go.mod

@@ -25,7 +25,7 @@ require (
 	github.com/mattn/go-isatty v0.0.20
 	github.com/moby/buildkit v0.13.2
 	github.com/opencontainers/go-digest v1.0.0
-	github.com/scaleway/scaleway-sdk-go v1.0.0-beta.32.0.20250326091623-c76ff7151d13
+	github.com/scaleway/scaleway-sdk-go v1.0.0-beta.33.0.20250327145452-20e9e72214ed
 	github.com/skratchdot/open-golang v0.0.0-20200116055534-eef842397966
 	github.com/spf13/cobra v1.9.1
 	github.com/spf13/pflag v1.0.6

go.sum

@@ -462,8 +462,8 @@ github.com/rogpeppe/go-internal v1.11.0/go.mod h1:ddIwULY96R17DhadqLgMfk9H9tvdUz
 github.com/russross/blackfriday/v2 v2.1.0/go.mod h1:+Rmxgy9KzJVeS9/2gXHxylqXiyQDYRxCVz55jmeOWTM=
 github.com/sabhiram/go-gitignore v0.0.0-20210923224102-525f6e181f06 h1:OkMGxebDjyw0ULyrTYWeN0UNCCkmCWfjPnIA2W6oviI=
 github.com/sabhiram/go-gitignore v0.0.0-20210923224102-525f6e181f06/go.mod h1:+ePHsJ1keEjQtpvf9HHw0f4ZeJ0TLRsxhunSI2hYJSs=
-github.com/scaleway/scaleway-sdk-go v1.0.0-beta.32.0.20250326091623-c76ff7151d13 h1:GLd3G2hvNpzjMUYOdLO79M+jiicgXnaf8eCKK+nOHLY=
-github.com/scaleway/scaleway-sdk-go v1.0.0-beta.32.0.20250326091623-c76ff7151d13/go.mod h1:792k1RTU+5JeMXm35/e2Wgp71qPH/DmDoZrRc+EFZDk=
+github.com/scaleway/scaleway-sdk-go v1.0.0-beta.33.0.20250327145452-20e9e72214ed h1:klCw4VdfiQ+nTqNoY8ymobNj0ZYs5oDQ9A6ilvndopg=
+github.com/scaleway/scaleway-sdk-go v1.0.0-beta.33.0.20250327145452-20e9e72214ed/go.mod h1:792k1RTU+5JeMXm35/e2Wgp71qPH/DmDoZrRc+EFZDk=
 github.com/sclevine/spec v1.4.0 h1:z/Q9idDcay5m5irkZ28M7PtQM4aOISzOpj4bUPkDee8=
 github.com/sclevine/spec v1.4.0/go.mod h1:LvpgJaFyvQzRvc1kaDs0bulYwzC70PbiYjC4QnFHkOM=
 github.com/secure-systems-lab/go-securesystemslib v0.8.0 h1:mr5An6X45Kb2nddcFlbmfHkLguCE9laoZCUzEEpIZXA=

internal/namespaces/iam/v1alpha1/iam_cli.go

@@ -637,7 +637,7 @@ func iamUserDelete() *core.Command {
 func iamUserCreate() *core.Command {
 	return &core.Command{
 		Short:     `Create a new user`,
-		Long:      `Create a new user. You must define the ` + "`" + `organization_id` + "`" + ` and the ` + "`" + `email` + "`" + ` in your request.`,
+		Long:      `Create a new user. You must define the ` + "`" + `organization_id` + "`" + ` in your request. If you are adding a member, enter the member's details. If you are adding a guest, you must define the ` + "`" + `email` + "`" + ` and not add the member attribute.`,
 		Namespace: "iam",
 		Resource:  "user",
 		Verb:      "create",