Image Management

Permission

API

Action

Dependencies

IAM Project

Enterprise Project

Querying Images

GET /v2/cloudimages

ims:images:list

-

Y

Y

Querying Supported Image OSs

GET /v1/cloudimages/os_version

ims:images:list

-

Y

x

Updating Image Information

PATCH /v2/cloudimages/{image_id}

  • ims:images:update

  • ims:serverImages:create (only for migration to enterprise projects)

  • ims:serverImages:create (only for migration to enterprise projects)

    obs:bucket:*

    obs:object:*

    kms:*:*

    ecs:cloudServers:get

    ecs:servers:get

    ecs:serverVolumes:use

    ecs:cloudServers:list

    ecs:serverVolumeAttachments:list

    ecs:servers:list

    evs:volumes:*

    bms:servers:list

    bms:servers:get

    bms:serverFlavors:get

Y

Y

Creating an Image

POST /v2/cloudimages/action

Note

If you use an external image file to create an image, you must have Tenant Administrator permissions for OBS.

ims:serverImages:create

obs:bucket:*

obs:object:*

kms:*:*

ecs:cloudServers:get

ecs:servers:get

ecs:serverVolumes:use

ecs:cloudServers:list

ecs:serverVolumeAttachments:list

ecs:servers:list

evs:volumes:*

bms:servers:list

bms:servers:get

bms:serverFlavors:get

Y

Y

Importing an Image File Quickly

POST /v2/cloudimages/quickimport/action

Note

You must have Tenant Administrator permissions for OBS.

  • ims:serverImages:create (required only for quickly importing system disk images)

  • ims:dataImages:create (required only for quickly importing data disk images)

  • ims:serverImages:create (required only for quickly importing system disk images)

    obs:bucket:*

    obs:object:*

    kms:*:*

    ecs:cloudServers:get

    ecs:servers:get

    ecs:serverVolumes:use

    ecs:cloudServers:list

    ecs:serverVolumeAttachments:list

    ecs:servers:list

    evs:volumes:*

    bms:servers:list

    bms:servers:get

    bms:serverFlavors:get

  • ims:dataImages:create (required only for quickly importing data disk images)

    obs:bucket:*

    obs:object:*

    kms:*:*

    ecs:cloudServers:get

    ecs:servers:get

    ecs:serverVolumes:use

    ecs:cloudServers:list

    ecs:serverVolumeAttachments:list

    ecs:servers:list

    evs:volumes:*

Y

Y

Creating a Data Disk Image Using an External Image File

POST /v1/cloudimages/dataimages/action

Note

You must have Tenant Administrator permissions for OBS.

ims:dataImages:create

obs:bucket:*

obs:object:*

kms:*:*

ecs:cloudServers:get

ecs:servers:get

ecs:serverVolumes:use

ecs:cloudServers:list

ecs:serverVolumeAttachments:list

ecs:servers:list

evs:volumes:*

Y

Y

Creating a Full-ECS Image

POST /v1/cloudimages/wholeimages/action

Note

You must have Administrator permissions for CSBS or Admin permissions for CBR.

ims:wholeImages:create

obs:bucket:*

obs:object:*

kms:*:*

cbr:*:*

CSBS:backup:*

ecs:cloudServers:get

ecs:servers:get

ecs:serverVolumes:use

ecs:cloudServers:list

ecs:serverVolumeAttachments:list

ecs:servers:list

evs:volumes:*

Y

Y

Registering an Image

PUT /v1/cloudimages/{image_id}/upload

Note

  • You must have Tenant Administrator permissions for OBS.

  • You have permission to use enterprise projects when you register an image only if you select the default enterprise project.

ims:images:upload

ims:images:get

ims:images:update

obs:bucket:*

obs:object:*

kms:*:*

Y

Y

Exporting an Image

POST /v1/cloudimages/{image_id}/file

Note

You must have Tenant Administrator permissions for OBS.

ims:images:export

obs:bucket:*

obs:object:*

kms:*:*

Y

Y

Querying Images (Native OpenStack API)

GET /v2/images

ims:images:list

-

Y

x

Querying Image Details (Native OpenStack API)

GET /v2/images/{image_id}

ims:images:get

-

Y

Y

Updating Image Information (Native OpenStack API)

PATCH /v2/images/{image_id}

ims:images:update

-

Y

Y

Deleting an Image (Native OpenStack API)

DELETE /v2/images/{image_id}

ims:images:delete

-

Y

Y

Creating Image Metadata (Native OpenStack API)

POST /v2/images

ims:images:create

-

Y

x

Uploading an Image (Native OpenStack API)

PUT /v2/images/{image_id}/file

  • ims:images:get

  • ims:images:update

  • ims:images:upload

  • ims:images:upload

    obs:bucket:*

    obs:object:*

    kms:*:*

Y

x

Querying the API Version (Native OpenStack API)

GET /

N/A

-

Y

x

Querying Image Details (Native OpenStack API V1.1, Deprecated)

GET /v1.1/images/detail

ims:images:list

-

Y

x

Querying Image Metadata (Native OpenStack API V1, Deprecated)

HEAD /v1/images/{image_id}

ims:images:get

-

Y

x

Deleting an Image (Native OpenStack API V1.1, Deprecated)

DELETE /v1.1/images/{image_id}

ims:images:delete

-

Y

x

last updated: 2025-06-16 13:20 UTC - commit: c9f53da9f210523b0a64fc038a9b02c9c5fbc319