Asset

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

JSON representation 
{
  "product_object_id": string,
  "hostname": string,
  "asset_id": string,
  "ip": [
    string
  ],
  "mac": [
    string
  ],
  "nat_ip": [
    string
  ],
  "first_seen_time": string,
  "hardware": [
    {
      object (Hardware)
    }
  ],
  "platform_software": {
    object (PlatformSoftware)
  },
  "software": [
    {
      object (Software)
    }
  ],
  "location": {
    object (Location)
  },
  "category": string,
  "type": enum (AssetType),
  "network_domain": string,
  "creation_time": string,
  "first_discover_time": string,
  "last_discover_time": string,
  "system_last_update_time": string,
  "last_boot_time": string,
  "labels": [
    {
      object (Label)
    }
  ],
  "deployment_status": enum (DeploymentStatus),
  "vulnerabilities": [
    {
      object (Vulnerability)
    }
  ],
  "attribute": {
    object (Attribute)
  }
}
Fields
product_object_id

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.
asset_id

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.
nat_ip[]

string

List of NAT IP addresses associated with an asset.
first_seen_time

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 uses 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.
platform_software

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).
network_domain

string

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

string (Timestamp format)

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

Uses RFC 3339, where generated output will always be Z-normalized and uses 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".
first_discover_time

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 uses 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".
last_discover_time

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 uses 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".
system_last_update_time

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 uses 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".
last_boot_time

string (Timestamp format)

Time the asset was last boot started.

Uses RFC 3339, where generated output will always be Z-normalized and uses 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.
deployment_status

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 
{
  "serial_number": string,
  "manufacturer": string,
  "model": string,
  "cpu_platform": string,
  "cpu_model": string,
  "cpu_clock_speed": string,
  "cpu_max_clock_speed": string,
  "cpu_number_cores": string,
  "ram": string
}
Fields
serial_number

string

Hardware serial number.
manufacturer

string

Hardware manufacturer.
model

string

Hardware model.
cpu_platform

string

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

string

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

string

Clock speed of the hardware CPU in MHz.
cpu_max_clock_speed

string

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

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),
  "platform_version": string,
  "platform_patch_level": string
}
Fields
platform

enum (Platform)

The platform operating system.
platform_version

string

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

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,
  "vendor_name": 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.
vendor_name

string

The name of the software vendor.