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

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

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

Updates the parameters of a list of assets.

## Path parameters

- `parent` string, required

## Request body

- BatchUpdateAssetsRequest — A request to update a list of assets.
  - `requests` UpdateAssetRequest[] — Required. The request message specifying the resources to update. A maximum of 1000 assets can be modified in a batch.
    - `updateMask` string, google-fieldmask — 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.
    - `asset` Asset — An asset represents a resource in your environment. Asset types include virtual machines and databases.
      - `name` string — Output only. The full name of the asset.
      - `labels` object — Labels as key value pairs.
      - `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.
              - …
          - `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.
              - …
      - `sources` string[] — Output only. The list of sources contributing to the asset.
      - `hideReason` string — Optional. An optional reason for marking this asset as hidden.
      - `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.
              - …
            - `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.
      - `hideTime` string, google-datetime — Output only. The timestamp when the asset was marked as hidden.
      - `insightList` InsightList — Message containing insights list.
        - `insights` Insight[] — Output only. Insights of the list.
          - `migrationInsight` MigrationInsight — An insight about potential migrations for an asset.
            - `fit` FitDescriptor — Describes the fit level of an asset for migration to a specific target.
              - …
            - `computeEngineTarget` ComputeEngineMigrationTarget — Compute engine migration target.
              - …
          - `genericInsight` GenericInsight — A generic insight about an asset.
            - `additionalInformation` string[] — 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.
            - `defaultMessage` 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` string, int64 — 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.
        - `updateTime` string, google-datetime — Output only. Update timestamp.
      - `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.
              - …
          - `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.
              - …
          - `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.
              - …
            - `fstab` FstabEntryList — Fstab content.
              - …
            - `nfsExports` NfsExportList — NFS exports.
              - …
            - `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.
              - …
            - `network` RuntimeNetworkInfo — Runtime networking information.
              - …
            - `lastBootTime` string, google-datetime — Last time the OS was booted.
            - `processes` RunningProcessList — List of running guest OS processes.
              - …
            - `openFileList` OpenFileList — Open file list.
              - …
            - `domain` string — Domain, e.g. c.stratozone-development.internal.
            - `installedApps` GuestInstalledApplicationList — Guest installed application list.
              - …
            - `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.
              - …
          - `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
              - …
            - `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.
      - `createTime` string, google-datetime — Output only. The timestamp when the asset was created.
      - `updateTime` string, google-datetime — Output only. The timestamp when the asset was last updated.
      - `assignedGroups` string[] — Output only. The list of groups that the asset is assigned to.
      - `attributes` object — Generic asset attributes.
      - `title` string — Output only. Server generated human readable name of the asset.
      - `hidden` boolean — Optional. Indicates if the asset is hidden.
      - `performanceData` AssetPerformanceData — Performance data for an asset.
        - `dailyResourceUsageAggregations` DailyResourceUsageAggregation[] — 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.
          - `memory` DailyResourceUsageAggregationMemory — Statistical aggregation of memory usage.
            - `utilizationPercentage` DailyResourceUsageAggregationStats — Statistical aggregation of samples for a single resource usage.
              - …
          - `date` 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.
          - `cpu` DailyResourceUsageAggregationCPU — Statistical aggregation of CPU usage.
            - `utilizationPercentage` DailyResourceUsageAggregationStats — Statistical aggregation of samples for a single resource usage.
              - …
          - `network` DailyResourceUsageAggregationNetwork — Statistical aggregation of network usage.
            - `egressBps` DailyResourceUsageAggregationStats — Statistical aggregation of samples for a single resource usage.
              - …
            - `ingressBps` DailyResourceUsageAggregationStats — Statistical aggregation of samples for a single resource usage.
              - …
          - `disk` DailyResourceUsageAggregationDisk — Statistical aggregation of disk usage.
            - `iops` DailyResourceUsageAggregationStats — Statistical aggregation of samples for a single resource usage.
              - …
            - `readIops` DailyResourceUsageAggregationStats — Statistical aggregation of samples for a single resource usage.
              - …
            - `writeIops` DailyResourceUsageAggregationStats — Statistical aggregation of samples for a single resource usage.
              - …
    - `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).

## 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)
