devices

Creates, updates, deletes, gets or lists a devices resource.

Overview

Name	devices
Type	Resource
Id	google.cloudidentity.devices

Fields

Name	Datatype	Description
name	string	Output only. Resource name of the Device in format: devices/{device}, where device is the unique id assigned to the Device.
androidSpecificAttributes	object	Resource representing the Android specific attributes of a Device.
assetTag	string	Asset tag of the device.
basebandVersion	string	Output only. Baseband version of the device.
bootloaderVersion	string	Output only. Device bootloader version. Example: 0.6.7.
brand	string	Output only. Device brand. Example: Samsung.
buildNumber	string	Output only. Build number of the device.
compromisedState	string	Output only. Represents whether the Device is compromised.
createTime	string	Output only. When the Company-Owned device was imported. This field is empty for BYOD devices.
deviceId	string	Unique identifier for the device.
deviceType	string	Output only. Type of device.
enabledDeveloperOptions	boolean	Output only. Whether developer options is enabled on device.
enabledUsbDebugging	boolean	Output only. Whether USB debugging is enabled on device.
encryptionState	string	Output only. Device encryption state.
endpointVerificationSpecificAttributes	object	Resource representing the Endpoint Verification-specific attributes of a device.
hostname	string	Host name of the device.
imei	string	Output only. IMEI number of device if GSM device; empty otherwise.
kernelVersion	string	Output only. Kernel version of the device.
lastSyncTime	string	Most recent time when device synced with this service.
managementState	string	Output only. Management state of the device
manufacturer	string	Output only. Device manufacturer. Example: Motorola.
meid	string	Output only. MEID number of device if CDMA device; empty otherwise.
model	string	Output only. Model name of device. Example: Pixel 3.
networkOperator	string	Output only. Mobile or network operator of device, if available.
osVersion	string	Output only. OS version of the device. Example: Android 8.1.0.
otherAccounts	array	Output only. Domain name for Google accounts on device. Type for other accounts on device. On Android, will only be populated if
ownerType	string	Output only. Whether the device is owned by the company or an individual
releaseVersion	string	Output only. OS release version. Example: 6.0.
securityPatchTime	string	Output only. OS security patch update time on device.
serialNumber	string	Serial Number of device. Example: HT82V1A01076.
unifiedDeviceId	string	Output only. Unified device id of the device.
wifiMacAddresses	array	WiFi MAC addresses of device.

Methods

Name	Accessible by	Required Params	Description
get	SELECT	devicesId	Retrieves the specified device.
list	SELECT		Lists/Searches devices.
create	INSERT		Creates a device. Only company-owned device may be created. Note: This method is available only to customers who have one of the following SKUs: Enterprise Standard, Enterprise Plus, Enterprise for Education, and Cloud Identity Premium
delete	DELETE	devicesId	Deletes the specified device.
cancel_wipe	EXEC	devicesId	Cancels an unfinished device wipe. This operation can be used to cancel device wipe in the gap between the wipe operation returning success and the device being wiped. This operation is possible when the device is in a "pending wipe" state. The device enters the "pending wipe" state when a wipe device command is issued, but has not yet been sent to the device. The cancel wipe will fail if the wipe command has already been issued to the device.
wipe	EXEC	devicesId	Wipes all data on the specified device.

SELECT examples

Lists/Searches devices.

SELECT
name,
androidSpecificAttributes,
assetTag,
basebandVersion,
bootloaderVersion,
brand,
buildNumber,
compromisedState,
createTime,
deviceId,
deviceType,
enabledDeveloperOptions,
enabledUsbDebugging,
encryptionState,
endpointVerificationSpecificAttributes,
hostname,
imei,
kernelVersion,
lastSyncTime,
managementState,
manufacturer,
meid,
model,
networkOperator,
osVersion,
otherAccounts,
ownerType,
releaseVersion,
securityPatchTime,
serialNumber,
unifiedDeviceId,
wifiMacAddresses
FROM google.cloudidentity.devices
;

INSERT example

Use the following StackQL query and manifest file to create a new devices resource.

All Properties

/*+ create */
INSERT INTO google.cloudidentity.devices (
lastSyncTime,
serialNumber,
assetTag,
wifiMacAddresses,
deviceId,
hostname
)
SELECT 
'{{ lastSyncTime }}',
'{{ serialNumber }}',
'{{ assetTag }}',
'{{ wifiMacAddresses }}',
'{{ deviceId }}',
'{{ hostname }}'
;

Manifest

- name: your_resource_model_name
  props:
    - name: name
      value: string
    - name: createTime
      value: string
    - name: lastSyncTime
      value: string
    - name: ownerType
      value: string
    - name: model
      value: string
    - name: osVersion
      value: string
    - name: deviceType
      value: string
    - name: serialNumber
      value: string
    - name: assetTag
      value: string
    - name: imei
      value: string
    - name: meid
      value: string
    - name: wifiMacAddresses
      value:
        - string
    - name: networkOperator
      value: string
    - name: manufacturer
      value: string
    - name: releaseVersion
      value: string
    - name: brand
      value: string
    - name: buildNumber
      value: string
    - name: kernelVersion
      value: string
    - name: basebandVersion
      value: string
    - name: enabledDeveloperOptions
      value: boolean
    - name: otherAccounts
      value:
        - string
    - name: enabledUsbDebugging
      value: boolean
    - name: securityPatchTime
      value: string
    - name: bootloaderVersion
      value: string
    - name: encryptionState
      value: string
    - name: androidSpecificAttributes
      value:
        - name: enabledUnknownSources
          value: boolean
        - name: supportsWorkProfile
          value: boolean
        - name: ownerProfileAccount
          value: boolean
        - name: ownershipPrivilege
          value: string
        - name: verifiedBoot
          value: boolean
        - name: ctsProfileMatch
          value: boolean
        - name: verifyAppsEnabled
          value: boolean
        - name: hasPotentiallyHarmfulApps
          value: boolean
    - name: managementState
      value: string
    - name: compromisedState
      value: string
    - name: deviceId
      value: string
    - name: unifiedDeviceId
      value: string
    - name: endpointVerificationSpecificAttributes
      value:
        - name: certificateAttributes
          value:
            - - name: fingerprint
                value: string
              - name: thumbprint
                value: string
              - name: validationState
                value: string
              - name: serialNumber
                value: string
              - name: validityStartTime
                value: string
              - name: validityExpirationTime
                value: string
              - name: issuer
                value: string
              - name: subject
                value: string
              - name: certificateTemplate
                value:
                  - name: id
                    value: string
                  - name: majorVersion
                    value: integer
                  - name: minorVersion
                    value: integer
        - name: browserAttributes
          value:
            - - name: lastProfileSyncTime
                value: string
              - name: chromeBrowserInfo
                value:
                  - name: browserVersion
                    value: string
                  - name: browserManagementState
                    value: string
                  - name: isFileUploadAnalysisEnabled
                    value: boolean
                  - name: isFileDownloadAnalysisEnabled
                    value: boolean
                  - name: isBulkDataEntryAnalysisEnabled
                    value: boolean
                  - name: isSecurityEventAnalysisEnabled
                    value: boolean
                  - name: isRealtimeUrlCheckEnabled
                    value: boolean
                  - name: safeBrowsingProtectionLevel
                    value: string
                  - name: isSiteIsolationEnabled
                    value: boolean
                  - name: isBuiltInDnsClientEnabled
                    value: boolean
                  - name: passwordProtectionWarningTrigger
                    value: string
                  - name: isChromeRemoteDesktopAppBlocked
                    value: boolean
                  - name: isChromeCleanupEnabled
                    value: boolean
                  - name: isThirdPartyBlockingEnabled
                    value: boolean
              - name: chromeProfileId
                value: string
        - name: additionalSignals
          value: object
    - name: hostname
      value: string

DELETE example

Deletes the specified devices resource.

/*+ delete */
DELETE FROM google.cloudidentity.devices
WHERE devicesId = '{{ devicesId }}';