openstack.image.v1.image

Image 类

Image 类继承自 Resource。

class openstack.image.v1.image.Image(_synchronized=False, connection=None, **attrs)

基础资源

参数：

  • _synchronized (bool) – 这不打算直接使用。请参阅 new() 和 existing()。

  • connection (openstack.connection.Connection) – 对正在使用的 Connection 的引用。默认为 None，允许在单元测试中等情况下使用不带活动 Connection 的 Resource 对象。Resource 代码中对 self._connection 的使用应使用 None 检查进行保护。

resource_key = 'image'

资源的单数形式的键。

resources_key = 'images'

资源的复数形式的键。

base_path = '/images'

此资源的 URI 的基本部分。

allow_create = True

允许对此资源进行创建操作。

allow_fetch = True

允许对此资源进行获取操作。

allow_commit = True

允许对此资源进行更新操作。

allow_delete = True

允许对此资源进行删除操作。

allow_list = True

允许对此资源进行列表操作。

checksum

用于图像数据校验的哈希值。镜像服务使用此值进行验证。

container_format

容器格式是指虚拟机镜像是否包含有关实际虚拟机元数据的文件格式。容器格式包括 OVF 和 Amazon AMI。此外，虚拟机镜像可能没有容器格式 - 相反，该镜像只是未结构化数据的blob。

copy_from

从 URL 复制镜像的位置

created_at

创建此镜像的时间戳。

disk_format

有效值为：aki、ari、ami、raw、iso、vhd、vdi、qcow2 或 vmdk。虚拟机镜像的磁盘格式是底层磁盘镜像的格式。虚拟设备供应商对布局在虚拟机磁盘镜像中包含的信息有不同的格式。

is_protected

定义镜像是否可以删除。类型：bool

is_public

True 如果这是公共镜像。类型：bool

location

由 URI 标识的镜像的位置

min_disk

启动镜像所需的最小磁盘大小，单位为 GB。

min_ram

启动镜像所需的最小 RAM 大小，单位为 MB。

name

镜像的名称。请注意，镜像的名称对于 Glance 节点而言不是唯一的。API 不能期望用户知道其他用户拥有的镜像的名称。

owner

镜像的所有者或项目的 ID。

owner_id

镜像的所有者或项目的 ID。（向后兼容）

properties

与镜像关联的属性（如果有）。

size

图像数据的大小，以字节为单位。

status

镜像状态。

updated_at

上次更新此镜像的时间戳。

classmethod find(session, name_or_id, ignore_missing=True, **params)

按其名称或 ID 查找资源。

参数：

  • session (Adapter) – 用于发出此请求的会话。

  • name_or_id – 此资源的标识符（如果请求需要）。默认值为 None。

  • ignore_missing (bool) – 当设置为 False 时，如果资源不存在，将引发 NotFoundException。当设置为 True 时，尝试查找不存在的资源时将返回 None。

  • params (dict) – 传递给底层方法的任何其他参数，例如传递 URI 参数到 existing()。

返回值:

与给定名称或 ID 匹配的 Resource 对象，或者如果没有任何匹配项则返回 None。

引发:

openstack.exceptions.DuplicateResource 如果为该请求找到多个资源。

引发:

openstack.exceptions.NotFoundException 如果未找到任何内容且 ignore_missing 为 False。