Skip to main content

device_os_accounts

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

Overview​

Namedevice_os_accounts
TypeResource
Idokta.devices.device_os_accounts

Fields​

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringUnique identifier for the OS account
_embeddedobjectEmbedded resources related to the OS account
_linksobject
createdstring (date-time)Timestamp when the OS account was created
deviceIdstringUnique identifier of the device this OS account belongs to
lastSeenAtstring (date-time)Timestamp when the OS account was last seen
lastUpdatedstring (date-time)Timestamp when the OS account was last updated
platformstringOS platform for OS accounts (desktop platforms only) (MACOS, WINDOWS)
profileobject
resourceAlternateIdstring
resourceDisplayNameobjectDisplay name of the OS account
resourceIdstringAlternate key for the id
resourceTypestring (default: DOSAccount)
statusstringStatus of the OS account (ACTIVE, DELETED)

Methods​

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_device_osaccountselectdeviceId, osAccountId, subdomainexpandRetrieves an OS account by osAccountId for a device
list_device_osaccountsselectdeviceId, subdomainexpandLists all OS accounts for a device by deviceId

Parameters​

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
deviceIdstringid of the device
osAccountIdstringThe unique identifier for the OS account (example: dao3qgkIEKjhNZudR0g4)
subdomainstring(default: my-org)
expandarrayComma-separated list of related resources to include in the _embedded attribute. Supported values are users and account_linked_enrollments.

SELECT examples​

Retrieves an OS account by osAccountId for a device

SELECT
id,
_embedded,
_links,
created,
deviceId,
lastSeenAt,
lastUpdated,
platform,
profile,
resourceAlternateId,
resourceDisplayName,
resourceId,
resourceType,
status
FROM okta.devices.device_os_accounts
WHERE deviceId = '{{ deviceId }}' -- required
AND osAccountId = '{{ osAccountId }}' -- required
AND subdomain = '{{ subdomain }}' -- required
AND expand = '{{ expand }}'
;