Spec-Zone.ru › Ansible

community.general.clc_modify_server модуль – Изменение серверов в CenturyLink Cloud

Примечание

Этот модуль является частью коллекции community.general (версия 9.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.general. Вам потребуются дополнительные требования для использования этого модуля, см. Требования для получения подробной информации.

Чтобы использовать его в playbook, укажите: community.general.clc_modify_server.

  • Краткое описание
  • Требования
  • Параметры
  • Атрибуты
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Модуль Ansible для изменения серверов в CenturyLink Cloud.

Требования

Ниже приведены требования, необходимые на хосте, который выполняет этот модуль.

  • python = 2.7
  • requests >= 2.5.0
  • clc-sdk

Параметры

Параметр

Комментарии

alert_policy_id

string

Идентификатор политики оповещения, который будет связан с сервером. Взаимоисключающий с ‘alert_policy_name’

alert_policy_name

string

Имя политики оповещения, которая будет связана с сервером. Взаимоисключающий с ‘alert_policy_id’

anti_affinity_policy_id

string

Идентификатор политики анти-аффинити, который будет установлен для сервера гипермасштаба. Взаимоисключающий с ‘anti_affinity_policy_name’

anti_affinity_policy_name

string

Имя политики анти-аффинити, которая будет установлена для сервера гипермасштаба. Взаимоисключающий с ‘anti_affinity_policy_id’

cpu

string

Сколько процессоров обновить на сервере

memory

string

Объём памяти (в ГБ), который нужно установить для сервера.

server_ids

list / elements=string / required

Список идентификаторов серверов для изменения.

state

string

Состояние, в котором должны находиться предоставленные ресурсы.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

wait

boolean

Ждать завершения задач подготовки перед возвратом.

Варианты:

  • false
  • true ← (по умолчанию)

Атрибуты

Атрибут

Поддержка

Описание

check_mode

Поддержка: полная

Может работать в режиме check_mode и возвращать прогноз состояния «изменено» без изменения целевого объекта.

diff_mode

Поддержка: отсутствует

В режиме diff вернёт подробности о том, что изменилось (или что, возможно, нужно изменить в check_mode).

Примечания

Примечание

  • Для использования этого модуля необходимо установить следующие переменные среды, которые обеспечивают доступ к Centurylink Cloud — CLC_V2_API_USERNAME, идентификатор входа в учётную запись для облака centurylink — CLC_V2_API_PASSWORD, пароль учётной записи для облака centurylink
  • В качестве альтернативы модуль принимает токен 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
  • Пользователи могут установить 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

список / элементы=строка

Список идентификаторов серверов, которые были изменены

Возвращаемое значение: успех

Пример: ["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)

Ссылки на коллекцию

  • Трекер задач
  • Репозиторий (источники)
  • Задайте вопрос
  • Отправить отчет об ошибке
  • Запросить новую функцию
  • Общение

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/clc_modify_server_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API