Package google.cloud.osconfig.v1

Index

• Inventory (message)
• Inventory.Item (message)
• Inventory.Item.OriginType (enum)
• Inventory.Item.Type (enum)
• Inventory.OsInfo (message)
• Inventory.SoftwarePackage (message)
• Inventory.VersionedPackage (message)
• Inventory.WindowsApplication (message)
• Inventory.WindowsQuickFixEngineeringPackage (message)
• Inventory.WindowsUpdatePackage (message)
• Inventory.WindowsUpdatePackage.WindowsUpdateCategory (message)
• Inventory.ZypperPatch (message)

Inventory

This API resource represents the available inventory data for a Compute Engine virtual machine (VM) instance at a given point in time.

You can use this API resource to determine the inventory data of your VM.

For more information, see Information provided by OS inventory management.

Fields
name	string Output only. The Inventory API resource name. Format: projects/{project_number}/locations/{location}/instances/{instance_id}/inventory
os_info	OsInfo Base level operating system information for the VM.
items	map<string, Item> Inventory items related to the VM keyed by an opaque unique identifier for each inventory item. The identifier is unique to each distinct and addressable inventory item and will change, when there is a new package version.
update_time	Timestamp Output only. Timestamp of the last reported inventory for the VM.

Item

A single piece of inventory on a VM.

Fields
id	string Identifier for this item, unique across items for this VM.
origin_type	OriginType The origin of this inventory item.
create_time	Timestamp When this inventory item was first detected.
update_time	Timestamp When this inventory item was last modified.
type	Type The specific type of inventory, correlating to its specific details.
Union field details. Specific details of this inventory item based on its type. details can be only one of the following:
installed_package	SoftwarePackage Software package present on the VM instance.
available_package	SoftwarePackage Software package available to be installed on the VM instance.

OriginType

The origin of a specific inventory item.

Enums
ORIGIN_TYPE_UNSPECIFIED	Invalid. An origin type must be specified.
INVENTORY_REPORT	This inventory item was discovered as the result of the agent reporting inventory via the reporting API.

Type

The different types of inventory that are tracked on a VM.

Enums
TYPE_UNSPECIFIED	Invalid. An type must be specified.
INSTALLED_PACKAGE	This represents a package that is installed on the VM.
AVAILABLE_PACKAGE	This represents an update that is available for a package.

OsInfo

Operating system information for the VM.

Fields
hostname	string The VM hostname.
long_name	string The operating system long name. For example 'Debian GNU/Linux 9' or 'Microsoft Window Server 2019 Datacenter'.
short_name	string The operating system short name. For example, 'windows' or 'debian'.
version	string The version of the operating system.
architecture	string The system architecture of the operating system.
kernel_version	string The kernel version of the operating system.
kernel_release	string The kernel release of the operating system.
osconfig_agent_version	string The current version of the OS Config agent running on the VM.

SoftwarePackage

Software package information of the operating system.

Fields
Union field details. Information about the different types of software packages. details can be only one of the following:
yum_package	VersionedPackage Yum package info. For details about the yum package manager, see https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/6/html/deployment_guide/ch-yum.
apt_package	VersionedPackage Details of an APT package. For details about the apt package manager, see https://wiki.debian.org/Apt.
zypper_package	VersionedPackage Details of a Zypper package. For details about the Zypper package manager, see https://en.opensuse.org/SDB:Zypper_manual.
googet_package	VersionedPackage Details of a Googet package. For details about the googet package manager, see https://github.com/google/googet.
zypper_patch	ZypperPatch Details of a Zypper patch. For details about the Zypper package manager, see https://en.opensuse.org/SDB:Zypper_manual.
wua_package	WindowsUpdatePackage Details of a Windows Update package. See https://docs.microsoft.com/en-us/windows/win32/api/_wua/ for information about Windows Update.
qfe_package	WindowsQuickFixEngineeringPackage Details of a Windows Quick Fix engineering package. See https://docs.microsoft.com/en-us/windows/win32/cimwin32prov/win32-quickfixengineering for info in Windows Quick Fix Engineering.
cos_package	VersionedPackage Details of a COS package.
windows_application	WindowsApplication Details of Windows Application.

VersionedPackage

Information related to the a standard versioned package. This includes package info for APT, Yum, Zypper, and Googet package managers.

Fields
package_name	string The name of the package.
architecture	string The system architecture this package is intended for.
version	string The version of the package.

WindowsApplication

Contains information about a Windows application that is retrieved from the Windows Registry. For more information about these fields, see: https://docs.microsoft.com/en-us/windows/win32/msi/uninstall-registry-key

Fields
display_name	string The name of the application or product.
display_version	string The version of the product or application in string format.
publisher	string The name of the manufacturer for the product or application.
install_date	Date The last time this product received service. The value of this property is replaced each time a patch is applied or removed from the product or the command-line option is used to repair the product.
help_link	string The internet address for technical support.

WindowsQuickFixEngineeringPackage

Information related to a Quick Fix Engineering package. Fields are taken from Windows QuickFixEngineering Interface and match the source names: https://docs.microsoft.com/en-us/windows/win32/cimwin32prov/win32-quickfixengineering

Fields
caption	string A short textual description of the QFE update.
description	string A textual description of the QFE update.
hot_fix_id	string Unique identifier associated with a particular QFE update.
install_time	Timestamp Date that the QFE update was installed. Mapped from installed_on field.

WindowsUpdatePackage

Details related to a Windows Update package. Field data and names are taken from Windows Update API IUpdate Interface: https://docs.microsoft.com/en-us/windows/win32/api/_wua/ Descriptive fields like title, and description are localized based on the locale of the VM being updated.

Fields
title	string The localized title of the update package.
description	string The localized description of the update package.
categories[]	WindowsUpdateCategory The categories that are associated with this update package.
kb_article_ids[]	string A collection of Microsoft Knowledge Base article IDs that are associated with the update package.
support_url	string A hyperlink to the language-specific support information for the update.
more_info_urls[]	string A collection of URLs that provide more information about the update package.
update_id	string Gets the identifier of an update package. Stays the same across revisions.
revision_number	int32 The revision number of this update package.
last_deployment_change_time	Timestamp The last published date of the update, in (UTC) date and time.

WindowsUpdateCategory

Categories specified by the Windows Update.

Fields
id	string The identifier of the windows update category.
name	string The name of the windows update category.

ZypperPatch

Details related to a Zypper Patch.

Fields
patch_name	string The name of the patch.
category	string The category of the patch.
severity	string The severity specified for this patch
summary	string Any summary information provided about this patch.