Skip to content

datadog list-users

Get the list of all users in the organization

Description

Get the list of all users in the organization

Synopsis

datadog list-users
    [--site <site>]
    [--size <size>]
    [--number <number>]
    [--sort <sort>]
    [--filter <filter>]
    [--status <status>]
    [--user <user>]

Arguments

site - (string)

     Site where this command will be executed
     Example: --site "site-1"
     Default: input.site      Attributes: optional

size - (int)

     Size for a given page. The maximum allowed value is 5000
     Example: --size 1
     Default: _None_      Attributes: optional

     Validation:
         max: 5000

number - (int)

     Specific page number to return
     Example: --number 1
     Default: _None_      Attributes: optional

sort - (string)

     user attribute to order results by, default ascending
     Example: --sort "sort-1"
     Default: _None_      Attributes: optional

     Validation:
         allowed values: name, -name, modified_at, -modified_at, user_count, -user_count

filter - (string)

     Filter all users by the given string. Defaults to no filtering
     Example: --filter "filter-1"
     Default: _None_      Attributes: optional

status - (string)

     Filter on status attribute
     Example: --status "status-1"
     Default: _None_      Attributes: optional, multiple allowed

     Validation:
         allowed values: Active, Pending, Disabled

user - (string)

     The ID of the user
     Example: --user "user-1"
     Default: _None_      Attributes: optional

Examples

Input:

!datadog list-users
Output:

Input:
!datadog list-users --user "0a587d98-0727-41fc-b926-027cb686ec8d"
Output:

Access Control

To use this command, you need access to the following:

Field Value
Action "read"
Service Type "datadog"
Service Instance
Namespace
Object Type "user"
Object ID

Please see Access Control for details.