UI validates and imports the OVA file.
Use cases:
1.1 GUI-Based Method for VM Capture & Export
Navigate to Virtual Server Instances → Select VM → Capture.
Select volumes and then go to Next page
Choose destination (Image Catalog, Cloud Object Storage or both).
while selecting COS or Both you need to Specify region, bucket name, Image Name. Provide HMAC access key & secret access key
1.2 GUI-Based Method for Export
From Image Catalog, select image → Export to COS.
Specify
region,
bucket name and provide
HMAC access key & secret key
1.3 GUI-Based Method for Import
From Image Catalog, click Import → Provide COS bucket details.
Specify Image, region, Image Filename, bucket name and Provide HMAC access key & secret access key.
Give custom image name, tier, storage pool and select import image option
Find your newly exported image by completing either one of the following tasks:
-
If you chose to capture and export your volume-backed image to Cloud Object Storage, go to your Cloud Object Storage bucket.
-
If you chose to capture and export your volume-backed image to the image catalog, go to Boot images.
2.1 Add a capture pvm-instance to the jobs queue using API Method
curl -X POST https://us-east.power-iaas.cloud.ibm.com/pcloud/v2/cloud-instances/$CLOUD_INSTANCE_ID/pvm-instances/$PVM_INSTANCE_ID/capture -H "Authorization: Bearer $TOKEN" -H "CRN: $CRN" -H "Content-Type: application/json" -d '{
"captureName": "Capture_File_1",
"captureDestination": "both",
"cloudStorageRegion": "us-east",
"cloudStorageImagePath": "XYZ_Bucket",
"cloudStorageAccessKey": "XXXX-XXXX-XXXX-XXXX",
"cloudStorageSecretKey": "XXXX-XXXX-XXXX-XXXX"
}'
2.2 Add image export job to the jobs queue using API Method
curl -X POST https://us-east.power-iaas.cloud.ibm.com/pcloud/v2/cloud-instances/$CLOUD_INSTANCE_ID/images/$IMAGE_ID/export -H "Authorization: Bearer $TOKEN" -H "CRN: $CRN" -H "Content-Type: application/json" -d '{
"Region": "us-east",
"bucketName": "XYZ_Bucket",
"AccessKey": "XXXX-XXXX-XXXX-XXXX",
"SecretKey": "XXXX-XXXX-XXXX-XXXX"
}
2.3 Create an cos-image import job using API Method
curl -X POST https://us-east.power-iaas.cloud.ibm.com/pcloud/v1/cloud-instances/$CLOUD_INSTANCE_ID/cos-images -H "Authorization: Bearer $TOKEN" -H "CRN: $CRN" -H "Content-Type: application/json"
-d '{
"imageName": "my-image-catalog-name",
"region": "us-east",
"imageFilename": "my-os-image-file.ova.gz",
"bucketName": "my-cos-bucket-name",
"accessKey": "my-cos-bucket-access-key",
"secretKey": "my-cos-bucket-secret-key",
"storageType": "tier3"
"storagePool": "StoragePool-3"
"storageAffinity": {
"affinityPolicy": "affinity",
"affinityPVMInstance": "testVM3",
}
}'
3.1 Using CLI Capture VM
ibmcloud pi instance capture create INSTANCE_ID --destination DEST --name NAME [--access-key KEY] [--image-path PATH] [--region REGION] [--secret-key KEY] [--user-tags USER_TAG1[,USER_TAGn]] [--volumes VOLUME1[,VOLUMEn]]
3.2 Using CLI Export Image
ibmcloud pi image export IMAGE_ID --access-key KEY --bucket BUCKET_NAME --region REGION_NAME --secret-key KEY
3.3 Using CLI Import Image
ibmcloud pi image-import --name IMAGE_NAME --source COS_BUCKET_NAME \
--access-key ACCESS_KEY --secret-key SECRET_KEY --region REGION
Additional CLI Options for Managing VM capture, Export and Import operations
To view the job status or details, run the below commands from the CLI.
Find your newly exported image by completing either one of the following tasks:
-
To see your newly exported image in Cloud Object Storage, use the ibmcloud cos list-objects command:
ibmcloud cos list-objects --bucket BUCKET_NAME [--delimiter DELIMITER] [--encoding-type METHOD] [--prefix PREFIX] [--starting-token TOKEN] [--page-size SIZE] [--max-items NUMBER] [--region REGION] [--json]
Known Limitations: