Asset

Information about a compute asset such as a workstation, laptop, phone, virtual desktop, or VM.

JSON representation 
{
  "productObjectId": string,
  "hostname": string,
  "assetId": string,
  "ip": [
    string
  ],
  "mac": [
    string
  ],
  "natIp": [
    string
  ],
  "firstSeenTime": string,
  "hardware": [
    {
      object (Hardware)
    }
  ],
  "platformSoftware": {
    object (PlatformSoftware)
  },
  "software": [
    {
      object (Software)
    }
  ],
  "location": {
    object (Location)
  },
  "category": string,
  "type": enum (AssetType),
  "networkDomain": string,
  "creationTime": string,
  "firstDiscoverTime": string,
  "lastDiscoverTime": string,
  "systemLastUpdateTime": string,
  "lastBootTime": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "deploymentStatus": enum (DeploymentStatus),
  "vulnerabilities": [
    {
      object (Vulnerability)
    }
  ],
  "attribute": {
    object (Attribute)
  }
}
Fields
productObjectId

string

A vendor-specific identifier to uniquely identify the entity (a GUID or similar). This field can be used as an entity indicator for asset entities.
hostname

string

Asset hostname or domain name field. This field can be used as an entity indicator for asset entities.
assetId

string

The asset ID. Value must contain the ':' character. For example, cs:abcdd23434. This field can be used as an entity indicator for asset entities.
ip[]

string

A list of IP addresses associated with an asset. This field can be used as an entity indicator for asset entities.
mac[]

string

List of MAC addresses associated with an asset. This field can be used as an entity indicator for asset entities.
natIp[]

string

List of NAT IP addresses associated with an asset.
firstSeenTime

string (Timestamp format)

The first observed time for an asset. The value is calculated on the basis of the first time the identifier was observed.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
hardware[]

object (Hardware)

The asset hardware specifications.
platformSoftware

object (PlatformSoftware)

The asset operating system platform software.
software[]

object (Software)

The asset software details.
location

object (Location)

Location of the asset.
category

string

The category of the asset (e.g. "End User Asset", "Workstation", "Server").
type

enum (AssetType)

The type of the asset (e.g. workstation or laptop or server).
networkDomain

string

The network domain of the asset (e.g. "corp.acme.com")
creationTime
(deprecated)

string (Timestamp format)

Time the asset was created or provisioned. Deprecate: creationTime should be populated in Attribute as generic metadata.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
firstDiscoverTime

string (Timestamp format)

Time the asset was first discovered (by asset management/discoverability software).

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
lastDiscoverTime

string (Timestamp format)

Time the asset was last discovered (by asset management/discoverability software).

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
systemLastUpdateTime

string (Timestamp format)

Time the asset system or OS was last updated. For all other operations that are not system updates (such as resizing a VM), use Attribute.last_update_time.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
lastBootTime

string (Timestamp format)

Time the asset was last boot started.

Uses RFC 3339, where generated output will always be Z-normalized and use 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
labels[]
(deprecated)

object (Label)

Metadata labels for the asset. Deprecated: labels should be populated in Attribute as generic metadata.
deploymentStatus

enum (DeploymentStatus)

The deployment status of the asset for device lifecycle purposes.
vulnerabilities[]

object (Vulnerability)

Vulnerabilities discovered on asset.
attribute

object (Attribute)

Generic entity metadata attributes of the asset.

Hardware

Hardware specification details for a resource, including both physical and virtual hardware.

JSON representation 
{
  "serialNumber": string,
  "manufacturer": string,
  "model": string,
  "cpuPlatform": string,
  "cpuModel": string,
  "cpuClockSpeed": string,
  "cpuMaxClockSpeed": string,
  "cpuNumberCores": string,
  "ram": string
}
Fields
serialNumber

string

Hardware serial number.
manufacturer

string

Hardware manufacturer.
model

string

Hardware model.
cpuPlatform

string

Platform of the hardware CPU (e.g. "Intel Broadwell").
cpuModel

string

Model description of the hardware CPU (e.g. "2.8 GHz Quad-Core Intel Core i5").
cpuClockSpeed

string

Clock speed of the hardware CPU in MHz.
cpuMaxClockSpeed

string

Maximum possible clock speed of the hardware CPU in MHz.
cpuNumberCores

string

Number of CPU cores.
ram

string

Amount of the hardware ramdom access memory (RAM) in Mb.

PlatformSoftware

Platform software information about an operating system.

JSON representation 
{
  "platform": enum (Platform),
  "platformVersion": string,
  "platformPatchLevel": string
}
Fields
platform

enum (Platform)

The platform operating system.
platformVersion

string

The platform software version ( e.g. "Microsoft Windows 1803").
platformPatchLevel

string

The platform software patch level ( e.g. "Build 17134.48", "SP1").

Software

Information about a software package or application.

JSON representation 
{
  "name": string,
  "version": string,
  "permissions": [
    {
      object (Permission)
    }
  ],
  "description": string,
  "vendorName": string
}
Fields
name

string

The name of the software.
version

string

The version of the software.
permissions[]

object (Permission)

System permissions granted to the software. For example, "android.permission.WRITE_EXTERNAL_STORAGE"
description

string

The description of the software.
vendorName

string

The name of the software vendor.