novaclient.v2.servers 模块

服务器接口。

class novaclient.v2.servers.NetworkInterface(manager, info, loaded=False, resp=None)

基类: Resource

填充并绑定到管理器。

参数：

  • manager – BaseManager 对象

  • info – 表示资源属性的字典

  • loaded – 如果设置为 True，则防止延迟加载

  • resp – 响应或响应对象列表

property id
class novaclient.v2.servers.SecurityGroup(manager, info, loaded=False, resp=None)

基类: Resource

填充并绑定到管理器。

参数：

  • manager – BaseManager 对象

  • info – 表示资源属性的字典

  • loaded – 如果设置为 True，则防止延迟加载

  • resp – 响应或响应对象列表

class novaclient.v2.servers.Server(manager, info, loaded=False, resp=None)

基类: Resource

填充并绑定到管理器。

参数：

  • manager – BaseManager 对象

  • info – 表示资源属性的字典

  • loaded – 如果设置为 True，则防止延迟加载

  • resp – 响应或响应对象列表

HUMAN_ID = True
add_security_group(security_group)

向实例添加安全组。

参数：

security_group – 要添加的安全组名称

返回值:

novaclient.base.DictWithMeta 的一个实例

add_tag(tag)

向实例添加单个标签。

backup(backup_name, backup_type, rotation)

备份服务器实例。

参数：

  • backup_name – 备份镜像的名称

  • backup_type – 备份类型，例如 ‘daily’ 或 ‘weekly’

  • rotation – 整型参数，表示保留多少个备份。

返回值:

novaclient.base.TupleWithMeta 的一个实例

change_password(password)

更新服务器的管理员密码。

参数：

password – 要设置为服务器管理员密码的字符串

返回值:

novaclient.base.TupleWithMeta 的一个实例

clear_password()

获取服务器的密码。

confirm_resize()

确认调整大小成功，从而删除原始服务器。

返回值:

novaclient.base.TupleWithMeta 的一个实例

create_image(image_name, metadata=None)

基于此服务器创建镜像。

参数：

  • image_name – 要分配给新创建镜像的名称。

  • metadata – 要分配给镜像的元数据。

delete()

删除（即关闭并删除镜像）此服务器。

返回值:

novaclient.base.TupleWithMeta 的一个实例

delete_all_tags()

删除实例的所有标签。

delete_tag(tag)

删除实例的单个标签。

diagnostics()

诊断 – 获取服务器诊断信息。

evacuate(host=None, password=None)

将实例从故障主机迁移到指定主机。

参数：

  • host – 目标主机名称

  • password – 要设置为迁移服务器管理员密码的字符串。

返回值:

novaclient.base.TupleWithMeta 的一个实例

force_delete()

强制删除 – 强制删除服务器。

返回值:

novaclient.base.TupleWithMeta 的一个实例

get_console_output(length=None)

从服务器获取文本控制台日志输出。

参数：

length – 您要检索的行数（作为整数）

get_console_url(console_type)

检索特定协议和 console_type 的控制台

参数：

console_type – 控制台类型

get_mks_console()

获取服务器的 mks 控制台。

get_password(private_key=None)

获取服务器的密码。

如果提供了私钥，则返回实例的明文密码，否则返回加密密码。

参数：

private_key – 用于解密的私钥文件的路径（可选）

get_rdp_console(console_type)

获取服务器的 rdp 控制台。

参数：

console_type – 控制台类型（‘rdp-html5’）

get_serial_console(console_type)

获取服务器的串行控制台。

参数：

console_type – 控制台类型（‘serial’）

get_spice_console(console_type)

获取服务器的 spice 控制台。

参数：

console_type – 控制台类型（‘spice-html5’）

get_vnc_console(console_type)

获取服务器的 vnc 控制台。

参数：

console_type – 控制台类型（‘novnc’ 或 ‘xvpvnc’）

interface_attach(port_id, net_id, fixed_ip, tag=None)

将网络接口附加到实例，并附带可选的标签。

interface_detach(port_id)

将网络接口从实例分离。

interface_list()

列出附加到实例的接口。

list_security_group()

列出实例的安全组。

live_migrate(host=None, block_migration=None)

将正在运行的实例迁移到新机器。

参数：

  • host – 目标主机名称。

  • block_migration – 如果为 True，则执行块迁移，默认值为 None，映射为 ‘auto’。

返回值:

novaclient.base.TupleWithMeta 的一个实例

lock(reason=None)

锁定 – 锁定实例，使其免受某些操作的影响。

参数：

reason – （可选）锁定原因。

返回值:

novaclient.base.TupleWithMeta 的一个实例

migrate(host=None)

将服务器迁移到新主机。

参数：

host – （可选）目标主机。

返回值:

novaclient.base.TupleWithMeta 的一个实例

property networks

生成简化的地址列表

返回值:

一个 OrderedDict，以网络名称为键，并按网络名称升序排序。

pause()

暂停 – 暂停正在运行的服务器。

返回值:

novaclient.base.TupleWithMeta 的一个实例

reboot(reboot_type='SOFT')

重新启动服务器。

参数：

reboot_type – 要么 REBOOT_SOFT 用于软件级别重新启动，要么 REBOOT_HARD 用于虚拟电源循环硬重启。

返回值:

novaclient.base.TupleWithMeta 的一个实例

rebuild(image, password=None, preserve_ephemeral=False, *, disk_config=None, name=None, meta=None, files=None, description=<object object>, key_name=<object object>, userdata=<object object>, trusted_image_certificates=<object object>, hostname=<object object>)

重建 – 关闭然后重新镜像 – 此服务器。

参数：

  • image – Image（或其 ID）以重新镜像。

  • password – 要设置为重建服务器密码的字符串。

  • preserve_ephemeral – 如果为 True，则请求在重建实例时保留任何临时设备。默认为 False。

  • disk_config – 在重建服务器上使用的分区模式。有效值为 ‘AUTO’ 或 ‘MANUAL’

  • name – 服务器的名称。

  • meta – 要为此服务器存储的任意键/值元数据的字典。键和值都必须 <=255 个字符。

  • files – 在启动时覆盖服务器上的文件的字典。键是文件名（例如 /etc/passwd），值是文件内容（可以是字符串或类文件对象）。允许的最大条目数为五个，并且每个文件必须小于或等于 10k。（从 microversion 2.57 开始已弃用）

  • description – 服务器的可选描述。如果指定为 None，将取消设置现有的描述。（从 microversion 2.19 开始）

  • key_name – 用于重建操作的可选密钥对名称。如果指定为 None，将取消设置现有的密钥。（从 microversion 2.54 开始）

  • userdata – 要传递给元数据服务器以暴露的用于实例的 userdata。可以是文件类型对象或字符串。如果指定为 None，将取消设置现有的 user_data。（从 microversion 2.57 开始）

  • trusted_image_certificates – 受信任证书 ID 的列表，或 None 以取消设置/重置服务器的受信任镜像证书（从 microversion 2.63 开始）

  • hostname – 要为实例配置的可选主机名。如果指定为 None，将取消设置现有的主机名。（从 microversion 2.90 开始）

返回值:

服务器

remove_security_group(security_group)

从实例中移除安全组。

返回值:

novaclient.base.TupleWithMeta 的一个实例

rescue(password=None, image=None)

救援 – 救援出现问题的服务器。

参数：

  • password – 要在救援实例中设置的管理员密码。

  • image – 用于救援的 Image。

返回值:

novaclient.base.TupleWithMeta 的一个实例

reset_network()

重置实例的网络。

返回值:

novaclient.base.TupleWithMeta 的一个实例

reset_state(state='error')

将实例的状态重置为 active 或 error。

返回值:

novaclient.base.TupleWithMeta 的一个实例

resize(flavor, *, disk_config=None)

调整服务器的资源。

参数：

  • flavor – 要调整到的 Flavor（或其 ID）。

  • disk_config – 重建服务器时使用的分区模式。有效值为 ‘AUTO’ 或 ‘MANUAL’。

返回值:

novaclient.base.TupleWithMeta 的一个实例

在通过 confirm_resize() 确认调整大小事件之前，旧服务器将保留，并且可以使用 revert_resize() 快速回滚到旧配置。默认情况下，所有调整大小将在 24 小时后自动确认。

restore()

恢复 – 恢复处于 ‘soft-deleted’ 状态的服务器。

返回值:

novaclient.base.TupleWithMeta 的一个实例

resume()

恢复 – 恢复暂停的服务器。

返回值:

novaclient.base.TupleWithMeta 的一个实例

revert_resize()

撤销之前的调整大小，切换回旧服务器。

返回值:

novaclient.base.TupleWithMeta 的一个实例

set_tags(tags)

为实例设置标签列表。

shelve()

搁置 – 搁置服务器。

返回值:

novaclient.base.TupleWithMeta 的一个实例

shelve_offload()

Shelve_offload – 从计算节点移除搁置的服务器。

返回值:

novaclient.base.TupleWithMeta 的一个实例

start()

启动 – 启动暂停的服务器。

返回值:

novaclient.base.TupleWithMeta 的一个实例

stop()

停止 – 停止正在运行的服务器。

返回值:

novaclient.base.TupleWithMeta 的一个实例

suspend()

暂停 – 暂停正在运行的服务器。

返回值:

novaclient.base.TupleWithMeta 的一个实例

tag_list()

获取实例的标签列表。

topology()

检索服务器拓扑。

trigger_crash_dump()

在实例中触发崩溃转储

unlock()

解锁 – 移除实例锁。

返回值:

novaclient.base.TupleWithMeta 的一个实例

unpause()

取消暂停 – 取消暂停暂停的服务器。

返回值:

novaclient.base.TupleWithMeta 的一个实例

unrescue()

取消救援 – 取消救援救援的服务器。

返回值:

novaclient.base.TupleWithMeta 的一个实例

unshelve(availability_zone=<object object>, host=None)

取消搁置 – 取消搁置服务器。

参数：

  • availability_zone – 如果指定，实例将被取消搁置到 availability_zone。如果传递 None，则实例定义的 availability_zone 将被取消固定，并且实例将被安排到任何 availability_zone（自由调度）。如果未指定，实例将被取消搁置到其定义的 availability_zone 或任何 availability_zone（自由调度）。

  • host – 指定的主机（可选）

返回值:

novaclient.base.TupleWithMeta 的一个实例

update(name=None, description=None, hostname=None)

更新此服务器的属性。

参数：

  • name – 更新服务器的名称。

  • description – 更新服务器的描述。

  • hostname – 更新服务器的主机名。

返回值:

服务器

class novaclient.v2.servers.ServerManager(api)

基类: BootingManagerWithFind

add_security_group(server, security_group)

向实例添加安全组

参数：

  • server – 实例的 ID。

  • security_group – 要添加的安全组的名称。

返回值:

novaclient.base.DictWithMeta 的一个实例

add_tag(server, tag)

向实例添加单个标签。

backup(server, backup_name, backup_type, rotation)

备份服务器实例。

参数：

  • server – Server（或其 ID）要共享到的。

  • backup_name – 备份镜像的名称

  • backup_type – 备份类型，例如 ‘daily’ 或 ‘weekly’

  • rotation – 整型参数，表示保留多少个备份。

返回值:

如果请求的微版本小于 2.45，则为 novaclient.base.TupleWithMeta 的实例，否则为 novaclient.base.DictWithMeta。

change_password(server, password)

更新服务器的密码。

参数：

server – 要更改管理员密码的 Server（或其 ID）

返回值:

novaclient.base.TupleWithMeta 的一个实例

clear_password(server)

清除实例的管理员密码

从元数据服务器中移除实例的管理员密码。

参数：

server – 要清除管理员密码的 Server（或其 ID）

confirm_resize(server)

确认调整大小成功，从而删除原始服务器。

参数：

server – Server（或其 ID）要共享到的。

返回值:

novaclient.base.TupleWithMeta 的一个实例

create(name, image, flavor, meta=None, files=None, reservation_id=False, min_count=None, max_count=None, security_groups=None, userdata=None, key_name=None, availability_zone=None, block_device_mapping=None, block_device_mapping_v2=None, nics=None, scheduler_hints=None, config_drive=None, disk_config=None, admin_pass=None, access_ip_v4=None, access_ip_v6=None, description=None, tags=None, trusted_image_certificates=None, host=None, hypervisor_hostname=None, hostname=None)

创建（启动）新的服务器。

为了创建具有预先存在的端口的服务器，这些端口包含 resource_request 值，例如为了保证最小带宽服务质量支持，需要微版本 2.72。

参数：

  • name – 服务器的名称。

  • image – 要启动的 Image。

  • flavor – 要启动到的 Flavor。

  • meta – 要为此服务器存储的任意键/值元数据的字典。键和值都必须 <=255 个字符。

  • files – 在启动时覆盖服务器上的文件的字典。键是文件名（例如 /etc/passwd），值是文件内容（可以是字符串或类文件对象）。允许的最大条目数为五个，并且每个文件必须小于或等于 10k。（从 microversion 2.57 开始已弃用）

  • reservation_id – 返回正在请求的服务器集合的 reservation_id，布尔值。

  • min_count – 要启动的服务器的最小数量。

  • max_count – 要启动的服务器的最大数量。

  • security_groups – 安全组名称列表

  • userdata – 要传递给元数据服务器以暴露的用户数据，这也可以是文件类型对象或字符串。

  • key_name – 要注入到实例的先前创建的密钥对的名称。

  • availability_zone – 实例放置的可用区的名称。

  • block_device_mapping – 此服务器的块设备映射的字典。

  • block_device_mapping_v2 – 此服务器的块设备映射（字典）列表。

  • nics – 要添加到此服务器的有序网络接口（字典）列表，其中包含有关连接的网络、固定 IP、端口等的信息。从微版本 2.37 开始，此字段是必需的，并且也支持 ‘auto’ 或 ‘none’ 的单个字符串值。 ‘auto’ 值意味着计算服务将在项目没有可用网络时自动分配网络。这与在微版本 2.37 之前不传递任何内容时的行为相同。 ‘none’ 值告诉计算服务不要为服务器分配任何网络。

  • scheduler_hints – 客户端指定的任意键值对，以帮助启动实例。

  • config_drive – 启用 config drive 的布尔值。

  • disk_config – 控制在创建服务器时如何分区磁盘。可能的值是 ‘AUTO’ 或 ‘MANUAL’。

  • admin_pass – 添加用户提供的管理员密码。

  • access_ip_v4 – 添加替代访问 IP（v4）

  • access_ip_v6 – 添加替代访问 IP（v6）

  • description – 可选的服务器描述（自 microversion 2.19 起允许）

  • tags – 要添加到服务器的任意字符串列表作为标签（自 microversion 2.52 起允许）

  • trusted_image_certificates – 可信证书 ID 列表（自 microversion 2.63 起允许）

  • host – 请求创建服务器的主机（自 microversion 2.74 起允许）

  • hypervisor_hostname – 请求创建服务器的 hypervisor 主机名（自 microversion 2.74 起允许）

  • hostname – 请求的服务器主机名（自 microversion 2.90 起允许）

create_image(server, image_name, metadata=None)

创建服务器快照。

参数：

  • server – Server（或其 ID）要共享到的。

  • image_name – 快照镜像的名称

  • metadata – 新创建的镜像实体的元数据

返回值:

novaclient.base.StrWithMeta 的实例（快照镜像的 UUID）

delete(server)

删除（即关闭并删除镜像）此服务器。

参数：

server – 要删除的 Server（或其 ID）

返回值:

novaclient.base.TupleWithMeta 的一个实例

delete_all_tags(server)

删除实例的所有标签。

delete_meta(server, keys)

删除服务器的元数据

参数：

  • server – 要添加元数据的 Server

  • keys – 要从服务器删除的元数据键列表

返回值:

novaclient.base.TupleWithMeta 的一个实例

delete_tag(server, tag)

删除实例的单个标签。

diagnostics(server)

检索服务器诊断信息。

参数：

server – 要检索诊断信息的 Server（或其 ID）

返回值:

novaclient.base.TupleWithMeta 的一个实例

evacuate(server, host=None, password=None)

迁移服务器实例。

参数：

  • server – 要迁移到的 Server（或其 ID）

  • host – 目标主机名称。

  • password – 迁移服务器上设置的密码字符串。

返回值:

novaclient.base.TupleWithMeta 的一个实例

force_delete(server)

强制删除服务器。

参数：

server – 要强制删除的 Server（或其 ID）

返回值:

novaclient.base.TupleWithMeta 的一个实例

get(server)

获取服务器。

参数：

server – 要获取的 Server 的 ID。

返回类型:

服务器

get_console_output(server, length=None)

从服务器获取文本控制台日志输出。

参数：

  • server – 要检索控制台输出的 Server（或其 ID）

  • length – 要检索的尾部日志行数。

返回值:

novaclient.base.StrWithMeta 或 novaclient.base.UnicodeWithMeta 的实例

get_console_url(server, console_type)

检索服务器的控制台 URL。

参数：

  • server – 获取控制台 URL 的服务器

  • console_type – 类型可以是 novnc/xvpvnc 用于 vnc 协议；spice-html5 用于 spice 协议；rdp-html5 用于 rdp 协议；serial 用于 serial 协议。webmks 用于 mks 协议（版本 2.8 起）。

get_meta(server, key)

显示服务器的元数据项的详细信息，按键。 :param server: Server（或其 ID）。 :param key: 要获取的元数据键

get_mks_console(server)

获取实例的 mks 控制台

参数：

server – 要获取控制台的 Server（或其 ID）

返回值:

novaclient.base.DictWithMeta 的一个实例

get_password(server, private_key=None)

获取实例的管理员密码

如果提供了私钥，则以明文形式返回实例的管理员密码，否则返回加密的密码。

要求安装 openssl 并将其添加到路径中

参数：

  • server – 要返回管理员密码的 Server（或其 ID）

  • private_key – 用于解密密码的私钥（可选）

返回值:

novaclient.base.StrWithMeta 或 novaclient.base.BytesWithMeta 或 novaclient.base.UnicodeWithMeta 的实例

get_rdp_console(server, console_type)

获取实例的 rdp 控制台

参数：

  • server – 要获取控制台的 Server（或其 ID）

  • console_type – 要获取的 rdp 控制台类型（‘rdp-html5’）

返回值:

novaclient.base.DictWithMeta 的一个实例

get_serial_console(server, console_type)

获取实例的串口控制台

参数：

  • server – 要获取控制台的 Server（或其 ID）

  • console_type – 要获取的串口控制台类型（‘serial’）

返回值:

novaclient.base.DictWithMeta 的一个实例

get_spice_console(server, console_type)

获取实例的 spice 控制台

参数：

  • server – 要获取控制台的 Server（或其 ID）

  • console_type – 要获取的 spice 控制台类型（‘spice-html5’）

返回值:

novaclient.base.DictWithMeta 的一个实例

get_vnc_console(server, console_type)

获取实例的 vnc 控制台

参数：

  • server – 要获取控制台的 Server（或其 ID）

  • console_type – 要获取的 vnc 控制台类型（‘novnc’ 或 ‘xvpvnc’）

返回值:

novaclient.base.DictWithMeta 的一个实例

interface_attach(server, port_id, net_id, fixed_ip, tag=None)

将网络接口附加到实例。

参数：

  • server – 要附加到的 Server（或其 ID）

  • port_id – 要附加的端口。port_id 和 net_id 参数互斥。

  • net_id – 要附加的网络 ID。

  • fixed_ip – 固定 IP 地址。如果指定了 fixed_ip，则必须同时指定 net_id。

  • tag – 标签。

interface_detach(server, port_id)

从实例分离网络接口。

参数：

  • server – 要分离的 Server（或其 ID）

  • port_id – 要分离的端口。

返回值:

novaclient.base.TupleWithMeta 的一个实例

interface_list(server)

列出附加的网络接口

参数：

server – 要查询的 Server（或其 ID）

ips(server)

返回与服务器关联的 IP 地址。

通常比获取服务器的所有详细信息更便宜的调用。

参数：

server – 要返回 IP 地址的 Server（或其 ID）

返回值:

novaclient.base.DictWithMeta 的一个实例

list(detailed=True, search_opts=None, marker=None, limit=None, sort_keys=None, sort_dirs=None)

获取服务器列表。

参数：

  • detailed – 是否返回详细的服务器信息（可选）。

  • search_opts – 用于过滤不匹配 search_opts 的服务器的搜索选项（可选）。搜索选项的格式是键/值对的字典，它将被附加到查询字符串。有关完整的键列表，请参见：https://docs.openstack.org/api-ref/compute/#list-servers

  • marker – 从服务器列表中该服务器 ID 之后的位置开始返回服务器（可选）。

  • limit – 要返回的最大服务器数量（可选）。请注意，API 服务器具有可配置的默认限制。如果此处未指定限制或限制大于默认值，将使用默认限制。如果 limit == -1，将返回所有服务器。

  • sort_keys – 排序键列表

  • sort_dirs – 排序方向列表

返回类型:

Server 列表

示例

client.servers.list() - 返回详细的服务器列表

client.servers.list(search_opts={‘status’: ‘ERROR’}) - 返回错误状态的服务器列表。

client.servers.list(limit=10) - 只返回 10 台服务器

list_meta(server)

列出服务器的所有元数据。 :param server: Server（或其 ID）。 :returns: 元数据字典。

list_security_group(server)

列出实例的安全组

参数：

server – 实例的 ID。

live_migrate(server, host, block_migration)

将正在运行的实例迁移到新机器。

参数：

  • server – 来自 nova list 的实例 ID。

  • host – 目标主机名称。

  • block_migration – 如果为 True，则执行 block_migration，可以设置为 ‘auto’

返回值:

novaclient.base.TupleWithMeta 的一个实例

lock(server, reason=None)

锁定服务器。

参数：

  • server – 要锁定的 Server（或其 ID）

  • reason – （可选）锁定原因。

返回值:

novaclient.base.TupleWithMeta 的一个实例

migrate(server, host=None)

将服务器迁移到新主机。

参数：

  • server – 要迁移的 Server（或其 ID）。

  • host – （可选）目标主机。

返回值:

novaclient.base.TupleWithMeta 的一个实例

pause(server)

暂停服务器。

参数：

server – 要暂停的 Server（或其 ID）

返回值:

novaclient.base.TupleWithMeta 的一个实例

reboot(server, reboot_type='SOFT')

重启服务器。

参数：

  • server – Server（或其 ID）要共享到的。

  • reboot_type – 要么 REBOOT_SOFT 用于软件级别重新启动，要么 REBOOT_HARD 用于虚拟电源循环硬重启。

返回值:

novaclient.base.TupleWithMeta 的一个实例

rebuild(server, image, password=None, disk_config=None, preserve_ephemeral=False, name=None, meta=None, files=None, *, description=<object object>, key_name=<object object>, userdata=<object object>, trusted_image_certificates=<object object>, hostname=<object object>)

重建 – 关闭然后重新镜像 – 服务器。

参数：

  • server – Server（或其 ID）要共享到的。

  • image – Image（或其 ID）以重新镜像。

  • password – 要设置为重建服务器密码的字符串。

  • disk_config – 在重建服务器上使用的分区模式。有效值为 ‘AUTO’ 或 ‘MANUAL’

  • preserve_ephemeral – 如果为 True，则请求在重建实例时保留任何临时设备。默认为 False。

  • name – 服务器的名称。

  • meta – 要为此服务器存储的任意键/值元数据的字典。键和值都必须 <=255 个字符。

  • files – 在启动时覆盖服务器上的文件的字典。键是文件名（例如 /etc/passwd），值是文件内容（可以是字符串或类文件对象）。允许的最大条目数为五个，并且每个文件必须小于或等于 10k。（从 microversion 2.57 开始已弃用）

  • description – 服务器的可选描述。如果指定为 None，将取消设置现有的描述。（从 microversion 2.19 开始）

  • key_name – 用于重建操作的可选密钥对名称。如果指定为 None，将取消设置现有的密钥。（从 microversion 2.54 开始）

  • userdata – 要传递给元数据服务器以暴露的用于实例的 userdata。可以是文件类型对象或字符串。如果指定为 None，将取消设置现有的 user_data。（从 microversion 2.57 开始）

  • trusted_image_certificates – 受信任证书 ID 的列表，或 None 以取消设置/重置服务器的受信任镜像证书（从 microversion 2.63 开始）

  • hostname – 要为实例配置的可选主机名。如果指定为 None，将取消设置现有的主机名。（从 microversion 2.90 开始）

返回值:

服务器

remove_security_group(server, security_group)

从实例中移除安全组

参数：

  • server – 实例的 ID。

  • security_group – 要移除的安全组的名称。

返回值:

novaclient.base.TupleWithMeta 的一个实例

rescue(server, password=None, image=None)

救援服务器。

参数：

  • server – 要救援的 Server。

  • password – 要在救援实例中设置的管理员密码。

  • image – 用于救援的 Image。

返回值:

novaclient.base.TupleWithMeta 的一个实例

reset_network(server)

重置实例的网络。

参数：

server – 要重置网络的 Server

返回值:

novaclient.base.TupleWithMeta 的一个实例

reset_state(server, state='error')

将实例的状态重置为 active 或 error。

参数：

  • server – 要重置状态的实例的 ID。

  • state – 所需状态；‘active’ 或 ‘error’。默认为 ‘error’。

返回值:

novaclient.base.TupleWithMeta 的一个实例

resize(server, flavor, disk_config=None)

调整服务器资源。

参数：

  • server – Server（或其 ID）要共享到的。

  • flavor – 要调整到的 Flavor（或其 ID）。

  • disk_config – 重建服务器时使用的分区模式。有效值为 ‘AUTO’ 或 ‘MANUAL’。

返回值:

novaclient.base.TupleWithMeta 的一个实例

在通过 confirm_resize() 确认调整大小事件之前，旧服务器将保留，并且可以使用 revert_resize() 快速回滚到旧配置。默认情况下，所有调整大小将在 24 小时后自动确认。

resource_class

Server 的别名

restore(server)

恢复软删除的服务器。

参数：

server – 要恢复的 Server（或其 ID）

返回值:

novaclient.base.TupleWithMeta 的一个实例

resume(server)

恢复服务器。

参数：

server – 要恢复的 Server（或其 ID）

返回值:

novaclient.base.TupleWithMeta 的一个实例

revert_resize(server)

撤销之前的调整大小，切换回旧服务器。

参数：

server – Server（或其 ID）要共享到的。

返回值:

novaclient.base.TupleWithMeta 的一个实例

set_meta(server, metadata)

设置服务器的元数据 :param server: 要添加元数据的 Server :param metadata: 要添加到服务器的元数据的字典

set_meta_item(server, key, value)

更新服务器元数据的一个条目 :param server: 要添加元数据的 Server :param key: 要更新的元数据键 :param value: 字符串值

set_tags(server, tags)

为实例设置标签列表。

shelve(server)

搁置服务器。

参数：

server – 要搁置的 Server（或其 ID）

返回值:

novaclient.base.TupleWithMeta 的一个实例

shelve_offload(server)

从计算节点移除搁置的实例。

参数：

server – 要搁置卸载的 Server（或其 ID）

返回值:

novaclient.base.TupleWithMeta 的一个实例

start(server)

启动服务器。

参数：

server – 要启动的 Server（或其 ID）

返回值:

novaclient.base.TupleWithMeta 的一个实例

stop(server)

停止服务器。

参数：

server – 要停止的 Server（或其 ID）

返回值:

novaclient.base.TupleWithMeta 的一个实例

suspend(server)

暂停服务器。

参数：

server – 要暂停的 Server（或其 ID）

返回值:

novaclient.base.TupleWithMeta 的一个实例

tag_list(server)

获取实例的标签列表。

topology(server)

检索服务器拓扑。

参数：

server – 要返回拓扑的 Server（或其 ID）

返回值:

novaclient.base.DictWithMeta 的一个实例

static transform_userdata(userdata)
trigger_crash_dump(server)

在实例中触发崩溃转储

unlock(server)

解锁服务器。

参数：

server – 要解锁的 Server（或其 ID）

返回值:

novaclient.base.TupleWithMeta 的一个实例

unpause(server)

取消暂停服务器。

参数：

server – 要取消暂停的 Server（或其 ID）

返回值:

novaclient.base.TupleWithMeta 的一个实例

unrescue(server)

取消救援服务器。

参数：

server – 要取消救援的 Server（或其 ID）

返回值:

novaclient.base.TupleWithMeta 的一个实例

unshelve(server, availability_zone=<object object>, host=None)

取消挂起服务器。

参数：

  • availability_zone – 如果指定，实例将被取消搁置到 availability_zone。如果传递 None，则实例定义的 availability_zone 将被取消固定，并且实例将被安排到任何 availability_zone（自由调度）。如果未指定，实例将被取消搁置到其定义的 availability_zone 或任何 availability_zone（自由调度）。

  • host – 指定的主机（可选）

返回值:

novaclient.base.TupleWithMeta 的一个实例

update(server, name=None, description=None, hostname=None)

更新服务器的属性。

参数：

  • server – 要更新的 Server（或其 ID）。

  • name – 更新服务器的名称。

  • description – 更新服务器的描述。如果等于空字符串（例如 ""），则将删除服务器描述。

  • hostname – 更新元数据服务记录的服务器主机名。请注意，需要在客户机上运行单独的实用程序才能将这些更改反映在客户机本身中。

返回值:

服务器