GoSpace Manager

Version v0.11.0

Manage Google Workspace resources using a developer-friendly CLI written in Go

list

Lists/Searches devices.

Synopsis

Implements the API documented at https://cloud.google.com/identity/docs/reference/rest/v1/devices/list

gsm devices list [flags]

Options

      --customer string   Resource name of the customer.
                          If you're using this API for your own organization, use customers/my_customer.
                          If you're using this API to manage another organization, use customers/{customer_id}, where customer_id is the customer to whom the device belongs. (default "customers/my_customer")
      --fields string     Fields allows partial responses to be retrieved.
                          See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
      --filter string     Additional restrictions when fetching list of devices.
                          For a list of search fields, refer to https://developers.google.com/admin-sdk/directory/v1/search-operators.
                          Multiple search fields are separated by the space character.
  -h, --help              help for list
      --orderBy string    Order specification for devices in the response.
                          Only one of the following field names may be used to specify the order: createTime, lastSyncTime, model, osVersion, deviceType and serialNumber.
                          desc may be specified optionally at the end to specify results to be sorted in descending order.
                          Default order is ascending.
      --view string       The view to use for the List request.
                          Possible values are:
                          COMPANY_INVENTORY      This view contains all devices imported by the company admin.
                                                 Each device in the response contains all information specified by the company admin when importing the device (i.e. asset tags).
                                                 This includes devices that may be unaassigned or assigned to users.
                          USER_ASSIGNED_DEVICES  This view contains all devices with at least one user registered on the device.
                                                 Each device in the response contains all device information, except for asset tags.

Options inherited from parent commands

      --compressOutput         By default, GSM outputs "pretty" (indented) objects. By setting this flag, GSM's output will be compressed. This may or may not improve performance in scripts.
      --config string          config file (default is $HOME/.config/gsm/.gsm.yaml)
      --delay int              This delay (plus a random jitter between 0 and 50) will be applied after every command to avoid reaching quota and rate limits. Set to 0 to disable.
      --dwdSubject string      Specify a subject used for DWD impersonation (overrides value in config file)
      --log string             Set the path of the log file. Default is either ~/gsm.log or defined in your config file
      --maxElapsedTime int     This is the maximum total time that will be spent retrying a request in minutes. (default 15)
      --maxRetryInterval int   This is the maximum interval that will be used between retry attempts in seconds. (default 320)
      --redirectPort int       This is the TCP port on which GSM will create web server if you authenticate with a user account for the first time. This is necessary for the OAuth flow. See https://developers.google.com/identity/protocols/oauth2/native-app#redirect-uri_loopback (default 8081)
      --retryOn ints           Specify the HTTP error code(s) that GSM should retry on. Note that GSM will always retry on HTTP 403 errors that indicate a quota / rate limit error
      --streamOutput           Setting this flag will cause GSM to output slice values to stdout one by one, instead of one large object

SEE ALSO

  • gsm devices - Manage Devices (Part of Cloud Identity API)