image_imports

Creates, updates, deletes, gets or lists an image_imports resource.

Overview

Name	image_imports
Type	Resource
Id	google.vmmigration.image_imports

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
name	string	Output only. The resource path of the ImageImport.
cloudStorageUri	string	Immutable. The path to the Cloud Storage file from which the image should be imported.
createTime	string (google-datetime)	Output only. The time the image import was created.
diskImageTargetDefaults	object	Immutable. Target details for importing a disk image, will be used by ImageImportJob. (id: DiskImageTargetDetails)
encryption	object	Immutable. The encryption details used by the image import process during the image adaptation for Compute Engine. (id: Encryption)
machineImageTargetDefaults	object	Immutable. Target details for importing a machine image, will be used by ImageImportJob. (id: MachineImageTargetDetails)
recentImageImportJobs	array	Output only. The result of the most recent runs for this ImageImport. All jobs for this ImageImport can be listed via ListImageImportJobs.

list

Name	Datatype	Description
name	string	Output only. The resource path of the ImageImport.
cloudStorageUri	string	Immutable. The path to the Cloud Storage file from which the image should be imported.
createTime	string (google-datetime)	Output only. The time the image import was created.
diskImageTargetDefaults	object	Immutable. Target details for importing a disk image, will be used by ImageImportJob. (id: DiskImageTargetDetails)
encryption	object	Immutable. The encryption details used by the image import process during the image adaptation for Compute Engine. (id: Encryption)
machineImageTargetDefaults	object	Immutable. Target details for importing a machine image, will be used by ImageImportJob. (id: MachineImageTargetDetails)
recentImageImportJobs	array	Output only. The result of the most recent runs for this ImageImport. All jobs for this ImageImport can be listed via ListImageImportJobs.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	projectsId, locationsId, imageImportsId		Gets details of a single ImageImport.
list	select	projectsId, locationsId	filter, orderBy, pageSize, pageToken	Lists ImageImports in a given project.
create	insert	projectsId, locationsId	imageImportId, requestId	Creates a new ImageImport in a given project.
delete	delete	projectsId, locationsId, imageImportsId	requestId	Deletes a single ImageImport.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
imageImportsId	string
locationsId	string
projectsId	string
filter	string
imageImportId	string
orderBy	string
pageSize	integer (int32)
pageToken	string
requestId	string

SELECT examples

get

Gets details of a single ImageImport.

SELECT
name,
cloudStorageUri,
createTime,
diskImageTargetDefaults,
encryption,
machineImageTargetDefaults,
recentImageImportJobs
FROM google.vmmigration.image_imports
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND imageImportsId = '{{ imageImportsId }}' -- required
;

list

Lists ImageImports in a given project.

SELECT
name,
cloudStorageUri,
createTime,
diskImageTargetDefaults,
encryption,
machineImageTargetDefaults,
recentImageImportJobs
FROM google.vmmigration.image_imports
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND filter = '{{ filter }}'
AND orderBy = '{{ orderBy }}'
AND pageSize = '{{ pageSize }}'
AND pageToken = '{{ pageToken }}'
;

INSERT examples

create

Creates a new ImageImport in a given project.

INSERT INTO google.vmmigration.image_imports (
data__cloudStorageUri,
data__diskImageTargetDefaults,
data__encryption,
data__machineImageTargetDefaults,
projectsId,
locationsId,
imageImportId,
requestId
)
SELECT 
'{{ cloudStorageUri }}',
'{{ diskImageTargetDefaults }}',
'{{ encryption }}',
'{{ machineImageTargetDefaults }}',
'{{ projectsId }}',
'{{ locationsId }}',
'{{ imageImportId }}',
'{{ requestId }}'
RETURNING
name,
done,
error,
metadata,
response
;

Manifest

# Description fields are for documentation purposes
- name: image_imports
props:
  - name: projectsId
    value: "{{ projectsId }}"
    description: Required parameter for the image_imports resource.
  - name: locationsId
    value: "{{ locationsId }}"
    description: Required parameter for the image_imports resource.
  - name: cloudStorageUri
    value: "{{ cloudStorageUri }}"
    description: |
      Immutable. The path to the Cloud Storage file from which the image should be imported.
  - name: diskImageTargetDefaults
    description: |
      Immutable. Target details for importing a disk image, will be used by ImageImportJob.
    value:
      additionalLicenses:
        - "{{ additionalLicenses }}"
      dataDiskImageImport:
        guestOsFeatures:
          - "{{ guestOsFeatures }}"
      description: "{{ description }}"
      encryption:
        kmsKey: "{{ kmsKey }}"
      familyName: "{{ familyName }}"
      imageName: "{{ imageName }}"
      labels: "{{ labels }}"
      osAdaptationParameters:
        adaptationModifiers:
          - modifier: "{{ modifier }}"
            value: "{{ value }}"
        bootConversion: "{{ bootConversion }}"
        generalize: {{ generalize }}
        licenseType: "{{ licenseType }}"
      singleRegionStorage: {{ singleRegionStorage }}
      targetProject: "{{ targetProject }}"
  - name: encryption
    description: |
      Immutable. The encryption details used by the image import process during the image adaptation for Compute Engine.
    value:
      kmsKey: "{{ kmsKey }}"
  - name: machineImageTargetDefaults
    description: |
      Immutable. Target details for importing a machine image, will be used by ImageImportJob.
    value:
      additionalLicenses:
        - "{{ additionalLicenses }}"
      description: "{{ description }}"
      encryption:
        kmsKey: "{{ kmsKey }}"
      labels: "{{ labels }}"
      machineImageName: "{{ machineImageName }}"
      machineImageParametersOverrides:
        machineType: "{{ machineType }}"
      networkInterfaces:
        - externalIp: "{{ externalIp }}"
          internalIp: "{{ internalIp }}"
          network: "{{ network }}"
          networkTier: "{{ networkTier }}"
          subnetwork: "{{ subnetwork }}"
      osAdaptationParameters:
        adaptationModifiers:
          - modifier: "{{ modifier }}"
            value: "{{ value }}"
        bootConversion: "{{ bootConversion }}"
        generalize: {{ generalize }}
        licenseType: "{{ licenseType }}"
      serviceAccount:
        email: "{{ email }}"
        scopes:
          - "{{ scopes }}"
      shieldedInstanceConfig:
        enableIntegrityMonitoring: {{ enableIntegrityMonitoring }}
        enableVtpm: {{ enableVtpm }}
        secureBoot: "{{ secureBoot }}"
      singleRegionStorage: {{ singleRegionStorage }}
      skipOsAdaptation: "{{ skipOsAdaptation }}"
      tags:
        - "{{ tags }}"
      targetProject: "{{ targetProject }}"
  - name: imageImportId
    value: "{{ imageImportId }}"
  - name: requestId
    value: "{{ requestId }}"

DELETE examples

delete

Deletes a single ImageImport.

DELETE FROM google.vmmigration.image_imports
WHERE projectsId = '{{ projectsId }}' --required
AND locationsId = '{{ locationsId }}' --required
AND imageImportsId = '{{ imageImportsId }}' --required
AND requestId = '{{ requestId }}'
;