glanceclient.v2.images 模块¶
- class glanceclient.v2.images.Controller(http_client, schema_client)¶
基类:
object- add_image_location(image_id, location_url, validation_data={})¶
向镜像添加新的位置。
- 参数：
image_id – 要添加位置的镜像 ID。
location_url – 要添加的位置的 URL。
validation_data – 镜像的验证数据。
- add_location(image_id, url, metadata, validation_data=None)¶
向镜像的位置列表中添加新的位置条目。
添加已存在于位置列表中的 URL 会导致错误。
- 参数：
image_id – 要添加位置的镜像 ID。
url – 要添加的位置的 URL。
metadata – 与位置关联的元数据。
validation_data – 镜像的验证数据。
- 返回值:
更新后的镜像
- create(**kwargs)¶
创建镜像。
- data(image_id, do_checksum=True, allow_md5_fallback=False)¶
检索镜像的数据。
当启用 do_checksum 时，验证过程如下：
如果镜像具有 ‘os_hash_value’ 属性，则镜像的 ‘os_hash_algo’ 属性中指定的算法将用于与 ‘os_hash_value’ 值进行验证。如果指定的哈希算法不可用并且 allow_md5_fallback 为 True，则继续执行步骤 #2
否则，如果镜像具有 checksum 属性，则使用 MD5 与 ‘checksum’ 值进行验证。（如果客户端不可用 MD5，则下载失败。）
否则，如果下载响应具有 ‘content-md5’ 标头，则使用 MD5 与标头值进行验证。（如果客户端不可用 MD5，则下载失败。）
如果以上 1-3 都无法完成，则数据将不会被验证（这与旧行为兼容）
- 参数：
image_id – 要下载的镜像的 ID
do_checksum – 启用/禁用校验和验证
allow_md5_fallback – 如果镜像的 ‘os_hash_algo’ 属性中指定的算法不可用，则使用 MD5 校验和进行验证
- 返回值:
一个可迭代的 body 或
None
- deactivate(image_id)¶
停用镜像。
- delete(image_id)¶
删除镜像。
- delete_from_store(store_id, image_id)¶
从特定存储中删除镜像数据。
- delete_locations(image_id, url_set)¶
删除镜像的一个或多个位置条目。
- 参数：
image_id – 要从中删除位置的镜像 ID。
url_set – 要删除的位置条目的 URL 集合。
- 返回值:
无
- get(image_id)¶
- get_associated_image_tasks(image_id)¶
获取与镜像关联的任务。
- 参数：
image_id – 镜像的 ID
- 引发:
exc.HTTPNotImplemented 如果 Glance 不够新，无法支持此 API (v2.12)。
- get_image_locations(image_id)¶
获取与镜像关联的位置列表。
- 参数：
image_id – 要获取位置的镜像 ID。
- get_import_info()¶
从发现端点获取导入信息。
- get_stores_info()¶
从发现端点获取可用的存储信息。
- get_stores_info_detail()¶
从发现端点获取可用的存储信息。
- image_import(image_id, method='glance-direct', uri=None, remote_region=None, remote_image_id=None, remote_service_interface=None, backend=None, stores=None, allow_failure=True, all_stores=None)¶
通过方法导入镜像。
- list(**kwargs)¶
检索镜像对象列表。
- 参数：
page_size – 每个分页请求中请求的镜像数量。
- 返回值:
镜像列表的生成器。
- property model¶
- reactivate(image_id)¶
重新激活镜像。
- stage(image_id, image_data, image_size=None)¶
将数据上传到镜像暂存。
- 参数：
image_id – 要上传数据的镜像 ID。
image_data – 提供要上传的数据的文件类对象。
image_size – 如果存在，则将其传递给上传调用
- property unvalidated_model¶
- update(image_id, remove_props=None, **kwargs)¶
更新镜像的属性。
- 参数：
image_id – 要修改的镜像 ID。
remove_props – 要删除的属性名称列表
kwargs – 镜像属性名称及其新值。
- update_location(image_id, url, metadata)¶
更新镜像的位置列表中的现有位置条目。
指定的 URL 必须已存在于镜像的位置列表中。
- 参数：
image_id – 要更新位置的镜像 ID。
url – 要更新的位置的 URL。
metadata – 与位置关联的元数据。
- 返回值:
更新后的镜像
- upload(image_id, image_data, image_size=None, u_url=None, backend=None)¶
上传镜像的数据。
- 参数：
image_id – 要上传数据的镜像 ID。
image_data – 提供要上传的数据的文件类对象。
image_size – 如果存在，则将其作为标头传递
u_url – 要上传数据的上传 URL。
backend – 要上传镜像的后端存储。
