Images

List all public images

get

Returns all public images from FPT, which are customized for GPU Hopper generations. Refers to https://fptcloud.com/en/documents/metal-cloud/?doc=os-image

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

vpc_idstring · uuidRequired

The unique identifier of the VPC.

Responses

200

A list of images.

application/json

dataobject[]Optional

401

Unauthorized access.

403

Forbidden.

500

Internal server error.

get

/api/v2/vmware/vpc/{vpc_id}/hpc/images

HTTPcURLJavaScriptPython

GET /api/v2/vmware/vpc/{vpc_id}/hpc/images HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {}
  ]
}

List all custom images

get

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

vpc_idstring · uuidRequired

The unique identifier of the VPC.

Responses

200

A list of custom images.

application/json

dataobject[]Optional

401

Unauthorized access.

403

Forbidden.

500

Internal server error.

get

/api/v2/vmware/vpc/{vpc_id}/hpc/custom-images

HTTPcURLJavaScriptPython

GET /api/v2/vmware/vpc/{vpc_id}/hpc/custom-images HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "data": [
    {}
  ]
}

Upload a new custom image to S3

post

With custom image templates, you can capture an image of a Bare Metal GPU server to replicate its configuration with minimal changes in the order process. Image templates provide an imaging option for all Bare Metal GPU servers, regardless of operating system. When your image template is complete, you can use it to create another Bare Metal GPU server.

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

vpc_idstring · uuidRequired

The unique identifier of the VPC.

Body

application/json

namestringRequired

Name of the image.

sizeintegerRequired

Size of the image in bytes.

sha256stringRequired

SHA256 hash of the image file.

vpcIdstring · nullableOptional

The VPC ID associated with the image.

Responses

201

Image registered successfully.

application/json

400

Invalid request payload.

401

Unauthorized access.

403

Forbidden.

500

Internal server error.

post

/api/v2/vmware/vpc/{vpc_id}/hpc/images/

HTTPcURLJavaScriptPython

POST /api/v2/vmware/vpc/{vpc_id}/hpc/images/ HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 55

{
  "name": "text",
  "size": 1,
  "sha256": "text",
  "vpcId": "text"
}

{
  "message": "text",
  "data": {
    "image_id": "text",
    "name": "text",
    "description": "text",
    "created_at": "2026-03-07T02:51:24.377Z"
  }
}

Get presigned upload URLs

post

Get an file URL in S3 bucket after uploading the custom image.

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

vpc_idstring · uuidRequired

The unique identifier of the VPC where the image belongs.

Body

application/json

sha256stringOptional

SHA256 hash of the image file.

Responses

200

Presigned URLs generated successfully.

application/json

datastring[]Optional

Presigned URL for uploading image chunks.

400

Invalid request payload.

401

Unauthorized access.

403

Forbidden.

500

Internal server error.

post

/api/v2/vmware/vpc/{vpc_id}/hpc/images/presign-urls/

HTTPcURLJavaScriptPython

POST /api/v2/vmware/vpc/{vpc_id}/hpc/images/presign-urls/ HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 17

{
  "sha256": "text"
}

{
  "data": [
    "text"
  ]
}

Upload a custom image from S3 to FPT image repository

put

After uploading a custom image successfully to S3 of FPT, you need to push it to FPT image repository. It is the last step for custom image upload and lets you create a new server with it.

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

vpc_idstring · uuidRequired

The unique identifier of the VPC where the custom image will be upload.

file_shastringRequired

The SHA256 hash of the file being uploaded.

Body

application/json

namestringOptional

Optional name associated with the update.

Responses

200

Image upload completed successfully.

application/json

messagestringOptional

400

Invalid request payload.

401

Unauthorized access.

403

Forbidden.

500

Internal server error.

put

/api/v2/vmware/vpc/{vpc_id}/hpc/images/{file_sha}/

HTTPcURLJavaScriptPython

PUT /api/v2/vmware/vpc/{vpc_id}/hpc/images/{file_sha}/ HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 56

{
  "parts": [
    {
      "ETag": "text",
      "PartNumber": 1
    }
  ],
  "name": "text"
}

{
  "message": "text"
}

Delete a custom image

delete

Deleting permanently a custom image, and it cannot be undone. Ensure you are deleting the correct image. The server you’ve created from a custom image is not deleted when you delete the image from your account. You can destroy the Bare Metal GPU server from the FPT Customer portal separately.

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

vpc_idstring · uuidRequired

The unique identifier of the VPC where the image will be deleted.

hpc_file_idstringRequired

The ID of the custom image to delete.

Responses

200

Image deleted successfully.

application/json

messagestringOptional

401

Unauthorized access.

403

Forbidden.

500

Internal server error.

delete

/api/v2/vmware/vpc/{vpc_id}/hpc/images/{hpc_file_id}/

HTTPcURLJavaScriptPython

DELETE /api/v2/vmware/vpc/{vpc_id}/hpc/images/{hpc_file_id}/ HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "message": "text"
}

Sync an image to Console (Portal)

post

Synchronizes the metadata and image file of a custom image in the centralized image repository of FPT with FPT Cloud console (Portal)

Authorizations

bearer

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Path parameters

vpc_idstring · uuidRequired

The unique identifier of the VPC where the image will be synchronized.

hpc_file_idstringRequired

The ID of the custom image to synchronize.

Responses

200

Image synced successfully.

application/json

messagestringOptional

401

Unauthorized access.

403

Forbidden.

500

Internal server error.

post

/api/v2/vmware/vpc/{vpc_id}/hpc/images/{hpc_file_id}/sync/

HTTPcURLJavaScriptPython

POST /api/v2/vmware/vpc/{vpc_id}/hpc/images/{hpc_file_id}/sync/ HTTP/1.1
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "message": "text"
}