published on Wednesday, Jun 17, 2026 by pulumiverse
published on Wednesday, Jun 17, 2026 by pulumiverse
Use this data source to get information on an existing IAM user based on its ID or email address. For more information refer to the IAM API documentation.
Example Usage
import * as pulumi from "@pulumi/pulumi";
import * as scaleway from "@pulumiverse/scaleway";
// Get info by user id
const findById = scaleway.iam.getUser({
userId: "11111111-1111-1111-1111-111111111111",
});
// Get info by email address
const findByEmail = scaleway.iam.getUser({
email: "foo@bar.com",
});
import pulumi
import pulumi_scaleway as scaleway
# Get info by user id
find_by_id = scaleway.iam.get_user(user_id="11111111-1111-1111-1111-111111111111")
# Get info by email address
find_by_email = scaleway.iam.get_user(email="foo@bar.com")
package main
import (
"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
"github.com/pulumiverse/pulumi-scaleway/sdk/go/scaleway/iam"
)
func main() {
pulumi.Run(func(ctx *pulumi.Context) error {
// Get info by user id
_, err := iam.LookupUser(ctx, &iam.LookupUserArgs{
UserId: pulumi.StringRef("11111111-1111-1111-1111-111111111111"),
}, nil)
if err != nil {
return err
}
// Get info by email address
_, err = iam.LookupUser(ctx, &iam.LookupUserArgs{
Email: pulumi.StringRef("foo@bar.com"),
}, nil)
if err != nil {
return err
}
return nil
})
}
using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Scaleway = Pulumiverse.Scaleway;
return await Deployment.RunAsync(() =>
{
// Get info by user id
var findById = Scaleway.Iam.GetUser.Invoke(new()
{
UserId = "11111111-1111-1111-1111-111111111111",
});
// Get info by email address
var findByEmail = Scaleway.Iam.GetUser.Invoke(new()
{
Email = "foo@bar.com",
});
});
package generated_program;
import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.scaleway.iam.IamFunctions;
import com.pulumi.scaleway.iam.inputs.GetUserArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;
public class App {
public static void main(String[] args) {
Pulumi.run(App::stack);
}
public static void stack(Context ctx) {
// Get info by user id
final var findById = IamFunctions.getUser(GetUserArgs.builder()
.userId("11111111-1111-1111-1111-111111111111")
.build());
// Get info by email address
final var findByEmail = IamFunctions.getUser(GetUserArgs.builder()
.email("foo@bar.com")
.build());
}
}
variables:
# Get info by user id
findById:
fn::invoke:
function: scaleway:iam:getUser
arguments:
userId: 11111111-1111-1111-1111-111111111111
# Get info by email address
findByEmail:
fn::invoke:
function: scaleway:iam:getUser
arguments:
email: foo@bar.com
Example coming soon!
Using getIamUser
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getIamUser(args: GetIamUserArgs, opts?: InvokeOptions): Promise<GetIamUserResult>
function getIamUserOutput(args: GetIamUserOutputArgs, opts?: InvokeOptions): Output<GetIamUserResult>def get_iam_user(email: Optional[str] = None,
organization_id: Optional[str] = None,
tags: Optional[Sequence[str]] = None,
user_id: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetIamUserResult
def get_iam_user_output(email: pulumi.Input[Optional[str]] = None,
organization_id: pulumi.Input[Optional[str]] = None,
tags: pulumi.Input[Optional[Sequence[pulumi.Input[str]]]] = None,
user_id: pulumi.Input[Optional[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetIamUserResult]func LookupIamUser(ctx *Context, args *LookupIamUserArgs, opts ...InvokeOption) (*LookupIamUserResult, error)
func LookupIamUserOutput(ctx *Context, args *LookupIamUserOutputArgs, opts ...InvokeOption) LookupIamUserResultOutput> Note: This function is named LookupIamUser in the Go SDK.
public static class GetIamUser
{
public static Task<GetIamUserResult> InvokeAsync(GetIamUserArgs args, InvokeOptions? opts = null)
public static Output<GetIamUserResult> Invoke(GetIamUserInvokeArgs args, InvokeOptions? opts = null)
}public static CompletableFuture<GetIamUserResult> getIamUser(GetIamUserArgs args, InvokeOptions options)
public static Output<GetIamUserResult> getIamUser(GetIamUserArgs args, InvokeOptions options)
fn::invoke:
function: scaleway:index/getIamUser:getIamUser
arguments:
# arguments dictionarydata "scaleway_getiamuser" "name" {
# arguments
}The following arguments are supported:
- Email string
- The email address of the IAM user.
- Organization
Id string organizationId) The ID of the organization the user is associated with.- List<string>
- The tags associated with the user.
- User
Id string The ID of the IAM user.
Note You must specify at least one:
emailand/oruserId.
- Email string
- The email address of the IAM user.
- Organization
Id string organizationId) The ID of the organization the user is associated with.- []string
- The tags associated with the user.
- User
Id string The ID of the IAM user.
Note You must specify at least one:
emailand/oruserId.
- email string
- The email address of the IAM user.
- organization_
id string organizationId) The ID of the organization the user is associated with.- list(string)
- The tags associated with the user.
- user_
id string The ID of the IAM user.
Note You must specify at least one:
emailand/oruserId.
- email String
- The email address of the IAM user.
- organization
Id String organizationId) The ID of the organization the user is associated with.- List<String>
- The tags associated with the user.
- user
Id String The ID of the IAM user.
Note You must specify at least one:
emailand/oruserId.
- email string
- The email address of the IAM user.
- organization
Id string organizationId) The ID of the organization the user is associated with.- string[]
- The tags associated with the user.
- user
Id string The ID of the IAM user.
Note You must specify at least one:
emailand/oruserId.
- email str
- The email address of the IAM user.
- organization_
id str organizationId) The ID of the organization the user is associated with.- Sequence[str]
- The tags associated with the user.
- user_
id str The ID of the IAM user.
Note You must specify at least one:
emailand/oruserId.
- email String
- The email address of the IAM user.
- organization
Id String organizationId) The ID of the organization the user is associated with.- List<String>
- The tags associated with the user.
- user
Id String The ID of the IAM user.
Note You must specify at least one:
emailand/oruserId.
getIamUser Result
The following output properties are available:
- Account
Root stringUser Id - Created
At string - Deletable bool
- First
Name string - Id string
- The provider-assigned unique ID for this managed resource.
- Last
Login stringAt - Last
Name string - Locale string
- Locked bool
- Mfa bool
- Password string
- Password
Wo string - Password
Wo intVersion - Phone
Number string - Send
Password boolEmail - Send
Welcome boolEmail - Status string
- Type string
- Updated
At string - Username string
- Email string
- Organization
Id string - List<string>
- The tags associated with the user.
- User
Id string
- Account
Root stringUser Id - Created
At string - Deletable bool
- First
Name string - Id string
- The provider-assigned unique ID for this managed resource.
- Last
Login stringAt - Last
Name string - Locale string
- Locked bool
- Mfa bool
- Password string
- Password
Wo string - Password
Wo intVersion - Phone
Number string - Send
Password boolEmail - Send
Welcome boolEmail - Status string
- Type string
- Updated
At string - Username string
- Email string
- Organization
Id string - []string
- The tags associated with the user.
- User
Id string
- account_
root_ stringuser_ id - created_
at string - deletable bool
- first_
name string - id string
- The provider-assigned unique ID for this managed resource.
- last_
login_ stringat - last_
name string - locale string
- locked bool
- mfa bool
- password string
- password_
wo string - password_
wo_ numberversion - phone_
number string - send_
password_ boolemail - send_
welcome_ boolemail - status string
- type string
- updated_
at string - username string
- email string
- organization_
id string - list(string)
- The tags associated with the user.
- user_
id string
- account
Root StringUser Id - created
At String - deletable Boolean
- first
Name String - id String
- The provider-assigned unique ID for this managed resource.
- last
Login StringAt - last
Name String - locale String
- locked Boolean
- mfa Boolean
- password String
- password
Wo String - password
Wo IntegerVersion - phone
Number String - send
Password BooleanEmail - send
Welcome BooleanEmail - status String
- type String
- updated
At String - username String
- email String
- organization
Id String - List<String>
- The tags associated with the user.
- user
Id String
- account
Root stringUser Id - created
At string - deletable boolean
- first
Name string - id string
- The provider-assigned unique ID for this managed resource.
- last
Login stringAt - last
Name string - locale string
- locked boolean
- mfa boolean
- password string
- password
Wo string - password
Wo numberVersion - phone
Number string - send
Password booleanEmail - send
Welcome booleanEmail - status string
- type string
- updated
At string - username string
- email string
- organization
Id string - string[]
- The tags associated with the user.
- user
Id string
- account_
root_ struser_ id - created_
at str - deletable bool
- first_
name str - id str
- The provider-assigned unique ID for this managed resource.
- last_
login_ strat - last_
name str - locale str
- locked bool
- mfa bool
- password str
- password_
wo str - password_
wo_ intversion - phone_
number str - send_
password_ boolemail - send_
welcome_ boolemail - status str
- type str
- updated_
at str - username str
- email str
- organization_
id str - Sequence[str]
- The tags associated with the user.
- user_
id str
- account
Root StringUser Id - created
At String - deletable Boolean
- first
Name String - id String
- The provider-assigned unique ID for this managed resource.
- last
Login StringAt - last
Name String - locale String
- locked Boolean
- mfa Boolean
- password String
- password
Wo String - password
Wo NumberVersion - phone
Number String - send
Password BooleanEmail - send
Welcome BooleanEmail - status String
- type String
- updated
At String - username String
- email String
- organization
Id String - List<String>
- The tags associated with the user.
- user
Id String
Package Details
- Repository
- scaleway pulumiverse/pulumi-scaleway
- License
- Apache-2.0
- Notes
- This Pulumi package is based on the
scalewayTerraform Provider.
published on Wednesday, Jun 17, 2026 by pulumiverse