ngine_io.cloudstack.cs_service_offering 模块 – 管理基于 Apache CloudStack 云的服务产品。

注意

此模块是 ngine_io.cloudstack 集合 (版本 2.5.0) 的一部分。

如果您使用的是 ansible 包，则可能已安装此集合。它不包含在 ansible-core 中。要检查它是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用： ansible-galaxy collection install ngine_io.cloudstack。您需要其他要求才能使用此模块，有关详细信息，请参阅要求。

要在 playbook 中使用它，请指定： ngine_io.cloudstack.cs_service_offering。

ngine_io.cloudstack 0.1.0 中的新增功能

概要 

创建和删除访客和系统 VM 的服务产品。
更新现有服务产品的 display_text。

要求 

在执行此模块的主机上需要以下要求。

python >= 2.6
cs >= 0.9.0

参数 

参数	注释
api_http_method 字符串	用于查询 API 端点的 HTTP 方法。如果未给出，则考虑 `CLOUDSTACK_METHOD` 环境变量。选项 `"get"` ← (默认) `"post"`
api_key 字符串 / 必需	CloudStack API 的 API 密钥。如果未给出，则考虑 `CLOUDSTACK_KEY` 环境变量。
api_secret 字符串 / 必需	CloudStack API 的密钥。如果未设置，则考虑 `CLOUDSTACK_SECRET` 环境变量。
api_timeout 整数	HTTP 超时（秒）。如果未给出，则考虑 `CLOUDSTACK_TIMEOUT` 环境变量。默认值： `10`
api_url 字符串 / 必需	CloudStack API 的 URL，例如 https://cloud.example.com/client/api。如果未给出，则考虑 `CLOUDSTACK_ENDPOINT` 环境变量。
api_verify_ssl_cert 字符串	验证 CA 权威证书文件。如果未给出，则考虑 `CLOUDSTACK_VERIFY` 环境变量。
cpu_number 整数	服务产品的 CPU 数量。
cpu_speed 整数	服务产品的 CPU 速度（MHz）。
deployment_planner 字符串	用于部署此产品的 VM 的部署规划器启发式算法。如果未设置，则使用全局配置 vm.deployment.planner 的值。
disk_bytes_read_rate 别名：bytes_read_rate 整数	磁盘产品的读取速率（字节）。
disk_bytes_write_rate 别名：bytes_write_rate 整数	磁盘产品的写入速率（字节）。
disk_iops_max 整数	计算产品的最大 IOPS。
disk_iops_min 整数	计算产品的最小 IOPS。
disk_iops_read_rate 整数	磁盘产品的读取 I/O 请求速率。
disk_iops_write_rate 整数	磁盘产品的写入 I/O 请求速率。
display_text 字符串	服务产品的显示文本。如果未设置，则在创建时将 name 用作 display_text。
domain 字符串	服务产品相关的域。如果未设置，则对所有域和子域公开。
host_tags 别名：host_tag 列表 / 元素=字符串	此服务产品的主机标签。
hypervisor_snapshot_reserve 整数	作为卷百分比的虚拟机快照保留空间。仅适用于使用 Xen 或 VMware 的托管存储。
is_customized 布尔值	该产品是否可定制。选项 `false` `true`
is_iops_customized 别名：disk_iops_customized 布尔值	计算产品的 IOPS 是否自定义。选项 `false` `true`
is_system 布尔值	它是否是系统 VM 产品。选项 `false` ← (默认) `true`
is_volatile 布尔值	虚拟机是否需要易失性。每次重新启动 VM 时，根磁盘都会被分离然后销毁，并创建一个新的根磁盘并将其附加到 VM。选项 `false` `true`
limit_cpu_usage 布尔值	将 CPU 使用限制为已提交的服务产品。选项 `false` `true`
memory 整数	服务产品的总内存（MB）。
name 字符串 / 必需	服务产品的名称。
network_rate 整数	允许的数据传输速率（Mb/s）。仅适用于非系统产品和具有 system_vm_type=domainrouter 的系统产品。
offer_ha 布尔值	服务产品是否设置了 HA。选项 `false` `true`
配置类型字符串	用于创建卷的配置类型。选项 `“精简型”` `“稀疏型”` `“完整型”`
服务配置详情列表 / 元素=字典	规划器详情，用于存储特定参数。一个字典列表，包含键`key`和`value`。
状态字符串	服务配置的状态。选项 `"present"` ← (默认) `“不存在”`
存储标签别名：storage_tag 列表 / 元素=字符串	此服务配置的存储标签。
存储类型字符串	服务配置的存储类型。选项 `“本地”` `“共享”`
系统VM类型字符串	系统VM类型。如果is_system=yes，则需要此参数。选项 `“域路由器”` `“控制台代理”` `“二级存储虚拟机”`
验证证书布尔值在ngine_io.cloudstack 2.4.0中添加	如果`false`，则不会验证SSL证书。如果没有给出，则考虑`CLOUDSTACK_DANGEROUS_NO_TLS_VERIFY`环境变量。这仅应在使用自签名证书的个人控制站点上使用。选项 `false` `true` ← (默认)

备注 

注意

有关CloudStack模块的详细指南，请参阅CloudStack云指南。
此模块支持检查模式。

示例 

- name: Create a non-volatile compute service offering with local storage
  ngine_io.cloudstack.cs_service_offering:
    name: Micro
    display_text: Micro 512mb 1cpu
    cpu_number: 1
    cpu_speed: 2198
    memory: 512
    host_tags: eco
    storage_type: local

- name: Create a volatile compute service offering with shared storage
  ngine_io.cloudstack.cs_service_offering:
    name: Tiny
    display_text: Tiny 1gb 1cpu
    cpu_number: 1
    cpu_speed: 2198
    memory: 1024
    storage_type: shared
    is_volatile: yes
    host_tags: eco
    storage_tags: eco

- name: Create or update a volatile compute service offering with shared storage
  ngine_io.cloudstack.cs_service_offering:
    name: Tiny
    display_text: Tiny 1gb 1cpu
    cpu_number: 1
    cpu_speed: 2198
    memory: 1024
    storage_type: shared
    is_volatile: yes
    host_tags: eco
    storage_tags: eco

- name: Create or update a custom compute service offering
  ngine_io.cloudstack.cs_service_offering:
    name: custom
    display_text: custom compute offer
    is_customized: yes
    storage_type: shared
    host_tags: eco
    storage_tags: eco

- name: Remove a compute service offering
  ngine_io.cloudstack.cs_service_offering:
    name: Tiny
    state: absent

- name: Create or update a system offering for the console proxy
  ngine_io.cloudstack.cs_service_offering:
    name: System Offering for Console Proxy 2GB
    display_text: System Offering for Console Proxy 2GB RAM
    is_system: yes
    system_vm_type: consoleproxy
    cpu_number: 1
    cpu_speed: 2198
    memory: 2048
    storage_type: shared
    storage_tags: perf

- name: Remove a system offering
  ngine_io.cloudstack.cs_service_offering:
    name: System Offering for Console Proxy 2GB
    is_system: yes
    state: absent

返回值 

常见返回值已在此处记录，以下是此模块特有的字段

键	描述
cpu_number 整数	服务配置中的CPU数量返回值：成功示例：`4`
cpu_speed 整数	服务配置中CPU的速度（MHz）返回值：成功示例：`2198`
创建日期字符串	配置创建日期返回值：成功示例：`"2017-11-19T10:48:59+0000"`
磁盘读取速率（字节）整数	服务配置的字节读取速率返回值：成功示例：`1000`
磁盘写入速率（字节）整数	服务配置的字节写入速率返回值：成功示例：`1000`
disk_iops_max 整数	磁盘配置的最大IOPS 返回值：成功示例：`1000`
disk_iops_min 整数	磁盘配置的最小IOPS 返回值：成功示例：`500`
disk_iops_read_rate 整数	服务配置的每秒I/O请求读取速率返回值：成功示例：`1000`
disk_iops_write_rate 整数	服务配置的每秒I/O请求写入速率返回值：成功示例：`1000`
display_text 字符串	配置的显示文本返回值：成功示例：`"Micro 512mb 1cpu"`
domain 字符串	配置所在的域返回值：成功示例：`"ROOT"`
主机标签列表 / 元素=字符串	主机标签列表返回值：成功示例：`["eco"]`
ID 字符串	服务配置的UUID 返回值：成功示例：`"a6f7a5fc-43f8-11e5-a151-feff819cdc9f"`
is_customized 布尔值	配置是否可定制返回值：成功示例：`false`
是否使用自定义IOPS 布尔值	配置是否使用自定义IOPS。返回值：成功示例：`false`
is_system 布尔值	配置是否用于系统VM。返回值：成功示例：`false`
is_volatile 布尔值	配置是否为易失性。返回值：成功示例：`false`
limit_cpu_usage 布尔值	CPU使用率是否限制在已承诺的服务配置中。返回值：成功示例：`false`
memory 整数	系统配置的内存返回值：成功示例：`512`
name 字符串	系统配置的名称返回值：成功示例：`"Micro"`
network_rate 整数	允许的数据传输速率（兆比特/秒）返回值：成功示例：`1000`
offer_ha 布尔值	配置中是否启用了HA支持。返回值：成功示例：`false`
配置类型字符串	用于创建卷的配置类型返回值：成功示例：`"thin"`
服务配置详情字典	附加的服务配置详情返回值：成功示例：`{"pciDevice": "Group of NVIDIA Corporation GK107GL [GRID K1] GPUs", "vgpuType": "GRID K180Q"}`
存储标签列表 / 元素=字符串	存储标签列表返回值：成功示例：`["eco"]`
存储类型字符串	用于创建卷的存储类型返回值：成功示例：`"shared"`
系统VM类型字符串	此配置的系统VM类型返回值：成功示例：`"consoleproxy"`

作者

René Moser (@resmo)