aggregateValues(parent, body=None, x__xgafv=None)
Aggregates the requested fields based on provided function.
batchDelete(parent, body=None, x__xgafv=None)
Deletes list of Assets.
batchUpdate(parent, body=None, x__xgafv=None)
Updates the parameters of a list of assets.
Close httplib2 connections.
delete(name, requestId=None, x__xgafv=None)
Deletes an asset.
get(name, view=None, x__xgafv=None)
Gets the details of an asset.
list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)
Lists all the assets in a given project and location.
Retrieves the next page of results.
patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)
Updates the parameters of an asset.
reportAssetFrames(parent, body=None, source=None, x__xgafv=None)
Reports a set of frames.
aggregateValues(parent, body=None, x__xgafv=None)
Aggregates the requested fields based on provided function.
Args:
parent: string, Required. Parent value for `AggregateAssetsValuesRequest`. (required)
body: object, The request body.
The object takes the form of:
{ # A request to aggregate one or more values.
"aggregations": [ # Array of aggregations to perform. Up to 25 aggregations can be defined.
{ # Message describing an aggregation. The message includes the aggregation type, parameters, and the field on which to perform the aggregation.
"count": { # Object count. # Count the number of matching objects.
},
"field": "A String", # The name of the field on which to aggregate.
"frequency": { # Frequency distribution of all field values. # Creates a frequency distribution of all field values.
},
"histogram": { # Histogram of bucketed assets counts by field value. # Creates a bucketed histogram of field values.
"lowerBounds": [ # Lower bounds of buckets. The response will contain `n+1` buckets for `n` bounds. The first bucket will count all assets for which the field value is smaller than the first bound. Subsequent buckets will count assets for which the field value is greater or equal to a lower bound and smaller than the next one. The last bucket will count assets for which the field value is greater or equal to the final lower bound. You can define up to 20 lower bounds.
3.14,
],
},
"sum": { # Sum of field values. # Sum over a numeric field.
},
},
],
"filter": "A String", # Optional. The aggregation will be performed on assets that match the provided filter.
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A response to a request to aggregated assets values.
"results": [ # The aggregation results.
{ # Message describing a result of an aggregation.
"count": { # The result of a count aggregation.
"value": "A String",
},
"field": "A String",
"frequency": { # The result of a frequency distribution aggregation.
"values": {
"a_key": "A String",
},
},
"histogram": { # The result of a bucketed histogram aggregation.
"buckets": [ # Buckets in the histogram. There will be `n+1` buckets matching `n` lower bounds in the request. The first bucket will be from -infinity to the first bound. Subsequent buckets will be between one bound and the next. The final bucket will be from the final bound to infinity.
{ # A histogram bucket with a lower and upper bound, and a count of items with a field value between those bounds. The lower bound is inclusive and the upper bound is exclusive. Lower bound may be -infinity and upper bound may be infinity.
"count": "A String", # Count of items in the bucket.
"lowerBound": 3.14, # Lower bound - inclusive.
"upperBound": 3.14, # Upper bound - exclusive.
},
],
},
"sum": { # The result of a sum aggregation.
"value": 3.14,
},
},
],
}
batchDelete(parent, body=None, x__xgafv=None)
Deletes list of Assets.
Args:
parent: string, Required. Parent value for batch asset delete. (required)
body: object, The request body.
The object takes the form of:
{ # A request to delete a list of asset.
"allowMissing": True or False, # Optional. When this value is set to `true` the request is a no-op for non-existing assets. See https://google.aip.dev/135#delete-if-existing for additional details. Default value is `false`.
"names": [ # Required. The IDs of the assets to delete. A maximum of 1000 assets can be deleted in a batch. Format: projects/{project}/locations/{location}/assets/{name}.
"A String",
],
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
}
batchUpdate(parent, body=None, x__xgafv=None)
Updates the parameters of a list of assets.
Args:
parent: string, Required. Parent value for batch asset update. (required)
body: object, The request body.
The object takes the form of:
{ # A request to update a list of assets.
"requests": [ # Required. The request message specifying the resources to update. A maximum of 1000 assets can be modified in a batch.
{ # A request to update an asset.
"asset": { # An asset represents a resource in your environment. Asset types include virtual machines and databases. # Required. The resource being updated.
"assignedGroups": [ # Output only. The list of groups that the asset is assigned to.
"A String",
],
"attributes": { # Generic asset attributes.
"a_key": "A String",
},
"createTime": "A String", # Output only. The timestamp when the asset was created.
"insightList": { # Message containing insights list. # Output only. The list of insights associated with the asset.
"insights": [ # Output only. Insights of the list.
{ # An insight about an asset.
"genericInsight": { # A generic insight about an asset. # Output only. A generic insight about an asset
"additionalInformation": [ # Output only. Additional information about the insight, each entry can be a logical entry and must make sense if it is displayed with line breaks between each entry. Text can contain md style links.
"A String",
],
"defaultMessage": "A String", # Output only. In case message_code is not yet known by the client default_message will be the message to be used instead.
"messageId": "A String", # Output only. Represents a globally unique message id for this insight, can be used for localization purposes, in case message_code is not yet known by the client use default_message instead.
},
"migrationInsight": { # An insight about potential migrations for an asset. # Output only. An insight about potential migrations for an asset.
"computeEngineTarget": { # Compute engine migration target. # Output only. A Google Compute Engine target.
"shape": { # Compute Engine target shape descriptor. # Description of the suggested shape for the migration target.
"logicalCoreCount": 42, # Output only. Number of logical cores.
"machineType": "A String", # Output only. Compute Engine machine type.
"memoryMb": 42, # Memory in mebibytes.
"physicalCoreCount": 42, # Number of physical cores.
"series": "A String", # Output only. Compute Engine machine series.
"storage": [ # Output only. Compute Engine storage. Never empty.
{ # Compute Engine storage option descriptor.
"sizeGb": 42, # Output only. Disk size in GiB.
"type": "A String", # Output only. Disk type backing the storage.
},
],
},
},
"fit": { # Describes the fit level of an asset for migration to a specific target. # Output only. Description of how well the asset this insight is associated with fits the proposed migration.
"fitLevel": "A String", # Output only. Fit level.
},
},
},
],
"updateTime": "A String", # Output only. Update timestamp.
},
"labels": { # Labels as key value pairs.
"a_key": "A String",
},
"machineDetails": { # Details of a machine. # Output only. Asset information specific for virtual and physical machines.
"architecture": { # Details of the machine architecture. # Architecture details (vendor, CPU architecture).
"bios": { # Details about the BIOS. # BIOS Details.
"biosName": "A String", # BIOS name. This fields is deprecated. Please use the `id` field instead.
"id": "A String", # BIOS ID.
"manufacturer": "A String", # BIOS manufacturer.
"releaseDate": { # 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: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # BIOS release date.
"day": 42, # 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.
"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
"smbiosUuid": "A String", # SMBIOS UUID.
"version": "A String", # BIOS version.
},
"cpuArchitecture": "A String", # CPU architecture, e.g., "x64-based PC", "x86_64", "i686" etc.
"cpuName": "A String", # CPU name, e.g., "Intel Xeon E5-2690", "AMD EPYC 7571" etc.
"cpuSocketCount": 42, # Number of processor sockets allocated to the machine.
"cpuThreadCount": 42, # Deprecated: use MachineDetails.core_count instead. Number of CPU threads allocated to the machine.
"firmwareType": "A String", # Firmware type.
"hyperthreading": "A String", # CPU hyper-threading support.
"vendor": "A String", # Hardware vendor.
},
"coreCount": 42, # Number of logical CPU cores in the machine. Must be non-negative.
"createTime": "A String", # Machine creation time.
"disks": { # Details of machine disks. # Disk details.
"disks": { # VM disks. # List of disks.
"entries": [ # Disk entries.
{ # Single disk entry.
"capacityBytes": "A String", # Disk capacity.
"diskLabel": "A String", # Disk label.
"diskLabelType": "A String", # Disk label type (e.g. BIOS/GPT)
"freeBytes": "A String", # Disk free space.
"hwAddress": "A String", # Disk hardware address (e.g. 0:1 for SCSI).
"interfaceType": "A String", # Disks interface type.
"partitions": { # Disk partition list. # Partition layout.
"entries": [ # Partition entries.
{ # Disk Partition details.
"capacityBytes": "A String", # Partition capacity.
"fileSystem": "A String", # Partition file system.
"freeBytes": "A String", # Partition free space.
"mountPoint": "A String", # Mount pount (Linux/Windows) or drive letter (Windows).
"subPartitions": # Object with schema name: DiskPartitionList # Sub-partitions.
"type": "A String", # Partition type.
"uuid": "A String", # Partition UUID.
},
],
},
"vmware": { # VMware disk config details. # VMware disk details.
"backingType": "A String", # VMDK backing type.
"rdmCompatibility": "A String", # RDM compatibility mode.
"shared": True or False, # Is VMDK shared with other VMs.
"vmdkMode": "A String", # VMDK disk mode.
},
},
],
},
"totalCapacityBytes": "A String", # Disk total Capacity.
"totalFreeBytes": "A String", # Total disk free space.
},
"guestOs": { # Information from Guest-level collections. # Guest OS information.
"config": { # Guest OS config information. # OS and app configuration.
"fstab": { # Fstab content. # Mount list (Linux fstab).
"entries": [ # Fstab entries.
{ # Single fstab entry.
"file": "A String", # The mount point for the filesystem.
"freq": 42, # Used by dump to determine which filesystems need to be dumped.
"mntops": "A String", # Mount options associated with the filesystem.
"passno": 42, # Used by the fsck(8) program to determine the order in which filesystem checks are done at reboot time.
"spec": "A String", # The block special device or remote filesystem to be mounted.
"vfstype": "A String", # The type of the filesystem.
},
],
},
"hosts": { # Hosts content. # Hosts file (/etc/hosts).
"entries": [ # Hosts entries.
{ # Single /etc/hosts entry.
"hostNames": [ # List of host names / aliases.
"A String",
],
"ip": "A String", # IP (raw, IPv4/6 agnostic).
},
],
},
"issue": "A String", # OS issue (typically /etc/issue in Linux).
"nfsExports": { # NFS exports. # NFS exports.
"entries": [ # NFS export entries.
{ # NFS export.
"exportDirectory": "A String", # The directory being exported.
"hosts": [ # The hosts or networks to which the export is being shared.
"A String",
],
},
],
},
"selinuxMode": "A String", # Security-Enhanced Linux (SELinux) mode.
},
"family": "A String", # What family the OS belong to, if known.
"osName": "A String", # The name of the operating system.
"runtime": { # Guest OS runtime information. # Runtime information.
"domain": "A String", # Domain, e.g. c.stratozone-development.internal.
"installedApps": { # Guest installed application list. # Installed applications information.
"entries": [ # Application entries.
{ # Guest installed application information.
"applicationName": "A String", # Installed application name.
"installTime": "A String", # The time when the application was installed.
"licenses": [ # License strings associated with the installed application.
"A String",
],
"path": "A String", # Source path.
"vendor": "A String", # Installed application vendor.
"version": "A String", # Installed application version.
},
],
},
"lastBootTime": "A String", # Last time the OS was booted.
"machineName": "A String", # Machine name.
"network": { # Runtime networking information. # Runtime network information (connections, ports).
"connections": { # Network connection list. # Network connections.
"entries": [ # Network connection entries.
{
"localIpAddress": "A String", # Local IP address.
"localPort": 42, # Local port.
"pid": "A String", # Process ID.
"processName": "A String", # Process or service name.
"protocol": "A String", # Connection protocol (e.g. TCP/UDP).
"remoteIpAddress": "A String", # Remote IP address.
"remotePort": 42, # Remote port.
"state": "A String", # Network connection state.
},
],
},
"scanTime": "A String", # Time of the last network scan.
},
"openFileList": { # Open file list. # Open files information.
"entries": [ # Open file details entries.
{ # Open file Information.
"command": "A String", # Opened file command.
"filePath": "A String", # Opened file file path.
"fileType": "A String", # Opened file file type.
"user": "A String", # Opened file user.
},
],
},
"processes": { # List of running guest OS processes. # Running processes.
"entries": [ # Running process entries.
{ # Guest OS running process details.
"attributes": { # Process extended attributes.
"a_key": "A String",
},
"cmdline": "A String", # Process full command line.
"exePath": "A String", # Process binary path.
"pid": "A String", # Process ID.
"user": "A String", # User running the process.
},
],
},
"services": { # List of running guest OS services. # Running background services.
"entries": [ # Running service entries.
{ # Guest OS running service details.
"cmdline": "A String", # Service command line.
"exePath": "A String", # Service binary path.
"pid": "A String", # Service pid.
"serviceName": "A String", # Service name.
"startMode": "A String", # Service start mode (OS-agnostic).
"state": "A String", # Service state (OS-agnostic).
},
],
},
},
"version": "A String", # The version of the operating system.
},
"machineName": "A String", # Machine name.
"memoryMb": 42, # The amount of memory in the machine. Must be non-negative.
"network": { # Details of network adapters and settings. # Network details.
"adapters": { # List of network adapters. # List of network adapters.
"entries": [ # Network adapter entries.
{ # Details of network adapter.
"adapterType": "A String", # Network adapter type (e.g. VMXNET3).
"addresses": { # List of allocated/assigned network addresses. # NetworkAddressList
"entries": [ # Network address entries.
{ # Details of network address.
"assignment": "A String", # Whether DHCP is used to assign addresses.
"bcast": "A String", # Broadcast address.
"fqdn": "A String", # Fully qualified domain name.
"ipAddress": "A String", # Assigned or configured IP Address.
"subnetMask": "A String", # Subnet mask.
},
],
},
"macAddress": "A String", # MAC address.
},
],
},
"primaryIpAddress": "A String", # The primary IP address of the machine.
"primaryMacAddress": "A String", # MAC address of the machine. This property is used to uniqly identify the machine.
"publicIpAddress": "A String", # The public IP address of the machine.
},
"platform": { # Information about the platform. # Platform specific information.
"awsEc2Details": { # AWS EC2 specific details. # AWS EC2 specific details.
"hyperthreading": "A String", # Optional. Whether the machine is hyperthreaded.
"location": "A String", # The location of the machine in the AWS format.
"machineTypeLabel": "A String", # AWS platform's machine type label.
},
"azureVmDetails": { # Azure VM specific details. # Azure VM specific details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # The location of the machine in the Azure format.
"machineTypeLabel": "A String", # Azure platform's machine type label.
"provisioningState": "A String", # Azure platform's provisioning state.
},
"genericDetails": { # Generic platform details. # Generic platform details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # Free text representation of the machine location. The format of this field should not be relied on. Different VMs in the same location may have different string values for this field.
},
"physicalDetails": { # Platform specific details for Physical Machines. # Physical machines platform details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # Free text representation of the machine location. The format of this field should not be relied on. Different machines in the same location may have different string values for this field.
},
"vmwareDetails": { # VMware specific details. # VMware specific details.
"esxHyperthreading": "A String", # Whether the ESX is hyperthreaded.
"esxVersion": "A String", # ESX version.
"osid": "A String", # VMware os enum - https://vdc-repo.vmware.com/vmwb-repository/dcr-public/da47f910-60ac-438b-8b9b-6122f4d14524/16b7274a-bf8b-4b4c-a05e-746f2aa93c8c/doc/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html.
"vcenterFolder": "A String", # Folder name in vCenter where asset resides.
"vcenterUri": "A String", # vCenter URI used in collection.
"vcenterVersion": "A String", # vCenter version.
"vcenterVmId": "A String", # vCenter VM ID.
},
},
"powerState": "A String", # Power state of the machine.
"uuid": "A String", # Machine unique identifier.
},
"name": "A String", # Output only. The full name of the asset.
"performanceData": { # Performance data for an asset. # Output only. Performance data for the asset.
"dailyResourceUsageAggregations": [ # Daily resource usage aggregations. Contains all of the data available for an asset, up to the last 420 days. Aggregations are sorted from oldest to most recent.
{ # Usage data aggregation for a single day.
"cpu": { # Statistical aggregation of CPU usage. # CPU usage.
"utilizationPercentage": { # Statistical aggregation of samples for a single resource usage. # CPU utilization percentage.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
"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: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Aggregation date. Day boundaries are at midnight UTC.
"day": 42, # 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.
"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
"disk": { # Statistical aggregation of disk usage. # Disk usage.
"iops": { # Statistical aggregation of samples for a single resource usage. # Disk I/O operations per second.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
"memory": { # Statistical aggregation of memory usage. # Memory usage.
"utilizationPercentage": { # Statistical aggregation of samples for a single resource usage. # Memory utilization percentage.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
"network": { # Statistical aggregation of network usage. # Network usage.
"egressBps": { # Statistical aggregation of samples for a single resource usage. # Network egress in B/s.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
"ingressBps": { # Statistical aggregation of samples for a single resource usage. # Network ingress in B/s.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
},
],
},
"sources": [ # Output only. The list of sources contributing to the asset.
"A String",
],
"updateTime": "A String", # Output only. The timestamp when the asset was last updated.
},
"requestId": "A String", # Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
"updateMask": "A String", # Required. Field mask is used to specify the fields to be overwritten in the `Asset` resource by the update. The values specified in the `update_mask` field are relative to the resource, not the full request. A field will be overwritten if it is in the mask. A single * value in the mask lets you to overwrite all fields.
},
],
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response for updating a list of assets.
"assets": [ # Update asset content. The content only includes values after field mask being applied.
{ # An asset represents a resource in your environment. Asset types include virtual machines and databases.
"assignedGroups": [ # Output only. The list of groups that the asset is assigned to.
"A String",
],
"attributes": { # Generic asset attributes.
"a_key": "A String",
},
"createTime": "A String", # Output only. The timestamp when the asset was created.
"insightList": { # Message containing insights list. # Output only. The list of insights associated with the asset.
"insights": [ # Output only. Insights of the list.
{ # An insight about an asset.
"genericInsight": { # A generic insight about an asset. # Output only. A generic insight about an asset
"additionalInformation": [ # Output only. Additional information about the insight, each entry can be a logical entry and must make sense if it is displayed with line breaks between each entry. Text can contain md style links.
"A String",
],
"defaultMessage": "A String", # Output only. In case message_code is not yet known by the client default_message will be the message to be used instead.
"messageId": "A String", # Output only. Represents a globally unique message id for this insight, can be used for localization purposes, in case message_code is not yet known by the client use default_message instead.
},
"migrationInsight": { # An insight about potential migrations for an asset. # Output only. An insight about potential migrations for an asset.
"computeEngineTarget": { # Compute engine migration target. # Output only. A Google Compute Engine target.
"shape": { # Compute Engine target shape descriptor. # Description of the suggested shape for the migration target.
"logicalCoreCount": 42, # Output only. Number of logical cores.
"machineType": "A String", # Output only. Compute Engine machine type.
"memoryMb": 42, # Memory in mebibytes.
"physicalCoreCount": 42, # Number of physical cores.
"series": "A String", # Output only. Compute Engine machine series.
"storage": [ # Output only. Compute Engine storage. Never empty.
{ # Compute Engine storage option descriptor.
"sizeGb": 42, # Output only. Disk size in GiB.
"type": "A String", # Output only. Disk type backing the storage.
},
],
},
},
"fit": { # Describes the fit level of an asset for migration to a specific target. # Output only. Description of how well the asset this insight is associated with fits the proposed migration.
"fitLevel": "A String", # Output only. Fit level.
},
},
},
],
"updateTime": "A String", # Output only. Update timestamp.
},
"labels": { # Labels as key value pairs.
"a_key": "A String",
},
"machineDetails": { # Details of a machine. # Output only. Asset information specific for virtual and physical machines.
"architecture": { # Details of the machine architecture. # Architecture details (vendor, CPU architecture).
"bios": { # Details about the BIOS. # BIOS Details.
"biosName": "A String", # BIOS name. This fields is deprecated. Please use the `id` field instead.
"id": "A String", # BIOS ID.
"manufacturer": "A String", # BIOS manufacturer.
"releaseDate": { # 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: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # BIOS release date.
"day": 42, # 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.
"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
"smbiosUuid": "A String", # SMBIOS UUID.
"version": "A String", # BIOS version.
},
"cpuArchitecture": "A String", # CPU architecture, e.g., "x64-based PC", "x86_64", "i686" etc.
"cpuName": "A String", # CPU name, e.g., "Intel Xeon E5-2690", "AMD EPYC 7571" etc.
"cpuSocketCount": 42, # Number of processor sockets allocated to the machine.
"cpuThreadCount": 42, # Deprecated: use MachineDetails.core_count instead. Number of CPU threads allocated to the machine.
"firmwareType": "A String", # Firmware type.
"hyperthreading": "A String", # CPU hyper-threading support.
"vendor": "A String", # Hardware vendor.
},
"coreCount": 42, # Number of logical CPU cores in the machine. Must be non-negative.
"createTime": "A String", # Machine creation time.
"disks": { # Details of machine disks. # Disk details.
"disks": { # VM disks. # List of disks.
"entries": [ # Disk entries.
{ # Single disk entry.
"capacityBytes": "A String", # Disk capacity.
"diskLabel": "A String", # Disk label.
"diskLabelType": "A String", # Disk label type (e.g. BIOS/GPT)
"freeBytes": "A String", # Disk free space.
"hwAddress": "A String", # Disk hardware address (e.g. 0:1 for SCSI).
"interfaceType": "A String", # Disks interface type.
"partitions": { # Disk partition list. # Partition layout.
"entries": [ # Partition entries.
{ # Disk Partition details.
"capacityBytes": "A String", # Partition capacity.
"fileSystem": "A String", # Partition file system.
"freeBytes": "A String", # Partition free space.
"mountPoint": "A String", # Mount pount (Linux/Windows) or drive letter (Windows).
"subPartitions": # Object with schema name: DiskPartitionList # Sub-partitions.
"type": "A String", # Partition type.
"uuid": "A String", # Partition UUID.
},
],
},
"vmware": { # VMware disk config details. # VMware disk details.
"backingType": "A String", # VMDK backing type.
"rdmCompatibility": "A String", # RDM compatibility mode.
"shared": True or False, # Is VMDK shared with other VMs.
"vmdkMode": "A String", # VMDK disk mode.
},
},
],
},
"totalCapacityBytes": "A String", # Disk total Capacity.
"totalFreeBytes": "A String", # Total disk free space.
},
"guestOs": { # Information from Guest-level collections. # Guest OS information.
"config": { # Guest OS config information. # OS and app configuration.
"fstab": { # Fstab content. # Mount list (Linux fstab).
"entries": [ # Fstab entries.
{ # Single fstab entry.
"file": "A String", # The mount point for the filesystem.
"freq": 42, # Used by dump to determine which filesystems need to be dumped.
"mntops": "A String", # Mount options associated with the filesystem.
"passno": 42, # Used by the fsck(8) program to determine the order in which filesystem checks are done at reboot time.
"spec": "A String", # The block special device or remote filesystem to be mounted.
"vfstype": "A String", # The type of the filesystem.
},
],
},
"hosts": { # Hosts content. # Hosts file (/etc/hosts).
"entries": [ # Hosts entries.
{ # Single /etc/hosts entry.
"hostNames": [ # List of host names / aliases.
"A String",
],
"ip": "A String", # IP (raw, IPv4/6 agnostic).
},
],
},
"issue": "A String", # OS issue (typically /etc/issue in Linux).
"nfsExports": { # NFS exports. # NFS exports.
"entries": [ # NFS export entries.
{ # NFS export.
"exportDirectory": "A String", # The directory being exported.
"hosts": [ # The hosts or networks to which the export is being shared.
"A String",
],
},
],
},
"selinuxMode": "A String", # Security-Enhanced Linux (SELinux) mode.
},
"family": "A String", # What family the OS belong to, if known.
"osName": "A String", # The name of the operating system.
"runtime": { # Guest OS runtime information. # Runtime information.
"domain": "A String", # Domain, e.g. c.stratozone-development.internal.
"installedApps": { # Guest installed application list. # Installed applications information.
"entries": [ # Application entries.
{ # Guest installed application information.
"applicationName": "A String", # Installed application name.
"installTime": "A String", # The time when the application was installed.
"licenses": [ # License strings associated with the installed application.
"A String",
],
"path": "A String", # Source path.
"vendor": "A String", # Installed application vendor.
"version": "A String", # Installed application version.
},
],
},
"lastBootTime": "A String", # Last time the OS was booted.
"machineName": "A String", # Machine name.
"network": { # Runtime networking information. # Runtime network information (connections, ports).
"connections": { # Network connection list. # Network connections.
"entries": [ # Network connection entries.
{
"localIpAddress": "A String", # Local IP address.
"localPort": 42, # Local port.
"pid": "A String", # Process ID.
"processName": "A String", # Process or service name.
"protocol": "A String", # Connection protocol (e.g. TCP/UDP).
"remoteIpAddress": "A String", # Remote IP address.
"remotePort": 42, # Remote port.
"state": "A String", # Network connection state.
},
],
},
"scanTime": "A String", # Time of the last network scan.
},
"openFileList": { # Open file list. # Open files information.
"entries": [ # Open file details entries.
{ # Open file Information.
"command": "A String", # Opened file command.
"filePath": "A String", # Opened file file path.
"fileType": "A String", # Opened file file type.
"user": "A String", # Opened file user.
},
],
},
"processes": { # List of running guest OS processes. # Running processes.
"entries": [ # Running process entries.
{ # Guest OS running process details.
"attributes": { # Process extended attributes.
"a_key": "A String",
},
"cmdline": "A String", # Process full command line.
"exePath": "A String", # Process binary path.
"pid": "A String", # Process ID.
"user": "A String", # User running the process.
},
],
},
"services": { # List of running guest OS services. # Running background services.
"entries": [ # Running service entries.
{ # Guest OS running service details.
"cmdline": "A String", # Service command line.
"exePath": "A String", # Service binary path.
"pid": "A String", # Service pid.
"serviceName": "A String", # Service name.
"startMode": "A String", # Service start mode (OS-agnostic).
"state": "A String", # Service state (OS-agnostic).
},
],
},
},
"version": "A String", # The version of the operating system.
},
"machineName": "A String", # Machine name.
"memoryMb": 42, # The amount of memory in the machine. Must be non-negative.
"network": { # Details of network adapters and settings. # Network details.
"adapters": { # List of network adapters. # List of network adapters.
"entries": [ # Network adapter entries.
{ # Details of network adapter.
"adapterType": "A String", # Network adapter type (e.g. VMXNET3).
"addresses": { # List of allocated/assigned network addresses. # NetworkAddressList
"entries": [ # Network address entries.
{ # Details of network address.
"assignment": "A String", # Whether DHCP is used to assign addresses.
"bcast": "A String", # Broadcast address.
"fqdn": "A String", # Fully qualified domain name.
"ipAddress": "A String", # Assigned or configured IP Address.
"subnetMask": "A String", # Subnet mask.
},
],
},
"macAddress": "A String", # MAC address.
},
],
},
"primaryIpAddress": "A String", # The primary IP address of the machine.
"primaryMacAddress": "A String", # MAC address of the machine. This property is used to uniqly identify the machine.
"publicIpAddress": "A String", # The public IP address of the machine.
},
"platform": { # Information about the platform. # Platform specific information.
"awsEc2Details": { # AWS EC2 specific details. # AWS EC2 specific details.
"hyperthreading": "A String", # Optional. Whether the machine is hyperthreaded.
"location": "A String", # The location of the machine in the AWS format.
"machineTypeLabel": "A String", # AWS platform's machine type label.
},
"azureVmDetails": { # Azure VM specific details. # Azure VM specific details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # The location of the machine in the Azure format.
"machineTypeLabel": "A String", # Azure platform's machine type label.
"provisioningState": "A String", # Azure platform's provisioning state.
},
"genericDetails": { # Generic platform details. # Generic platform details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # Free text representation of the machine location. The format of this field should not be relied on. Different VMs in the same location may have different string values for this field.
},
"physicalDetails": { # Platform specific details for Physical Machines. # Physical machines platform details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # Free text representation of the machine location. The format of this field should not be relied on. Different machines in the same location may have different string values for this field.
},
"vmwareDetails": { # VMware specific details. # VMware specific details.
"esxHyperthreading": "A String", # Whether the ESX is hyperthreaded.
"esxVersion": "A String", # ESX version.
"osid": "A String", # VMware os enum - https://vdc-repo.vmware.com/vmwb-repository/dcr-public/da47f910-60ac-438b-8b9b-6122f4d14524/16b7274a-bf8b-4b4c-a05e-746f2aa93c8c/doc/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html.
"vcenterFolder": "A String", # Folder name in vCenter where asset resides.
"vcenterUri": "A String", # vCenter URI used in collection.
"vcenterVersion": "A String", # vCenter version.
"vcenterVmId": "A String", # vCenter VM ID.
},
},
"powerState": "A String", # Power state of the machine.
"uuid": "A String", # Machine unique identifier.
},
"name": "A String", # Output only. The full name of the asset.
"performanceData": { # Performance data for an asset. # Output only. Performance data for the asset.
"dailyResourceUsageAggregations": [ # Daily resource usage aggregations. Contains all of the data available for an asset, up to the last 420 days. Aggregations are sorted from oldest to most recent.
{ # Usage data aggregation for a single day.
"cpu": { # Statistical aggregation of CPU usage. # CPU usage.
"utilizationPercentage": { # Statistical aggregation of samples for a single resource usage. # CPU utilization percentage.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
"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: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Aggregation date. Day boundaries are at midnight UTC.
"day": 42, # 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.
"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
"disk": { # Statistical aggregation of disk usage. # Disk usage.
"iops": { # Statistical aggregation of samples for a single resource usage. # Disk I/O operations per second.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
"memory": { # Statistical aggregation of memory usage. # Memory usage.
"utilizationPercentage": { # Statistical aggregation of samples for a single resource usage. # Memory utilization percentage.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
"network": { # Statistical aggregation of network usage. # Network usage.
"egressBps": { # Statistical aggregation of samples for a single resource usage. # Network egress in B/s.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
"ingressBps": { # Statistical aggregation of samples for a single resource usage. # Network ingress in B/s.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
},
],
},
"sources": [ # Output only. The list of sources contributing to the asset.
"A String",
],
"updateTime": "A String", # Output only. The timestamp when the asset was last updated.
},
],
}
close()
Close httplib2 connections.
delete(name, requestId=None, x__xgafv=None)
Deletes an asset.
Args:
name: string, Required. Name of the resource. (required)
requestId: string, Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes after the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); }
}
get(name, view=None, x__xgafv=None)
Gets the details of an asset.
Args:
name: string, Required. Name of the resource. (required)
view: string, View of the assets. Defaults to BASIC.
Allowed values
ASSET_VIEW_UNSPECIFIED - The asset view is not specified. The API displays the basic view by default.
ASSET_VIEW_BASIC - The asset view includes only basic metadata of the asset.
ASSET_VIEW_FULL - The asset view includes all the metadata of an asset and performance data.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # An asset represents a resource in your environment. Asset types include virtual machines and databases.
"assignedGroups": [ # Output only. The list of groups that the asset is assigned to.
"A String",
],
"attributes": { # Generic asset attributes.
"a_key": "A String",
},
"createTime": "A String", # Output only. The timestamp when the asset was created.
"insightList": { # Message containing insights list. # Output only. The list of insights associated with the asset.
"insights": [ # Output only. Insights of the list.
{ # An insight about an asset.
"genericInsight": { # A generic insight about an asset. # Output only. A generic insight about an asset
"additionalInformation": [ # Output only. Additional information about the insight, each entry can be a logical entry and must make sense if it is displayed with line breaks between each entry. Text can contain md style links.
"A String",
],
"defaultMessage": "A String", # Output only. In case message_code is not yet known by the client default_message will be the message to be used instead.
"messageId": "A String", # Output only. Represents a globally unique message id for this insight, can be used for localization purposes, in case message_code is not yet known by the client use default_message instead.
},
"migrationInsight": { # An insight about potential migrations for an asset. # Output only. An insight about potential migrations for an asset.
"computeEngineTarget": { # Compute engine migration target. # Output only. A Google Compute Engine target.
"shape": { # Compute Engine target shape descriptor. # Description of the suggested shape for the migration target.
"logicalCoreCount": 42, # Output only. Number of logical cores.
"machineType": "A String", # Output only. Compute Engine machine type.
"memoryMb": 42, # Memory in mebibytes.
"physicalCoreCount": 42, # Number of physical cores.
"series": "A String", # Output only. Compute Engine machine series.
"storage": [ # Output only. Compute Engine storage. Never empty.
{ # Compute Engine storage option descriptor.
"sizeGb": 42, # Output only. Disk size in GiB.
"type": "A String", # Output only. Disk type backing the storage.
},
],
},
},
"fit": { # Describes the fit level of an asset for migration to a specific target. # Output only. Description of how well the asset this insight is associated with fits the proposed migration.
"fitLevel": "A String", # Output only. Fit level.
},
},
},
],
"updateTime": "A String", # Output only. Update timestamp.
},
"labels": { # Labels as key value pairs.
"a_key": "A String",
},
"machineDetails": { # Details of a machine. # Output only. Asset information specific for virtual and physical machines.
"architecture": { # Details of the machine architecture. # Architecture details (vendor, CPU architecture).
"bios": { # Details about the BIOS. # BIOS Details.
"biosName": "A String", # BIOS name. This fields is deprecated. Please use the `id` field instead.
"id": "A String", # BIOS ID.
"manufacturer": "A String", # BIOS manufacturer.
"releaseDate": { # 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: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # BIOS release date.
"day": 42, # 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.
"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
"smbiosUuid": "A String", # SMBIOS UUID.
"version": "A String", # BIOS version.
},
"cpuArchitecture": "A String", # CPU architecture, e.g., "x64-based PC", "x86_64", "i686" etc.
"cpuName": "A String", # CPU name, e.g., "Intel Xeon E5-2690", "AMD EPYC 7571" etc.
"cpuSocketCount": 42, # Number of processor sockets allocated to the machine.
"cpuThreadCount": 42, # Deprecated: use MachineDetails.core_count instead. Number of CPU threads allocated to the machine.
"firmwareType": "A String", # Firmware type.
"hyperthreading": "A String", # CPU hyper-threading support.
"vendor": "A String", # Hardware vendor.
},
"coreCount": 42, # Number of logical CPU cores in the machine. Must be non-negative.
"createTime": "A String", # Machine creation time.
"disks": { # Details of machine disks. # Disk details.
"disks": { # VM disks. # List of disks.
"entries": [ # Disk entries.
{ # Single disk entry.
"capacityBytes": "A String", # Disk capacity.
"diskLabel": "A String", # Disk label.
"diskLabelType": "A String", # Disk label type (e.g. BIOS/GPT)
"freeBytes": "A String", # Disk free space.
"hwAddress": "A String", # Disk hardware address (e.g. 0:1 for SCSI).
"interfaceType": "A String", # Disks interface type.
"partitions": { # Disk partition list. # Partition layout.
"entries": [ # Partition entries.
{ # Disk Partition details.
"capacityBytes": "A String", # Partition capacity.
"fileSystem": "A String", # Partition file system.
"freeBytes": "A String", # Partition free space.
"mountPoint": "A String", # Mount pount (Linux/Windows) or drive letter (Windows).
"subPartitions": # Object with schema name: DiskPartitionList # Sub-partitions.
"type": "A String", # Partition type.
"uuid": "A String", # Partition UUID.
},
],
},
"vmware": { # VMware disk config details. # VMware disk details.
"backingType": "A String", # VMDK backing type.
"rdmCompatibility": "A String", # RDM compatibility mode.
"shared": True or False, # Is VMDK shared with other VMs.
"vmdkMode": "A String", # VMDK disk mode.
},
},
],
},
"totalCapacityBytes": "A String", # Disk total Capacity.
"totalFreeBytes": "A String", # Total disk free space.
},
"guestOs": { # Information from Guest-level collections. # Guest OS information.
"config": { # Guest OS config information. # OS and app configuration.
"fstab": { # Fstab content. # Mount list (Linux fstab).
"entries": [ # Fstab entries.
{ # Single fstab entry.
"file": "A String", # The mount point for the filesystem.
"freq": 42, # Used by dump to determine which filesystems need to be dumped.
"mntops": "A String", # Mount options associated with the filesystem.
"passno": 42, # Used by the fsck(8) program to determine the order in which filesystem checks are done at reboot time.
"spec": "A String", # The block special device or remote filesystem to be mounted.
"vfstype": "A String", # The type of the filesystem.
},
],
},
"hosts": { # Hosts content. # Hosts file (/etc/hosts).
"entries": [ # Hosts entries.
{ # Single /etc/hosts entry.
"hostNames": [ # List of host names / aliases.
"A String",
],
"ip": "A String", # IP (raw, IPv4/6 agnostic).
},
],
},
"issue": "A String", # OS issue (typically /etc/issue in Linux).
"nfsExports": { # NFS exports. # NFS exports.
"entries": [ # NFS export entries.
{ # NFS export.
"exportDirectory": "A String", # The directory being exported.
"hosts": [ # The hosts or networks to which the export is being shared.
"A String",
],
},
],
},
"selinuxMode": "A String", # Security-Enhanced Linux (SELinux) mode.
},
"family": "A String", # What family the OS belong to, if known.
"osName": "A String", # The name of the operating system.
"runtime": { # Guest OS runtime information. # Runtime information.
"domain": "A String", # Domain, e.g. c.stratozone-development.internal.
"installedApps": { # Guest installed application list. # Installed applications information.
"entries": [ # Application entries.
{ # Guest installed application information.
"applicationName": "A String", # Installed application name.
"installTime": "A String", # The time when the application was installed.
"licenses": [ # License strings associated with the installed application.
"A String",
],
"path": "A String", # Source path.
"vendor": "A String", # Installed application vendor.
"version": "A String", # Installed application version.
},
],
},
"lastBootTime": "A String", # Last time the OS was booted.
"machineName": "A String", # Machine name.
"network": { # Runtime networking information. # Runtime network information (connections, ports).
"connections": { # Network connection list. # Network connections.
"entries": [ # Network connection entries.
{
"localIpAddress": "A String", # Local IP address.
"localPort": 42, # Local port.
"pid": "A String", # Process ID.
"processName": "A String", # Process or service name.
"protocol": "A String", # Connection protocol (e.g. TCP/UDP).
"remoteIpAddress": "A String", # Remote IP address.
"remotePort": 42, # Remote port.
"state": "A String", # Network connection state.
},
],
},
"scanTime": "A String", # Time of the last network scan.
},
"openFileList": { # Open file list. # Open files information.
"entries": [ # Open file details entries.
{ # Open file Information.
"command": "A String", # Opened file command.
"filePath": "A String", # Opened file file path.
"fileType": "A String", # Opened file file type.
"user": "A String", # Opened file user.
},
],
},
"processes": { # List of running guest OS processes. # Running processes.
"entries": [ # Running process entries.
{ # Guest OS running process details.
"attributes": { # Process extended attributes.
"a_key": "A String",
},
"cmdline": "A String", # Process full command line.
"exePath": "A String", # Process binary path.
"pid": "A String", # Process ID.
"user": "A String", # User running the process.
},
],
},
"services": { # List of running guest OS services. # Running background services.
"entries": [ # Running service entries.
{ # Guest OS running service details.
"cmdline": "A String", # Service command line.
"exePath": "A String", # Service binary path.
"pid": "A String", # Service pid.
"serviceName": "A String", # Service name.
"startMode": "A String", # Service start mode (OS-agnostic).
"state": "A String", # Service state (OS-agnostic).
},
],
},
},
"version": "A String", # The version of the operating system.
},
"machineName": "A String", # Machine name.
"memoryMb": 42, # The amount of memory in the machine. Must be non-negative.
"network": { # Details of network adapters and settings. # Network details.
"adapters": { # List of network adapters. # List of network adapters.
"entries": [ # Network adapter entries.
{ # Details of network adapter.
"adapterType": "A String", # Network adapter type (e.g. VMXNET3).
"addresses": { # List of allocated/assigned network addresses. # NetworkAddressList
"entries": [ # Network address entries.
{ # Details of network address.
"assignment": "A String", # Whether DHCP is used to assign addresses.
"bcast": "A String", # Broadcast address.
"fqdn": "A String", # Fully qualified domain name.
"ipAddress": "A String", # Assigned or configured IP Address.
"subnetMask": "A String", # Subnet mask.
},
],
},
"macAddress": "A String", # MAC address.
},
],
},
"primaryIpAddress": "A String", # The primary IP address of the machine.
"primaryMacAddress": "A String", # MAC address of the machine. This property is used to uniqly identify the machine.
"publicIpAddress": "A String", # The public IP address of the machine.
},
"platform": { # Information about the platform. # Platform specific information.
"awsEc2Details": { # AWS EC2 specific details. # AWS EC2 specific details.
"hyperthreading": "A String", # Optional. Whether the machine is hyperthreaded.
"location": "A String", # The location of the machine in the AWS format.
"machineTypeLabel": "A String", # AWS platform's machine type label.
},
"azureVmDetails": { # Azure VM specific details. # Azure VM specific details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # The location of the machine in the Azure format.
"machineTypeLabel": "A String", # Azure platform's machine type label.
"provisioningState": "A String", # Azure platform's provisioning state.
},
"genericDetails": { # Generic platform details. # Generic platform details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # Free text representation of the machine location. The format of this field should not be relied on. Different VMs in the same location may have different string values for this field.
},
"physicalDetails": { # Platform specific details for Physical Machines. # Physical machines platform details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # Free text representation of the machine location. The format of this field should not be relied on. Different machines in the same location may have different string values for this field.
},
"vmwareDetails": { # VMware specific details. # VMware specific details.
"esxHyperthreading": "A String", # Whether the ESX is hyperthreaded.
"esxVersion": "A String", # ESX version.
"osid": "A String", # VMware os enum - https://vdc-repo.vmware.com/vmwb-repository/dcr-public/da47f910-60ac-438b-8b9b-6122f4d14524/16b7274a-bf8b-4b4c-a05e-746f2aa93c8c/doc/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html.
"vcenterFolder": "A String", # Folder name in vCenter where asset resides.
"vcenterUri": "A String", # vCenter URI used in collection.
"vcenterVersion": "A String", # vCenter version.
"vcenterVmId": "A String", # vCenter VM ID.
},
},
"powerState": "A String", # Power state of the machine.
"uuid": "A String", # Machine unique identifier.
},
"name": "A String", # Output only. The full name of the asset.
"performanceData": { # Performance data for an asset. # Output only. Performance data for the asset.
"dailyResourceUsageAggregations": [ # Daily resource usage aggregations. Contains all of the data available for an asset, up to the last 420 days. Aggregations are sorted from oldest to most recent.
{ # Usage data aggregation for a single day.
"cpu": { # Statistical aggregation of CPU usage. # CPU usage.
"utilizationPercentage": { # Statistical aggregation of samples for a single resource usage. # CPU utilization percentage.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
"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: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Aggregation date. Day boundaries are at midnight UTC.
"day": 42, # 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.
"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
"disk": { # Statistical aggregation of disk usage. # Disk usage.
"iops": { # Statistical aggregation of samples for a single resource usage. # Disk I/O operations per second.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
"memory": { # Statistical aggregation of memory usage. # Memory usage.
"utilizationPercentage": { # Statistical aggregation of samples for a single resource usage. # Memory utilization percentage.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
"network": { # Statistical aggregation of network usage. # Network usage.
"egressBps": { # Statistical aggregation of samples for a single resource usage. # Network egress in B/s.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
"ingressBps": { # Statistical aggregation of samples for a single resource usage. # Network ingress in B/s.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
},
],
},
"sources": [ # Output only. The list of sources contributing to the asset.
"A String",
],
"updateTime": "A String", # Output only. The timestamp when the asset was last updated.
}
list(parent, filter=None, orderBy=None, pageSize=None, pageToken=None, view=None, x__xgafv=None)
Lists all the assets in a given project and location.
Args:
parent: string, Required. Parent value for `ListAssetsRequest`. (required)
filter: string, Filtering results.
orderBy: string, Field to sort by. See https://google.aip.dev/132#ordering for more details.
pageSize: integer, Requested page size. Server may return fewer items than requested. If unspecified, server will pick an appropriate default.
pageToken: string, A token identifying a page of results the server should return.
view: string, View of the assets. Defaults to BASIC.
Allowed values
ASSET_VIEW_UNSPECIFIED - The asset view is not specified. The API displays the basic view by default.
ASSET_VIEW_BASIC - The asset view includes only basic metadata of the asset.
ASSET_VIEW_FULL - The asset view includes all the metadata of an asset and performance data.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # Response message for listing assets.
"assets": [ # A list of assets.
{ # An asset represents a resource in your environment. Asset types include virtual machines and databases.
"assignedGroups": [ # Output only. The list of groups that the asset is assigned to.
"A String",
],
"attributes": { # Generic asset attributes.
"a_key": "A String",
},
"createTime": "A String", # Output only. The timestamp when the asset was created.
"insightList": { # Message containing insights list. # Output only. The list of insights associated with the asset.
"insights": [ # Output only. Insights of the list.
{ # An insight about an asset.
"genericInsight": { # A generic insight about an asset. # Output only. A generic insight about an asset
"additionalInformation": [ # Output only. Additional information about the insight, each entry can be a logical entry and must make sense if it is displayed with line breaks between each entry. Text can contain md style links.
"A String",
],
"defaultMessage": "A String", # Output only. In case message_code is not yet known by the client default_message will be the message to be used instead.
"messageId": "A String", # Output only. Represents a globally unique message id for this insight, can be used for localization purposes, in case message_code is not yet known by the client use default_message instead.
},
"migrationInsight": { # An insight about potential migrations for an asset. # Output only. An insight about potential migrations for an asset.
"computeEngineTarget": { # Compute engine migration target. # Output only. A Google Compute Engine target.
"shape": { # Compute Engine target shape descriptor. # Description of the suggested shape for the migration target.
"logicalCoreCount": 42, # Output only. Number of logical cores.
"machineType": "A String", # Output only. Compute Engine machine type.
"memoryMb": 42, # Memory in mebibytes.
"physicalCoreCount": 42, # Number of physical cores.
"series": "A String", # Output only. Compute Engine machine series.
"storage": [ # Output only. Compute Engine storage. Never empty.
{ # Compute Engine storage option descriptor.
"sizeGb": 42, # Output only. Disk size in GiB.
"type": "A String", # Output only. Disk type backing the storage.
},
],
},
},
"fit": { # Describes the fit level of an asset for migration to a specific target. # Output only. Description of how well the asset this insight is associated with fits the proposed migration.
"fitLevel": "A String", # Output only. Fit level.
},
},
},
],
"updateTime": "A String", # Output only. Update timestamp.
},
"labels": { # Labels as key value pairs.
"a_key": "A String",
},
"machineDetails": { # Details of a machine. # Output only. Asset information specific for virtual and physical machines.
"architecture": { # Details of the machine architecture. # Architecture details (vendor, CPU architecture).
"bios": { # Details about the BIOS. # BIOS Details.
"biosName": "A String", # BIOS name. This fields is deprecated. Please use the `id` field instead.
"id": "A String", # BIOS ID.
"manufacturer": "A String", # BIOS manufacturer.
"releaseDate": { # 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: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # BIOS release date.
"day": 42, # 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.
"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
"smbiosUuid": "A String", # SMBIOS UUID.
"version": "A String", # BIOS version.
},
"cpuArchitecture": "A String", # CPU architecture, e.g., "x64-based PC", "x86_64", "i686" etc.
"cpuName": "A String", # CPU name, e.g., "Intel Xeon E5-2690", "AMD EPYC 7571" etc.
"cpuSocketCount": 42, # Number of processor sockets allocated to the machine.
"cpuThreadCount": 42, # Deprecated: use MachineDetails.core_count instead. Number of CPU threads allocated to the machine.
"firmwareType": "A String", # Firmware type.
"hyperthreading": "A String", # CPU hyper-threading support.
"vendor": "A String", # Hardware vendor.
},
"coreCount": 42, # Number of logical CPU cores in the machine. Must be non-negative.
"createTime": "A String", # Machine creation time.
"disks": { # Details of machine disks. # Disk details.
"disks": { # VM disks. # List of disks.
"entries": [ # Disk entries.
{ # Single disk entry.
"capacityBytes": "A String", # Disk capacity.
"diskLabel": "A String", # Disk label.
"diskLabelType": "A String", # Disk label type (e.g. BIOS/GPT)
"freeBytes": "A String", # Disk free space.
"hwAddress": "A String", # Disk hardware address (e.g. 0:1 for SCSI).
"interfaceType": "A String", # Disks interface type.
"partitions": { # Disk partition list. # Partition layout.
"entries": [ # Partition entries.
{ # Disk Partition details.
"capacityBytes": "A String", # Partition capacity.
"fileSystem": "A String", # Partition file system.
"freeBytes": "A String", # Partition free space.
"mountPoint": "A String", # Mount pount (Linux/Windows) or drive letter (Windows).
"subPartitions": # Object with schema name: DiskPartitionList # Sub-partitions.
"type": "A String", # Partition type.
"uuid": "A String", # Partition UUID.
},
],
},
"vmware": { # VMware disk config details. # VMware disk details.
"backingType": "A String", # VMDK backing type.
"rdmCompatibility": "A String", # RDM compatibility mode.
"shared": True or False, # Is VMDK shared with other VMs.
"vmdkMode": "A String", # VMDK disk mode.
},
},
],
},
"totalCapacityBytes": "A String", # Disk total Capacity.
"totalFreeBytes": "A String", # Total disk free space.
},
"guestOs": { # Information from Guest-level collections. # Guest OS information.
"config": { # Guest OS config information. # OS and app configuration.
"fstab": { # Fstab content. # Mount list (Linux fstab).
"entries": [ # Fstab entries.
{ # Single fstab entry.
"file": "A String", # The mount point for the filesystem.
"freq": 42, # Used by dump to determine which filesystems need to be dumped.
"mntops": "A String", # Mount options associated with the filesystem.
"passno": 42, # Used by the fsck(8) program to determine the order in which filesystem checks are done at reboot time.
"spec": "A String", # The block special device or remote filesystem to be mounted.
"vfstype": "A String", # The type of the filesystem.
},
],
},
"hosts": { # Hosts content. # Hosts file (/etc/hosts).
"entries": [ # Hosts entries.
{ # Single /etc/hosts entry.
"hostNames": [ # List of host names / aliases.
"A String",
],
"ip": "A String", # IP (raw, IPv4/6 agnostic).
},
],
},
"issue": "A String", # OS issue (typically /etc/issue in Linux).
"nfsExports": { # NFS exports. # NFS exports.
"entries": [ # NFS export entries.
{ # NFS export.
"exportDirectory": "A String", # The directory being exported.
"hosts": [ # The hosts or networks to which the export is being shared.
"A String",
],
},
],
},
"selinuxMode": "A String", # Security-Enhanced Linux (SELinux) mode.
},
"family": "A String", # What family the OS belong to, if known.
"osName": "A String", # The name of the operating system.
"runtime": { # Guest OS runtime information. # Runtime information.
"domain": "A String", # Domain, e.g. c.stratozone-development.internal.
"installedApps": { # Guest installed application list. # Installed applications information.
"entries": [ # Application entries.
{ # Guest installed application information.
"applicationName": "A String", # Installed application name.
"installTime": "A String", # The time when the application was installed.
"licenses": [ # License strings associated with the installed application.
"A String",
],
"path": "A String", # Source path.
"vendor": "A String", # Installed application vendor.
"version": "A String", # Installed application version.
},
],
},
"lastBootTime": "A String", # Last time the OS was booted.
"machineName": "A String", # Machine name.
"network": { # Runtime networking information. # Runtime network information (connections, ports).
"connections": { # Network connection list. # Network connections.
"entries": [ # Network connection entries.
{
"localIpAddress": "A String", # Local IP address.
"localPort": 42, # Local port.
"pid": "A String", # Process ID.
"processName": "A String", # Process or service name.
"protocol": "A String", # Connection protocol (e.g. TCP/UDP).
"remoteIpAddress": "A String", # Remote IP address.
"remotePort": 42, # Remote port.
"state": "A String", # Network connection state.
},
],
},
"scanTime": "A String", # Time of the last network scan.
},
"openFileList": { # Open file list. # Open files information.
"entries": [ # Open file details entries.
{ # Open file Information.
"command": "A String", # Opened file command.
"filePath": "A String", # Opened file file path.
"fileType": "A String", # Opened file file type.
"user": "A String", # Opened file user.
},
],
},
"processes": { # List of running guest OS processes. # Running processes.
"entries": [ # Running process entries.
{ # Guest OS running process details.
"attributes": { # Process extended attributes.
"a_key": "A String",
},
"cmdline": "A String", # Process full command line.
"exePath": "A String", # Process binary path.
"pid": "A String", # Process ID.
"user": "A String", # User running the process.
},
],
},
"services": { # List of running guest OS services. # Running background services.
"entries": [ # Running service entries.
{ # Guest OS running service details.
"cmdline": "A String", # Service command line.
"exePath": "A String", # Service binary path.
"pid": "A String", # Service pid.
"serviceName": "A String", # Service name.
"startMode": "A String", # Service start mode (OS-agnostic).
"state": "A String", # Service state (OS-agnostic).
},
],
},
},
"version": "A String", # The version of the operating system.
},
"machineName": "A String", # Machine name.
"memoryMb": 42, # The amount of memory in the machine. Must be non-negative.
"network": { # Details of network adapters and settings. # Network details.
"adapters": { # List of network adapters. # List of network adapters.
"entries": [ # Network adapter entries.
{ # Details of network adapter.
"adapterType": "A String", # Network adapter type (e.g. VMXNET3).
"addresses": { # List of allocated/assigned network addresses. # NetworkAddressList
"entries": [ # Network address entries.
{ # Details of network address.
"assignment": "A String", # Whether DHCP is used to assign addresses.
"bcast": "A String", # Broadcast address.
"fqdn": "A String", # Fully qualified domain name.
"ipAddress": "A String", # Assigned or configured IP Address.
"subnetMask": "A String", # Subnet mask.
},
],
},
"macAddress": "A String", # MAC address.
},
],
},
"primaryIpAddress": "A String", # The primary IP address of the machine.
"primaryMacAddress": "A String", # MAC address of the machine. This property is used to uniqly identify the machine.
"publicIpAddress": "A String", # The public IP address of the machine.
},
"platform": { # Information about the platform. # Platform specific information.
"awsEc2Details": { # AWS EC2 specific details. # AWS EC2 specific details.
"hyperthreading": "A String", # Optional. Whether the machine is hyperthreaded.
"location": "A String", # The location of the machine in the AWS format.
"machineTypeLabel": "A String", # AWS platform's machine type label.
},
"azureVmDetails": { # Azure VM specific details. # Azure VM specific details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # The location of the machine in the Azure format.
"machineTypeLabel": "A String", # Azure platform's machine type label.
"provisioningState": "A String", # Azure platform's provisioning state.
},
"genericDetails": { # Generic platform details. # Generic platform details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # Free text representation of the machine location. The format of this field should not be relied on. Different VMs in the same location may have different string values for this field.
},
"physicalDetails": { # Platform specific details for Physical Machines. # Physical machines platform details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # Free text representation of the machine location. The format of this field should not be relied on. Different machines in the same location may have different string values for this field.
},
"vmwareDetails": { # VMware specific details. # VMware specific details.
"esxHyperthreading": "A String", # Whether the ESX is hyperthreaded.
"esxVersion": "A String", # ESX version.
"osid": "A String", # VMware os enum - https://vdc-repo.vmware.com/vmwb-repository/dcr-public/da47f910-60ac-438b-8b9b-6122f4d14524/16b7274a-bf8b-4b4c-a05e-746f2aa93c8c/doc/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html.
"vcenterFolder": "A String", # Folder name in vCenter where asset resides.
"vcenterUri": "A String", # vCenter URI used in collection.
"vcenterVersion": "A String", # vCenter version.
"vcenterVmId": "A String", # vCenter VM ID.
},
},
"powerState": "A String", # Power state of the machine.
"uuid": "A String", # Machine unique identifier.
},
"name": "A String", # Output only. The full name of the asset.
"performanceData": { # Performance data for an asset. # Output only. Performance data for the asset.
"dailyResourceUsageAggregations": [ # Daily resource usage aggregations. Contains all of the data available for an asset, up to the last 420 days. Aggregations are sorted from oldest to most recent.
{ # Usage data aggregation for a single day.
"cpu": { # Statistical aggregation of CPU usage. # CPU usage.
"utilizationPercentage": { # Statistical aggregation of samples for a single resource usage. # CPU utilization percentage.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
"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: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Aggregation date. Day boundaries are at midnight UTC.
"day": 42, # 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.
"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
"disk": { # Statistical aggregation of disk usage. # Disk usage.
"iops": { # Statistical aggregation of samples for a single resource usage. # Disk I/O operations per second.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
"memory": { # Statistical aggregation of memory usage. # Memory usage.
"utilizationPercentage": { # Statistical aggregation of samples for a single resource usage. # Memory utilization percentage.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
"network": { # Statistical aggregation of network usage. # Network usage.
"egressBps": { # Statistical aggregation of samples for a single resource usage. # Network egress in B/s.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
"ingressBps": { # Statistical aggregation of samples for a single resource usage. # Network ingress in B/s.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
},
],
},
"sources": [ # Output only. The list of sources contributing to the asset.
"A String",
],
"updateTime": "A String", # Output only. The timestamp when the asset was last updated.
},
],
"nextPageToken": "A String", # A token identifying a page of results the server should return.
"unreachable": [ # Locations that could not be reached.
"A String",
],
}
list_next()
Retrieves the next page of results.
Args:
previous_request: The request for the previous page. (required)
previous_response: The response from the request for the previous page. (required)
Returns:
A request object that you can call 'execute()' on to request the next
page. Returns None if there are no more items in the collection.
patch(name, body=None, requestId=None, updateMask=None, x__xgafv=None)
Updates the parameters of an asset.
Args:
name: string, Output only. The full name of the asset. (required)
body: object, The request body.
The object takes the form of:
{ # An asset represents a resource in your environment. Asset types include virtual machines and databases.
"assignedGroups": [ # Output only. The list of groups that the asset is assigned to.
"A String",
],
"attributes": { # Generic asset attributes.
"a_key": "A String",
},
"createTime": "A String", # Output only. The timestamp when the asset was created.
"insightList": { # Message containing insights list. # Output only. The list of insights associated with the asset.
"insights": [ # Output only. Insights of the list.
{ # An insight about an asset.
"genericInsight": { # A generic insight about an asset. # Output only. A generic insight about an asset
"additionalInformation": [ # Output only. Additional information about the insight, each entry can be a logical entry and must make sense if it is displayed with line breaks between each entry. Text can contain md style links.
"A String",
],
"defaultMessage": "A String", # Output only. In case message_code is not yet known by the client default_message will be the message to be used instead.
"messageId": "A String", # Output only. Represents a globally unique message id for this insight, can be used for localization purposes, in case message_code is not yet known by the client use default_message instead.
},
"migrationInsight": { # An insight about potential migrations for an asset. # Output only. An insight about potential migrations for an asset.
"computeEngineTarget": { # Compute engine migration target. # Output only. A Google Compute Engine target.
"shape": { # Compute Engine target shape descriptor. # Description of the suggested shape for the migration target.
"logicalCoreCount": 42, # Output only. Number of logical cores.
"machineType": "A String", # Output only. Compute Engine machine type.
"memoryMb": 42, # Memory in mebibytes.
"physicalCoreCount": 42, # Number of physical cores.
"series": "A String", # Output only. Compute Engine machine series.
"storage": [ # Output only. Compute Engine storage. Never empty.
{ # Compute Engine storage option descriptor.
"sizeGb": 42, # Output only. Disk size in GiB.
"type": "A String", # Output only. Disk type backing the storage.
},
],
},
},
"fit": { # Describes the fit level of an asset for migration to a specific target. # Output only. Description of how well the asset this insight is associated with fits the proposed migration.
"fitLevel": "A String", # Output only. Fit level.
},
},
},
],
"updateTime": "A String", # Output only. Update timestamp.
},
"labels": { # Labels as key value pairs.
"a_key": "A String",
},
"machineDetails": { # Details of a machine. # Output only. Asset information specific for virtual and physical machines.
"architecture": { # Details of the machine architecture. # Architecture details (vendor, CPU architecture).
"bios": { # Details about the BIOS. # BIOS Details.
"biosName": "A String", # BIOS name. This fields is deprecated. Please use the `id` field instead.
"id": "A String", # BIOS ID.
"manufacturer": "A String", # BIOS manufacturer.
"releaseDate": { # 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: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # BIOS release date.
"day": 42, # 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.
"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
"smbiosUuid": "A String", # SMBIOS UUID.
"version": "A String", # BIOS version.
},
"cpuArchitecture": "A String", # CPU architecture, e.g., "x64-based PC", "x86_64", "i686" etc.
"cpuName": "A String", # CPU name, e.g., "Intel Xeon E5-2690", "AMD EPYC 7571" etc.
"cpuSocketCount": 42, # Number of processor sockets allocated to the machine.
"cpuThreadCount": 42, # Deprecated: use MachineDetails.core_count instead. Number of CPU threads allocated to the machine.
"firmwareType": "A String", # Firmware type.
"hyperthreading": "A String", # CPU hyper-threading support.
"vendor": "A String", # Hardware vendor.
},
"coreCount": 42, # Number of logical CPU cores in the machine. Must be non-negative.
"createTime": "A String", # Machine creation time.
"disks": { # Details of machine disks. # Disk details.
"disks": { # VM disks. # List of disks.
"entries": [ # Disk entries.
{ # Single disk entry.
"capacityBytes": "A String", # Disk capacity.
"diskLabel": "A String", # Disk label.
"diskLabelType": "A String", # Disk label type (e.g. BIOS/GPT)
"freeBytes": "A String", # Disk free space.
"hwAddress": "A String", # Disk hardware address (e.g. 0:1 for SCSI).
"interfaceType": "A String", # Disks interface type.
"partitions": { # Disk partition list. # Partition layout.
"entries": [ # Partition entries.
{ # Disk Partition details.
"capacityBytes": "A String", # Partition capacity.
"fileSystem": "A String", # Partition file system.
"freeBytes": "A String", # Partition free space.
"mountPoint": "A String", # Mount pount (Linux/Windows) or drive letter (Windows).
"subPartitions": # Object with schema name: DiskPartitionList # Sub-partitions.
"type": "A String", # Partition type.
"uuid": "A String", # Partition UUID.
},
],
},
"vmware": { # VMware disk config details. # VMware disk details.
"backingType": "A String", # VMDK backing type.
"rdmCompatibility": "A String", # RDM compatibility mode.
"shared": True or False, # Is VMDK shared with other VMs.
"vmdkMode": "A String", # VMDK disk mode.
},
},
],
},
"totalCapacityBytes": "A String", # Disk total Capacity.
"totalFreeBytes": "A String", # Total disk free space.
},
"guestOs": { # Information from Guest-level collections. # Guest OS information.
"config": { # Guest OS config information. # OS and app configuration.
"fstab": { # Fstab content. # Mount list (Linux fstab).
"entries": [ # Fstab entries.
{ # Single fstab entry.
"file": "A String", # The mount point for the filesystem.
"freq": 42, # Used by dump to determine which filesystems need to be dumped.
"mntops": "A String", # Mount options associated with the filesystem.
"passno": 42, # Used by the fsck(8) program to determine the order in which filesystem checks are done at reboot time.
"spec": "A String", # The block special device or remote filesystem to be mounted.
"vfstype": "A String", # The type of the filesystem.
},
],
},
"hosts": { # Hosts content. # Hosts file (/etc/hosts).
"entries": [ # Hosts entries.
{ # Single /etc/hosts entry.
"hostNames": [ # List of host names / aliases.
"A String",
],
"ip": "A String", # IP (raw, IPv4/6 agnostic).
},
],
},
"issue": "A String", # OS issue (typically /etc/issue in Linux).
"nfsExports": { # NFS exports. # NFS exports.
"entries": [ # NFS export entries.
{ # NFS export.
"exportDirectory": "A String", # The directory being exported.
"hosts": [ # The hosts or networks to which the export is being shared.
"A String",
],
},
],
},
"selinuxMode": "A String", # Security-Enhanced Linux (SELinux) mode.
},
"family": "A String", # What family the OS belong to, if known.
"osName": "A String", # The name of the operating system.
"runtime": { # Guest OS runtime information. # Runtime information.
"domain": "A String", # Domain, e.g. c.stratozone-development.internal.
"installedApps": { # Guest installed application list. # Installed applications information.
"entries": [ # Application entries.
{ # Guest installed application information.
"applicationName": "A String", # Installed application name.
"installTime": "A String", # The time when the application was installed.
"licenses": [ # License strings associated with the installed application.
"A String",
],
"path": "A String", # Source path.
"vendor": "A String", # Installed application vendor.
"version": "A String", # Installed application version.
},
],
},
"lastBootTime": "A String", # Last time the OS was booted.
"machineName": "A String", # Machine name.
"network": { # Runtime networking information. # Runtime network information (connections, ports).
"connections": { # Network connection list. # Network connections.
"entries": [ # Network connection entries.
{
"localIpAddress": "A String", # Local IP address.
"localPort": 42, # Local port.
"pid": "A String", # Process ID.
"processName": "A String", # Process or service name.
"protocol": "A String", # Connection protocol (e.g. TCP/UDP).
"remoteIpAddress": "A String", # Remote IP address.
"remotePort": 42, # Remote port.
"state": "A String", # Network connection state.
},
],
},
"scanTime": "A String", # Time of the last network scan.
},
"openFileList": { # Open file list. # Open files information.
"entries": [ # Open file details entries.
{ # Open file Information.
"command": "A String", # Opened file command.
"filePath": "A String", # Opened file file path.
"fileType": "A String", # Opened file file type.
"user": "A String", # Opened file user.
},
],
},
"processes": { # List of running guest OS processes. # Running processes.
"entries": [ # Running process entries.
{ # Guest OS running process details.
"attributes": { # Process extended attributes.
"a_key": "A String",
},
"cmdline": "A String", # Process full command line.
"exePath": "A String", # Process binary path.
"pid": "A String", # Process ID.
"user": "A String", # User running the process.
},
],
},
"services": { # List of running guest OS services. # Running background services.
"entries": [ # Running service entries.
{ # Guest OS running service details.
"cmdline": "A String", # Service command line.
"exePath": "A String", # Service binary path.
"pid": "A String", # Service pid.
"serviceName": "A String", # Service name.
"startMode": "A String", # Service start mode (OS-agnostic).
"state": "A String", # Service state (OS-agnostic).
},
],
},
},
"version": "A String", # The version of the operating system.
},
"machineName": "A String", # Machine name.
"memoryMb": 42, # The amount of memory in the machine. Must be non-negative.
"network": { # Details of network adapters and settings. # Network details.
"adapters": { # List of network adapters. # List of network adapters.
"entries": [ # Network adapter entries.
{ # Details of network adapter.
"adapterType": "A String", # Network adapter type (e.g. VMXNET3).
"addresses": { # List of allocated/assigned network addresses. # NetworkAddressList
"entries": [ # Network address entries.
{ # Details of network address.
"assignment": "A String", # Whether DHCP is used to assign addresses.
"bcast": "A String", # Broadcast address.
"fqdn": "A String", # Fully qualified domain name.
"ipAddress": "A String", # Assigned or configured IP Address.
"subnetMask": "A String", # Subnet mask.
},
],
},
"macAddress": "A String", # MAC address.
},
],
},
"primaryIpAddress": "A String", # The primary IP address of the machine.
"primaryMacAddress": "A String", # MAC address of the machine. This property is used to uniqly identify the machine.
"publicIpAddress": "A String", # The public IP address of the machine.
},
"platform": { # Information about the platform. # Platform specific information.
"awsEc2Details": { # AWS EC2 specific details. # AWS EC2 specific details.
"hyperthreading": "A String", # Optional. Whether the machine is hyperthreaded.
"location": "A String", # The location of the machine in the AWS format.
"machineTypeLabel": "A String", # AWS platform's machine type label.
},
"azureVmDetails": { # Azure VM specific details. # Azure VM specific details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # The location of the machine in the Azure format.
"machineTypeLabel": "A String", # Azure platform's machine type label.
"provisioningState": "A String", # Azure platform's provisioning state.
},
"genericDetails": { # Generic platform details. # Generic platform details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # Free text representation of the machine location. The format of this field should not be relied on. Different VMs in the same location may have different string values for this field.
},
"physicalDetails": { # Platform specific details for Physical Machines. # Physical machines platform details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # Free text representation of the machine location. The format of this field should not be relied on. Different machines in the same location may have different string values for this field.
},
"vmwareDetails": { # VMware specific details. # VMware specific details.
"esxHyperthreading": "A String", # Whether the ESX is hyperthreaded.
"esxVersion": "A String", # ESX version.
"osid": "A String", # VMware os enum - https://vdc-repo.vmware.com/vmwb-repository/dcr-public/da47f910-60ac-438b-8b9b-6122f4d14524/16b7274a-bf8b-4b4c-a05e-746f2aa93c8c/doc/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html.
"vcenterFolder": "A String", # Folder name in vCenter where asset resides.
"vcenterUri": "A String", # vCenter URI used in collection.
"vcenterVersion": "A String", # vCenter version.
"vcenterVmId": "A String", # vCenter VM ID.
},
},
"powerState": "A String", # Power state of the machine.
"uuid": "A String", # Machine unique identifier.
},
"name": "A String", # Output only. The full name of the asset.
"performanceData": { # Performance data for an asset. # Output only. Performance data for the asset.
"dailyResourceUsageAggregations": [ # Daily resource usage aggregations. Contains all of the data available for an asset, up to the last 420 days. Aggregations are sorted from oldest to most recent.
{ # Usage data aggregation for a single day.
"cpu": { # Statistical aggregation of CPU usage. # CPU usage.
"utilizationPercentage": { # Statistical aggregation of samples for a single resource usage. # CPU utilization percentage.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
"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: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Aggregation date. Day boundaries are at midnight UTC.
"day": 42, # 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.
"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
"disk": { # Statistical aggregation of disk usage. # Disk usage.
"iops": { # Statistical aggregation of samples for a single resource usage. # Disk I/O operations per second.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
"memory": { # Statistical aggregation of memory usage. # Memory usage.
"utilizationPercentage": { # Statistical aggregation of samples for a single resource usage. # Memory utilization percentage.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
"network": { # Statistical aggregation of network usage. # Network usage.
"egressBps": { # Statistical aggregation of samples for a single resource usage. # Network egress in B/s.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
"ingressBps": { # Statistical aggregation of samples for a single resource usage. # Network ingress in B/s.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
},
],
},
"sources": [ # Output only. The list of sources contributing to the asset.
"A String",
],
"updateTime": "A String", # Output only. The timestamp when the asset was last updated.
}
requestId: string, Optional. An optional request ID to identify requests. Specify a unique request ID so that if you must retry your request, the server will know to ignore the request if it has already been completed. The server will guarantee that for at least 60 minutes since the first request. For example, consider a situation where you make an initial request and the request times out. If you make the request again with the same request ID, the server can check if original operation with the same request ID was received, and if so, will ignore the second request. This prevents clients from accidentally creating duplicate commitments. The request ID must be a valid UUID with the exception that zero UUID is not supported (00000000-0000-0000-0000-000000000000).
updateMask: string, Required. Field mask is used to specify the fields to be overwritten in the `Asset` resource by the update. The values specified in the `update_mask` field are relative to the resource, not the full request. A field will be overwritten if it is in the mask. A single * value in the mask lets you to overwrite all fields.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # An asset represents a resource in your environment. Asset types include virtual machines and databases.
"assignedGroups": [ # Output only. The list of groups that the asset is assigned to.
"A String",
],
"attributes": { # Generic asset attributes.
"a_key": "A String",
},
"createTime": "A String", # Output only. The timestamp when the asset was created.
"insightList": { # Message containing insights list. # Output only. The list of insights associated with the asset.
"insights": [ # Output only. Insights of the list.
{ # An insight about an asset.
"genericInsight": { # A generic insight about an asset. # Output only. A generic insight about an asset
"additionalInformation": [ # Output only. Additional information about the insight, each entry can be a logical entry and must make sense if it is displayed with line breaks between each entry. Text can contain md style links.
"A String",
],
"defaultMessage": "A String", # Output only. In case message_code is not yet known by the client default_message will be the message to be used instead.
"messageId": "A String", # Output only. Represents a globally unique message id for this insight, can be used for localization purposes, in case message_code is not yet known by the client use default_message instead.
},
"migrationInsight": { # An insight about potential migrations for an asset. # Output only. An insight about potential migrations for an asset.
"computeEngineTarget": { # Compute engine migration target. # Output only. A Google Compute Engine target.
"shape": { # Compute Engine target shape descriptor. # Description of the suggested shape for the migration target.
"logicalCoreCount": 42, # Output only. Number of logical cores.
"machineType": "A String", # Output only. Compute Engine machine type.
"memoryMb": 42, # Memory in mebibytes.
"physicalCoreCount": 42, # Number of physical cores.
"series": "A String", # Output only. Compute Engine machine series.
"storage": [ # Output only. Compute Engine storage. Never empty.
{ # Compute Engine storage option descriptor.
"sizeGb": 42, # Output only. Disk size in GiB.
"type": "A String", # Output only. Disk type backing the storage.
},
],
},
},
"fit": { # Describes the fit level of an asset for migration to a specific target. # Output only. Description of how well the asset this insight is associated with fits the proposed migration.
"fitLevel": "A String", # Output only. Fit level.
},
},
},
],
"updateTime": "A String", # Output only. Update timestamp.
},
"labels": { # Labels as key value pairs.
"a_key": "A String",
},
"machineDetails": { # Details of a machine. # Output only. Asset information specific for virtual and physical machines.
"architecture": { # Details of the machine architecture. # Architecture details (vendor, CPU architecture).
"bios": { # Details about the BIOS. # BIOS Details.
"biosName": "A String", # BIOS name. This fields is deprecated. Please use the `id` field instead.
"id": "A String", # BIOS ID.
"manufacturer": "A String", # BIOS manufacturer.
"releaseDate": { # 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: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # BIOS release date.
"day": 42, # 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.
"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
"smbiosUuid": "A String", # SMBIOS UUID.
"version": "A String", # BIOS version.
},
"cpuArchitecture": "A String", # CPU architecture, e.g., "x64-based PC", "x86_64", "i686" etc.
"cpuName": "A String", # CPU name, e.g., "Intel Xeon E5-2690", "AMD EPYC 7571" etc.
"cpuSocketCount": 42, # Number of processor sockets allocated to the machine.
"cpuThreadCount": 42, # Deprecated: use MachineDetails.core_count instead. Number of CPU threads allocated to the machine.
"firmwareType": "A String", # Firmware type.
"hyperthreading": "A String", # CPU hyper-threading support.
"vendor": "A String", # Hardware vendor.
},
"coreCount": 42, # Number of logical CPU cores in the machine. Must be non-negative.
"createTime": "A String", # Machine creation time.
"disks": { # Details of machine disks. # Disk details.
"disks": { # VM disks. # List of disks.
"entries": [ # Disk entries.
{ # Single disk entry.
"capacityBytes": "A String", # Disk capacity.
"diskLabel": "A String", # Disk label.
"diskLabelType": "A String", # Disk label type (e.g. BIOS/GPT)
"freeBytes": "A String", # Disk free space.
"hwAddress": "A String", # Disk hardware address (e.g. 0:1 for SCSI).
"interfaceType": "A String", # Disks interface type.
"partitions": { # Disk partition list. # Partition layout.
"entries": [ # Partition entries.
{ # Disk Partition details.
"capacityBytes": "A String", # Partition capacity.
"fileSystem": "A String", # Partition file system.
"freeBytes": "A String", # Partition free space.
"mountPoint": "A String", # Mount pount (Linux/Windows) or drive letter (Windows).
"subPartitions": # Object with schema name: DiskPartitionList # Sub-partitions.
"type": "A String", # Partition type.
"uuid": "A String", # Partition UUID.
},
],
},
"vmware": { # VMware disk config details. # VMware disk details.
"backingType": "A String", # VMDK backing type.
"rdmCompatibility": "A String", # RDM compatibility mode.
"shared": True or False, # Is VMDK shared with other VMs.
"vmdkMode": "A String", # VMDK disk mode.
},
},
],
},
"totalCapacityBytes": "A String", # Disk total Capacity.
"totalFreeBytes": "A String", # Total disk free space.
},
"guestOs": { # Information from Guest-level collections. # Guest OS information.
"config": { # Guest OS config information. # OS and app configuration.
"fstab": { # Fstab content. # Mount list (Linux fstab).
"entries": [ # Fstab entries.
{ # Single fstab entry.
"file": "A String", # The mount point for the filesystem.
"freq": 42, # Used by dump to determine which filesystems need to be dumped.
"mntops": "A String", # Mount options associated with the filesystem.
"passno": 42, # Used by the fsck(8) program to determine the order in which filesystem checks are done at reboot time.
"spec": "A String", # The block special device or remote filesystem to be mounted.
"vfstype": "A String", # The type of the filesystem.
},
],
},
"hosts": { # Hosts content. # Hosts file (/etc/hosts).
"entries": [ # Hosts entries.
{ # Single /etc/hosts entry.
"hostNames": [ # List of host names / aliases.
"A String",
],
"ip": "A String", # IP (raw, IPv4/6 agnostic).
},
],
},
"issue": "A String", # OS issue (typically /etc/issue in Linux).
"nfsExports": { # NFS exports. # NFS exports.
"entries": [ # NFS export entries.
{ # NFS export.
"exportDirectory": "A String", # The directory being exported.
"hosts": [ # The hosts or networks to which the export is being shared.
"A String",
],
},
],
},
"selinuxMode": "A String", # Security-Enhanced Linux (SELinux) mode.
},
"family": "A String", # What family the OS belong to, if known.
"osName": "A String", # The name of the operating system.
"runtime": { # Guest OS runtime information. # Runtime information.
"domain": "A String", # Domain, e.g. c.stratozone-development.internal.
"installedApps": { # Guest installed application list. # Installed applications information.
"entries": [ # Application entries.
{ # Guest installed application information.
"applicationName": "A String", # Installed application name.
"installTime": "A String", # The time when the application was installed.
"licenses": [ # License strings associated with the installed application.
"A String",
],
"path": "A String", # Source path.
"vendor": "A String", # Installed application vendor.
"version": "A String", # Installed application version.
},
],
},
"lastBootTime": "A String", # Last time the OS was booted.
"machineName": "A String", # Machine name.
"network": { # Runtime networking information. # Runtime network information (connections, ports).
"connections": { # Network connection list. # Network connections.
"entries": [ # Network connection entries.
{
"localIpAddress": "A String", # Local IP address.
"localPort": 42, # Local port.
"pid": "A String", # Process ID.
"processName": "A String", # Process or service name.
"protocol": "A String", # Connection protocol (e.g. TCP/UDP).
"remoteIpAddress": "A String", # Remote IP address.
"remotePort": 42, # Remote port.
"state": "A String", # Network connection state.
},
],
},
"scanTime": "A String", # Time of the last network scan.
},
"openFileList": { # Open file list. # Open files information.
"entries": [ # Open file details entries.
{ # Open file Information.
"command": "A String", # Opened file command.
"filePath": "A String", # Opened file file path.
"fileType": "A String", # Opened file file type.
"user": "A String", # Opened file user.
},
],
},
"processes": { # List of running guest OS processes. # Running processes.
"entries": [ # Running process entries.
{ # Guest OS running process details.
"attributes": { # Process extended attributes.
"a_key": "A String",
},
"cmdline": "A String", # Process full command line.
"exePath": "A String", # Process binary path.
"pid": "A String", # Process ID.
"user": "A String", # User running the process.
},
],
},
"services": { # List of running guest OS services. # Running background services.
"entries": [ # Running service entries.
{ # Guest OS running service details.
"cmdline": "A String", # Service command line.
"exePath": "A String", # Service binary path.
"pid": "A String", # Service pid.
"serviceName": "A String", # Service name.
"startMode": "A String", # Service start mode (OS-agnostic).
"state": "A String", # Service state (OS-agnostic).
},
],
},
},
"version": "A String", # The version of the operating system.
},
"machineName": "A String", # Machine name.
"memoryMb": 42, # The amount of memory in the machine. Must be non-negative.
"network": { # Details of network adapters and settings. # Network details.
"adapters": { # List of network adapters. # List of network adapters.
"entries": [ # Network adapter entries.
{ # Details of network adapter.
"adapterType": "A String", # Network adapter type (e.g. VMXNET3).
"addresses": { # List of allocated/assigned network addresses. # NetworkAddressList
"entries": [ # Network address entries.
{ # Details of network address.
"assignment": "A String", # Whether DHCP is used to assign addresses.
"bcast": "A String", # Broadcast address.
"fqdn": "A String", # Fully qualified domain name.
"ipAddress": "A String", # Assigned or configured IP Address.
"subnetMask": "A String", # Subnet mask.
},
],
},
"macAddress": "A String", # MAC address.
},
],
},
"primaryIpAddress": "A String", # The primary IP address of the machine.
"primaryMacAddress": "A String", # MAC address of the machine. This property is used to uniqly identify the machine.
"publicIpAddress": "A String", # The public IP address of the machine.
},
"platform": { # Information about the platform. # Platform specific information.
"awsEc2Details": { # AWS EC2 specific details. # AWS EC2 specific details.
"hyperthreading": "A String", # Optional. Whether the machine is hyperthreaded.
"location": "A String", # The location of the machine in the AWS format.
"machineTypeLabel": "A String", # AWS platform's machine type label.
},
"azureVmDetails": { # Azure VM specific details. # Azure VM specific details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # The location of the machine in the Azure format.
"machineTypeLabel": "A String", # Azure platform's machine type label.
"provisioningState": "A String", # Azure platform's provisioning state.
},
"genericDetails": { # Generic platform details. # Generic platform details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # Free text representation of the machine location. The format of this field should not be relied on. Different VMs in the same location may have different string values for this field.
},
"physicalDetails": { # Platform specific details for Physical Machines. # Physical machines platform details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # Free text representation of the machine location. The format of this field should not be relied on. Different machines in the same location may have different string values for this field.
},
"vmwareDetails": { # VMware specific details. # VMware specific details.
"esxHyperthreading": "A String", # Whether the ESX is hyperthreaded.
"esxVersion": "A String", # ESX version.
"osid": "A String", # VMware os enum - https://vdc-repo.vmware.com/vmwb-repository/dcr-public/da47f910-60ac-438b-8b9b-6122f4d14524/16b7274a-bf8b-4b4c-a05e-746f2aa93c8c/doc/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html.
"vcenterFolder": "A String", # Folder name in vCenter where asset resides.
"vcenterUri": "A String", # vCenter URI used in collection.
"vcenterVersion": "A String", # vCenter version.
"vcenterVmId": "A String", # vCenter VM ID.
},
},
"powerState": "A String", # Power state of the machine.
"uuid": "A String", # Machine unique identifier.
},
"name": "A String", # Output only. The full name of the asset.
"performanceData": { # Performance data for an asset. # Output only. Performance data for the asset.
"dailyResourceUsageAggregations": [ # Daily resource usage aggregations. Contains all of the data available for an asset, up to the last 420 days. Aggregations are sorted from oldest to most recent.
{ # Usage data aggregation for a single day.
"cpu": { # Statistical aggregation of CPU usage. # CPU usage.
"utilizationPercentage": { # Statistical aggregation of samples for a single resource usage. # CPU utilization percentage.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
"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: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # Aggregation date. Day boundaries are at midnight UTC.
"day": 42, # 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.
"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
"disk": { # Statistical aggregation of disk usage. # Disk usage.
"iops": { # Statistical aggregation of samples for a single resource usage. # Disk I/O operations per second.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
"memory": { # Statistical aggregation of memory usage. # Memory usage.
"utilizationPercentage": { # Statistical aggregation of samples for a single resource usage. # Memory utilization percentage.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
"network": { # Statistical aggregation of network usage. # Network usage.
"egressBps": { # Statistical aggregation of samples for a single resource usage. # Network egress in B/s.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
"ingressBps": { # Statistical aggregation of samples for a single resource usage. # Network ingress in B/s.
"average": 3.14, # Average usage value.
"median": 3.14, # Median usage value.
"ninteyFifthPercentile": 3.14, # 95th percentile usage value.
"peak": 3.14, # Peak usage value.
},
},
},
],
},
"sources": [ # Output only. The list of sources contributing to the asset.
"A String",
],
"updateTime": "A String", # Output only. The timestamp when the asset was last updated.
}
reportAssetFrames(parent, body=None, source=None, x__xgafv=None)
Reports a set of frames.
Args:
parent: string, Required. Parent of the resource. (required)
body: object, The request body.
The object takes the form of:
{ # Collection of frame data.
"framesData": [ # A repeated field of asset data.
{ # Contains data reported from an inventory source on an asset.
"attributes": { # Generic asset attributes.
"a_key": "A String",
},
"collectionType": "A String", # Optional. Frame collection type, if not specified the collection type will be based on the source type of the source the frame was reported on.
"labels": { # Labels as key value pairs.
"a_key": "A String",
},
"machineDetails": { # Details of a machine. # Asset information specific for virtual machines.
"architecture": { # Details of the machine architecture. # Architecture details (vendor, CPU architecture).
"bios": { # Details about the BIOS. # BIOS Details.
"biosName": "A String", # BIOS name. This fields is deprecated. Please use the `id` field instead.
"id": "A String", # BIOS ID.
"manufacturer": "A String", # BIOS manufacturer.
"releaseDate": { # 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: * google.type.TimeOfDay * google.type.DateTime * google.protobuf.Timestamp # BIOS release date.
"day": 42, # 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.
"month": 42, # Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
"year": 42, # Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
},
"smbiosUuid": "A String", # SMBIOS UUID.
"version": "A String", # BIOS version.
},
"cpuArchitecture": "A String", # CPU architecture, e.g., "x64-based PC", "x86_64", "i686" etc.
"cpuName": "A String", # CPU name, e.g., "Intel Xeon E5-2690", "AMD EPYC 7571" etc.
"cpuSocketCount": 42, # Number of processor sockets allocated to the machine.
"cpuThreadCount": 42, # Deprecated: use MachineDetails.core_count instead. Number of CPU threads allocated to the machine.
"firmwareType": "A String", # Firmware type.
"hyperthreading": "A String", # CPU hyper-threading support.
"vendor": "A String", # Hardware vendor.
},
"coreCount": 42, # Number of logical CPU cores in the machine. Must be non-negative.
"createTime": "A String", # Machine creation time.
"disks": { # Details of machine disks. # Disk details.
"disks": { # VM disks. # List of disks.
"entries": [ # Disk entries.
{ # Single disk entry.
"capacityBytes": "A String", # Disk capacity.
"diskLabel": "A String", # Disk label.
"diskLabelType": "A String", # Disk label type (e.g. BIOS/GPT)
"freeBytes": "A String", # Disk free space.
"hwAddress": "A String", # Disk hardware address (e.g. 0:1 for SCSI).
"interfaceType": "A String", # Disks interface type.
"partitions": { # Disk partition list. # Partition layout.
"entries": [ # Partition entries.
{ # Disk Partition details.
"capacityBytes": "A String", # Partition capacity.
"fileSystem": "A String", # Partition file system.
"freeBytes": "A String", # Partition free space.
"mountPoint": "A String", # Mount pount (Linux/Windows) or drive letter (Windows).
"subPartitions": # Object with schema name: DiskPartitionList # Sub-partitions.
"type": "A String", # Partition type.
"uuid": "A String", # Partition UUID.
},
],
},
"vmware": { # VMware disk config details. # VMware disk details.
"backingType": "A String", # VMDK backing type.
"rdmCompatibility": "A String", # RDM compatibility mode.
"shared": True or False, # Is VMDK shared with other VMs.
"vmdkMode": "A String", # VMDK disk mode.
},
},
],
},
"totalCapacityBytes": "A String", # Disk total Capacity.
"totalFreeBytes": "A String", # Total disk free space.
},
"guestOs": { # Information from Guest-level collections. # Guest OS information.
"config": { # Guest OS config information. # OS and app configuration.
"fstab": { # Fstab content. # Mount list (Linux fstab).
"entries": [ # Fstab entries.
{ # Single fstab entry.
"file": "A String", # The mount point for the filesystem.
"freq": 42, # Used by dump to determine which filesystems need to be dumped.
"mntops": "A String", # Mount options associated with the filesystem.
"passno": 42, # Used by the fsck(8) program to determine the order in which filesystem checks are done at reboot time.
"spec": "A String", # The block special device or remote filesystem to be mounted.
"vfstype": "A String", # The type of the filesystem.
},
],
},
"hosts": { # Hosts content. # Hosts file (/etc/hosts).
"entries": [ # Hosts entries.
{ # Single /etc/hosts entry.
"hostNames": [ # List of host names / aliases.
"A String",
],
"ip": "A String", # IP (raw, IPv4/6 agnostic).
},
],
},
"issue": "A String", # OS issue (typically /etc/issue in Linux).
"nfsExports": { # NFS exports. # NFS exports.
"entries": [ # NFS export entries.
{ # NFS export.
"exportDirectory": "A String", # The directory being exported.
"hosts": [ # The hosts or networks to which the export is being shared.
"A String",
],
},
],
},
"selinuxMode": "A String", # Security-Enhanced Linux (SELinux) mode.
},
"family": "A String", # What family the OS belong to, if known.
"osName": "A String", # The name of the operating system.
"runtime": { # Guest OS runtime information. # Runtime information.
"domain": "A String", # Domain, e.g. c.stratozone-development.internal.
"installedApps": { # Guest installed application list. # Installed applications information.
"entries": [ # Application entries.
{ # Guest installed application information.
"applicationName": "A String", # Installed application name.
"installTime": "A String", # The time when the application was installed.
"licenses": [ # License strings associated with the installed application.
"A String",
],
"path": "A String", # Source path.
"vendor": "A String", # Installed application vendor.
"version": "A String", # Installed application version.
},
],
},
"lastBootTime": "A String", # Last time the OS was booted.
"machineName": "A String", # Machine name.
"network": { # Runtime networking information. # Runtime network information (connections, ports).
"connections": { # Network connection list. # Network connections.
"entries": [ # Network connection entries.
{
"localIpAddress": "A String", # Local IP address.
"localPort": 42, # Local port.
"pid": "A String", # Process ID.
"processName": "A String", # Process or service name.
"protocol": "A String", # Connection protocol (e.g. TCP/UDP).
"remoteIpAddress": "A String", # Remote IP address.
"remotePort": 42, # Remote port.
"state": "A String", # Network connection state.
},
],
},
"scanTime": "A String", # Time of the last network scan.
},
"openFileList": { # Open file list. # Open files information.
"entries": [ # Open file details entries.
{ # Open file Information.
"command": "A String", # Opened file command.
"filePath": "A String", # Opened file file path.
"fileType": "A String", # Opened file file type.
"user": "A String", # Opened file user.
},
],
},
"processes": { # List of running guest OS processes. # Running processes.
"entries": [ # Running process entries.
{ # Guest OS running process details.
"attributes": { # Process extended attributes.
"a_key": "A String",
},
"cmdline": "A String", # Process full command line.
"exePath": "A String", # Process binary path.
"pid": "A String", # Process ID.
"user": "A String", # User running the process.
},
],
},
"services": { # List of running guest OS services. # Running background services.
"entries": [ # Running service entries.
{ # Guest OS running service details.
"cmdline": "A String", # Service command line.
"exePath": "A String", # Service binary path.
"pid": "A String", # Service pid.
"serviceName": "A String", # Service name.
"startMode": "A String", # Service start mode (OS-agnostic).
"state": "A String", # Service state (OS-agnostic).
},
],
},
},
"version": "A String", # The version of the operating system.
},
"machineName": "A String", # Machine name.
"memoryMb": 42, # The amount of memory in the machine. Must be non-negative.
"network": { # Details of network adapters and settings. # Network details.
"adapters": { # List of network adapters. # List of network adapters.
"entries": [ # Network adapter entries.
{ # Details of network adapter.
"adapterType": "A String", # Network adapter type (e.g. VMXNET3).
"addresses": { # List of allocated/assigned network addresses. # NetworkAddressList
"entries": [ # Network address entries.
{ # Details of network address.
"assignment": "A String", # Whether DHCP is used to assign addresses.
"bcast": "A String", # Broadcast address.
"fqdn": "A String", # Fully qualified domain name.
"ipAddress": "A String", # Assigned or configured IP Address.
"subnetMask": "A String", # Subnet mask.
},
],
},
"macAddress": "A String", # MAC address.
},
],
},
"primaryIpAddress": "A String", # The primary IP address of the machine.
"primaryMacAddress": "A String", # MAC address of the machine. This property is used to uniqly identify the machine.
"publicIpAddress": "A String", # The public IP address of the machine.
},
"platform": { # Information about the platform. # Platform specific information.
"awsEc2Details": { # AWS EC2 specific details. # AWS EC2 specific details.
"hyperthreading": "A String", # Optional. Whether the machine is hyperthreaded.
"location": "A String", # The location of the machine in the AWS format.
"machineTypeLabel": "A String", # AWS platform's machine type label.
},
"azureVmDetails": { # Azure VM specific details. # Azure VM specific details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # The location of the machine in the Azure format.
"machineTypeLabel": "A String", # Azure platform's machine type label.
"provisioningState": "A String", # Azure platform's provisioning state.
},
"genericDetails": { # Generic platform details. # Generic platform details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # Free text representation of the machine location. The format of this field should not be relied on. Different VMs in the same location may have different string values for this field.
},
"physicalDetails": { # Platform specific details for Physical Machines. # Physical machines platform details.
"hyperthreading": "A String", # Whether the machine is hyperthreaded.
"location": "A String", # Free text representation of the machine location. The format of this field should not be relied on. Different machines in the same location may have different string values for this field.
},
"vmwareDetails": { # VMware specific details. # VMware specific details.
"esxHyperthreading": "A String", # Whether the ESX is hyperthreaded.
"esxVersion": "A String", # ESX version.
"osid": "A String", # VMware os enum - https://vdc-repo.vmware.com/vmwb-repository/dcr-public/da47f910-60ac-438b-8b9b-6122f4d14524/16b7274a-bf8b-4b4c-a05e-746f2aa93c8c/doc/vim.vm.GuestOsDescriptor.GuestOsIdentifier.html.
"vcenterFolder": "A String", # Folder name in vCenter where asset resides.
"vcenterUri": "A String", # vCenter URI used in collection.
"vcenterVersion": "A String", # vCenter version.
"vcenterVmId": "A String", # vCenter VM ID.
},
},
"powerState": "A String", # Power state of the machine.
"uuid": "A String", # Machine unique identifier.
},
"performanceSamples": [ # Asset performance data samples. Samples that are from more than 40 days ago or after tomorrow are ignored.
{ # Performance data sample.
"cpu": { # CPU usage sample. # CPU usage sample.
"utilizedPercentage": 3.14, # Percentage of total CPU capacity utilized. Must be in the interval [0, 100]. On most systems can be calculated using 100 - idle percentage.
},
"disk": { # Disk usage sample. Values are across all disks. # Disk usage sample.
"averageIops": 3.14, # Average IOPS sampled over a short window. Must be non-negative.
},
"memory": { # Memory usage sample. # Memory usage sample.
"utilizedPercentage": 3.14, # Percentage of system memory utilized. Must be in the interval [0, 100].
},
"network": { # Network usage sample. Values are across all network interfaces. # Network usage sample.
"averageEgressBps": 3.14, # Average network egress in B/s sampled over a short window. Must be non-negative.
"averageIngressBps": 3.14, # Average network ingress in B/s sampled over a short window. Must be non-negative.
},
"sampleTime": "A String", # Time the sample was collected. If omitted, the frame report time will be used.
},
],
"reportTime": "A String", # The time the data was reported.
"traceToken": "A String", # Optional. Trace token is optionally provided to assist with debugging and traceability.
},
],
}
source: string, Required. Reference to a source.
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A response to a call to `ReportAssetFrame`.
}