community.general.clc_modify_server 模块 – 修改 CenturyLink Cloud 中的服务器

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

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

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

要在 playbook 中使用它，请指定：community.general.clc_modify_server。

概要 

一个用于修改 CenturyLink Cloud 中服务器的 Ansible 模块。

需求 

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

python = 2.7
requests >= 2.5.0
clc-sdk

参数 

参数	注释
alert_policy_id 字符串	要与服务器关联的警报策略 ID。这与“alert_policy_name”互斥
alert_policy_name 字符串	要与服务器关联的警报策略名称。这与“alert_policy_id”互斥
anti_affinity_policy_id 字符串	要为超大规模服务器设置的反亲和性策略 ID。这与“anti_affinity_policy_name”互斥
anti_affinity_policy_name 字符串	要为超大规模服务器设置的反亲和性策略名称。这与“anti_affinity_policy_id”互斥
cpu 字符串	要在服务器上更新的 CPU 数量
memory 字符串	要设置为服务器的内存（以 GB 为单位）。
server_ids 列表 / 元素=字符串 / 必需	要修改的服务器 ID 列表。
state 字符串	确保提供的资源处于的状态。选项 `"present"` ← (默认) `"absent"`
wait 布尔值	是否在返回之前等待配置任务完成。选项 `false` `true` ← (默认)

属性 

属性	支持	描述
check_mode	支持：完全支持	可以在 `check_mode` 中运行，并在不修改目标的情况下返回更改状态预测。
diff_mode	支持：不支持	处于 diff 模式时，将返回有关已更改内容（或可能需要在 `check_mode` 中更改）的详细信息。

备注 

注意

要使用此模块，需要设置以下环境变量，这些变量可以访问 CenturyLink Cloud - CLC_V2_API_USERNAME（CenturyLink Cloud 的帐户登录 ID） - CLC_V2_API_PASSWORD（CenturyLink Cloud 的帐户密码）
或者，该模块接受 API 令牌和帐户别名。可以使用 CLC 帐户登录名和密码通过 HTTP api 调用在 https://api.ctl.io/v2/authentication/login 生成 API 令牌 - CLC_V2_API_TOKEN（从 https://api.ctl.io/v2/authentication/login 生成的 API 令牌） - CLC_ACCT_ALIAS（与 CenturyLink Cloud 关联的帐户别名）
用户可以设置 CLC_V2_API_URL 来指定指向不同 CLC 环境的端点。

示例 

# Note - You must set the CLC_V2_API_USERNAME And CLC_V2_API_PASSWD Environment variables before running these examples

- name: Set the cpu count to 4 on a server
  community.general.clc_modify_server:
    server_ids:
        - UC1TESTSVR01
        - UC1TESTSVR02
    cpu: 4
    state: present

- name: Set the memory to 8GB on a server
  community.general.clc_modify_server:
    server_ids:
        - UC1TESTSVR01
        - UC1TESTSVR02
    memory: 8
    state: present

- name: Set the anti affinity policy on a server
  community.general.clc_modify_server:
    server_ids:
        - UC1TESTSVR01
        - UC1TESTSVR02
    anti_affinity_policy_name: 'aa_policy'
    state: present

- name: Remove the anti affinity policy on a server
  community.general.clc_modify_server:
    server_ids:
        - UC1TESTSVR01
        - UC1TESTSVR02
    anti_affinity_policy_name: 'aa_policy'
    state: absent

- name: Add the alert policy on a server
  community.general.clc_modify_server:
    server_ids:
        - UC1TESTSVR01
        - UC1TESTSVR02
    alert_policy_name: 'alert_policy'
    state: present

- name: Remove the alert policy on a server
  community.general.clc_modify_server:
    server_ids:
        - UC1TESTSVR01
        - UC1TESTSVR02
    alert_policy_name: 'alert_policy'
    state: absent

- name: Ret the memory to 16GB and cpu to 8 core on a lust if servers
  community.general.clc_modify_server:
    server_ids:
        - UC1TESTSVR01
        - UC1TESTSVR02
    cpu: 8
    memory: 16
    state: present

返回值 

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

键

描述

server_ids

列表 / 元素=字符串

已更改的服务器 ID 列表

返回：成功

示例：["UC1TEST-SVR01", "UC1TEST-SVR02"]

servers

列表 / 元素=字符串

已更改的服务器对象列表

返回：成功

示例： [{"changeInfo": {"createdBy": "service.wfad", "createdDate": 1438196820, "modifiedBy": "service.wfad", "modifiedDate": 1438196820}, "description": "test-server", "details": {"alertPolicies": [], "cpu": 1, "customFields": [], "diskCount": 3, "disks": [{"id": "0:0", "partitionPaths": [], "sizeGB": 1}, {"id": "0:1", "partitionPaths": [], "sizeGB": 2}, {"id": "0:2", "partitionPaths": [], "sizeGB": 14}], "hostName": "", "inMaintenanceMode": false, "ipAddresses": [{"internal": "10.1.1.1"}], "memoryGB": 1, "memoryMB": 1024, "partitions": [], "powerState": "started", "snapshots": [], "storageGB": 17}, "groupId": "086ac1dfe0b6411989e8d1b77c4065f0", "id": "test-server", "ipaddress": "10.120.45.23", "isTemplate": false, "links": [{"href": "/v2/servers/wfad/test-server", "id": "test-server", "rel": "self", "verbs": ["GET", "PATCH", "DELETE"]}, {"href": "/v2/groups/wfad/086ac1dfe0b6411989e8d1b77c4065f0", "id": "086ac1dfe0b6411989e8d1b77c4065f0", "rel": "group"}, {"href": "/v2/accounts/wfad", "id": "wfad", "rel": "account"}, {"href": "/v2/billing/wfad/serverPricing/test-server", "rel": "billing"}, {"href": "/v2/servers/wfad/test-server/publicIPAddresses", "rel": "publicIPAddresses", "verbs": ["POST"]}, {"href": "/v2/servers/wfad/test-server/credentials", "rel": "credentials"}, {"href": "/v2/servers/wfad/test-server/statistics", "rel": "statistics"}, {"href": "/v2/servers/wfad/510ec21ae82d4dc89d28479753bf736a/upcomingScheduledActivities", "rel": "upcomingScheduledActivities"}, {"href": "/v2/servers/wfad/510ec21ae82d4dc89d28479753bf736a/scheduledActivities", "rel": "scheduledActivities", "verbs": ["GET", "POST"]}, {"href": "/v2/servers/wfad/test-server/capabilities", "rel": "capabilities"}, {"href": "/v2/servers/wfad/test-server/alertPolicies", "rel": "alertPolicyMappings", "verbs": ["POST"]}, {"href": "/v2/servers/wfad/test-server/antiAffinityPolicy", "rel": "antiAffinityPolicyMapping", "verbs": ["PUT", "DELETE"]}, {"href": "/v2/servers/wfad/test-server/cpuAutoscalePolicy", "rel": "cpuAutoscalePolicyMapping", "verbs": ["PUT", "DELETE"]}], "locationId": "UC1", "name": "test-server", "os": "ubuntu14_64Bit", "osType": "Ubuntu 14 64-bit", "status": "active", "storageType": "standard", "type": "standard"}]

作者

CLC Runner (@clc-runner)

community.general.clc_modify_server 模块 – 修改 CenturyLink Cloud 中的服务器

概要

需求

参数

属性

备注

示例

返回值

作者

资源链接

概要 

需求 

参数 

属性 

备注 

示例 

返回值 