REST Resource: projects.locations.assets

Stay organized with collections Save and categorize content based on your preferences.

Resource: Asset

Message describing Asset object

JSON representation
{
  "name": string,
  "createTime": string,
  "updateTime": string,
  "labels": {
    string: string,
    ...
  },
  "attributes": {
    string: string,
    ...
  },
  "virtualMachineDetails": {
    object (VirtualMachineDetails)
  }
}
Fields
name

string

name of resource

createTime

string (Timestamp format)

Output only. [Output only] Create time stamp

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Output only. [Output only] Update time stamp.

A timestamp in RFC3339 UTC "Zulu" format, with nanosecond resolution and up to nine fractional digits. Examples: "2014-10-02T15:01:23Z" and "2014-10-02T15:01:23.045123456Z".

labels

map (key: string, value: string)

Labels as key value pairs.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

attributes

map (key: string, value: string)

Generic asset attributes.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

virtualMachineDetails

object (VirtualMachineDetails)

Output only. Asset information specific for VirtualMahines.

VirtualMachineDetails

Details of a VirtualMachine.

JSON representation
{
  "coreCount": integer,
  "memoryMb": integer,
  "osName": string,
  "vmUuid": string,
  "vmName": string,
  "osFamily": enum (OperatingSystemFamily),
  "vmArchitecture": {
    object (VirtualMachineArchitectureDetails)
  },
  "vmNetwork": {
    object (VirtualMachineNetworkDetails)
  },
  "vmDisks": {
    object (VirtualMachineDiskDetails)
  },
  "guestOs": {
    object (GuestOsDetails)
  },
  "vcenterFolder": string,
  "vcenterUrl": string,
  "vcenterVmId": string,
  "powerState": string,
  "performance": {
    object (PerformanceDetails)
  }
}
Fields
coreCount

integer

Number of CPU cores in the VirtualMachine.

memoryMb

integer

The amount of memory in the VirtualMachine.

osName

string

The name of the operating system running on the VirtualMachine.

vmUuid

string

Virtual Machine uniqe identifier.

vmName

string

Virtual Machine display name.

osFamily

enum (OperatingSystemFamily)

What family the OS belong to, if known.

vmArchitecture

object (VirtualMachineArchitectureDetails)

VM architecture details (vendor, cpu arch).

vmNetwork

object (VirtualMachineNetworkDetails)

VM network details.

vmDisks

object (VirtualMachineDiskDetails)

VM disk details.

guestOs

object (GuestOsDetails)

Guest OS information.

vcenterFolder

string

Folder name in vCenter where asset resides.

vcenterUrl

string

vCenter URL used in collection.

vcenterVmId

string

vCenter VM ID.

powerState

string

Power state of VM (poweredOn or poweredOff).

performance

object (PerformanceDetails)

Performance information.

OperatingSystemFamily

Known categories of operating systems

Enums
OS_FAMILY_UNKNOWN
OS_FAMILY_WINDOWS Microsoft Windows Server and Desktop
OS_FAMILY_LINUX Various Linux flavors
OS_FAMILY_UNIX Non-Linux Unix flavors

VirtualMachineArchitectureDetails

Details of VM architecture

JSON representation
{
  "cpuArchitecture": string,
  "cpuName": string,
  "cpuManufacturer": string,
  "vendor": string,
  "cpuThreadCount": integer,
  "cpuSocketCount": integer,
  "bios": {
    object (BiosDetails)
  },
  "firmware": string,
  "hyperthreading": enum (HyperThreading)
}
Fields
cpuArchitecture

string

CPU architecture e.g.: "x64-based PC", "x86_64", "i686" etc.

cpuName

string

CPU name e.g. "Intel Xeon E5-2690", "AMD EPYC 7571" etc.

cpuManufacturer

string

CPU manufacturer e.g.: "Intel", "AMD".

vendor

string

Hardware vendor.

cpuThreadCount

integer

Number of cpu threads allocated to the machine.

cpuSocketCount

integer

Number of processor sockets allocated ot the machine.

bios

object (BiosDetails)

Bios Details.

firmware

string

Firmware (BIOS/efi).

hyperthreading

enum (HyperThreading)

CPU hyperthreading support (inner enum).

BiosDetails

Details about the bios.

JSON representation
{
  "biosName": string,
  "biosManufacturer": string,
  "biosVersion": string,
  "biosReleaseDate": string
}
Fields
biosName

string

Bios name.

biosManufacturer

string

Bios manufacturer.

biosVersion

string

Bios version.

biosReleaseDate

string

Bios release date.

HyperThreading

CPU hyperthreading support.

Enums
HYPER_THREADING_UNSPECIFIED Unknown (default value).
HYPER_THREADING_DISABLED Hyperthreading is disabled.
HYPER_THREADING_ENABLED Hyperthreading is enabled.

VirtualMachineNetworkDetails

Details of network adapters and settings

JSON representation
{
  "primaryIpAddress": string,
  "networkAdapters": {
    object (NetworkAdapterList)
  },
  "defaultGw": string
}
Fields
primaryIpAddress

string

IP Address of the machine.

networkAdapters

object (NetworkAdapterList)

List of Network Adapters.

defaultGw

string

Default GW address. Top-level object, will be later encriched by full RouteInfo.

NetworkAdapterList

JSON representation
{
  "networkAdapters": [
    {
      object (NetworkAdapterDetails)
    }
  ]
}
Fields
networkAdapters[]

object (NetworkAdapterDetails)

Network Adapter descriptions.

NetworkAdapterDetails

Details of network adapter.

JSON representation
{
  "adapterType": string,
  "macAddress": string,
  "addresses": {
    object (NetworkAddressList)
  }
}
Fields
adapterType

string

Network adapter type (e.g. VMXNET3).

macAddress

string

MAC address.

addresses

object (NetworkAddressList)

NetworkAddressList

NetworkAddressList

List of allocated/assigned network addresses.

JSON representation
{
  "addresses": [
    {
      object (NetworkAddress)
    }
  ]
}
Fields
addresses[]

object (NetworkAddress)

NetworkAddress

Details of network address.

JSON representation
{
  "ipAddress": string,
  "subnetMask": string,
  "bcast": string,
  "fqdn": string,
  "assignment": enum (AddressAssignment)
}
Fields
ipAddress

string

Assigned or configured IP Address.

subnetMask

string

Subnet mask.

bcast

string

Broadcast address.

fqdn

string

Fully qualified domain name.

assignment

enum (AddressAssignment)

If DHCP is used to assign addresses.

AddressAssignment

Network address assignment (DHCP / static).

Enums
ADDRESS_ASSIGNMENT_UNSPECIFIED Unknown (default value).
ADDRESS_ASSIGNMENT_STATIC Staticly assigned IP.
ADDRESS_ASSIGNMENT_DHCP Dynamically assigned IP (DHCP).

VirtualMachineDiskDetails

Details of VM disks.

JSON representation
{
  "hddTotalCapacityBytes": string,
  "hddTotalFreeBytes": string,
  "disks": {
    object (DiskEntryList)
  },
  "lsblkJson": string
}
Fields
hddTotalCapacityBytes

string (int64 format)

Disk total Capacity.

hddTotalFreeBytes

string (int64 format)

Total Disk Free Space.

disks

object (DiskEntryList)

List of disks.

lsblkJson

string

Raw lsblk output in json.

DiskEntryList

VM disks.

JSON representation
{
  "entries": [
    {
      object (DiskEntry)
    }
  ]
}
Fields
entries[]

object (DiskEntry)

Disk entries.

DiskEntry

Single disk entry.

JSON representation
{
  "totalCapacityBytes": string,
  "totalFreeBytes": string,
  "diskLabel": string,
  "diskLabelType": string,
  "status": string,
  "interfaceType": string,
  "partitions": {
    object (DiskPartitionList)
  },
  "hwAddress": string
}
Fields
totalCapacityBytes

string (int64 format)

Disk Capacity (required).

totalFreeBytes

string (int64 format)

Disk Free Space.

diskLabel

string

Disk label.

diskLabelType

string

Disk label type (e.g. BIOS/GPT)

status

string

Disk status (e.g. online).

interfaceType

string

Disks interface type (e.g. SATA/SCSI)

partitions

object (DiskPartitionList)

Partition layout.

hwAddress

string

Disk hardware address (e.g. 0:1 for SCSI).

DiskPartitionList

JSON representation
{
  "entries": [
    {
      object (DiskPartition)
    }
  ]
}
Fields
entries[]

object (DiskPartition)

Partition entries.

DiskPartition

Disk Partition details.

JSON representation
{
  "type": string,
  "fileSystem": string,
  "mountPoint": string,
  "capacityBytes": string,
  "freeBytes": string,
  "uuid": string,
  "subPartitions": {
    object (DiskPartitionList)
  }
}
Fields
type

string

Partition type (e.g. BIOS boot).

fileSystem

string

Partition file system.

mountPoint

string

Mount pount (Linux/Windows) or drive letter (Windows).

capacityBytes

string (int64 format)

Partition capacity.

freeBytes

string (int64 format)

Partition free space.

uuid

string

Partition UUID.

subPartitions

object (DiskPartitionList)

Sub-partitions.

GuestOsDetails

Information from Guest-level collections.

JSON representation
{
  "config": {
    object (GuestConfigDetails)
  },
  "runtime": {
    object (GuestRuntimeDetails)
  }
}
Fields
config

object (GuestConfigDetails)

OS and app configuration.

runtime

object (GuestRuntimeDetails)

Runtime information.

GuestConfigDetails

Guest OS config information.

JSON representation
{
  "issue": string,
  "fstab": {
    object (FstabEntryList)
  },
  "hosts": {
    object (HostsEntryList)
  }
}
Fields
issue

string

OS issue (typically /etc/issue in Linux).

fstab

object (FstabEntryList)

Mount list (Linux fstab).

hosts

object (HostsEntryList)

Hosts file (/etc/hosts).

FstabEntryList

Fstab content.

JSON representation
{
  "entries": [
    {
      object (FstabEntry)
    }
  ]
}
Fields
entries[]

object (FstabEntry)

Fstab entries.

FstabEntry

Single fstab entry.

JSON representation
{
  "spec": string,
  "file": string,
  "vfstype": string,
  "mntops": string,
  "freq": integer,
  "passno": integer
}
Fields
spec

string

The block special device or remote filesystem to be mounted.

file

string

The mount point for the filesystem.

vfstype

string

The type of the filesystem.

mntops

string

Mount options associated with the filesystem.

freq

integer

Used by dump to determine which filesystems need to be dumped.

passno

integer

Used by the fsck(8) program to determine the order in which filesystem checks are done at reboot time.

HostsEntryList

Hosts content.

JSON representation
{
  "entries": [
    {
      object (HostsEntry)
    }
  ]
}
Fields
entries[]

object (HostsEntry)

Hosts entries.

HostsEntry

Single /etc/hosts entry.

JSON representation
{
  "ip": string,
  "hostNames": [
    string
  ]
}
Fields
ip

string

IP (raw, IPv4/6 agnostic).

hostNames[]

string

List of host names / aliases.

GuestRuntimeDetails

Guest OS runtime information.

JSON representation
{
  "services": {
    object (RunningServiceList)
  },
  "processes": {
    object (RunningProcessList)
  },
  "networkInfo": {
    object (RuntimeNetworkInfo)
  },
  "lastUptime": {
    object (Date)
  },
  "domain": string,
  "machineName": string,
  "installedApps": {
    object (GuestInstalledApplicationList)
  }
}
Fields
services

object (RunningServiceList)

Running background services.

processes

object (RunningProcessList)

Running processes.

networkInfo

object (RuntimeNetworkInfo)

Runtime network information (connections ports).

lastUptime

object (Date)

Date since last booted (last uptime date).

domain

string

Domain, e.g. c.stratozone-development.internal.

machineName

string

Machine name.

installedApps

object (GuestInstalledApplicationList)

Installed applications information.

RunningServiceList

List of running guest OS services.

JSON representation
{
  "services": [
    {
      object (RunningService)
    }
  ]
}
Fields
services[]

object (RunningService)

RunningService

Guest OS running service details.

JSON representation
{
  "name": string,
  "state": string,
  "startMode": string,
  "status": string,
  "exePath": string,
  "cmdline": string,
  "pid": string
}
Fields
name

string

Service name.

state

string

Service state (raw, OS-agnostic).

startMode

string

Service start mode (raw, OS-agnostic).

status

string

Service status.

exePath

string

Service binary path.

cmdline

string

Service command line.

pid

string (int64 format)

Service pid.

RunningProcessList

List of running guest OS processes.

JSON representation
{
  "processes": [
    {
      object (RunningProcess)
    }
  ]
}
Fields
processes[]

object (RunningProcess)

RunningProcess

Guest OS running process details.

JSON representation
{
  "pid": string,
  "exePath": string,
  "cmdline": string,
  "user": string,
  "attributes": {
    string: string,
    ...
  }
}
Fields
pid

string (int64 format)

Process ID.

exePath

string

Process binary path.

cmdline

string

Process full command line.

user

string

User running the process.

attributes

map (key: string, value: string)

Process extended attributes.

An object containing a list of "key": value pairs. Example: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

RuntimeNetworkInfo

Runtime networking information.

JSON representation
{
  "netstat": string,
  "connections": {
    object (NetworkConnectionList)
  },
  "netstatTime": {
    object (DateTime)
  }
}
Fields
netstat

string

Netstat (raw, OS-agnostic).

connections

object (NetworkConnectionList)

Network connections.

netstatTime

object (DateTime)

Netstat time collected.

NetworkConnectionList

Network connection list.

JSON representation
{
  "entries": [
    {
      object (NetworkConnection)
    }
  ]
}
Fields
entries[]

object (NetworkConnection)

NetworkConnection

JSON representation
{
  "protocol": string,
  "localIpAddress": string,
  "localPort": integer,
  "remoteIpAddress": string,
  "remotePort": integer,
  "state": string,
  "pid": string,
  "processName": string
}
Fields
protocol

string

Connection protocol (e.g. TCP/UDP).

localIpAddress

string

Local IP address.

localPort

integer

Local port.

remoteIpAddress

string

Remote IP address.

remotePort

integer

Remote port.

state

string

Connection state (e.g. CONNECTED).

pid

string (int64 format)

Process ID.

processName

string

Process or service name.

DateTime

Represents civil time (or occasionally physical time).

This type can represent a civil time in one of a few possible ways:

  • When utcOffset is set and timeZone is unset: a civil time on a calendar day with a particular offset from UTC.
  • When timeZone is set and utcOffset is unset: a civil time on a calendar day in a particular time zone.
  • When neither timeZone nor utcOffset is set: a civil time on a calendar day in local time.

The date is relative to the Proleptic Gregorian Calendar.

If year is 0, the DateTime is considered not to have a specific year. month and day must have valid, non-zero values.

This type may also be used to represent a physical time if all the date and time fields are set and either case of the time_offset oneof is set. Consider using Timestamp message for physical time instead. If your use case also would like to store the user's timezone, that can be done in another field.

This type is more flexible than some applications may want. Make sure to document and validate your application's limitations.

JSON representation
{
  "year": integer,
  "month": integer,
  "day": integer,
  "hours": integer,
  "minutes": integer,
  "seconds": integer,
  "nanos": integer,

  // Union field time_offset can be only one of the following:
  "utcOffset": string,
  "timeZone": {
    object (TimeZone)
  }
  // End of list of possible types for union field time_offset.
}
Fields
year

integer

Optional. Year of date. Must be from 1 to 9999, or 0 if specifying a datetime without a year.

month

integer

Required. Month of year. Must be from 1 to 12.

day

integer

Required. Day of month. Must be from 1 to 31 and valid for the year and month.

hours

integer

Required. Hours of day in 24 hour format. Should be from 0 to 23. An API may choose to allow the value "24:00:00" for scenarios like business closing time.

minutes

integer

Required. Minutes of hour of day. Must be from 0 to 59.

seconds

integer

Required. Seconds of minutes of the time. Must normally be from 0 to 59. An API may allow the value 60 if it allows leap-seconds.

nanos

integer

Required. Fractions of seconds in nanoseconds. Must be from 0 to 999,999,999.

Union field time_offset. Optional. Specifies either the UTC offset or the time zone of the DateTime. Choose carefully between them, considering that time zone data may change in the future (for example, a country modifies their DST start/end dates, and future DateTimes in the affected range had already been stored). If omitted, the DateTime is considered to be in local time. time_offset can be only one of the following:
utcOffset

string (Duration format)

UTC offset. Must be whole seconds, between -18 hours and +18 hours. For example, a UTC offset of -4:00 would be represented as { seconds: -14400 }.

A duration in seconds with up to nine fractional digits, terminated by 's'. Example: "3.5s".

timeZone

object (TimeZone)

Time zone.

TimeZone

Represents a time zone from the IANA Time Zone Database.

JSON representation
{
  "id": string,
  "version": string
}
Fields
id

string

IANA Time Zone Database time zone, e.g. "America/New_York".

version

string

Optional. IANA Time Zone Database version number, e.g. "2019a".

Date

Represents a whole or partial calendar date, such as a birthday. The time of day and time zone are either specified elsewhere or are insignificant. The date is relative to the Gregorian Calendar. This can represent one of the following:

  • A full date, with non-zero year, month, and day values.
  • A month and day, with a zero year (for example, an anniversary).
  • A year on its own, with a zero month and a zero day.
  • A year and month, with a zero day (for example, a credit card expiration date).

Related types:

JSON representation
{
  "year": integer,
  "month": integer,
  "day": integer
}
Fields
year

integer

Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.

month

integer

Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.

day

integer

Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.

GuestInstalledApplicationList

Guest installed application list.

JSON representation
{
  "entries": [
    {
      object (GuestInstalledApplication)
    }
  ]
}
Fields
entries[]

object (GuestInstalledApplication)

GuestInstalledApplication

Guest installed application information.

JSON representation
{
  "name": string,
  "vendor": string,
  "time": string,
  "path": string,
  "version": string
}
Fields
name

string

Installed application name .

vendor

string

Installed application vendor.

time

string

Date application was installed.

path

string

Source path.

version

string

Installed application version.

PerformanceDetails

Information about the performance.

JSON representation
{
  "memoryUsage": {
    object (MemoryUsage)
  },
  "cpuUsage": {
    object (CpuUsage)
  },
  "diskPerformance": {
    object (DiskPerformance)
  },
  "networkPerformance": {
    object (NetworkPerformance)
  }
}
Fields
memoryUsage

object (MemoryUsage)

Memory usage information.

cpuUsage

object (CpuUsage)

CPU usage information.

diskPerformance

object (DiskPerformance)

Disk Performance information.

networkPerformance

object (NetworkPerformance)

Network Performance information.

MemoryUsage

Information about memory usage.

JSON representation
{
  "sampleTime": {
    object (Date)
  },
  "memoryUtilizedPercentage": number
}
Fields
sampleTime

object (Date)

Date memory sample collected.

memoryUtilizedPercentage

number

Percentage of system memory utilized.

CpuUsage

Information about CPU usage.

JSON representation
{
  "sampleTime": {
    object (Date)
  },
  "cpuUtilizedPercentage": number
}
Fields
sampleTime

object (Date)

Date cpu sample collected.

cpuUtilizedPercentage

number

Percentage of cpu utilized

DiskPerformance

Information about disk performance.

JSON representation
{
  "diskIops": number,
  "diskReadsPerSecond": number,
  "diskWritesPerSecond": number
}
Fields
diskIops

number

Disk IOPS.

diskReadsPerSecond

number

Disk reads per second.

diskWritesPerSecond

number

Disk writes per second.

NetworkPerformance

Information about network performance.

JSON representation
{
  "networkSentBytesPerSecond": number,
  "networkReceivedBytesPerSecond": number
}
Fields
networkSentBytesPerSecond

number

Bytes sent per second.

networkReceivedBytesPerSecond

number

Bytes received per second.

Methods

create

Creates a new Asset in a given project and location.

delete

Deletes a single Asset.

get

Gets details of a single Asset.

list

Lists Assets in a given project and location.

patch

Updates the parameters of a single Asset.

reportAssetFrame
(deprecated)

Deprecated, Reports a set of frames.

reportAssetFrames

Reports a set of frames.