lookup

Looks up resource names of the DeviceUsers associated with the caller’s credentials, as well as the properties provided in the request.

Synopsis

This method must be called with end-user credentials with the scope: https://www.googleapis.com/auth/cloud-identity.devices.lookup

If multiple properties are provided, only DeviceUsers having all of these properties are considered as matches - i.e. the query behaves like an AND. Different platforms require different amounts of information from the caller to ensure that the DeviceUser is uniquely identified.

• iOS: No properties need to be passed, the caller’s credentials are sufficient to identify the corresponding DeviceUser.
• Android: Specifying the ‘androidId’ field is required.
• Desktop: Specifying the ‘rawResourceId’ field is required. Implements the API documented at https://cloud.google.com/identity/docs/reference/rest/v1/devices.deviceUsers/lookup

gsm deviceUsers lookup [flags]

Options

      --androidId string       Android Id returned by Settings.Secure#ANDROID_ID (https://developer.android.com/reference/android/provider/Settings.Secure.html#ANDROID_ID).
  -h, --help                   help for lookup
      --parent string          To list all DeviceUsers, set this to "devices/-".
                               To list all DeviceUsers owned by a device, set this to the resource name of the device.
                               Format: devices/{device}
      --rawResourceId string   Raw Resource Id used by Google Endpoint Verification.
                               If the user is enrolled into Google Endpoint Verification, this id will be saved as the 'device_resource_id' field in the following platform dependent files:
                               Mac      -  ~/.secureConnect/context_aware_config.json
                               Windows  - C:\Users\%USERPROFILE%.secureConnect\context_aware_config.json
                               Linux    - ~/.secureConnect/context_aware_config.json
      --userId string          The user whose DeviceUser's resource name will be fetched.
                               Must be set to 'me' to fetch the DeviceUser's resource name for the calling user.

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 deviceUsers - Manage device users (Part of Cloud Identity API)