GoSpace Manager

Version v0.11.0

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

list

Retrieves a paginated list of Chrome OS devices within an account.

Synopsis

Implements the API documented at https://developers.google.com/admin-sdk/directory/reference/rest/v1/chromeosdevices/list

gsm chromeOsDevices list [flags]

Options

      --customerId string    The unique ID for the customer's Workspace account.
                             As an account administrator, you can also use the my_customer alias to represent your account's customerId.
                             The customerId is also returned as part of the Users resource. (default "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.
  -h, --help                 help for list
      --orderBy string       Device property to use for sorting results.
                             
                             Acceptable values are:
                             annotatedLocation  - Chrome device location as annotated by the administrator.
                             annotatedUser      - Chrome device user as annotated by the administrator.
                             lastSync           - The date and time the Chrome device was last synchronized with the policy settings in the Admin console.
                             notes              - Chrome device notes as annotated by the administrator.
                             serialNumber       - The Chrome device serial number entered when the device was enabled.
                             status             - Chrome device status. For more information, see the chromeosdevices resource.
                             supportEndDate     - Chrome device support end date. This is applicable only for devices purchased directly from Google.
      --orgUnitPath string   The full path of the organizational unit or its unique ID.
      --projection string    Determines whether the response contains the full list of properties or only a subset.
                             
                             Acceptable values are:
                             BASIC  - Excludes the model, meid, orderNumber, willAutoRenew, osVersion, platformVersion, firmwareVersion, macAddress, and bootMode properties.
                             FULL   - Includes all metadata fields.
      --query string         Search string in the format provided by List query operators
                             (https://developers.google.com/admin-sdk/directory/v1/list-query-operators).
      --sortOrder string     Whether to return results in ascending or descending order. Must be used with the orderBy parameter.
                             
                             Acceptable values are:
                             ASCENDING   - Ascending order.
                             DESCENDING  - Descending order.

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