clc_modify_server - изменение серверов в CenturyLink Cloud.
Новая версия с 2.0.
- Описание
- Требования (для хоста, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Описание
- Модуль Ansible для изменения серверов в CenturyLink Cloud.
Требования (для хоста, на котором выполняется модуль)
- python = 2.7
- requests >= 2.5.0
- clc-sdk
Параметры
| параметр | обязательно | по умолчанию | выбор | комментарии |
|---|---|---|---|---|
| alert_policy_id | нет | None | Идентификатор политики оповещения, который необходимо связать с сервером. Взаимоисключающий с параметром 'alert_policy_name' | |
| alert_policy_name | нет | None | Имя политики оповещения, которое необходимо связать с сервером. Взаимоисключающий с параметром 'alert_policy_id' | |
| anti_affinity_policy_id | нет | None | Идентификатор политики противостояния, который необходимо установить для гипермасштабируемого сервера. Взаимоисключающий с параметром 'anti_affinity_policy_name' | |
| anti_affinity_policy_name | нет | None | Имя политики противостояния, которое необходимо установить для гипермасштабируемого сервера. Взаимоисключающий с параметром 'anti_affinity_policy_id' | |
| cpu | нет | None | Количество ЦП для обновления на сервере | |
| memory | нет | None | Объем памяти (в ГБ) для установки на сервере. | |
| server_ids | да | Список идентификаторов серверов для изменения. | ||
| state | нет | present |
| Состояние, которое необходимо гарантировать для предоставленных ресурсов. |
| wait | нет | True |
| Нужно ли ждать завершения задач развертывания перед возвратом. |
Примеры
# 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
clc_modify_server:
server_ids:
- UC1TESTSVR01
- UC1TESTSVR02
cpu: 4
state: present
- name: set the memory to 8GB on a server
clc_modify_server:
server_ids:
- UC1TESTSVR01
- UC1TESTSVR02
memory: 8
state: present
- name: set the anti affinity policy on a server
clc_modify_server:
server_ids:
- UC1TESTSVR01
- UC1TESTSVR02
anti_affinity_policy_name: 'aa_policy'
state: present
- name: remove the anti affinity policy on a server
clc_modify_server:
server_ids:
- UC1TESTSVR01
- UC1TESTSVR02
anti_affinity_policy_name: 'aa_policy'
state: absent
- name: add the alert policy on a server
clc_modify_server:
server_ids:
- UC1TESTSVR01
- UC1TESTSVR02
alert_policy_name: 'alert_policy'
state: present
- name: remove the alert policy on a server
clc_modify_server:
server_ids:
- UC1TESTSVR01
- UC1TESTSVR02
alert_policy_name: 'alert_policy'
state: absent
- name: set the memory to 16GB and cpu to 8 core on a lust if servers
clc_modify_server:
server_ids:
- UC1TESTSVR01
- UC1TESTSVR02
cpu: 8
memory: 16
state: present
Возвращаемые значения
Общие возвращаемые значения описаны здесь Возвращаемые значения, следующие поля уникальны для этого модуля:
| имя | описание | возвращается | тип | пример |
|---|---|---|---|---|
| server_ids | Список идентификаторов серверов, которые были изменены | успех | список | ['UC1TEST-SVR01', 'UC1TEST-SVR02'] |
| servers | Список объектов серверов, которые были изменены | успех | список | [{'status': 'активный', 'описание': 'test-сервер', 'changeInfo': {'modifiedBy': 'service.wfad', 'modifiedDate': 1438196820, 'createdBy': 'service.wfad', 'createdDate': 1438196820}, 'ipaddress': '10.120.45.23', 'storageType': 'стандартный', 'type': 'стандартный', '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': 'группа'}, {'href': '/v2/accounts/wfad', 'id': 'wfad', 'rel': 'аккаунт'}, {'href': '/v2/billing/wfad/serverPricing/test-server', 'rel': 'платежи'}, {'href': '/v2/servers/wfad/test-server/publicIPAddresses', 'verbs': ['POST'], 'rel': 'publicIPAddresses'}, {'href': '/v2/servers/wfad/test-server/credentials', 'rel': 'credentials'}, {'href': '/v2/servers/wfad/test-server/statistics', 'rel': 'статистика'}, {'href': '/v2/servers/wfad/510ec21ae82d4dc89d28479753bf736a/upcomingScheduledActivities', 'rel': 'upcomingScheduledActivities'}, {'href': '/v2/servers/wfad/510ec21ae82d4dc89d28479753bf736a/scheduledActivities', 'verbs': ['GET', 'POST'], 'rel': 'scheduledActivities'}, {'href': '/v2/servers/wfad/test-server/capabilities', 'rel': 'capabilities'}, {'href': '/v2/servers/wfad/test-server/alertPolicies', 'verbs': ['POST'], 'rel': 'alertPolicyMappings'}, {'href': '/v2/servers/wfad/test-server/antiAffinityPolicy', 'verbs': ['PUT', 'DELETE'], 'rel': 'antiAffinityPolicyMapping'}, {'href': '/v2/servers/wfad/test-server/cpuAutoscalePolicy', 'verbs': ['PUT', 'DELETE'], 'rel': 'cpuAutoscalePolicyMapping'}], 'id': 'test-server', 'locationId': 'UC1', 'details': {'hostName': '', 'powerState': 'запущен', 'ipAddresses': [{'internal': '10.1.1.1'}], 'disks': [{'partitionPaths': [], 'id': '0:0', 'sizeGB': 1}, {'partitionPaths': [], 'id': '0:1', 'sizeGB': 2}, {'partitionPaths': [], 'id': '0:2', 'sizeGB': 14}], 'diskCount': 3, 'snapshots': [], 'memoryMB': 1024, 'alertPolicies': [], 'memoryGB': 1, 'storageGB': 17, 'customFields': [], 'cpu': 1, 'inMaintenanceMode': false, 'partitions': []}, 'osType': 'Ubuntu 14 64-разрядный', 'os': 'ubuntu14_64Bit', 'groupId': '086ac1dfe0b6411989e8d1b77c4065f0', 'name': 'test-сервер'}] |
Примечания
Примечание
- Для использования данного модуля необходимо установить переменные окружения, обеспечивающие доступ к CenturyLink Cloud - CLC_V2_API_USERNAME, идентификатор входа в аккаунт - CLC_V2_API_PASSWORD, пароль аккаунта - CenturyLink Cloud
- В качестве альтернативы, модуль принимает токен API и псевдоним аккаунта. Токен API можно сгенерировать, используя входные данные в аккаунт CLC и пароль через вызов HTTP API @ https://api.ctl.io/v2/authentication/login - CLC_V2_API_TOKEN, токен API, сгенерированный из https://api.ctl.io/v2/authentication/login - CLC_ACCT_ALIAS, псевдоним аккаунта, связанный с CenturyLink Cloud
- Пользователи могут установить CLC_V2_API_URL для указания конечной точки для подключения к другому окружению CLC.
Статус
Данный модуль помечен как превью, что означает, что он не гарантирует обратную совместимость.
Для получения помощи в разработке модулей, если вы заинтересованы, прочитайте Справочная информация сообщества и участие, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/clc_modify_server_module.html