This is the multi-page printable view of this section. Click here to print.
Create Image
1 - 1.2
scpcli virtualserver image create
--url <value>
--os_distro <value>
--name <value>
[--container_format <value>]
[--disk_format <value>]
[--min_disk <value>]
[--min_ram <value>]
[--protected <value>]
[--tags <value>]
[--visibility <value>]
Description
Create Image.
State ACTIVE (CURRENT)
| Version | Not Before |
|---|---|
| 1.2 | - |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| url required | string | Object Storage URL for Image file (only qcow2 format allowed) | https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2 |
| os_distro required | string | OS distribution of the image to be uploaded | alma |
| name required | string | Image name | imagename |
| container_format optional | string | Container format | bare |
| disk_format optional | string | Disk format | qcow2 |
| min_disk optional | integer | Minimum disk capacity (GB) of the Image to be created | 100 |
| min_ram optional | integer | Minimum RAM capacity (GB) of the Image to be created | 0 |
| protected optional | boolean | whether Image deletion is prohibited | False |
| tags optional | array | Tags | '{"key": "Key", "value": "Value"}' |
| visibility optional | string | Indicates access permissions for the Image. Private: Can be used only within the Account, Shared: Can be shared between Accounts | private |
Responses
| Name | Description | Example |
|---|---|---|
| id | Image ID | 70a599e0-31e7-49b7-b260-868f441e862b |
| checksum | MD5 hash of the entire image data. and this field could be used to verify the integrity of image. | 7538e0fcb56e0e272cfd89eb384d6613 |
| container_format | Container format | bare |
| created_at | Created at | 2025-07-22T09:00:00Z |
| disk_format | Disk format | qcow2 |
| file | The URL for the virtual server image file | /v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file |
| min_disk | Minimum disk capacity (GB) of the Image to be created | 100 |
| min_ram | Minimum RAM capacity (GB) of the Image to be created | 0 |
| name | Image name | imagename |
| os_distro | OS distribution of the image to be uploaded | alma |
| os_hash_algo | OS hash algorithm used to verify image integrity | sha512 |
| os_hash_value | The actual digest of the image binary, calculated with the algorithm indicated by os_hash_algo. The value is presented as a hexadecimal string. | c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99 |
| os_hidden | Whether the image is hidden | False |
| owner | Owner account ID | a8f10467abfc4b87b64614ab36eb9ae4 |
| owner_account_name | Owner account name | AccountName |
| owner_user_name | Owner user name | user@samsung.com |
| protected | whether Image deletion is prohibited | False |
| root_device_name | Root device name | /dev/vda |
| scp_gpu_driver | K8s GPU Image driver version | 535.183.06 |
| scp_image_type | Image type | custom |
| scp_k8s_version | K8S version | v1.28.7 |
| scp_original_image_type | Original Image type | standard |
| scp_os_build_version | OS build version | 20250101 |
| scp_os_version | OS version | 8.8 |
| size | Image size | 2429747200 |
| status | Image status | active |
| updated_at | Updated at | 2025-07-26T12:00:00Z |
| url | Object Storage URL for Image file (only qcow2 format allowed) | https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2 |
| virtual_size | Virtual size | 17179869184 |
| visibility | Indicates access permissions for the Image. Private: Can be used only within the Account, Shared: Can be shared between Accounts | private |
| volumes | Volumes | [{“tag”: null, “volume_id”: null, “encryption_options”: null, “encryption_secret_uuid”: null, “encryption_format”: null, “device_name”: “/dev/vda”, “disk_bus”: “virtio”, “volume_type”: null, “encrypted”: null, “image_id”: null, “device_type”: “disk”, “source_type”: “snapshot”, “delete_on_termination”: false, “volume_size”: 104, “guest_format”: null, “boot_index”: 0, “destination_type”: “volume”, “snapshot_id”: “abde9e38-2ed5-4ecd-b23c-b0120e30690e”, “no_device”: null}] |
2 - 1.1
scpcli virtualserver image create
--url <value>
--os_distro <value>
--name <value>
[--container_format <value>]
[--disk_format <value>]
[--min_disk <value>]
[--min_ram <value>]
[--protected <value>]
[--tags <value>]
[--visibility <value>]
Description
Create Image.
State ACTIVE (DEPRECATED)
Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.
| Version | Not Before |
|---|---|
| 1.1 | 20260531 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| url required | string | Object Storage URL for Image file (only qcow2 format allowed) | https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2 |
| os_distro required | string | OS distribution of the image to be uploaded | alma |
| name required | string | Image name | imagename |
| container_format optional | string | Container format | bare |
| disk_format optional | string | Disk format | qcow2 |
| min_disk optional | integer | Minimum disk capacity (GB) of the Image to be created | 100 |
| min_ram optional | integer | Minimum RAM capacity (GB) of the Image to be created | 0 |
| protected optional | boolean | whether Image deletion is prohibited | False |
| tags optional | array | Tags | '{"key": "Key", "value": "Value"}' |
| visibility optional | string | Indicates access permissions for the Image. Private: Can be used only within the Account, Shared: Can be shared between Accounts | private |
Responses
| Name | Description | Example |
|---|---|---|
| id | Image ID | 70a599e0-31e7-49b7-b260-868f441e862b |
| checksum | MD5 hash of the entire image data. and this field could be used to verify the integrity of image. | 7538e0fcb56e0e272cfd89eb384d6613 |
| container_format | Container format | bare |
| created_at | Created at | 2025-07-22T09:00:00Z |
| disk_format | Disk format | qcow2 |
| file | The URL for the virtual server image file | /v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file |
| min_disk | Minimum disk capacity (GB) of the Image to be created | 100 |
| min_ram | Minimum RAM capacity (GB) of the Image to be created | 0 |
| name | Image name | imagename |
| os_distro | OS distribution of the image to be uploaded | alma |
| os_hash_algo | OS hash algorithm used to verify image integrity | sha512 |
| os_hash_value | The actual digest of the image binary, calculated with the algorithm indicated by os_hash_algo. The value is presented as a hexadecimal string. | c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99 |
| os_hidden | Whether the image is hidden | False |
| owner | Owner account ID | a8f10467abfc4b87b64614ab36eb9ae4 |
| owner_account_name | Owner account name | AccountName |
| owner_user_name | Owner user name | user@samsung.com |
| protected | whether Image deletion is prohibited | False |
| root_device_name | Root device name | /dev/vda |
| scp_image_type | Image type | custom |
| scp_k8s_version | K8S version | v1.28.7 |
| scp_original_image_type | Original Image type | standard |
| scp_os_build_version | OS build version | 20250101 |
| scp_os_version | OS version | 8.8 |
| size | Image size | 2429747200 |
| status | Image status | active |
| updated_at | Updated at | 2025-07-26T12:00:00Z |
| url | Object Storage URL for Image file (only qcow2 format allowed) | https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2 |
| virtual_size | Virtual size | 17179869184 |
| visibility | Indicates access permissions for the Image. Private: Can be used only within the Account, Shared: Can be shared between Accounts | private |
| volumes | Volumes | [{“tag”: null, “volume_id”: null, “encryption_options”: null, “encryption_secret_uuid”: null, “encryption_format”: null, “device_name”: “/dev/vda”, “disk_bus”: “virtio”, “volume_type”: null, “encrypted”: null, “image_id”: null, “device_type”: “disk”, “source_type”: “snapshot”, “delete_on_termination”: false, “volume_size”: 104, “guest_format”: null, “boot_index”: 0, “destination_type”: “volume”, “snapshot_id”: “abde9e38-2ed5-4ecd-b23c-b0120e30690e”, “no_device”: null}] |
3 - 1.0
scpcli virtualserver image create
--url <value>
--os_distro <value>
--name <value>
[--container_format <value>]
[--disk_format <value>]
[--min_disk <value>]
[--min_ram <value>]
[--protected <value>]
[--tags <value>]
[--visibility <value>]
Description
Create Image.
State ACTIVE (DEPRECATED)
Deprecated versions with Not Before dates that have arrived or expired are no longer supported. We recommend using the latest version.
| Version | Not Before |
|---|---|
| 1.0 | 20251231 |
Parameters
| Name | Type | Description | Example |
|---|---|---|---|
| url required | string | Object Storage URL for Image file (only qcow2 format allowed) | https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2 |
| os_distro required | string | OS distribution of the image to be uploaded | alma |
| name required | string | Image name | imagename |
| container_format optional | string | Container format | bare |
| disk_format optional | string | Disk format | qcow2 |
| min_disk optional | integer | Minimum disk capacity (GB) of the Image to be created | 100 |
| min_ram optional | integer | Minimum RAM capacity (GB) of the Image to be created | 0 |
| protected optional | boolean | whether Image deletion is prohibited | False |
| tags optional | array | Tags | '{"key": "Key", "value": "Value"}' |
| visibility optional | string | Indicates access permissions for the Image. Private: Can be used only within the Account, Shared: Can be shared between Accounts | private |
Responses
| Name | Description | Example |
|---|---|---|
| id | Image ID | 70a599e0-31e7-49b7-b260-868f441e862b |
| checksum | MD5 hash of the entire image data. and this field could be used to verify the integrity of image. | 7538e0fcb56e0e272cfd89eb384d6613 |
| container_format | Container format | bare |
| created_at | Created at | 2025-07-22T09:00:00Z |
| disk_format | Disk format | qcow2 |
| file | The URL for the virtual server image file | /v2/images/e08a37c1-2162-416e-b7fa-19902419170b/file |
| min_disk | Minimum disk capacity (GB) of the Image to be created | 100 |
| min_ram | Minimum RAM capacity (GB) of the Image to be created | 0 |
| name | Image name | imagename |
| os_distro | OS distribution of the image to be uploaded | alma |
| os_hash_algo | OS hash algorithm used to verify image integrity | sha512 |
| os_hash_value | The actual digest of the image binary, calculated with the algorithm indicated by os_hash_algo. The value is presented as a hexadecimal string. | c6a32fc3b7c909b8900b46f5e6066c028a1d799c0a263cf064a600c430a714627c21f98ac248e2f2bf29870a1a2773c7908244745016878e1a5f31dc2c405b99 |
| os_hidden | Whether the image is hidden | False |
| owner | Owner account ID | a8f10467abfc4b87b64614ab36eb9ae4 |
| owner_account_name | Owner account name | AccountName |
| owner_user_name | Owner user name | user@samsung.com |
| protected | whether Image deletion is prohibited | False |
| root_device_name | Root device name | /dev/vda |
| scp_image_type | Image type | custom |
| scp_k8s_version | K8S version | v1.28.7 |
| scp_original_image_type | Original Image type | standard |
| scp_os_build_version | OS build version | 20250101 |
| scp_os_version | OS version | 8.8 |
| size | Image size | 2429747200 |
| status | Image status | active |
| updated_at | Updated at | 2025-07-26T12:00:00Z |
| url | Object Storage URL for Image file (only qcow2 format allowed) | https://object-store.kr-west1.s.samsungsdscloud.com/8989447062e04a818baf9e073fd04fa7/bucket/object.qcow2 |
| virtual_size | Virtual size | 17179869184 |
| visibility | Indicates access permissions for the Image. Private: Can be used only within the Account, Shared: Can be shared between Accounts | private |
| volumes | Volumes | [{“tag”: null, “volume_id”: null, “encryption_options”: null, “encryption_secret_uuid”: null, “encryption_format”: null, “device_name”: “/dev/vda”, “disk_bus”: “virtio”, “volume_type”: null, “encrypted”: null, “image_id”: null, “device_type”: “disk”, “source_type”: “snapshot”, “delete_on_termination”: false, “volume_size”: 104, “guest_format”: null, “boot_index”: 0, “destination_type”: “volume”, “snapshot_id”: “abde9e38-2ed5-4ecd-b23c-b0120e30690e”, “no_device”: null}] |