---
title: pulumi insights account scan | CLI commands
url: /docs/iac/cli/commands/pulumi_insights_account_scan/
---

[EXPERIMENTAL] Trigger a resource discovery scan for an Insights account

## Synopsis

[EXPERIMENTAL] Trigger a resource discovery scan for an Insights account.

The positional argument is the Insights account to scan; the organization
defaults to the current default org and can be overridden with --org. For
parent accounts the server fans the scan out across child accounts and
returns the parent workflow run.

```
pulumi insights account scan  [flags]
```

## Examples

```
  # Trigger a scan in a specific Insights account.
  pulumi insights account scan prod-aws

  # Override the organization.
  pulumi insights account scan --org acme prod-aws

  # Tune scan concurrency and read timeout.
  pulumi insights account scan prod-aws \
      --list-concurrency 16 --read-concurrency 32 --read-timeout 1m

  # Emit JSON for scripting.
  pulumi insights account scan prod-aws --output json
```

## Options

```
      --agent-pool string      Agent pool ID to use for the scan (defaults to the account's default pool)
      --batch-size int         Number of resources processed per batch (server default when 0)
  -h, --help                   help for scan
      --list-concurrency int   Parallelism for list operations during the scan (server default when 0)
      --org string             Organization that owns the Insights account (defaults to the current default org)
      --output string          Output format. Supported values are: default and json (default "default")
      --read-concurrency int   Parallelism for read operations during the scan (server default when 0)
      --read-timeout string    Per-read timeout as a Go duration (e.g. '30s', '5m'); server default when empty
```

## Options inherited from parent commands

```
      --color string                 Colorize output. Choices are: always, never, raw, auto (default "auto")
  -C, --cwd string                   Run pulumi as if it had been started in another directory
      --disable-integrity-checking   Disable integrity checking of checkpoint files
  -e, --emoji                        Enable emojis in the output
  -Q, --fully-qualify-stack-names    Show fully-qualified stack names
      --logflow                      Flow log settings to child processes (like plugins)
      --logtostderr                  Log to stderr instead of to files
      --memprofilerate int           Enable more precise (and expensive) memory allocation profiles by setting runtime.MemProfileRate
      --non-interactive              Disable interactive mode for all commands
      --otel-traces string           Export OpenTelemetry traces to the specified endpoint. Use file:// for local JSON files, grpc:// for remote collectors
      --profiling string             Emit CPU and memory profiles and an execution trace to '[filename].[pid].{cpu,mem,trace}', respectively
      --tracing file:                Emit tracing to the specified endpoint. Use the file: scheme to write tracing data to a local file
  -v, --verbose int                  Enable verbose logging (e.g., v=3); anything >3 is very verbose
```

## SEE ALSO

* [pulumi insights account](/docs/iac/cli/commands/pulumi_insights_account/)	 - [EXPERIMENTAL] Manage Pulumi Insights accounts
* [pulumi insights account scan get](/docs/iac/cli/commands/pulumi_insights_account_scan_get/)	 - [EXPERIMENTAL] Get details for a specific Insights scan
* [pulumi insights account scan list](/docs/iac/cli/commands/pulumi_insights_account_scan_list/)	 - [EXPERIMENTAL] List recent scans for an Insights account
* [pulumi insights account scan log](/docs/iac/cli/commands/pulumi_insights_account_scan_log/)	 - [EXPERIMENTAL] Retrieve log output for an Insights scan