---
title: "POST /v1/{+parent}/assets:reportAssetFrames"
method: POST
path: "/v1/{+parent}/assets:reportAssetFrames"
tags: ["projects"]
---

# POST /v1/{+parent}/assets:reportAssetFrames

`POST /v1/{+parent}/assets:reportAssetFrames`

Reports a set of frames.

## Path parameters

- `parent` string, required

## Query parameters

- `source` string

## Request body

- Frames — Collection of frame data.
  - `framesData` AssetFrame[] — A repeated field of asset data.
    - `labels` object — Labels as key value pairs.
    - `machineDetails` MachineDetails — Details of a machine.
      - `uuid` string — Machine unique identifier.
      - `platform` PlatformDetails — Information about the platform.
        - `azureVmDetails` AzureVmPlatformDetails — Azure VM specific details.
          - `location` string — The location of the machine in the Azure format.
          - `provisioningState` string — Azure platform's provisioning state.
          - `machineTypeLabel` string — Azure platform's machine type label.
          - `hyperthreading` 'HYPERTHREADING_STATUS_UNSPECIFIED' | 'HYPERTHREADING_STATUS_DISABLED' | 'HYPERTHREADING_STATUS_ENABLED' — Whether the machine is hyperthreaded.
        - `genericDetails` GenericPlatformDetails — Generic platform details.
          - `hyperthreading` 'HYPERTHREADING_STATUS_UNSPECIFIED' | 'HYPERTHREADING_STATUS_DISABLED' | 'HYPERTHREADING_STATUS_ENABLED' — Whether the machine is hyperthreaded.
          - `location` 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.
        - `awsEc2Details` AwsEc2PlatformDetails — AWS EC2 specific details.
          - `machineTypeLabel` string — AWS platform's machine type label.
          - `hyperthreading` 'HYPERTHREADING_STATUS_UNSPECIFIED' | 'HYPERTHREADING_STATUS_DISABLED' | 'HYPERTHREADING_STATUS_ENABLED' — Optional. Whether the machine is hyperthreaded.
          - `location` string — The location of the machine in the AWS format.
        - `physicalDetails` PhysicalPlatformDetails — Platform specific details for Physical Machines.
          - `location` 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.
          - `hyperthreading` 'HYPERTHREADING_STATUS_UNSPECIFIED' | 'HYPERTHREADING_STATUS_DISABLED' | 'HYPERTHREADING_STATUS_ENABLED' — Whether the machine is hyperthreaded.
        - `vmwareDetails` VmwarePlatformDetails — VMware specific details.
          - `osid` 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` string — Folder name in vCenter where asset resides.
          - `esxHyperthreading` 'HYPERTHREADING_STATUS_UNSPECIFIED' | 'HYPERTHREADING_STATUS_DISABLED' | 'HYPERTHREADING_STATUS_ENABLED' — Whether the ESX is hyperthreaded.
          - `vcenterVmId` string — vCenter VM ID.
          - `vcenterVersion` string — vCenter version.
          - `esxVersion` string — ESX version.
          - `vcenterUri` string — vCenter URI used in collection.
      - `disks` MachineDiskDetails — Details of machine disks.
        - `disks` DiskEntryList — VM disks.
          - `entries` DiskEntry[] — Disk entries.
            - `diskLabel` string — Disk label.
            - `interfaceType` 'INTERFACE_TYPE_UNSPECIFIED' | 'IDE' | 'SATA' | 'SAS' | 'SCSI' | 'NVME' | 'FC' | 'ISCSI' — Disks interface type.
            - `freeBytes` string, int64 — Disk free space.
            - `vmware` VmwareDiskConfig — VMware disk config details.
              - …
            - `diskLabelType` string — Disk label type (e.g. BIOS/GPT)
            - `capacityBytes` string, int64 — Disk capacity.
            - `partitions` DiskPartitionList — Disk partition list.
              - …
            - `hwAddress` string — Disk hardware address (e.g. 0:1 for SCSI).
        - `totalCapacityBytes` string, int64 — Disk total Capacity.
        - `totalFreeBytes` string, int64 — Total disk free space.
      - `network` MachineNetworkDetails — Details of network adapters and settings.
        - `primaryIpAddress` string — The primary IP address of the machine.
        - `defaultGateway` string — Optional. Default gateway address.
        - `adapters` NetworkAdapterList — List of network adapters.
          - `entries` NetworkAdapterDetails[] — Network adapter entries.
            - `addresses` NetworkAddressList — List of allocated/assigned network addresses.
              - …
            - `adapterType` string — Network adapter type (e.g. VMXNET3).
            - `macAddress` string — MAC address.
        - `publicIpAddress` string — The public IP address of the machine.
        - `primaryMacAddress` string — MAC address of the machine. This property is used to uniqly identify the machine.
      - `coreCount` integer — Number of logical CPU cores in the machine. Must be non-negative.
      - `machineName` string — Machine name.
      - `memoryMb` integer — The amount of memory in the machine. Must be non-negative.
      - `guestOs` GuestOsDetails — Information from Guest-level collections.
        - `osName` string — The name of the operating system.
        - `version` string — The version of the operating system.
        - `family` 'OS_FAMILY_UNKNOWN' | 'OS_FAMILY_WINDOWS' | 'OS_FAMILY_LINUX' | 'OS_FAMILY_UNIX' — What family the OS belong to, if known.
        - `config` GuestConfigDetails — Guest OS config information.
          - `hosts` HostsEntryList — Hosts content.
            - `entries` HostsEntry[] — Hosts entries.
              - …
          - `fstab` FstabEntryList — Fstab content.
            - `entries` FstabEntry[] — Fstab entries.
              - …
          - `nfsExports` NfsExportList — NFS exports.
            - `entries` NfsExport[] — NFS export entries.
              - …
          - `issue` string — OS issue (typically /etc/issue in Linux).
          - `selinuxMode` 'SE_LINUX_MODE_UNSPECIFIED' | 'SE_LINUX_MODE_DISABLED' | 'SE_LINUX_MODE_PERMISSIVE' | 'SE_LINUX_MODE_ENFORCING' — Security-Enhanced Linux (SELinux) mode.
        - `runtime` GuestRuntimeDetails — Guest OS runtime information.
          - `services` RunningServiceList — List of running guest OS services.
            - `entries` RunningService[] — Running service entries.
              - …
          - `network` RuntimeNetworkInfo — Runtime networking information.
            - `scanTime` string, google-datetime — Time of the last network scan.
            - `connections` NetworkConnectionList — Network connection list.
              - …
          - `lastBootTime` string, google-datetime — Last time the OS was booted.
          - `processes` RunningProcessList — List of running guest OS processes.
            - `entries` RunningProcess[] — Running process entries.
              - …
          - `openFileList` OpenFileList — Open file list.
            - `entries` OpenFileDetails[] — Open file details entries.
              - …
          - `domain` string — Domain, e.g. c.stratozone-development.internal.
          - `installedApps` GuestInstalledApplicationList — Guest installed application list.
            - `entries` GuestInstalledApplication[] — Application entries.
              - …
          - `machineName` string — Machine name.
      - `diskPartitions` DiskPartitionDetails — Disk partition details.
        - `freeSpaceBytes` string, int64 — Output only. Total free space of all partitions.
        - `partitions` DiskPartitionList — Disk partition list.
          - `entries` DiskPartition[] — Partition entries.
            - `freeBytes` string, int64 — Partition free space.
            - `mountPoint` string — Mount point (Linux/Windows) or drive letter (Windows).
            - `capacityBytes` string, int64 — Partition capacity.
            - `fileSystem` string — Partition file system.
            - `subPartitions` DiskPartitionList — recursive
            - `type` string — Partition type.
            - `uuid` string — Partition UUID.
        - `totalCapacityBytes` string, int64 — Output only. Total capacity of all partitions.
      - `createTime` string, google-datetime — Machine creation time.
      - `architecture` MachineArchitectureDetails — Details of the machine architecture.
        - `cpuArchitecture` string — CPU architecture, e.g., "x64-based PC", "x86_64", "i686" etc.
        - `cpuName` string — CPU name, e.g., "Intel Xeon E5-2690", "AMD EPYC 7571" etc.
        - `vendor` string — Hardware vendor.
        - `firmwareType` 'FIRMWARE_TYPE_UNSPECIFIED' | 'BIOS' | 'EFI' — Firmware type.
        - `cpuSocketCount` integer — Number of processor sockets allocated to the machine.
        - `cpuManufacturer` string — Optional. CPU manufacturer, e.g., "Intel", "AMD".
        - `cpuThreadCount` integer — Deprecated: use MachineDetails.core_count instead. Number of CPU threads allocated to the machine.
        - `bios` BiosDetails — Details about the BIOS.
          - `biosName` string — BIOS name. This fields is deprecated. Please use the `id` field instead.
          - `id` string — BIOS ID.
          - `releaseDate` 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
            - `month` integer — Month of a year. Must be from 1 to 12, or 0 to specify a year without a month and day.
            - `day` integer — Day of a month. Must be from 1 to 31 and valid for the year and month, or 0 to specify a year by itself or a year and month where the day isn't significant.
            - `year` integer — Year of the date. Must be from 1 to 9999, or 0 to specify a date without a year.
          - `smbiosUuid` string — SMBIOS UUID.
          - `manufacturer` string — BIOS manufacturer.
          - `version` string — BIOS version.
        - `hyperthreading` 'CPU_HYPER_THREADING_UNSPECIFIED' | 'DISABLED' | 'ENABLED' — CPU hyper-threading support.
      - `powerState` 'POWER_STATE_UNSPECIFIED' | 'PENDING' | 'ACTIVE' | 'SUSPENDING' | 'SUSPENDED' | 'DELETING' | 'DELETED' — Power state of the machine.
    - `traceToken` string — Optional. Trace token is optionally provided to assist with debugging and traceability.
    - `databaseDeploymentDetails` DatabaseDeploymentDetails — The details of a database deployment asset.
      - `mysql` MysqlDatabaseDeployment — Specific details for a Mysql database deployment.
        - `properties` MySqlProperty[] — Optional. List of MySql properties.
          - `property` string — Required. The property name.
          - `numericValue` string, int64 — Required. The property numeric value.
          - `enabled` boolean — Required. The property is enabled.
        - `plugins` MySqlPlugin[] — Optional. List of MySql plugins.
          - `plugin` string — Required. The plugin name.
          - `enabled` boolean — Required. The plugin is active.
          - `version` string — Required. The plugin version.
        - `variables` MySqlVariable[] — Optional. List of MySql variables.
          - `value` string — Required. The variable value.
          - `category` string — Required. The variable category.
          - `variable` string — Required. The variable name.
        - `resourceGroupsCount` integer — Optional. Number of resource groups.
      - `awsRds` AwsRds — Specific details for an AWS RDS database deployment.
      - `aggregatedStats` DatabaseDeploymentDetailsAggregatedStats — Aggregated stats for the database deployment.
        - `databaseCount` integer — Output only. The number of databases in the deployment.
      - `generatedId` string — Optional. The database deployment generated ID.
      - `manualUniqueId` string — Optional. A manual unique ID set by the user.
      - `topology` DatabaseDeploymentTopology — Details of database deployment's topology.
        - `coreCount` integer — Optional. Number of total logical cores.
        - `coreLimit` integer — Optional. Number of total logical cores limited by db deployment.
        - `physicalCoreCount` integer — Optional. Number of total physical cores.
        - `memoryBytes` string, int64 — Optional. Total memory in bytes.
        - `physicalCoreLimit` integer — Optional. Number of total physical cores limited by db deployment.
        - `diskAllocatedBytes` string, int64 — Optional. Disk allocated in bytes.
        - `diskUsedBytes` string, int64 — Optional. Disk used in bytes.
        - `instances` DatabaseInstance[] — Optional. List of database instances.
          - `instanceName` string — Optional. The instance's name.
          - `network` DatabaseInstanceNetwork — Network details of a database instance.
            - `ipAddresses` string[] — Optional. The instance's IP addresses.
            - `primaryMacAddress` string — Optional. The instance's primary MAC address.
            - `hostNames` string[] — Optional. The instance's host names.
          - `role` 'ROLE_UNSPECIFIED' | 'PRIMARY' | 'SECONDARY' | 'ARBITER' — Optional. The instance role in the database engine.
        - `memoryLimitBytes` string, int64 — Optional. Total memory in bytes limited by db deployment.
      - `version` string — Optional. The database deployment version.
      - `edition` string — Optional. The database deployment edition.
      - `sqlServer` SqlServerDatabaseDeployment — Specific details for a Microsoft SQL Server database deployment.
        - `features` SqlServerFeature[] — Optional. List of SQL Server features.
          - `enabled` boolean — Required. Field enabled is set when a feature is used on the source deployment.
          - `featureName` string — Required. The feature name.
        - `serverFlags` SqlServerServerFlag[] — Optional. List of SQL Server server flags.
          - `serverFlagName` string — Required. The server flag name.
          - `value` string — Required. The server flag value set by the user.
          - `valueInUse` string — Required. The server flag actual value. If `value_in_use` is different from `value` it means that either the configuration change was not applied or it is an expected behavior. See SQL Server documentation for more details.
        - `traceFlags` SqlServerTraceFlag[] — Optional. List of SQL Server trace flags.
          - `traceFlagName` string — Required. The trace flag name.
          - `scope` 'SCOPE_UNSPECIFIED' | 'OFF' | 'GLOBAL' | 'SESSION' — Required. The trace flag scope.
      - `postgresql` PostgreSqlDatabaseDeployment — Specific details for a PostgreSQL database deployment.
        - `properties` PostgreSqlProperty[] — Optional. List of PostgreSql properties.
          - `enabled` boolean — Required. The property is enabled.
          - `property` string — Required. The property name.
          - `numericValue` string, int64 — Required. The property numeric value.
        - `settings` PostgreSqlSetting[] — Optional. List of PostgreSql settings.
          - `intValue` string, int64 — Required. The setting int value.
          - `realValue` number, float — Required. The setting real value.
          - `boolValue` boolean — Required. The setting boolean value.
          - `unit` string — Optional. The setting unit.
          - `setting` string — Required. The setting name.
          - `source` string — Required. The setting source.
          - `stringValue` string — Required. The setting string value. Notice that enum values are stored as strings.
    - `reportTime` string, google-datetime — The time the data was reported.
    - `performanceSamples` PerformanceSample[] — Asset performance data samples. Samples that are from more than 40 days ago or after tomorrow are ignored.
      - `memory` MemoryUsageSample — Memory usage sample.
        - `utilizedPercentage` number, float — Percentage of system memory utilized. Must be in the interval [0, 100].
      - `sampleTime` string, google-datetime — Time the sample was collected. If omitted, the frame report time will be used.
      - `disk` DiskUsageSample — Disk usage sample. Values are across all disks.
        - `averageReadIops` number, float — Optional. Average read IOPS sampled over a short window. Must be non-negative. If both read and write are zero they are ignored.
        - `averageIops` number, float — Optional. Average IOPS sampled over a short window. Must be non-negative. If read or write are set, the sum of read and write will override the value of the average_iops.
        - `averageWriteIops` number, float — Optional. Average write IOPS sampled over a short window. Must be non-negative. If both read and write are zero they are ignored.
      - `cpu` CpuUsageSample — CPU usage sample.
        - `utilizedPercentage` number, float — Percentage of total CPU capacity utilized. Must be in the interval [0, 100]. On most systems can be calculated using 100 - idle percentage.
      - `network` NetworkUsageSample — Network usage sample. Values are across all network interfaces.
        - `averageIngressBps` number, float — Average network ingress in B/s sampled over a short window. Must be non-negative.
        - `averageEgressBps` number, float — Average network egress in B/s sampled over a short window. Must be non-negative.
    - `collectionType` 'SOURCE_TYPE_UNKNOWN' | 'SOURCE_TYPE_UPLOAD' | 'SOURCE_TYPE_GUEST_OS_SCAN' | 'SOURCE_TYPE_INVENTORY_SCAN' | 'SOURCE_TYPE_CUSTOM' | 'SOURCE_TYPE_DISCOVERY_CLIENT' — 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.
    - `attributes` object — Generic asset attributes.
    - `databaseDetails` DatabaseDetails — Details of a logical database.
      - `databaseName` string — Required. The name of the database.
      - `parentDatabaseDeployment` DatabaseDetailsParentDatabaseDeployment — The identifiers of the parent database deployment.
        - `generatedId` string — Optional. The parent database deployment generated ID.
        - `manualUniqueId` string — Optional. The parent database deployment optional manual unique ID set by the user.
      - `allocatedStorageBytes` string, int64 — Optional. The allocated storage for the database in bytes.
      - `schemas` DatabaseSchema[] — Optional. The database schemas.
        - `mysql` MySqlSchemaDetails — Specific details for a Mysql database.
          - `storageEngines` MySqlStorageEngineDetails[] — Optional. Mysql storage engine tables.
            - `engine` 'ENGINE_UNSPECIFIED' | 'INNODB' | 'MYISAM' | 'MEMORY' | 'CSV' | 'ARCHIVE' | 'BLACKHOLE' | 'NDB' | 'MERGE' | 'FEDERATED' | 'EXAMPLE' | 'OTHER' — Required. The storage engine.
            - `encryptedTableCount` integer — Optional. The number of encrypted tables.
            - `tableCount` integer — Optional. The number of tables.
        - `tablesSizeBytes` string, int64 — Optional. The total size of tables in bytes.
        - `schemaName` string — Required. The name of the schema.
        - `objects` DatabaseObjects[] — Optional. List of details of objects by category.
          - `category` 'CATEGORY_UNSPECIFIED' | 'TABLE' | 'INDEX' | 'CONSTRAINTS' | 'VIEWS' | 'SOURCE_CODE' | 'OTHER' — Optional. The category of the objects.
          - `count` string, int64 — Optional. The number of objects.
        - `sqlServer` SqlServerSchemaDetails — Specific details for a SqlServer database.
          - `clrObjectCount` integer — Optional. SqlServer number of CLR objects.
        - `postgresql` PostgreSqlSchemaDetails — Specific details for a PostgreSql schema.
          - `foreignTablesCount` integer — Optional. PostgreSql foreign tables.
          - `postgresqlExtensions` PostgreSqlExtension[] — Optional. PostgreSql extensions.
            - `version` string — Required. The extension version.
            - `extension` string — Required. The extension name.

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/migrationcenter.md) · [All operations](https://skmtc.dev/google/apis/migrationcenter/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/migrationcenter/revisions/2a8b4eea0432/schema)
