7.1.0

CHANGELOG.md

@@ -1,11 +1,19 @@
-# Список изменений в версии 6.1.2
+# Список изменений в версии 7.1.0
 
 ## Добавлено
+### Модуль decort_kvmvm
+| Идентификатор<br>задачи | Описание |
+| --- | --- |
+| BANS-650 | Добавлена возможность откатить ВМ к состоянию снимка с помощью нового параметра `rollback_to`.  Добавлено возвращаемое значение `snapshots`. |
+| BANS-675 | Для параметра `chipset` добавлено значение по умолчанию `i440fx` при создании ВМ. |
+| BANS-692 | Добавлен параметр `preferred_cpu_cores` и возвращаемое значение  `preferred_cpu_cores`. |
+| BANS-694 | Добавлена проверка параметра `hp_backed` при подключении ВМ к `DPDK` сети . |
 
 ## Удалено
 
 ## Исправлено
-### Модуль decort_k8s
+### Модуль decort_kvmvm
 | Идентификатор<br>задачи | Описание |
 | --- | --- |
-| BANS-682 | При создании кластера k8s, модуль завершал свою работу ошибкой запроса к API. |
+| BANS-679 | Модуль завершал свою работу ошибкой проверки входных параметров при указании целевого состояния `state: absent` и имени ВМ, которой уже не существует. |
+| BANS-707 | При попытке для остановленной ВМ задать новые значения для параметров `chipset`, `cpu_pin`, `hp_backed` или `numa_affinity`, модуль требовал задать для параметра `state` значение, соответствующее остановленной ВМ. |

README.md

@@ -5,6 +5,7 @@
 
 | Версия платформы |   Версия модулей Ansible   |
 |:----------------:|:--------------------------:|
+|      4.2.0       |        7.0.x, 7.1.x        |
 |      4.1.0       |        6.0.x, 6.1.x        |
 |      4.0.0       | 5.6.x, 5.5.x, 5.4.x, 5.3.x |
 |   3.8.8, 3.8.9   |           5.2.6            |

examples/affinity.yaml

@@ -1,36 +0,0 @@
----
-#
-# DECORT kvmvm module example
-#
-- hosts: ansible_master
-  tasks:
-  - name: create a VM named cloud-init_example
-    decort_kvmvm:
-      name: affinity_example
-      annotation: "VM managed by decort_kvmvm module"
-      authenticator: oauth2
-      app_id: ""                                          # Application id from SSO Digital Energy
-      app_secret: ""                                      # API key from SSO Digital Energy
-      controller_url: ""                                  #"https://mr4.digitalenergy.online"
-      rg_id:                                              # Resource group id
-      cpu: 2
-      ram: 2048
-      boot_disk: 10
-      image_name: "DECS Ubuntu 18.04 v1.2.3"              # Name of OS image
-      networks:
-        - type: VINS
-          id:                                             # VINS id
-      tags: "Ansible cloud init example"
-      aff_lable: "Affinity lable"
-      tag:
-        - key: bd
-          value: main
-      aff_rule:
-        - key: app
-          value: main
-          topology: compute
-          policy: REQUIRED
-          mode: EQ
-      state: present
-    delegate_to: localhost
-    register: simple_vm

examples/anti_affinity.yaml

@@ -1,36 +0,0 @@
----
-#
-# DECORT kvmvm module example
-#
-- hosts: ansible_master
-  tasks:
-  - name: create a VM named cloud-init_example
-    decort_kvmvm:
-      name: anti-affinity_example
-      annotation: "VM managed by decort_kvmvm module"
-      authenticator: oauth2
-      app_id: ""                                          # Application id from SSO Digital Energy
-      app_secret: ""                                      # API key from SSO Digital Energy
-      controller_url: ""                                  #"https://mr4.digitalenergy.online"
-      rg_id:                                              # Resource group id
-      cpu: 2
-      ram: 2048
-      boot_disk: 10
-      image_name: "DECS Ubuntu 18.04 v1.2.3"              #Name of OS image
-      networks:
-        - type: VINS
-          id:                                             #VINS id
-      tags: "Ansible cloud init example"
-      aff_lable: "Anti affinity lable"
-      tag:
-        - key: bd
-          value: main
-      aaff_rule:
-        - key: app
-          value: main
-          topology: compute
-          policy: REQUIRED
-          mode: ANY
-      state: present
-    delegate_to: localhost
-    register: simple_vm

examples/cloud_init.yaml

@@ -1,38 +0,0 @@
-#
-# DECORT kvmvm module example
-#
-- hosts: ansible_master
-  tasks:
-  - name: create a VM named cloud-init_example
-    decort_kvmvm:
-      annotation: "VM managed by decort_kvmvm module"
-      authenticator: oauth2
-      app_id: ""                                          # Application id from SSO Digital Energy
-      app_secret: ""                                      # API key from SSO Digital Energy
-      controller_url: ""                                  #"https://mr4.digitalenergy.online"
-      name: cloud-init_example
-      cpu: 2
-      ram: 2048
-      boot_disk: 10
-      image_name: "DECS Ubuntu 18.04 v1.2.3"              #Name of OS image
-      networks:
-        - type: VINS
-          id:                                             #VINS id
-      tags: "Ansible cloud init example"
-      state: present
-      rg_id:                                              #Resource group id
-      ci_user_data:
-        packages:
-          - apache2
-        write_files:
-          - content: |
-              <div>
-              Hello World!
-              </div>
-            owner: user:user
-            path: /var/www/html/index.html
-        hostname: test-apache
-        ssh_keys:
-          - rsa_public: ssh-rsa AAAAOasDmLxnD=  user@pc
-    delegate_to: localhost
-    register: simple_vm

library/decort_bservice.py

@@ -13,8 +13,9 @@ from ansible.module_utils.decort_utils import *
 
 
 class decort_bservice(DecortController):
-    def __init__(self,arg_amodule):
+    def __init__(self):
-        super(decort_bservice, self).__init__(arg_amodule)
+        super(decort_bservice, self).__init__(AnsibleModule(**self.amodule_init_args))
+        arg_amodule = self.amodule
 
         validated_acc_id = 0
         validated_rg_id = 0
@@ -147,70 +148,66 @@ class decort_bservice(DecortController):
         ret_dict['account_id'] = self.bservice_info['accountId']
         ret_dict['groups'] = self.bservice_info['groups']
         return ret_dict
-    @staticmethod
-    def build_parameters():
-        return dict(
-            account_id=dict(type='int', required=False),
-            account_name=dict(type='str', required=False, default=''),
-            app_id=dict(type='str',
-                        required=False,
-                        fallback=(env_fallback, ['DECORT_APP_ID'])),
-            app_secret=dict(type='str',
-                            required=False,
-                            fallback=(env_fallback, ['DECORT_APP_SECRET']),
-                            no_log=True),
-            authenticator=dict(type='str',
-                            required=True,
-                            choices=['legacy', 'oauth2', 'jwt']),
-            controller_url=dict(type='str', required=True),
-            jwt=dict(type='str',
-                    required=False,
-                    fallback=(env_fallback, ['DECORT_JWT']),
-                    no_log=True),
-            oauth2_url=dict(type='str',
-                            required=False,
-                            fallback=(env_fallback, ['DECORT_OAUTH2_URL'])),
-            password=dict(type='str',
-                        required=False,
-                        fallback=(env_fallback, ['DECORT_PASSWORD']),
-                        no_log=True),
-            state=dict(type='str',
-                    default='present',
-                    choices=['absent', 'disabled', 'enabled', 'present','check']),
-            started=dict(type='bool', required=False, default=True),
-            user=dict(type='str',
-                    required=False,
-                    fallback=(env_fallback, ['DECORT_USER'])),
-            name=dict(type='str', required=False, default=''),
-            sshuser=dict(type='str', required=False,default=None),
-            sshkey=dict(type='str', required=False,default=None),
-            id=dict(type='int', required=False, default=0),
-            rg_id=dict(type='int', default=0),
-            rg_name=dict(type='str',default=""),
-            verify_ssl=dict(type='bool', required=False, default=True),
-            workflow_callback=dict(type='str', required=False),
-            workflow_context=dict(type='str', required=False),)
-def main():
-    module_parameters = decort_bservice.build_parameters()
 
-    amodule = AnsibleModule(argument_spec=module_parameters,
+    @property
-                            supports_check_mode=True,
+    def amodule_init_args(self) -> dict:
-                            mutually_exclusive=[
+        return self.pack_amodule_init_args(
-                                ['oauth2', 'password'],
+            argument_spec=dict(
-                                ['password', 'jwt'],
+                account_id=dict(
-                                ['jwt', 'oauth2'],
+                    type='int',
-                            ],
+                ),
-                            required_together=[
+                account_name=dict(
-                                ['app_id', 'app_secret'],
+                    type='str',
-                                ['user', 'password'],
+                    default='',
-                            ],
+                ),
-                            required_one_of=[
+                state=dict(
-                                ['id', 'name'],
+                    type='str',
-                                ['rg_id','rg_name']
+                    default='present',
-                            ],
+                    choices=[
-                            )
+                        'absent',
+                        'disabled',
+                        'enabled',
+                        'present',
+                        'check',
+                    ],
+                ),
+                started=dict(
+                    type='bool',
+                    default=True,
+                ),
+                name=dict(
+                    type='str',
+                    default='',
+                ),
+                sshuser=dict(
+                    type='str',
+                ),
+                sshkey=dict(
+                    type='str',
+                ),
+                id=dict(
+                    type='int',
+                    default=0,
+                ),
+                rg_id=dict(
+                    type='int',
+                    default=0,
+                ),
+                rg_name=dict(
+                    type='str',
+                    default='',
+                ),
+            ),
+            supports_check_mode=True,
+            required_one_of=[
+                ('id', 'name'),
+                ('rg_id', 'rg_name'),
+            ],
+        )
 
-    subj = decort_bservice(amodule)
+def main():
+    subj = decort_bservice()
+    amodule = subj.amodule
     
     if amodule.params['state'] == 'check':
         subj.result['changed'] = False

library/decort_disk.py

@@ -14,8 +14,9 @@ from ansible.module_utils.decort_utils import *
 
 
 class decort_disk(DecortController):
-    def __init__(self,arg_amodule):
+    def __init__(self):
-        super(decort_disk, self).__init__(arg_amodule)
+        super(decort_disk, self).__init__(AnsibleModule(**self.amodule_init_args))
+        arg_amodule = self.amodule
 
         validated_acc_id = 0
         validated_acc_info = None
@@ -176,98 +177,136 @@ class decort_disk(DecortController):
         ret_dict['iotune'] = self.disk_info['iotune']
 
         return ret_dict
-    @staticmethod
-    def build_parameters():
-        """Build and return a dictionary of parameters expected by decort_disk module in a form accepted
-        by AnsibleModule utility class."""
 
-        return dict(
+    @property
-            account_id=dict(type='int', required=False, default=0),
+    def amodule_init_args(self) -> dict:
-            account_name=dict(type='str', required=False, default=''),
+        return self.pack_amodule_init_args(
-            description=dict(type='str', required=False, default='Disk by decort_disk'),
+            argument_spec=dict(
-            app_id=dict(type='str',
+                account_id=dict(
-                        required=False,
+                    type='int',
-                        fallback=(env_fallback, ['DECORT_APP_ID'])),
+                    default=0,
-            app_secret=dict(type='str',
+                ),
-                            required=False,
+                account_name=dict(
-                            fallback=(env_fallback, ['DECORT_APP_SECRET']),
+                    type='str',
-                            no_log=True),
+                    default='',
-            authenticator=dict(type='str',
+                ),
-                               required=True,
+                description=dict(
-                               choices=['legacy', 'oauth2', 'jwt']),
+                    type='str',
-            controller_url=dict(type='str', required=True),
+                    default='Disk by decort_disk',
-            id=dict(type='int', required=False, default=0),
+                ),
-            name=dict(type='str', required=False),
+                id=dict(
-            force_detach=dict(type='bool', required=False, default=False),
+                    type='int',
-            jwt=dict(type='str',
+                    default=0,
-                     required=False,
+                ),
-                     fallback=(env_fallback, ['DECORT_JWT']),
+                name=dict(
-                     no_log=True),
+                    type='str',
-            oauth2_url=dict(type='str',
+                ),
-                            required=False,
+                force_detach=dict(
-                            fallback=(env_fallback, ['DECORT_OAUTH2_URL'])),
+                    type='bool',
-            password=dict(type='str',
+                    default=False,
-                          required=False,
+                ),
-                          fallback=(env_fallback, ['DECORT_PASSWORD']),
+                place_with=dict(
-                          no_log=True),
+                    type='int',
-            place_with=dict(type='int', default=0),
+                    default=0,
-            pool=dict(type='str', default=''),
+                ),
-            sep_id=dict(type='int', default=0),
+                pool=dict(
-            size=dict(type='int'),
+                    type='str',
-            type=dict(type='str', 
+                    default='',
-                      required=False, 
+                ),
-                      default="D",
+                sep_id=dict(
-                      choices=['B', 'D', 'T']),
+                    type='int',
-            iops=dict(type='int',required=False,default=2000),
+                    default=0,
-            limitIO=dict(type='dict',
+                ),
-                options=dict(
+                size=dict(
-                    total_bytes_sec=dict(required=False,type='int'),
+                    type='int',
-                    read_bytes_sec=dict(required=False,type='int'),
+                ),
-                    write_bytes_sec=dict(required=False,type='int'),
+                type=dict(
-                    total_iops_sec=dict(required=False,type='int'),
+                    type='str',
-                    read_iops_sec=dict(required=False,type='int'),
+                    default='D',
-                    write_iops_sec=dict(required=False,type='int'),
+                    choices=[
-                    total_bytes_sec_max=dict(required=False,type='int'),
+                        'B',
-                    read_bytes_sec_max=dict(required=False,type='int'),
+                        'D',
-                    write_bytes_sec_max=dict(required=False,type='int'),
+                        'T',
-                    total_iops_sec_max=dict(required=False,type='int'),
+                    ],
-                    read_iops_sec_max=dict(required=False,type='int'),
+                ),
-                    write_iops_sec_max=dict(required=False,type='int'),
+                iops=dict(
-                    size_iops_sec=dict(required=False,type='int'),)),
+                    type='int',
-            permanently=dict(type='bool', required=False, default=False),
+                    default=2000,
-            shareable=dict(type='bool', required=False, default=False),
+                ),
-            reason=dict(type='str', required=False,default='Managed by Ansible decort_disk'),
+                limitIO=dict(
-            state=dict(type='str',
+                    type='dict',
-                       default='present',
+                    options=dict(
-                       choices=['absent', 'present']),
+                        total_bytes_sec=dict(
-            user=dict(type='str',
+                            type='int',
-                      required=False,
+                        ),
-                      fallback=(env_fallback, ['DECORT_USER'])),
+                        read_bytes_sec=dict(
-            verify_ssl=dict(type='bool', required=False, default=True),
+                            type='int',
-            workflow_callback=dict(type='str', required=False),
+                        ),
-            workflow_context=dict(type='str', required=False),
+                        write_bytes_sec=dict(
+                            type='int',
+                        ),
+                        total_iops_sec=dict(
+                            type='int',
+                        ),
+                        read_iops_sec=dict(
+                            type='int',
+                        ),
+                        write_iops_sec=dict(
+                            type='int',
+                        ),
+                        total_bytes_sec_max=dict(
+                            type='int',
+                        ),
+                        read_bytes_sec_max=dict(
+                            type='int',
+                        ),
+                        write_bytes_sec_max=dict(
+                            type='int',
+                        ),
+                        total_iops_sec_max=dict(
+                            type='int',
+                        ),
+                        read_iops_sec_max=dict(
+                            type='int',
+                        ),
+                        write_iops_sec_max=dict(
+                            type='int',
+                        ),
+                        size_iops_sec=dict(
+                            type='int',
+                        ),
+                    ),
+                ),
+                permanently=dict(
+                    type='bool',
+                    default=False,
+                ),
+                shareable=dict(
+                    type='bool',
+                    default=False,
+                ),
+                reason=dict(
+                    type='str',
+                    default='Managed by Ansible decort_disk',
+                ),
+                state=dict(
+                    type='str',
+                    default='present',
+                    choices=[
+                        'absent',
+                        'present',
+                    ],
+                ),
+            ),
+            supports_check_mode=True,
+            required_one_of=[
+                ('id', 'name'),
+            ],
         )
 
 def main():
-    module_parameters = decort_disk.build_parameters()
+    decon = decort_disk()
-
+    amodule = decon.amodule
-    amodule = AnsibleModule(argument_spec=module_parameters,
-                            supports_check_mode=True,
-                            mutually_exclusive=[
-                                ['oauth2', 'password'],
-                                ['password', 'jwt'],
-                                ['jwt', 'oauth2'],
-                            ],
-                            required_together=[
-                                ['app_id', 'app_secret'],
-                                ['user', 'password'],
-                            ],
-                            required_one_of=[
-                                ['id', 'name'],
-                            ],
-                            )
-
-    decon = decort_disk(amodule)
     #
     #Full range of Disk status is as follows:
     #

library/decort_group.py

@@ -13,8 +13,10 @@ from ansible.module_utils.decort_utils import *
 
 
 class decort_group(DecortController):
-    def __init__(self,arg_amodule):
+    def __init__(self):
-        super(decort_group, self).__init__(arg_amodule)
+        super(decort_group, self).__init__(AnsibleModule(**self.amodule_init_args))
+        arg_amodule = self.amodule
+
         self.group_should_exist = False
         validated_bservice_id = None
         #find and validate B-Service
@@ -169,95 +171,106 @@ class decort_group(DecortController):
         ret_dict['state'] = self.group_info['status']
         ret_dict['Computes'] = self.group_info['computes']
         return ret_dict
-    @staticmethod
+
-    def build_parameters():
+    @property
-        return dict(
+    def amodule_init_args(self) -> dict:
-            account_id=dict(type='int', required=False),
+        return self.pack_amodule_init_args(
-            account_name=dict(type='str', required=False, default=''),
+            argument_spec=dict(
-            app_id=dict(type='str',
+                account_id=dict(
-                        required=False,
+                    type='int',
-                        fallback=(env_fallback, ['DECORT_APP_ID'])),
+                ),
-            app_secret=dict(type='str',
+                account_name=dict(
-                            required=False,
+                    type='str',
-                            fallback=(env_fallback, ['DECORT_APP_SECRET']),
+                    default='',
-                            no_log=True),
+                ),
-            authenticator=dict(type='str',
+                state=dict(
-                            required=True,
+                    type='str',
-                            choices=['legacy', 'oauth2', 'jwt']),
-            controller_url=dict(type='str', required=True),
-            jwt=dict(type='str',
-                    required=False,
-                    fallback=(env_fallback, ['DECORT_JWT']),
-                    no_log=True),
-            oauth2_url=dict(type='str',
-                            required=False,
-                            fallback=(env_fallback, ['DECORT_OAUTH2_URL'])),
-            password=dict(type='str',
-                        required=False,
-                        fallback=(env_fallback, ['DECORT_PASSWORD']),
-                        no_log=True),
-            state=dict(type='str',
                     default='present',
-                    choices=['absent', 'started', 'stopped', 'present','check']),
+                    choices=[
-            user=dict(type='str',
+                        'absent',
-                    required=False,
+                        'started',
-                    fallback=(env_fallback, ['DECORT_USER'])),
+                        'stopped',
-            name=dict(type='str'),
+                        'present',
-            id=dict(type='int', required=False),
+                        'check',
-            image_id=dict(type='int', required=False),
+                    ],
-            image_name=dict(type='str', required=False),
+                ),
-            driver=dict(type='str', required=False, choices=['KVM_X86', 'SVA_KVM_X86'], default="KVM_X86"),
+                name=dict(
-            boot_disk=dict(type='int', required=False),
+                    type='str',
-            bservice_id=dict(type='int', required=True),
+                ),
-            count=dict(type='int'),
+                id=dict(
-            timeoutStart=dict(type='int', required=False),
+                    type='int',
-            role=dict(type='str', required=False),
+                ),
-            cpu=dict(type='int', required=False),
+                image_id=dict(
-            ram=dict(type='int', required=False),
+                    type='int',
-            networks=dict(
+                ),
-                type='list', elements='dict',
+                image_name=dict(
-                options=dict(
+                    type='str',
-                    type=dict(
+                ),
-                        type='str',
+                driver=dict(
-                        required=True,
+                    type='str',
-                        choices=['VINS', 'EXTNET']
+                    choices=[
-                    ),
+                        'KVM_X86',
-                    id=dict(
+                        'SVA_KVM_X86',
-                        type='int',
+                    ],
-                        required=True
+                    default='KVM_X86',
+                ),
+                boot_disk=dict(
+                    type='int',
+                ),
+                bservice_id=dict(
+                    type='int',
+                    required=True,
+                ),
+                count=dict(
+                    type='int',
+                ),
+                timeoutStart=dict(
+                    type='int',
+                ),
+                role=dict(
+                    type='str',
+                ),
+                cpu=dict(
+                    type='int',
+                ),
+                ram=dict(
+                    type='int',
+                ),
+                networks=dict(
+                    type='list',
+                    elements='dict',
+                    options=dict(
+                        type=dict(
+                            type='str',
+                            required=True,
+                            choices=[
+                                'VINS',
+                                'EXTNET',
+                            ]
+                        ),
+                        id=dict(
+                            type='int',
+                            required=True,
+                        )
                     )
-                )
+                ),
             ),
-            verify_ssl=dict(type='bool', required=False, default=True),
+            supports_check_mode=True,
-            workflow_callback=dict(type='str', required=False),
+            required_one_of=[
-            workflow_context=dict(type='str', required=False),)
+                ('id', 'name'),
-def main():
+                ('id', 'networks'),
-    module_parameters = decort_group.build_parameters()
+                ('id', 'count'),
-
+                ('id', 'cpu'),
-    amodule = AnsibleModule(argument_spec=module_parameters,
+                ('id', 'ram'),
-                            supports_check_mode=True,
+                ('id', 'boot_disk'),
-                            mutually_exclusive=[
+                ('id', 'image_id'),
-                                ['oauth2', 'password'],
+                ('id', 'driver'),
-                                ['password', 'jwt'],
+            ],
-                                ['jwt', 'oauth2'],
+        )
-                            ],
-                            required_together=[
-                                ['app_id', 'app_secret'],
-                                ['user', 'password'],
-                            ],
-                            required_one_of=[
-                                ['id', 'name'],
-                                ['id', 'networks'],
-                                ['id', 'count'],
-                                ['id', 'cpu'],
-                                ['id', 'ram'],
-                                ['id', 'boot_disk'],
-                                ['id', 'image_id'],
-                                ['id', 'driver'],
-                            ],
-                            )
 
-    subj = decort_group(amodule)
+def main():
+    subj = decort_group()
+    amodule = subj.amodule
     
     if amodule.params['state'] == 'check':
         subj.result['changed'] = False

library/decort_jwt.py

@@ -7,76 +7,32 @@ module: decort_jwt
 description: See L(Module Documentation,https://repository.basistech.ru/BASIS/decort-ansible/wiki/Home).
 '''
 
-import requests
-
 from ansible.module_utils.basic import AnsibleModule
-from ansible.module_utils.basic import env_fallback
+from ansible.module_utils.decort_utils import DecortController
-
 
-def decort_jwt_parameters():
-    """Build and return a dictionary of parameters expected by decort_jwt module in a form accepted
-    by AnsibleModule utility class"""
 
-    return dict(
+class DecortJWT(DecortController):
-        app_id=dict(type='str',
+    def __init__(self):
-                    required=True,
+        super().__init__(AnsibleModule(**self.amodule_init_args))
-                    fallback=(env_fallback, ['DECORT_APP_ID'])),
-        app_secret=dict(type='str',
-                        required=True,
-                        fallback=(env_fallback, ['DECORT_APP_SECRET']),
-                        no_log=True),
-        oauth2_url=dict(type='str',
-                        required=True,
-                        fallback=(env_fallback, ['DECORT_OAUTH2_URL'])),
-        validity=dict(type='int',
-                      required=False,
-                      default=3600),
-        verify_ssl=dict(type='bool', required=False, default=True),
-        workflow_callback=dict(type='str', required=False),
-        workflow_context=dict(type='str', required=False),
-    )
 
-def main():
+    @property
-    module_parameters = decort_jwt_parameters()
+    def amodule_init_args(self) -> dict:
+        amodule_init_args = self.common_amodule_init_args
+        amodule_argument_spec = amodule_init_args['argument_spec']
+        del amodule_argument_spec['controller_url']
+        del amodule_argument_spec['jwt']
+        amodule_argument_spec['authenticator']['choices'].remove('jwt')
 
-    amodule = AnsibleModule(argument_spec=module_parameters,
+        return amodule_init_args
-                            supports_check_mode=True,)
 
-    result = {'failed': False, 'changed': False}
+    def run(self):
+        self.result['jwt'] = self.jwt
+        self.amodule.exit_json(**self.result)
 
-    token_get_url = amodule.params['oauth2_url'] + "/v1/oauth/access_token"
-    req_data = dict(grant_type="client_credentials",
-                    client_id=amodule.params['app_id'],
-                    client_secret=amodule.params['app_secret'],
-                    response_type="id_token",
-                    validity=amodule.params['validity'],)
-    # TODO: Need standard code snippet to handle server timeouts gracefully
-    # Consider a few retries before giving up or use requests.Session & requests.HTTPAdapter
-    # see https://stackoverflow.com/questions/15431044/can-i-set-max-retries-for-requests-request
 
-    # catch requests.exceptions.ConnectionError to handle incorrect oauth2_url case
+def main():
-    try:
+    DecortJWT().run()
-        token_get_resp = requests.post(token_get_url, data=req_data, verify=amodule.params['verify_ssl'])
-    except requests.exceptions.ConnectionError as errco:
-        result.update(failed=True)
-        result['msg'] = "Failed to connect to {}: {}".format(token_get_url, errco)
-        amodule.fail_json(**result)
-    except requests.exceptions.Timeout as errti:
-        result.update(failed=True)
-        result['msg'] = "Timeout when trying to connect to {}: {}".format(token_get_url, errti)
-        amodule.fail_json(**result)
-
-    # alternative -- if resp == requests.codes.ok
-    if token_get_resp.status_code != 200:
-        result.update(failed=True)
-        result['msg'] = "Failed to obtain JWT access token from oauth2_url {} for app_id {}: {} {}".format(
-            token_get_url, amodule.params['app_id'],
-            token_get_resp.status_code, token_get_resp.reason)
-        amodule.fail_json(**result)
 
-    # Common return values: https://docs.ansible.com/ansible/2.3/common_return_values.html
-    result['jwt'] = token_get_resp.content.decode('utf8')
-    amodule.exit_json(**result)
 
 if __name__ == '__main__':
     main()

library/decort_k8s.py

@@ -14,8 +14,9 @@ from copy import deepcopy
 
 
 class decort_k8s(DecortController):
-    def __init__(self,arg_amodule):
+    def __init__(self):
-        super(decort_k8s, self).__init__(arg_amodule)
+        super(decort_k8s, self).__init__(AnsibleModule(**self.amodule_init_args))
+        arg_amodule = self.amodule
 
         validated_acc_id = 0
         validated_rg_id = 0
@@ -253,146 +254,196 @@ class decort_k8s(DecortController):
 
         return
 
-    @staticmethod
+    @property
-    def build_parameters():
+    def amodule_init_args(self) -> dict:
-        return dict(
+        return self.pack_amodule_init_args(
-            account_id=dict(type='int', required=False),
+            argument_spec=dict(
-            account_name=dict(type='str', required=False, default=''),
+                account_id=dict(
-            app_id=dict(type='str',
+                    type='int',
-                        required=False,
+                ),
-                        fallback=(env_fallback, ['DECORT_APP_ID'])),
+                account_name=dict(
-            app_secret=dict(type='str',
+                    type='str',
-                            required=False,
+                    default='',
-                            fallback=(env_fallback, ['DECORT_APP_SECRET']),
+                ),
-                            no_log=True),
+                quotas=dict(
-            authenticator=dict(type='str',
+                    type='dict',
-                            required=True,
+                ),
-                            choices=['legacy', 'oauth2', 'jwt']),
+                state=dict(
-            controller_url=dict(type='str', required=True),
+                    type='str',
-            # datacenter=dict(type='str', required=False, default=''),
-            jwt=dict(type='str',
-                    required=False,
-                    fallback=(env_fallback, ['DECORT_JWT']),
-                    no_log=True),
-            oauth2_url=dict(type='str',
-                            required=False,
-                            fallback=(env_fallback, ['DECORT_OAUTH2_URL'])),
-            password=dict(type='str',
-                        required=False,
-                        fallback=(env_fallback, ['DECORT_PASSWORD']),
-                        no_log=True),
-            quotas=dict(type='dict', required=False),
-            state=dict(type='str',
                     default='present',
-                    choices=['absent', 'disabled', 'enabled', 'present','check']),
+                    choices=[
-            permanent=dict(type='bool', default=False),
+                        'absent',
-            started=dict(type='bool', default=True),
+                        'disabled',
-            user=dict(type='str',
+                        'enabled',
-                    required=False,
+                        'present',
-                    fallback=(env_fallback, ['DECORT_USER'])),
+                        'check',
-            name=dict(type='str', required=False, default=""),
+                    ],
-            id=dict(type='int', required=False),
+                ),
-            getConfig=dict(type='bool',required=False, default=False),
+                permanent=dict(
-            rg_id=dict(type='int', default=0),
+                    type='bool',
-            rg_name=dict(type='str',default=""),
+                    default=False,
-            vins_id=dict(type='int', required=False,default=None),
+                ),
-            k8ci_id=dict(type='int'),
+                started=dict(
-            network_plugin=dict(type='str',required=False,default="flannel"),
+                    type='bool',
-            master_count=dict(type='int', default=1),
+                    default=True,
-            master_cpu=dict(type='int', default=2),
+                ),
-            master_ram=dict(type='int', default=2048),
+                name=dict(
-            master_disk=dict(type='int', default=10),
+                    type='str',
-            master_sepid=dict(type='int', required=False, default=None),
+                    default='',
-            master_pool=dict(type='str', required=False, default=None),
+                ),
-            workers=dict(
+                id=dict(
-                type='list',
+                    type='int',
-                elements='dict',
+                ),
-                options=dict(
+                getConfig=dict(
-                    name=dict(
+                    type='bool',
-                        type='str',
+                    default=False,
-                        required=True,
+                ),
-                    ),
+                rg_id=dict(
-                    num=dict(
+                    type='int',
-                        type='int',
+                    default=0,
-                    ),
+                ),
-                    cpu=dict(
+                rg_name=dict(
-                        type='int',
+                    type='str',
-                    ),
+                    default='',
-                    ram=dict(
+                ),
-                        type='int',
+                vins_id=dict(
-                    ),
+                    type='int',
-                    disk=dict(
+                ),
-                        type='int',
+                k8ci_id=dict(
-                    ),
+                    type='int',
-                    sep_id=dict(
+                ),
-                        type='int',
+                network_plugin=dict(
-                    ),
+                    type='str',
-                    pool=dict(
+                    default='flannel',
-                        type='str',
+                ),
-                    ),
+                master_count=dict(
-                    annotations=dict(
+                    type='int',
-                        type='list',
+                    default=1,
-                        elements='str',
+                ),
-                    ),
+                master_cpu=dict(
-                    ci_user_data=dict(
+                    type='int',
-                        type='dict',
+                    default=2,
-                    ),
+                ),
-                    labels=dict(
+                master_ram=dict(
-                        type='list',
+                    type='int',
-                        elements='str',
+                    default=2048,
-                    ),
+                ),
-                    taints=dict(
+                master_disk=dict(
-                        type='list',
+                    type='int',
-                        elements='str',
+                    default=10,
-                    ),
+                ),
-                    chipset=dict(
+                master_sepid=dict(
-                        type='str',
+                    type='int',
-                        choices=['Q35', 'i440fx'],
+                ),
+                master_pool=dict(
+                    type='str',
+                ),
+                workers=dict(
+                    type='list',
+                    elements='dict',
+                    options=dict(
+                        name=dict(
+                            type='str',
+                            required=True,
+                        ),
+                        num=dict(
+                            type='int',
+                        ),
+                        cpu=dict(
+                            type='int',
+                        ),
+                        ram=dict(
+                            type='int',
+                        ),
+                        disk=dict(
+                            type='int',
+                        ),
+                        sep_id=dict(
+                            type='int',
+                        ),
+                        pool=dict(
+                            type='str',
+                        ),
+                        annotations=dict(
+                            type='list',
+                            elements='str',
+                        ),
+                        ci_user_data=dict(
+                            type='dict',
+                        ),
+                        labels=dict(
+                            type='list',
+                            elements='str',
+                        ),
+                        taints=dict(
+                            type='list',
+                            elements='str',
+                        ),
+                        chipset=dict(
+                            type='str',
+                            choices=['Q35', 'i440fx'],
+                        ),
                     ),
                 ),
+                workers_metadata=dict(
+                    type='bool',
+                    default=False,
+                ),
+                extnet_id=dict(
+                    type='int',
+                    default=0,
+                ),
+                description=dict(
+                    type='str',
+                    default='Created by decort ansible module',
+                ),
+                with_lb=dict(
+                    type='bool',
+                    default=True,
+                ),
+                ha_lb=dict(
+                    type='bool',
+                    default=False,
+                ),
+                extnet_only=dict(
+                    type='bool',
+                    default=False,
+                ),
+                additionalSANs=dict(
+                    type='list',
+                ),
+                init_conf=dict(
+                    type='dict',
+                ),
+                cluster_conf=dict(
+                    type='dict',
+                ),
+                kublet_conf=dict(
+                    type='dict',
+                ),
+                kubeproxy_conf=dict(
+                    type='dict',
+                ),
+                join_conf=dict(
+                    type='dict',
+                ),
+                oidc_cert=dict(
+                    type='raw',
+                ),
+                master_chipset=dict(
+                    type='str',
+                    choices=['Q35', 'i440fx'],
+                ),
             ),
-            workers_metadata=dict(type='bool',required=False,default=False),
+            supports_check_mode=True,
-            extnet_id=dict(type='int',  default=0),
+            required_one_of=[
-            description=dict(type='str', default="Created by decort ansible module"),
+                ('id', 'name'),
-            with_lb=dict(type='bool', default=True),
+            ],
-            ha_lb=dict(type='bool', default=False),
-            extnet_only=dict(type='bool', default=False),
-            additionalSANs=dict(type='list',required=False, default=None),
-            init_conf=dict(type='dict', required=False, default=None),
-            cluster_conf=dict(type='dict', required=False, default=None),
-            kublet_conf=dict(type='dict', required=False, default=None),
-            kubeproxy_conf=dict(type='dict', required=False, default=None),
-            join_conf=dict(type='dict', required=False, default=None),
-            oidc_cert=dict(type='raw',required=False,default=None),
-            verify_ssl=dict(type='bool', required=False, default=True),
-            workflow_callback=dict(type='str', required=False),
-            workflow_context=dict(type='str', required=False),
-            master_chipset=dict(
-                type='str',
-                choices=['Q35', 'i440fx'],
-            ),
         )
 
 def main():
-    module_parameters = decort_k8s.build_parameters()
+    subj = decort_k8s()
-
+    amodule = subj.amodule
-    amodule = AnsibleModule(argument_spec=module_parameters,
-                            supports_check_mode=True,
-                            mutually_exclusive=[
-                                ['oauth2', 'password'],
-                                ['password', 'jwt'],
-                                ['jwt', 'oauth2'],
-                            ],
-                            required_together=[
-                                ['app_id', 'app_secret'],
-                                ['user', 'password'],
-                            ],
-                            required_one_of=[
-                                ['id', 'name'],
-                            ],
-                            )
-
-    subj = decort_k8s(amodule)
 
     if amodule.params['state'] == 'check':
         subj.result['changed'] = False

library/decort_kvmvm.py

@@ -13,9 +13,12 @@ from ansible.module_utils.decort_utils import *
 
 
 class decort_kvmvm(DecortController):
-    def __init__(self, arg_amodule):
+    def __init__(self):
         # call superclass constructor first
-        super(decort_kvmvm, self).__init__(arg_amodule)
+        super(decort_kvmvm, self).__init__(AnsibleModule(**self.amodule_init_args))
+        arg_amodule = self.amodule
+
+        self.aparam_networks_has_dpdk = None
 
         self.check_amodule_args()
 
@@ -27,6 +30,8 @@ class decort_kvmvm(DecortController):
         self.comp_info = None
         self.acc_id = 0
         self.rg_id = 0
+        self.aparam_image = None
+
 
         validated_acc_id =0
         validated_rg_id = 0
@@ -82,38 +87,9 @@ class decort_kvmvm(DecortController):
         if self.comp_id:
             self.comp_should_exist = True
             self.acc_id = self.comp_info['accountId']
-
-            check_error = False
-            params_to_check = {
-                'chipset': 'chipset',
-                'cpu_pin': 'cpupin',
-                'hp_backed': 'hpBacked',
-                'numa_affinity': 'numaAffinity',
-            }
-            for param_name, comp_field_name in params_to_check.items():
-                if (
-                    self.aparams[param_name] is not None
-                    and self.comp_info[comp_field_name] != self.aparams[param_name]
-                    and self.aparams['state'] not in ('halted', 'poweredoff')
-                ):
-                    self.message(
-                        f'Cannot change "{param_name}" for compute '
-                        f'{self.comp_id} if parameter "state" is not '
-                        f'halted or poweredoff.'
-                    )
-                    check_error = True
-
-            if check_error:
-                self.exit(fail=True)
-
         else:
-            if self.aparams['chipset'] is None:
+            if self.amodule.params['state'] != 'absent':
-                self.message(
+                self.check_amodule_args_for_create()
-                    'Check for parameter "chipset" failed: '
-                    'chipset must be specified for a new compute.'
-                )
-                self.exit(fail=True)
-
         return
 
     def check_amodule_args(self):
@@ -122,18 +98,49 @@ class decort_kvmvm(DecortController):
         cannot be implemented using Ansible Argument spec.
         """
 
-        # Check parameter "networks" for DPDK type
+        check_error = False
+
+        # Check parameter "networks"
         aparam_nets = self.aparams['networks']
         if aparam_nets:
             net_types = {net['type'] for net in aparam_nets}
-            DPDK = 'DPDK'
+            # DPDK and other networks
-            if DPDK in net_types and not net_types.issubset({'DPDK', 'EMPTY'}):
+            self.aparam_networks_has_dpdk = False
-                self.message(
+            if self.VMNetType.DPDK.value in net_types:
-                    'Check for parameter "networks" failed: a compute cannot'
+                self.aparam_networks_has_dpdk = True
-                    ' be connected to a DPDK network and a network of another'
+                if not net_types.issubset(
-                    ' type at the same time.'
+                    {self.VMNetType.DPDK.value, self.VMNetType.EMPTY.value}
-                )
+                ):
-                self.exit(fail=True)
+                    check_error = True
+                    self.message(
+                        'Check for parameter "networks" failed:'
+                        ' a compute cannot be connected to a DPDK network and'
+                        ' a network of another type at the same time.'
+                    )
+
+                if (
+                    self.aparams['hp_backed'] is not None
+                    and not self.aparams['hp_backed']
+                ):
+                    check_error = True
+                    self.message(
+                        'Check for parameter "networks" failed: '
+                        'hp_backed must be set to True to connect a compute '
+                        'to a DPDK network.'
+                    )
+            # MTU for non-DPDK networks
+            for net in aparam_nets:
+                if (
+                    net['type'] != self.VMNetType.DPDK.value
+                    and net['mtu'] is not None
+                ):
+                    check_error = True
+                    self.message(
+                        'Check for parameter "networks" failed:'
+                        ' MTU can be specifed only for DPDK network'
+                        ' (remove parameter "mtu" for network'
+                        f' {net["type"]} with ID {net["id"]}).'
+                    )
 
         aparam_custom_fields = self.aparams['custom_fields']
         if aparam_custom_fields is not None:
@@ -141,11 +148,25 @@ class decort_kvmvm(DecortController):
                 aparam_custom_fields['disable']
                 and aparam_custom_fields['fields'] is not None
             ):
+                check_error = True
                 self.message(
                     'Check for parameter "custom_fields" failed: '
                     '"fields" cannot be set if "disable" is True.'
                 )
-                self.exit(fail=True)
+
+        aparam_pref_cpu_cores = self.aparams['preferred_cpu_cores']
+        if (
+            aparam_pref_cpu_cores
+            and len(set(aparam_pref_cpu_cores)) != len(aparam_pref_cpu_cores)
+        ):
+            check_error = True
+            self.message(
+                'Check for parameter "preferred_cpu_cores" failed: '
+                'the list must contain only unique elements.'
+            )
+
+        if check_error:
+            self.exit(fail=True)
 
     def nop(self):
         """No operation (NOP) handler for Compute management by decort_kvmvm module.
@@ -197,17 +218,7 @@ class decort_kvmvm(DecortController):
         validated_bdisk_size = self.amodule.params['boot_disk'] or 0
 
         image_id, image_facts = None, None
-        if (
+        if self.aparam_image:
-            self.amodule.params['image_id'] is None
-            and self.amodule.params['image_name'] is None
-        ):
-            if self.amodule.params['state'] not in ('poweredoff', 'halted'):
-                self.result['msg'] = (
-                    '"state" parameter for a blank Compute must be either '
-                    '"poweredoff" or "halted".'
-                )
-                self.exit(fail=True)
-        else:
             # either image_name or image_id must be present
             if (
                 self.check_amodule_argument('image_id', abort=False)
@@ -242,7 +253,7 @@ class decort_kvmvm(DecortController):
         #
         # Once this "feature" is fixed, make sure VM is created according to the actual desired state
         #
-        start_compute = False # change this once a workaround for the aforementioned libvirt "feature" is implemented 
+        start_compute = False # change this once a workaround for the aforementioned libvirt "feature" is implemented
         if self.amodule.params['state'] in ('halted', 'poweredoff'):
             start_compute = False
         
@@ -269,6 +280,15 @@ class decort_kvmvm(DecortController):
         if numa_affinity is None:
             numa_affinity = 'none'
 
+
+        chipset = self.amodule.params['chipset']
+        if chipset is None:
+            chipset = 'i440fx'
+            self.message(
+                msg=f'Chipset not specified, '
+                    f'default value "{chipset}" will be used.',
+                warning=True,
+            )
         # if we get through here, all parameters required to create new Compute instance should be at hand
 
         # NOTE: KVM VM is created in HALTED state and must be explicitly started
@@ -282,10 +302,11 @@ class decort_kvmvm(DecortController):
                                     sep_id=self.amodule.params['sep_id' ] if "sep_id" in self.amodule.params else None,
                                     pool_name=self.amodule.params['pool'] if "pool" in self.amodule.params else None,
                                     start_on_create=start_compute,
-                                    chipset=self.amodule.params['chipset'],
+                                    chipset=chipset,
                                     cpu_pin=cpu_pin,
                                     hp_backed=hp_backed,
-                                    numa_affinity=numa_affinity)
+                                    numa_affinity=numa_affinity,
+                                    preferred_cpu_cores=self.amodule.params['preferred_cpu_cores'],)
         self.comp_should_exist = True
         
         # Originally we would have had to re-read comp_info after VM was provisioned
@@ -331,8 +352,9 @@ class decort_kvmvm(DecortController):
                               self.amodule.params['aaff_rule'],
                               label=self.amodule.params['affinity_label'],)
         # NOTE: see NOTE above regarding libvirt "feature" and new VMs created in HALTED state
-        if self.amodule.params['state'] not in ('halted', 'poweredoff'):
+        if self.aparam_image:
-            self.compute_powerstate(self.comp_info, 'started')
+            if self.amodule.params['state'] not in ('halted', 'poweredoff'):
+                self.compute_powerstate(self.comp_info, 'started')
 
         if self.aparams['custom_fields'] is None:
             custom_fields_disable = True
@@ -352,7 +374,13 @@ class decort_kvmvm(DecortController):
             need_custom_fields=True,
         )
 
-        self.skip_final_get = True
+        if self.compute_update_args:
+            self.compute_update(
+                compute_id=self.comp_info['id'],
+                **self.compute_update_args,
+            )
+        else:
+            self.skip_final_get = True
 
         return
 
@@ -388,6 +416,18 @@ class decort_kvmvm(DecortController):
 
         Note that it does not modify power state of KVM VM.
         """
+        if self.compute_update_args:
+            self.compute_update(
+                compute_id=self.comp_info['id'],
+                **self.compute_update_args,
+            )
+
+        if self.amodule.params['rollback_to'] is not None:
+            self.compute_rollback(
+                compute_id=self.comp_info['id'],
+                snapshot_label=self.amodule.params['rollback_to'],
+            )
+
         if self.amodule.params['networks'] is not None:
             self.compute_networks(
                 comp_dict=self.comp_info,
@@ -412,12 +452,6 @@ class decort_kvmvm(DecortController):
                               self.amodule.params['aaff_rule'],
                               label=self.amodule.params['affinity_label'])
 
-        if self.compute_update_args:
-            self.compute_update(
-                compute_id=self.comp_info['id'],
-                **self.compute_update_args,
-            )
-
         aparam_custom_fields = self.amodule.params['custom_fields']
         if aparam_custom_fields is not None:
             compute_custom_fields = self.comp_info['custom_fields']
@@ -446,18 +480,19 @@ class decort_kvmvm(DecortController):
             'hp_backed': 'hpBacked',
             'numa_affinity': 'numaAffinity',
             'description': 'desc',
+            'auto_start': 'autoStart',
+            'preferred_cpu_cores': 'preferredCpu',
         }
-        for param_name, comp_field_name in params_to_check.items():
+        for aparam_name, comp_field_name in params_to_check.items():
-            aparam_value = self.amodule.params[param_name]
+            aparam_value = self.amodule.params[aparam_name]
             if (
                 aparam_value is not None
                 and aparam_value != self.comp_info[comp_field_name]
             ):
-                result_args[param_name] = aparam_value
+                result_args[aparam_name] = aparam_value
 
         return result_args
 
-
     def package_facts(self, check_mode=False):
         """Package a dictionary of KVM VM facts according to the decort_kvmvm module specification. 
         This dictionary will be returned to the upstream Ansible engine at the completion of decort_kvmvm 
@@ -492,6 +527,9 @@ class decort_kvmvm(DecortController):
                     hp_backed="",
                     numa_affinity="",
                     custom_fields={},
+                    vnc_password="",
+                    snapshots=[],
+                    preferred_cpu_cores=[],
                     )
 
         if check_mode or self.comp_info is None:
@@ -554,14 +592,40 @@ class decort_kvmvm(DecortController):
 
         ret_dict['custom_fields'] = self.comp_info['custom_fields']
 
+        ret_dict['vnc_password'] = self.comp_info['vncPasswd']
+
+        ret_dict['auto_start'] = self.comp_info['autoStart']
+
+        ret_dict['snapshots'] = self.comp_info['snapSets']
+
+        ret_dict['preferred_cpu_cores'] = self.comp_info['preferredCpu']
+
         return ret_dict
 
     def check_amodule_args_for_create(self):
         # Check for unacceptable parameters for a blank Compute
         if (
-            self.aparams['image_id'] is None
+            self.aparams['image_id'] is not None
-            and self.aparams['image_name'] is None
+            or self.aparams['image_name'] is not None
         ):
+            self.aparam_image = True
+        else:
+            self.aparam_image = False
+            if (
+                self.aparams['state'] is not None
+                and self.aparams['state'] not in (
+                    'present',
+                    'poweredoff',
+                    'halted',
+                )
+            ):
+                self.message(
+                    'Check for parameter "state" failed: '
+                    'state for a blank Compute must be either '
+                    '"present", "poweredoff" or "halted".'
+                )
+                self.exit(fail=True)
+
             for parameter in (
                 'ssh_key',
                 'ssh_key_user',
@@ -586,133 +650,202 @@ class decort_kvmvm(DecortController):
                 )
                 self.exit(fail=True)
 
-    @staticmethod
+        if self.aparams['rollback_to'] is not None:
-    def build_parameters():
+            self.message(
-        """Build and return a dictionary of parameters expected by decort_kvmvm module in a form
+                'Check for parameter "rollback_to" failed: '
-        accepted by AnsibleModule utility class.
+                'rollback_to can be specified only for existing compute.'
-        This dictionary is then used y AnsibleModule class instance to parse and validate parameters
+            )
-        passed to the module from the playbook.
+            self.exit(fail=True)
-        """
 
-        return dict(
+        if self.aparam_networks_has_dpdk and not self.aparams['hp_backed']:
-            account_id=dict(type='int', required=False, default=0),
+            self.message(
-            account_name=dict(type='str', required=False, default=''),
+                'Check for parameter "networks" failed:'
-            description=dict(type='str', required=False),
+                ' hp_backed must be set to True to connect a compute'
-            app_id=dict(type='str',
+                ' to a DPDK network.'
-                        required=False,
+            )
-                        fallback=(env_fallback, ['DECORT_APP_ID'])),
+            self.exit(fail=True)
-            app_secret=dict(type='str',
+
-                            required=False,
+    @property
-                            fallback=(env_fallback, ['DECORT_APP_SECRET']),
+    def amodule_init_args(self) -> dict:
-                            no_log=True),
+        return self.pack_amodule_init_args(
-            authenticator=dict(type='str',
+            argument_spec=dict(
-                               required=True,
+                account_id=dict(
-                               choices=['legacy', 'oauth2', 'jwt']),
+                    type='int',
-            boot_disk=dict(type='int', required=False),
+                    default=0,
-            sep_id=dict(type='int', required=False),
-            pool=dict(type='str', required=False),
-            controller_url=dict(type='str', required=True),
-            # count=dict(type='int', required=False, default=1),
-            cpu=dict(type='int', required=False),
-            # datacenter=dict(type='str', required=False, default=''),
-            data_disks=dict(type='list', required=False), # list of integer disk IDs
-            id=dict(type='int', required=False, default=0),
-            image_id=dict(type='int', required=False),
-            image_name=dict(type='str', required=False),
-            jwt=dict(type='str',
-                     required=False,
-                     fallback=(env_fallback, ['DECORT_JWT']),
-                     no_log=True),
-            name=dict(type='str'),
-            networks=dict(
-                type='list',
-                elements='dict',
-                options=dict(
-                    type=dict(
-                        type='str',
-                        required=True,
-                        choices=[
-                            'VINS',
-                            'EXTNET',
-                            'VFNIC',
-                            'DPDK',
-                            'EMPTY',
-                        ],
-                    ),
-                    id=dict(
-                        type='int',
-                    ),
-                    ip_addr=dict(
-                        type='str',
-                    ),
                 ),
-                required_if=[
+                account_name=dict(
-                  ('type', 'VINS', ('id',)),
+                    type='str',
-                  ('type', 'EXTNET', ('id',)),
+                    default='',
-                  ('type', 'VFNIC', ('id',)),
+                ),
-                  ('type', 'DPDK', ('id',)),
+                description=dict(
-                ],
+                    type='str',
-            ),
+                ),
-            network_order_changing=dict(
+                boot_disk=dict(
-                type='bool',
+                    type='int',
-                default=False,
+                ),
-            ),
+                sep_id=dict(
-            oauth2_url=dict(type='str',
+                    type='int',
-                            required=False,
+                ),
-                            fallback=(env_fallback, ['DECORT_OAUTH2_URL'])),
+                pool=dict(
-            password=dict(type='str',
+                    type='str',
-                          required=False,
+                ),
-                          fallback=(env_fallback, ['DECORT_PASSWORD']),
+                controller_url=dict(
-                          no_log=True),
+                    type='str',
-            ram=dict(type='int', required=False),
+                    required=True,
-            rg_id=dict(type='int', default=0),
+                ),
-            rg_name=dict(type='str', default=""),
+                cpu=dict(
-            ssh_key=dict(type='str', required=False),
+                    type='int',
-            ssh_key_user=dict(type='str', required=False),
+                ),
-            tag=dict(type='dict', required=False),
+                data_disks=dict( # list of integer disk IDs
-            affinity_label=dict(type='str', required=False),
+                    type='list',
-            aff_rule=dict(type='list', required=False),
+                ),
-            aaff_rule=dict(type='list', required=False),
+                id=dict(
-            ci_user_data=dict(type='dict', required=False),
+                    type='int',
-            state=dict(type='str',
+                    default=0,
-                       default='present',
+                ),
-                       choices=['absent', 'paused', 'poweredoff', 'halted', 'poweredon', 'present', 'check']),
+                image_id=dict(
-            tags=dict(type='str', required=False),
+                    type='int',
-            user=dict(type='str',
+                ),
-                      required=False,
+                image_name=dict(
-                      fallback=(env_fallback, ['DECORT_USER'])),
+                    type='str',
-            verify_ssl=dict(type='bool', required=False, default=True),
+                ),
-            # wait_for_ip_address=dict(type='bool', required=False, default=False),
+                name=dict(
-            workflow_callback=dict(type='str', required=False),
+                    type='str',
-            workflow_context=dict(type='str', required=False),
+                ),
-            chipset=dict(
+                networks=dict(
-                type='str',
+                    type='list',
-                choices=['Q35', 'i440fx']
+                    elements='dict',
-            ),
+                    options=dict(
-            cpu_pin=dict(
+                        type=dict(
-                type='bool',
+                            type='str',
-            ),
+                            required=True,
-            hp_backed=dict(
+                            choices=[
-                type='bool',
+                                'VINS',
-            ),
+                                'EXTNET',
-            numa_affinity=dict(
+                                'VFNIC',
-                type='str',
+                                'DPDK',
-                choices=['strict', 'loose', 'none'],
+                                'EMPTY',
-            ),
+                            ],
-            custom_fields=dict(
+                        ),
-                type='dict',
+                        id=dict(
-                options=dict(
+                            type='int',
-                    fields=dict(
+                        ),
-                        type='dict',
+                        ip_addr=dict(
+                            type='str',
+                        ),
+                        mtu=dict(
+                            type='int',
+                        ),
                     ),
-                    disable=dict(
+                    required_if=[
-                        type='bool',
+                      ('type', 'VINS', ('id',)),
+                      ('type', 'EXTNET', ('id',)),
+                      ('type', 'VFNIC', ('id',)),
+                      ('type', 'DPDK', ('id',)),
+                    ],
+                ),
+                network_order_changing=dict(
+                    type='bool',
+                    default=False,
+                ),
+                ram=dict(
+                    type='int',
+                ),
+                rg_id=dict(
+                    type='int',
+                    default=0,
+                ),
+                rg_name=dict(
+                    type='str',
+                    default='',
+                ),
+                ssh_key=dict(
+                    type='str',
+                ),
+                ssh_key_user=dict(
+                    type='str',
+                ),
+                tag=dict(
+                    type='dict',
+                ),
+                affinity_label=dict(
+                    type='str',
+                ),
+                aff_rule=dict(
+                    type='list',
+                ),
+                aaff_rule=dict(
+                    type='list',
+                ),
+                ci_user_data=dict(
+                    type='dict',
+                ),
+                state=dict(
+                    type='str',
+                    choices=[
+                        'absent',
+                        'paused',
+                        'poweredoff',
+                        'halted',
+                        'poweredon',
+                        'present',
+                    ],
+                ),
+                tags=dict(
+                    type='str',
+                ),
+                chipset=dict(
+                    type='str',
+                    choices=[
+                        'Q35',
+                        'i440fx',
+                    ]
+                ),
+                cpu_pin=dict(
+                    type='bool',
+                ),
+                hp_backed=dict(
+                    type='bool',
+                ),
+                numa_affinity=dict(
+                    type='str',
+                    choices=[
+                        'strict',
+                        'loose',
+                        'none',
+                    ],
+                ),
+                custom_fields=dict(
+                    type='dict',
+                    options=dict(
+                        fields=dict(
+                            type='dict',
+                        ),
+                        disable=dict(
+                            type='bool',
+                        ),
                     ),
                 ),
+                auto_start=dict(
+                    type='bool',
+                ),
+                rollback_to=dict(
+                    type='str',
+                ),
+                preferred_cpu_cores=dict(
+                    type='list',
+                    elements='int',
+                ),
             ),
+            supports_check_mode=True,
+            required_one_of=[
+                ('id', 'name'),
+            ],
         )
     
     def check_amodule_args_for_change(self):
+        check_errors = False
+
         new_boot_disk_size = self.amodule.params['boot_disk']
         if new_boot_disk_size is not None:
             for disk in self.comp_info['disks']:
@@ -720,19 +853,109 @@ class decort_kvmvm(DecortController):
                     boot_disk_size = disk['sizeMax']
                     break
             else:
+                check_errors = True
                 self.message(
                     f'Can\'t set boot disk size for Compute '
                     f'{self.comp_info["id"]}, because it doesn\'t have a '
                     f'boot disk.'
                 )
-                self.exit(fail=True)
+
             if new_boot_disk_size < boot_disk_size:
+                check_errors = True
                 self.message(
                     f'New boot disk size {new_boot_disk_size} is less than '
                     f'current {boot_disk_size} for Compute ID '
                     f'{self.comp_info["id"]}'
                 )
-                self.exit(fail=True)
+
+        if (
+            not self.comp_info['imageId']
+            and self.amodule.params['state'] in ('poweredon', 'paused')
+        ):
+            check_errors = True
+            self.message(
+                'Check for parameter "state" failed: '
+                'state for a blank Compute can not be "poweredon" or "paused".'
+            )
+
+        is_vm_stopped_or_will_be_stopped  = (
+            (
+                self.comp_info['techStatus'] == 'STOPPED'
+                and (
+                    self.amodule.params['state'] is None
+                    or self.amodule.params['state'] in (
+                        'halted', 'poweredoff', 'present',
+                    )
+                )
+            )
+            or (
+                self.comp_info['techStatus'] != 'STOPPED'
+                and self.amodule.params['state'] in (
+                    'halted', 'poweredoff',
+                )
+            )
+        )
+
+        if self.amodule.params['rollback_to'] is not None:
+            if not is_vm_stopped_or_will_be_stopped:
+                check_errors = True
+                self.message(
+                    'Check for parameter "rollback_to" failed: '
+                    'VM must be stopped to rollback.'
+                )
+
+            vm_snapshot_labels = [
+                snapshot['label'] for snapshot in self.comp_info['snapSets']
+            ]
+            if self.amodule.params['rollback_to'] not in vm_snapshot_labels:
+                check_errors = True
+                self.message(
+                    f'Check for parameter "rollback_to" failed: '
+                    f'snapshot with label '
+                    f'{self.amodule.params["rollback_to"]} does not exist '
+                    f'for VM ID{self.comp_info["id"]}.'
+                )
+
+        params_to_check = {
+            'chipset': 'chipset',
+            'cpu_pin': 'cpupin',
+            'hp_backed': 'hpBacked',
+            'numa_affinity': 'numaAffinity',
+        }
+        for param_name, comp_field_name in params_to_check.items():
+            if (
+                self.aparams[param_name] is not None
+                and self.comp_info[comp_field_name] != self.aparams[param_name]
+                and not is_vm_stopped_or_will_be_stopped
+            ):
+                check_errors = True
+                self.message(
+                    f'Check for parameter "{param_name}" failed: '
+                    f'VM must be stopped to change {param_name}.'
+                )
+
+        if self.aparams['preferred_cpu_cores'] is not None:
+            if not is_vm_stopped_or_will_be_stopped:
+                check_errors = True
+                self.message(
+                    'Check for parameter "preferred_cpu_cores" failed: '
+                    'VM must be stopped to change preferred_cpu_cores.'
+                )
+
+        if (
+            self.aparam_networks_has_dpdk
+            and not self.comp_info['hpBacked']
+            and not self.aparams['hp_backed']
+        ):
+            check_errors = True
+            self.message(
+                'Check for parameter "networks" failed: '
+                'hp_backed must be set to True to connect a compute '
+                'to a DPDK network.'
+            )
+
+        if check_errors:
+            self.exit(fail=True)
 
 # Workflow digest:
 # 1) authenticate to DECORT controller & validate authentication by issuing API call - done when creating DECSController
@@ -747,49 +970,10 @@ class decort_kvmvm(DecortController):
 # 6) report result to Ansible
 
 def main():
-    module_parameters = decort_kvmvm.build_parameters()
-
-    amodule = AnsibleModule(argument_spec=module_parameters,
-                            supports_check_mode=True,
-                            mutually_exclusive=[
-                                ['oauth2', 'password'],
-                                ['password', 'jwt'],
-                                ['jwt', 'oauth2'],
-                            ],
-                            required_together=[
-                                ['app_id', 'app_secret'],
-                                ['user', 'password'],
-                            ],
-                            required_one_of=[
-                                ['id', 'name'],
-                            ],
-                            )
-
     # Initialize DECORT KVM VM instance object
     # This object does not necessarily represent an existing KVM VM
-    subj = decort_kvmvm(amodule)
+    subj = decort_kvmvm()
-
+    amodule = subj.amodule
-    # handle state=check before any other logic
-    if amodule.params['state'] == 'check':
-        subj.result['changed'] = False
-        if subj.comp_id:
-            # Compute is found - package facts and report success to Ansible
-            subj.result['failed'] = False
-            # _, subj.comp_info, _ = subj.compute_find(comp_id=subj.comp_id)
-            # _, rg_facts = subj.rg_find(arg_account_id=0, arg_rg_id=subj.rg_id)
-            subj.result['facts'] = subj.package_facts(amodule.check_mode)
-            amodule.exit_json(**subj.result)
-            # we exit the module at this point
-        else:
-            subj.result['failed'] = True
-            subj.result['msg'] = ("Cannot locate Compute name '{}'. Other arguments are: Compute ID {}, "
-                                  "RG name '{}', RG ID {}, Account '{}'.").format(amodule.params['name'],
-                                                                                amodule.params['id'],
-                                                                                amodule.params['rg_name'],
-                                                                                amodule.params['rg_id'],
-                                                                                amodule.params['account_name'])
-            amodule.fail_json(**subj.result)
-            pass
 
     if subj.comp_id:
         subj.check_amodule_args_for_change()
@@ -800,8 +984,14 @@ def main():
         elif subj.comp_info['status'] in ("ENABLED", "DISABLED"):
             if amodule.params['state'] == 'absent':
                 subj.destroy()
-            elif amodule.params['state'] in ('present', 'paused', 'poweredon', 'poweredoff', 'halted'):
+            else:
-                subj.compute_powerstate(subj.comp_info, amodule.params['state'])
+                if amodule.params['state'] in (
+                    'paused', 'poweredon', 'poweredoff', 'halted'
+                ):
+                    subj.compute_powerstate(
+                        comp_facts=subj.comp_info,
+                        target_state=amodule.params['state'],
+                    )
                 subj.modify(arg_wait_cycles=7)
         elif subj.comp_info['status'] == "DELETED":
             if amodule.params['state'] in ('present', 'poweredon'):
@@ -828,15 +1018,16 @@ def main():
             elif amodule.params['state'] == 'paused':
                 subj.error()
     else:
-        subj.check_amodule_args_for_create()
+        state = amodule.params['state']
-
+        if state is None:
+            state = 'present'
         # Preexisting Compute of specified identity was not found.
         # If requested state is 'absent' - nothing to do
-        if amodule.params['state'] == 'absent':
+        if state == 'absent':
             subj.nop()
-        elif amodule.params['state'] in ('present', 'poweredon', 'poweredoff', 'halted'):
+        elif state in ('present', 'poweredon', 'poweredoff', 'halted'):
             subj.create() # this call will also handle data disk & network connection
-        elif amodule.params['state'] == 'paused':
+        elif state == 'paused':
             subj.error()
 
     if subj.result['failed']:

library/decort_lb.py

@@ -13,8 +13,9 @@ from ansible.module_utils.decort_utils import *
 
 
 class decort_lb(DecortController):
-    def __init__(self,arg_amodule) -> None:
+    def __init__(self) -> None:
-        super(decort_lb,self).__init__(arg_amodule)    
+        super(decort_lb,self).__init__(AnsibleModule(**self.amodule_init_args))
+        arg_amodule = self.amodule
 
         self.lb_id = 0
         self.lb_facts = None
@@ -216,83 +217,93 @@ class decort_lb(DecortController):
             ret_dict['backends'] = self.lb_facts['backends']
             ret_dict['frontends'] = self.lb_facts['frontends']
         return ret_dict
-    @staticmethod
-    def build_parameters():
-        """Build and return a dictionary of parameters expected by decort_vins module in a form accepted
-        by AnsibleModule utility class."""
 
-        return dict(
+    @property
-            account_id=dict(type='int', required=False),
+    def amodule_init_args(self) -> dict:
-            account_name=dict(type='str', required=False, default=''),
+        return self.pack_amodule_init_args(
-            description=dict(type='str', required=False, default='Managed by Ansible module decort_lb'),
+            argument_spec=dict(
-            app_id=dict(type='str',
+                account_id=dict(
-                        required=False,
+                    type='int',
-                        fallback=(env_fallback, ['DECORT_APP_ID'])),
+                ),
-            app_secret=dict(type='str',
+                account_name=dict(
-                            required=False,
+                    type='str',
-                            fallback=(env_fallback, ['DECORT_APP_SECRET']),
+                    default='',
-                            no_log=True),
+                ),
-            authenticator=dict(type='str',
+                description=dict(
-                            required=True,
+                    type='str',
-                            choices=['legacy', 'oauth2', 'jwt']),
+                    default='Managed by Ansible module decort_lb',
-            controller_url=dict(type='str', required=True),
+                ),
-            # datacenter=dict(type='str', required=False, default=''),
+                ext_net_id=dict(
-            ext_net_id=dict(type='int', required=False, default=-1),
+                    type='int',
-            ext_ip_addr=dict(type='str', required=False, default=''),
+                    default=-1,
-            jwt=dict(type='str',
+                ),
-                    required=False,
+                ext_ip_addr=dict(
-                    fallback=(env_fallback, ['DECORT_JWT']),
+                    type='str',
-                    no_log=True),
+                    default='',
-            oauth2_url=dict(type='str',
+                ),
-                            required=False,
+                state=dict(
-                            fallback=(env_fallback, ['DECORT_OAUTH2_URL'])),
+                    type='str',
-            password=dict(type='str',
-                        required=False,
-                        fallback=(env_fallback, ['DECORT_PASSWORD']),
-                        no_log=True),
-            state=dict(type='str',
                     default='present',
-                    choices=['absent', 'disabled', 'enabled', 'present','restart']),
+                    choices=[
-            user=dict(type='str',
+                        'absent',
-                    required=False,
+                        'disabled',
-                    fallback=(env_fallback, ['DECORT_USER'])),
+                        'enabled',
-            rg_id=dict(type='int', required=False, default=0),
+                        'present',
-            rg_name=dict(type='str', required=False, default=''),
+                        'restart',
-            vins_name=dict(type='str', required=False, default=''),
+                    ],
-            vins_id=dict(type='int', required=False, default=0),
+                ),
-            verify_ssl=dict(type='bool', required=False, default=True),
+                rg_id=dict(
-            lb_id=dict(type='int', required=False, default=0),
+                    type='int',
-            lb_name=dict(type='str'),
+                    default=0,
-            ha_lb=dict(type='bool', required=False, default=False),
+                ),
-            backends=dict(type='list',required=False),
+                rg_name=dict(
-            frontends=dict(type='list',required=False),
+                    type='str',
-            servers=dict(type='list',required=False),
+                    default='',
-            permanently=dict(type='bool', required=False, default=False),
+                ),
-            workflow_callback=dict(type='str', required=False),
+                vins_name=dict(
-            workflow_context=dict(type='str', required=False),
+                    type='str',
+                    default='',
+                ),
+                vins_id=dict(
+                    type='int',
+                    default=0,
+                ),
+                lb_id=dict(
+                    type='int',
+                    default=0,
+                ),
+                lb_name=dict(
+                    type='str',
+                ),
+                ha_lb=dict(
+                    type='bool',
+                    default=False,
+                ),
+                backends=dict(
+                    type='list',
+                ),
+                frontends=dict(
+                    type='list',
+                ),
+                servers=dict(
+                    type='list',
+                ),
+                permanently=dict(
+                    type='bool',
+                    default=False,
+                ),
+            ),
+            supports_check_mode=True,
+            required_one_of=[
+                ('rg_id', 'rg_name'),
+                ('lb_id', 'lb_name'),
+                ('vins_id', 'vins_name'),
+            ],
         )
 
 def main():
-    module_parameters = decort_lb.build_parameters()
+    decon = decort_lb()
-
+    amodule = decon.amodule
-    amodule = AnsibleModule(argument_spec=module_parameters,
-                            supports_check_mode=True,
-                            mutually_exclusive=[
-                                ['oauth2', 'password'],
-                                ['password', 'jwt'],
-                                ['jwt', 'oauth2'],
-                            ],
-                            required_together=[
-                                ['app_id', 'app_secret'],
-                                ['user', 'password']
-                            ],
-                            required_one_of=[
-                                ['rg_id','rg_name'],
-                                ['lb_id','lb_name'],
-                                ['vins_id','vins_name']
-                            ]
-                            )
-    decon = decort_lb(amodule)
     if decon.lb_id:
         if decon.lb_facts['status'] in ["MODELED", "DISABLING", "ENABLING", "DELETING","DESTROYING","RESTORING"]:
             decon.result['failed'] = True

library/decort_osimage.py

@@ -14,8 +14,9 @@ from ansible.module_utils.decort_utils import *
 
 
 class decort_osimage(DecortController):
-    def __init__(self,amodule):
+    def __init__(self):
-        super(decort_osimage, self).__init__(amodule)
+        super(decort_osimage, self).__init__(AnsibleModule(**self.amodule_init_args))
+        amodule = self.amodule
 
         self.validated_image_id = 0
         self.validated_virt_image_id = 0
@@ -26,7 +27,7 @@ class decort_osimage(DecortController):
             self.validated_account_id, _ = self.account_find(amodule.params['account_name'])
         else:
             self.validated_account_id = amodule.params['account_Id']
-        
+
         if self.validated_account_id == 0:
             # we failed either to find or access the specified account - fail the module
             self.result['failed'] = True
@@ -72,9 +73,9 @@ class decort_osimage(DecortController):
 
     def decort_image_create(self,amodule):
         # function that creates OS image
-        image_facts = self.image_create(img_name=self.validated_image_name, 
+        image_facts = self.image_create(img_name=self.validated_image_name,
-                        url=amodule.params['url'], 
+                        url=amodule.params['url'],
-                        gid=amodule.params['gid'], 
+                        gid=amodule.params['gid'],
                         boottype=amodule.params['boottype'],
                         imagetype=amodule.params['imagetype'],
                         hotresize=amodule.params['hotresize'],
@@ -97,7 +98,7 @@ class decort_osimage(DecortController):
         self.result['msg'] = ("Image '{}' linked to virtual image '{}'").format(self.target_image_id,
                                                                                 decort_osimage.decort_osimage_package_facts(image_facts)['id'],)
         return image_id, image_facts
-    
+
     def decort_image_delete(self,amodule):
         # function that removes an image
         self.image_delete(imageId=amodule.image_id_delete)
@@ -110,7 +111,7 @@ class decort_osimage(DecortController):
         image_id, image_facts = decort_osimage.decort_virt_image_find(self, amodule)
         self.result['facts'] = decort_osimage.decort_osimage_package_facts(image_facts, amodule.check_mode)
         return image_id, image_facts
-    
+
     def decort_image_rename(self,amodule):
         # image renaming function
         image_facts = self.image_rename(imageId=self.validated_image_id, name=amodule.params['image_name'])
@@ -149,7 +150,7 @@ class decort_osimage(DecortController):
             # if void facts provided - change state value to ABSENT and return
             ret_dict['state'] = "ABSENT"
             return ret_dict
-    
+
         ret_dict['id'] = arg_osimage_facts['id']
         ret_dict['name'] = arg_osimage_facts['name']
         ret_dict['size'] = arg_osimage_facts['size']
@@ -162,84 +163,95 @@ class decort_osimage(DecortController):
         ret_dict['accountId'] = arg_osimage_facts['accountId']
         return ret_dict
 
-
+    @property
-    def decort_osimage_parameters():
+    def amodule_init_args(self) -> dict:
-        """Build and return a dictionary of parameters expected by decort_osimage module in a form accepted
+        return self.pack_amodule_init_args(
-        by AnsibleModule utility class."""
+            argument_spec=dict(
-
+                pool=dict(
-        return dict(
+                    type='str',
-            app_id=dict(type='str',
+                    default='',
-                        required=False,
+                ),
-                        fallback=(env_fallback, ['DECORT_APP_ID'])),
+                sep_id=dict(
-            app_secret=dict(type='str',
+                    type='int',
-                            required=False,
+                    default=0,
-                            fallback=(env_fallback, ['DECORT_APP_SECRET']),
+                ),
-                            no_log=True),
+                account_name=dict(
-            authenticator=dict(type='str',
+                    type='str',
-                               required=True,
+                ),
-                               choices=['legacy', 'oauth2', 'jwt']),
+                account_Id=dict(
-            controller_url=dict(type='str', required=True),
+                    type='int',
-            jwt=dict(type='str',
+                ),
-                     required=False,
+                image_name=dict(
-                     fallback=(env_fallback, ['DECORT_JWT']),
+                    type='str',
-                     no_log=True),
+                ),
-            oauth2_url=dict(type='str',
+                image_id=dict(
-                            required=False,
+                    type='int',
-                            fallback=(env_fallback, ['DECORT_OAUTH2_URL'])),
+                    default=0,
-            password=dict(type='str',
+                ),
-                          required=False,
+                virt_id=dict(
-                          fallback=(env_fallback, ['DECORT_PASSWORD']),
+                    type='int',
-                          no_log=True),
+                    default=0,
-            pool=dict(type='str', required=False, default=""),
+                ),
-            sep_id=dict(type='int', required=False, default=0),
+                virt_name=dict(
-            account_name=dict(type='str', required=False),
+                    type='str',
-            account_Id=dict(type='int', required=False),
+                ),
-            user=dict(type='str',
+                state=dict(
-                      required=False,
+                    type='str',
-                      fallback=(env_fallback, ['DECORT_USER'])),
+                    default='present',
-            verify_ssl=dict(type='bool', required=False, default=True),
+                    choices=[
-            workflow_callback=dict(type='str', required=False),
+                        'absent',
-            workflow_context=dict(type='str', required=False),
+                        'present',
-            image_name=dict(type='str', required=False),
+                    ],
-            image_id=dict(type='int', required=False,default=0),
+                ),
-            virt_id=dict(type='int', required=False, default=0),
+                drivers=dict(
-            virt_name=dict(type='str', required=False),
+                    type='str',
-            state=dict(type='str',
+                    default='KVM_X86',
-                   default='present',
+                ),
-                   choices=['absent', 'present']),
+                imagetype=dict(
-            drivers=dict(type='str', required=False, default="KVM_X86"),
+                    type='str',
-            imagetype=dict(type='str', required=False, default="linux"),
+                    default='linux',
-            boottype=dict(type='str', required=False, default="uefi"),
+                ),
-            url=dict(type='str', required=False),
+                boottype=dict(
-            gid=dict(type='int', required=False, default=0),
+                    type='str',
-            sepId=dict(type='int', required=False, default=0),
+                    default='uefi',
-            poolName=dict(type='str', required=False),
+                ),
-            hotresize=dict(type='bool', required=False, default=False),
+                url=dict(
-            image_username=dict(type='str', required=False),
+                    type='str',
-            image_password=dict(type='str', required=False),
+                ),
-            usernameDL=dict(type='str', required=False),
+                gid=dict(
-            passwordDL=dict(type='str', required=False),
+                    type='int',
+                    default=0,
+                ),
+                sepId=dict(
+                    type='int',
+                    default=0,
+                ),
+                poolName=dict(
+                    type='str',
+                ),
+                hotresize=dict(
+                    type='bool',
+                    default=False,
+                ),
+                image_username=dict(
+                    type='str',
+                ),
+                image_password=dict(
+                    type='str',
+                ),
+                usernameDL=dict(
+                    type='str',
+                ),
+                passwordDL=dict(
+                    type='str',
+                ),
+            ),
+            supports_check_mode=True,
         )
-        
 
 def main():
-    module_parameters = decort_osimage.decort_osimage_parameters()
+    decon = decort_osimage()
-
+    amodule = decon.amodule
-    amodule = AnsibleModule(argument_spec=module_parameters,
-                            supports_check_mode=True,
-                            mutually_exclusive=[
-                                ['oauth2', 'password'],
-                                ['password', 'jwt'],
-                                ['jwt', 'oauth2'],
-                            ],
-                            required_together=[
-                                ['app_id', 'app_secret'],
-                                ['user', 'password'],
-                            ],
-                            )
-
-    decon = decort_osimage(amodule)
-
     if amodule.params['virt_name'] or amodule.params['virt_id']:
 
         image_id, image_facts = decort_osimage.decort_virt_image_find(decon, amodule)

library/decort_pfw.py

@@ -8,106 +8,87 @@ description: See L(Module Documentation,https://repository.basistech.ru/BASIS/de
 '''
 
 from ansible.module_utils.basic import AnsibleModule
-from ansible.module_utils.basic import env_fallback
 
 from ansible.module_utils.decort_utils import *
 
 
-def decort_pfw_package_facts(comp_facts, vins_facts, pfw_facts, check_mode=False):
+class decort_pfw(DecortController):
-    """Package a dictionary of PFW rules facts according to the decort_pfw module specification. 
+    def __init__(self):
-    This dictionary will be returned to the upstream Ansible engine at the completion of 
+        super(decort_pfw, self).__init__(AnsibleModule(**self.amodule_init_args))
-    the module run.
+
+    @property
+    def amodule_init_args(self) -> dict:
+        return self.pack_amodule_init_args(
+            argument_spec=dict(
+                compute_id=dict(
+                    type='int',
+                    required=True,
+                ),
+                rules=dict(
+                    type='list',
+                ),
+                state=dict(
+                    type='str',
+                    default='present',
+                    choices=[
+                        'absent',
+                        'present',
+                    ],
+                ),
+                vins_id=dict(
+                    type='int',
+                    required=True,
+                ),
+            ),
+            supports_check_mode=True,
+        )
+
+    def decort_pfw_package_facts(self, comp_facts, vins_facts, pfw_facts, check_mode=False):
+        """Package a dictionary of PFW rules facts according to the decort_pfw module specification.
+        This dictionary will be returned to the upstream Ansible engine at the completion of
+        the module run.
+
+        @param (dict) pfw_facts: dictionary with PFW facts as returned by API call to .../???/get
+        @param (bool) check_mode: boolean that tells if this Ansible module is run in check mode
+        """
+
+        ret_dict = dict(state="CHECK_MODE",
+                        compute_id=0,
+                        public_ip="",
+                        rules=[],
+                        vins_id=0,
+                        )
+
+        if check_mode:
+            # in check mode return immediately with the default values
+            return ret_dict
+
+        if pfw_facts is None:
+            # if void facts provided - change state value to ABSENT and return
+            ret_dict['state'] = "ABSENT"
+            return ret_dict
+
+        ret_dict['compute_id'] = comp_facts['id']
+        ret_dict['vins_id'] = vins_facts['id']
+        ret_dict['public_ip'] = vins_facts['vnfs']['GW']['config']['ext_net_ip']
+
+        if len(pfw_facts) != 0:
+            ret_dict['state'] = 'PRESENT'
+            ret_dict['rules'] = pfw_facts
+        else:
+            ret_dict['state'] = 'ABSENT'
 
-    @param (dict) pfw_facts: dictionary with PFW facts as returned by API call to .../???/get
-    @param (bool) check_mode: boolean that tells if this Ansible module is run in check mode
-    """
-
-    ret_dict = dict(state="CHECK_MODE",
-                    compute_id=0,
-                    public_ip="",
-                    rules=[],
-                    vins_id=0,
-                    )
-
-    if check_mode:
-        # in check mode return immediately with the default values
         return ret_dict
 
-    if pfw_facts is None:
+    def decort_pfw_parameters(self):
-        # if void facts provided - change state value to ABSENT and return
+        """Build and return a dictionary of parameters expected by decort_pfw module in a form accepted
-        ret_dict['state'] = "ABSENT"
+        by AnsibleModule utility class."""
-        return ret_dict
 
-    ret_dict['compute_id'] = comp_facts['id']
+        return
-    ret_dict['vins_id'] = vins_facts['id']
-    ret_dict['public_ip'] = vins_facts['vnfs']['GW']['config']['ext_net_ip']
-    
-    if len(pfw_facts) != 0:
-        ret_dict['state'] = 'PRESENT'
-        ret_dict['rules'] = pfw_facts
-    else:
-        ret_dict['state'] = 'ABSENT'
-
-    return ret_dict
-
-def decort_pfw_parameters():
-    """Build and return a dictionary of parameters expected by decort_pfw module in a form accepted
-    by AnsibleModule utility class."""
-
-    return dict(
-        app_id=dict(type='str',
-                    required=False,
-                    fallback=(env_fallback, ['DECORT_APP_ID'])),
-        app_secret=dict(type='str',
-                        required=False,
-                        fallback=(env_fallback, ['DECORT_APP_SECRET']),
-                        no_log=True),
-        authenticator=dict(type='str',
-                           required=True,
-                           choices=['legacy', 'oauth2', 'jwt']),
-        compute_id=dict(type='int', required=True),
-        controller_url=dict(type='str', required=True),
-        jwt=dict(type='str',
-                 required=False,
-                 fallback=(env_fallback, ['DECORT_JWT']),
-                 no_log=True),
-        oauth2_url=dict(type='str',
-                        required=False,
-                        fallback=(env_fallback, ['DECORT_OAUTH2_URL'])),
-        password=dict(type='str',
-                      required=False,
-                      fallback=(env_fallback, ['DECORT_PASSWORD']),
-                      no_log=True),
-        rules=dict(type='list', required=False),
-        state=dict(type='str',
-                   default='present',
-                   choices=['absent', 'present']),
-        user=dict(type='str',
-                  required=False,
-                  fallback=(env_fallback, ['DECORT_USER'])),
-        verify_ssl=dict(type='bool', required=False, default=True),
-        vins_id=dict(type='int', required=True),
-        workflow_callback=dict(type='str', required=False),
-        workflow_context=dict(type='str', required=False),
-    )
 
 def main():
-    module_parameters = decort_pfw_parameters()
+    decon = decort_pfw()
-
+    amodule = decon.amodule
-    amodule = AnsibleModule(argument_spec=module_parameters,
-                            supports_check_mode=True,
-                            mutually_exclusive=[
-                                ['oauth2', 'password'],
-                                ['password', 'jwt'],
-                                ['jwt', 'oauth2'],
-                            ],
-                            required_together=[
-                                ['app_id', 'app_secret'],
-                                ['user', 'password'],
-                            ],
-                            )
-
-    decon = DecortController(amodule)
 
     pfw_facts = None # will hold PFW facts as returned by pfw_configure
 
@@ -157,7 +138,7 @@ def main():
         amodule.fail_json(**decon.result)
     else:
         # prepare PFW facts to be returned as part of decon.result and then call exit_json(...)
-        decon.result['facts'] = decort_pfw_package_facts(comp_facts, vins_facts, pfw_facts, amodule.check_mode)
+        decon.result['facts'] = decon.decort_pfw_package_facts(comp_facts, vins_facts, pfw_facts, amodule.check_mode)
         amodule.exit_json(**decon.result)
 
 if __name__ == "__main__":

library/decort_rg.py

@@ -14,8 +14,9 @@ from ansible.module_utils.decort_utils import *
 
 
 class decort_rg(DecortController):
-    def __init__(self,amodule):
+    def __init__(self):
-        super(decort_rg, self).__init__(amodule)
+        super(decort_rg, self).__init__(AnsibleModule(**self.amodule_init_args))
+        amodule = self.amodule
 
         self.validated_acc_id = 0
         self.validated_rg_id = 0
@@ -237,81 +238,105 @@ class decort_rg(DecortController):
 
         return ret_dict
 
-    def parameters():
+    @property
-        """Build and return a dictionary of parameters expected by decort_rg module in a form accepted
+    def amodule_init_args(self) -> dict:
-        by AnsibleModule utility class."""
+        return self.pack_amodule_init_args(
-
+            argument_spec=dict(
-        return dict(
+                account_id=dict(
-            account_id=dict(type='int', required=False),
+                    type='int',
-            account_name=dict(type='str', required=False, default=''),
+                ),
-            access=dict(type='dict'),
+                account_name=dict(
-            description=dict(type='str', required=False, default=''),
+                    type='str',
-            app_id=dict(type='str',
+                    default='',
-                        required=False,
+                ),
-                        fallback=(env_fallback, ['DECORT_APP_ID'])),
+                access=dict(
-            app_secret=dict(type='str',
+                    type='dict',
-                            required=False,
+                ),
-                            fallback=(env_fallback, ['DECORT_APP_SECRET']),
+                description=dict(
-                            no_log=True),
+                    type='str',
-            authenticator=dict(type='str',
+                    default='',
-                               required=True,
+                ),
-                               choices=['legacy', 'oauth2', 'jwt']),
+                def_netType=dict(
-            controller_url=dict(type='str', required=True),
+                    type='str',
-            # datacenter=dict(type='str', required=False, default=''),
+                    choices=[
-            def_netType=dict(type='str', choices=['PRIVATE','PUBLIC', 'NONE'], default='PRIVATE'),
+                        'PRIVATE',
-            def_netId=dict(type='int'),
+                        'PUBLIC',
-            extNetId=dict(type='int', default=0),
+                        'NONE',
-            extNetIp=dict(type='str', default=""),
+                    ],
-            owner=dict(type='str', default=""),
+                    default='PRIVATE',
-            ipcidr=dict(type='str', default=""),
+                ),
-            jwt=dict(type='str',
+                def_netId=dict(
-                     required=False,
+                    type='int',
-                     fallback=(env_fallback, ['DECORT_JWT']),
+                ),
-                    no_log=True),
+                extNetId=dict(
-            oauth2_url=dict(type='str',
+                    type='int',
-                            required=False,
+                    default=0,
-                            fallback=(env_fallback, ['DECORT_OAUTH2_URL'])),
+                ),
-            rename=dict(type='str', default=""),
+                extNetIp=dict(
-            password=dict(type='str',
+                    type='str',
-                          required=False,
+                    default='',
-                          fallback=(env_fallback, ['DECORT_PASSWORD']),
+                ),
-                          no_log=True),
+                owner=dict(
-            quotas=dict(type='dict', required=False),
+                    type='str',
-            resType=dict(type='list'),
+                    default='',
-            state=dict(type='str',
+                ),
-                       default='present',
+                ipcidr=dict(
-                       choices=['absent', 'disabled', 'enabled', 'present']),
+                    type='str',
-            permanently=dict(type='bool',
+                    default='',
-                             default='False'),
+                ),
-            user=dict(type='str',
+                rename=dict(
-                      required=False,
+                    type='str',
-                      fallback=(env_fallback, ['DECORT_USER'])),
+                    default='',
-            rg_name=dict(type='str', required=False,),
+                ),
-            rg_id=dict(type='int', required=False),
+                quotas=dict(
-            verify_ssl=dict(type='bool', required=False, default=True),
+                    type='dict',
-            workflow_callback=dict(type='str', required=False),
+                ),
-            workflow_context=dict(type='str', required=False),
+                resType=dict(
-            sep_pools=dict(
+                    type='list',
-                type='list',
+                ),
-                elements='dict',
+                state=dict(
-                options=dict(
+                    type='str',
-                    sep_id=dict(
+                    default='present',
-                        type='int',
+                    choices=[
-                        required=True,
+                        'absent',
-                    ),
+                        'disabled',
-                    pool_names=dict(
+                        'enabled',
-                        type='list',
+                        'present',
-                        required=True,
+                    ],
-                        elements='str',
+                ),
+                permanently=dict(
+                    type='bool',
+                    default='False',
+                ),
+                rg_name=dict(
+                    type='str',
+                ),
+                rg_id=dict(
+                    type='int',
+                ),
+                sep_pools=dict(
+                    type='list',
+                    elements='dict',
+                    options=dict(
+                        sep_id=dict(
+                            type='int',
+                            required=True,
+                        ),
+                        pool_names=dict(
+                            type='list',
+                            required=True,
+                            elements='str',
+                        ),
                     ),
                 ),
+                recursive_deletion=dict(
+                    type='bool',
+                    default=False,
+                )
             ),
-            recursive_deletion=dict(
+            supports_check_mode=True,
-                type='bool',
-                default=False,
-            )
         )
-
+    
     # Workflow digest:
     # 1) authenticate to DECORT controller & validate authentication by issuing API call - done when creating DECORTController
     # 2) check if the RG with the specified id or rg_name:name exists
@@ -320,22 +345,8 @@ class decort_rg(DecortController):
     # 5) report result to Ansible
 
 def main():
-    module_parameters = decort_rg.parameters()
+    decon = decort_rg()
-
+    amodule = decon.amodule
-    amodule = AnsibleModule(argument_spec=module_parameters,
-                            supports_check_mode=True,
-                            mutually_exclusive=[
-                                ['oauth2', 'password'],
-                                ['password', 'jwt'],
-                                ['jwt', 'oauth2'],
-                            ],
-                            required_together=[
-                                ['app_id', 'app_secret'],
-                                ['user', 'password'],
-                            ],
-                            )
-
-    decon = decort_rg(amodule)
     #amodule.check_mode=True
     if decon.validated_rg_id > 0:
         if decon.rg_facts['status'] in ["MODELED", "DISABLING", "ENABLING", "DELETING", "DESTROYING", "CONFIRMED"]:

library/decort_snapshot.py

@@ -0,0 +1,157 @@
+#!/usr/bin/python
+
+DOCUMENTATION = r'''
+---
+module: decort_snapshot
+
+description: See L(Module Documentation,https://repository.basistech.ru/BASIS/decort-ansible/wiki/Home).
+'''
+
+import time
+from ansible.module_utils.basic import AnsibleModule
+from ansible.module_utils.decort_utils import DecortController
+
+
+class DecortSnapshot(DecortController):
+    def __init__(self):
+        super().__init__(AnsibleModule(**self.amodule_init_args))
+        self.check_amodule_args()
+
+        self.aparams_label = self.aparams['label']
+        self.aparams_vm_id = self.aparams['vm_id']
+
+        vm_id, vm_facts, _ = self._compute_get_by_id(
+            comp_id=self.aparams_vm_id,
+        )
+        if not vm_id:
+            self.message(f'VM {self.aparams_vm_id} not found')
+            self.exit(fail=True)
+
+        self.vm_name = vm_facts['name']
+        self.vm_snapshots = vm_facts['snapSets']
+        self.vm_snapshot_labels = [
+            snapshot['label'] for snapshot in self.vm_snapshots
+        ]
+
+        if (
+            self.aparams_label is not None
+            and self.aparams_label not in self.vm_snapshot_labels
+            and self.aparams['state'] is None
+        ):
+            self.message(
+                f'Snapshot {self.aparams_label} '
+                f'not found for VM {self.aparams_vm_id}'
+            )
+            self.exit(fail=True)
+
+        self.new_snapshot_label = None
+        if self.aparams['state'] == 'present':
+            if self.aparams_label is None:
+                self.new_snapshot_label = (
+                    f'{self.vm_name}_{self.sec_to_dt_str(time.time())}'
+                )
+            elif self.aparams_label not in self.vm_snapshot_labels:
+                self.new_snapshot_label = self.aparams_label
+
+    @property
+    def amodule_init_args(self) -> dict:
+        return self.pack_amodule_init_args(
+            argument_spec=dict(
+                label=dict(
+                    type='str',
+                ),
+                state=dict(
+                    type='str',
+                    choices=(
+                        'absent',
+                        'present',
+                    ),
+                ),
+                usage=dict(
+                    type='bool',
+                    default=False,
+                ),
+                vm_id=dict(
+                    type='int',
+                    required=True,
+                ),
+            ),
+            supports_check_mode=True,
+            required_if=[
+                ('state', 'absent', ('label',)),
+            ],
+            required_one_of=[
+                ('label', 'state'),
+            ],
+        )
+
+    def check_amodule_args(self):
+        check_error = False
+        if (
+            self.aparams['state'] == 'absent'
+            and self.aparams['usage']
+        ):
+            self.message(
+                'Parameter "usage" is not supported when deleting snapshot'
+            )
+            check_error = True
+
+        if check_error:
+            self.exit(fail=True)
+
+    def run(self):
+        self.get_info(first_run=True)
+        self.change()
+        self.exit()
+
+    def get_info(self, first_run: bool = False):
+        if not first_run:
+            self.vm_snapshots = self.snapshot_list(
+                compute_id=self.aparams_vm_id,
+            )
+        label = self.new_snapshot_label or self.aparams_label
+        for snapshot in self.vm_snapshots:
+            if snapshot['label'] == label:
+                self.facts = snapshot
+                if self.aparams['usage']:
+                    self.facts['stored'] = self.get_snapshot_usage()
+                self.facts['vm_id'] = self.aparams_vm_id
+                break
+
+    def change(self):
+        match self.aparams['state']:
+            case 'present':
+                if self.new_snapshot_label:
+                    self.create()
+            case 'absent':
+                if self.aparams_label in self.vm_snapshot_labels:
+                    self.delete()
+
+    def create(self):
+        self.snapshot_create(
+            compute_id=self.aparams_vm_id,
+            label=self.new_snapshot_label,
+        )
+        self.get_info()
+
+    def delete(self):
+        self.snapshot_delete(
+            compute_id=self.aparams_vm_id,
+            label=self.aparams_label,
+        )
+        self.facts = {}
+
+    def get_snapshot_usage(self) -> int:
+        label = self.new_snapshot_label or self.aparams_label
+        common_snapshots_usage_info, _ = self.snapshot_usage(
+            compute_id=self.aparams_vm_id,
+            label=label,
+        )
+        return common_snapshots_usage_info['stored']
+
+def main():
+    DecortSnapshot().run()
+
+
+if __name__ == '__main__':
+    main()

library/decort_vins.py

@@ -14,8 +14,9 @@ from ansible.module_utils.decort_utils import *
 
 
 class decort_vins(DecortController):
-    def __init__(self,arg_amodule):
+    def __init__(self):
-        super(decort_vins, self).__init__(arg_amodule)
+        super(decort_vins, self).__init__(AnsibleModule(**self.amodule_init_args))
+        arg_amodule = self.amodule
 
         self.vins_id = 0
         self.vins_level = ""  # "ID" if specified by ID, "RG" - at resource group, "ACC" - at account level
@@ -237,61 +238,84 @@ class decort_vins(DecortController):
 
         return ret_dict
 
-    @staticmethod
-    def build_parameters():
-        """Build and return a dictionary of parameters expected by decort_vins module in a form accepted
-        by AnsibleModule utility class."""
 
-        return dict(
+    @property
-            account_id=dict(type='int', required=False,default=0),
+    def amodule_init_args(self) -> dict:
-            account_name=dict(type='str', required=False, default=''),
+        return self.pack_amodule_init_args(
-            description=dict(type='str', required=False, default=''),
+            argument_spec=dict(
-            app_id=dict(type='str',
+                account_id=dict(
-                        required=False,
+                    type='int',
-                        fallback=(env_fallback, ['DECORT_APP_ID'])),
+                    default=0,
-            app_secret=dict(type='str',
+                ),
-                            required=False,
+                account_name=dict(
-                            fallback=(env_fallback, ['DECORT_APP_SECRET']),
+                    type='str',
-                            no_log=True),
+                    default='',
-            authenticator=dict(type='str',
+                ),
-                            required=True,
+                description=dict(
-                            choices=['legacy', 'oauth2', 'jwt']),
+                    type='str',
-            controller_url=dict(type='str', required=True),
+                    default='',
-            # datacenter=dict(type='str', required=False, default=''),
+                ),
-            ext_net_id=dict(type='int', required=False, default=-1),
+                ext_net_id=dict(
-            ext_ip_addr=dict(type='str', required=False, default=''),
+                    type='int',
-            ipcidr=dict(type='str', required=False, default=''),
+                    default=-1,
-            mgmtaddr=dict(type='list',required=False, default=[]),
+                ),
-            custom_config=dict(type='bool',required=False, default=False),
+                ext_ip_addr=dict(
-            config_save=dict(type='bool',required=False, default=False),
+                    type='str',
-            connect_to=dict(type='list', default=[], required=False),
+                    default='',
-            jwt=dict(type='str',
+                ),
-                    required=False,
+                ipcidr=dict(
-                    fallback=(env_fallback, ['DECORT_JWT']),
+                    type='str',
-                    no_log=True),
+                    default='',
-            oauth2_url=dict(type='str',
+                ),
-                            required=False,
+                mgmtaddr=dict(
-                            fallback=(env_fallback, ['DECORT_OAUTH2_URL'])),
+                    type='list',
-            password=dict(type='str',
+                    default=[],
-                        required=False,
+                ),
-                        fallback=(env_fallback, ['DECORT_PASSWORD']),
+                custom_config=dict(
-                        no_log=True),
+                    type='bool',
-            state=dict(type='str',
+                    default=False,
+                ),
+                config_save=dict(
+                    type='bool',
+                    default=False,
+                ),
+                connect_to=dict(
+                    type='list',
+                    default=[],
+                ),
+                state=dict(
+                    type='str',
                     default='present',
-                    choices=['absent', 'disabled', 'enabled', 'present']),
+                    choices=[
-            user=dict(type='str',
+                        'absent',
-                    required=False,
+                        'disabled',
-                    fallback=(env_fallback, ['DECORT_USER'])),
+                        'enabled',
-            rg_id=dict(type='int', required=False, default=0),
+                        'present',
-            rg_name=dict(type='str', required=False, default=''),
+                    ],
-            verify_ssl=dict(type='bool', required=False, default=True),
+                ),
-            vins_id=dict(type='int', required=False, default=0),
+                rg_id=dict(
-            vins_name=dict(type='str', required=False,default=""),
+                    type='int',
-            workflow_callback=dict(type='str', required=False),
+                    default=0,
-            workflow_context=dict(type='str', required=False),
+                ),
+                rg_name=dict(
+                    type='str',
+                    default='',
+                ),
+                vins_id=dict(
+                    type='int',
+                    default=0,
+                ),
+                vins_name=dict(
+                    type='str',
+                    default='',
+                ),
+            ),
+            supports_check_mode=True,
+            required_one_of=[
+                ('vins_id', 'vins_name'),
+            ],
         )
 
-
 # Workflow digest:
 # 1) authenticate to DECORT controller & validate authentication by issuing API call - done when creating DECORTController
 # 2) check if the ViNS with this id or name exists under specified account / resource group
@@ -300,25 +324,8 @@ class decort_vins(DecortController):
 # 5) report result to Ansible
 
 def main():
-    module_parameters = decort_vins.build_parameters()
+    decon = decort_vins()
-
+    amodule = decon.amodule
-    amodule = AnsibleModule(argument_spec=module_parameters,
-                            supports_check_mode=True,
-                            mutually_exclusive=[
-                                ['oauth2', 'password'],
-                                ['password', 'jwt'],
-                                ['jwt', 'oauth2'],
-                            ],
-                            required_together=[
-                                ['app_id', 'app_secret'],
-                                ['user', 'password'],
-                            ],
-                            required_one_of=[
-                                ['vins_id', 'vins_name'],
-                            ],
-                            )
-
-    decon = decort_vins(amodule)
     #
     # Initial validation of module arguments is complete
     #

module_utils/decort_utils.py

@@ -3,7 +3,7 @@ from datetime import datetime
 from enum import Enum
 import json
 import re
-from typing import Any, Callable, Iterable, Literal, Optional
+from typing import Any, Callable, Iterable, Literal, Optional, Tuple
 import time
 
 import jwt
@@ -156,6 +156,15 @@ class DecortController(object):
         ARCXDU = 'ARCXDU'
         CXDRAU = 'CXDRAU'
 
+
+    class VMNetType(Enum):
+        VINS = 'VINS'
+        EXTNET = 'EXTNET'
+        VFNIC = 'VFNIC'
+        EMPTY = 'EMPTY'
+        DPDK = 'DPDK'
+
+
     class MESSAGES:
         @staticmethod
         def ssl_error(url: None | str = None):
@@ -298,14 +307,15 @@ class DecortController(object):
         self.result = {'failed': False, 'changed': False, 'waypoints': "Init"}
 
         self.authenticator = arg_amodule.params['authenticator']
-        self.controller_url = arg_amodule.params['controller_url']
+        self.controller_url = arg_amodule.params.get('controller_url')
 
-        self.jwt = arg_amodule.params['jwt']
+        self.jwt = arg_amodule.params.get('jwt')
         self.app_id = arg_amodule.params['app_id']
         self.app_secret = arg_amodule.params['app_secret']
         self.oauth2_url = arg_amodule.params['oauth2_url']
-        # self.password = arg_amodule.params['password']
+        self.domain = arg_amodule.params['domain']
-        # self.user = arg_amodule.params['user']
+        self.password = arg_amodule.params['password']
+        self.username = arg_amodule.params['username']
         self.session_key = ''
         # self.iconf = arg_iconf
         self.verify_ssl = arg_amodule.params['verify_ssl']
@@ -328,18 +338,12 @@ class DecortController(object):
                 self.result['msg'] = ("JWT based authentication requested, but no JWT specified. "
                                       "Use 'jwt' parameter or set 'DECORT_JWT' environment variable")
                 self.amodule.fail_json(**self.result)
-        elif self.authenticator == "legacy":
+        elif self.authenticator in ('oauth2', 'decs3o', 'bvs'):
-            if not self.password:
+            if self.authenticator == 'oauth2':
-                self.result['failed'] = True
+                self.result['warning'] = (
-                self.result['msg'] = ("Legacy user authentication requested, but no password specified. "
+                    '"oauth2" authenticator type is deprecated and might be '
-                                      "Use 'password' parameter or set 'DECORT_PASSWORD' environment variable.")
+                    'removed in newer versions. Please use "decs3o" instead.'
-                self.amodule.fail_json(**self.result)
+                )
-            if not self.user:
-                self.result['failed'] = True
-                self.result['msg'] = ("Legacy user authentication requested, but no user specified. "
-                                      "Use 'user' parameter or set 'DECORT_USER' environment variable.")
-                self.amodule.fail_json(**self.result)
-        elif self.authenticator == "oauth2":
             if not self.app_id:
                 self.result['failed'] = True
                 self.result['msg'] = ("Oauth2 based authentication requested, but no application ID specified. "
@@ -355,6 +359,28 @@ class DecortController(object):
                 self.result['msg'] = ("Oauth2 base authentication requested, but no Oauth2 provider URL specified. "
                                       "Use 'oauth2_url' parameter or set 'DECORT_OAUTH2_URL' environment variable.")
                 self.amodule.fail_json(**self.result)
+            if self.authenticator == 'bvs':
+                if not self.domain:
+                    self.message(
+                        'BVS authentication requested, but no domain '
+                        'specified. Use "domain" parameter or set '
+                        '"DECORT_DOMAIN" environment variable.'
+                    )
+                    self.exit(fail=True)
+                if not self.password:
+                    self.message(
+                        'BVS authentication requested, but no password '
+                        'specified. Use "password" parameter or set '
+                        '"DECORT_PASSWORD" environment variable.'
+                    )
+                    self.exit(fail=True)
+                if not self.username:
+                    self.message(
+                        'BVS authentication requested, but no user specified. '
+                        'Use "user" parameter or set "DECORT_USER" '
+                        'environment variable.'
+                    )
+                    self.exit(fail=True)
         else:
             # Unknown authenticator type specified - notify and exit
             self.result['failed'] = True
@@ -368,15 +394,12 @@ class DecortController(object):
             self.validate_jwt()  # this call will abort the script if validation fails
             jwt_decoded = jwt.decode(self.jwt, algorithms=["ES384"], options={"verify_signature": False})
             self.decort_username = jwt_decoded['username'] + "@" + jwt_decoded['iss']
-        elif self.authenticator == "legacy":
-            # obtain session id from the DECORT controller and thus validate the the legacy user
-            self.validate_legacy_user()  # this call will abort the script if validation fails
-            self.decort_username = self.user
         else:
-            # self.authenticator == "oauth2" - Oauth2 based authorization mode
+            # Oauth2 based authorization mode
             # obtain JWT from Oauth2 provider and validate on the DECORT controller
-            self.obtain_oauth2_jwt()
+            self.obtain_jwt()
-            self.validate_jwt()  # this call will abort the script if validation fails
+            if self.controller_url is not None:
+                self.validate_jwt()  # this call will abort the script if validation fails
             jwt_decoded = jwt.decode(self.jwt, algorithms=["ES384"], options={"verify_signature": False})
             self.decort_username = jwt_decoded['username'] + "@" + jwt_decoded['iss']
 
@@ -441,7 +464,7 @@ class DecortController(object):
         return int(datetime(**datetime_args).timestamp())
 
     @staticmethod
-    def sec_to_dt_str(sec: int, str_format: str = '%Y-%m-%d_%H-%M-%S') -> str:
+    def sec_to_dt_str(sec: float, str_format: str = '%Y-%m-%d_%H-%M-%S') -> str:
         """
         Convert the Unix-time int to the datetime string of the format
         from `str_format`.
@@ -466,13 +489,17 @@ class DecortController(object):
                     ),
                 authenticator=dict(
                     type='str',
-                    required=True,
+                    choices=['oauth2', 'jwt', 'bvs', 'decs3o'],
-                    choices=['oauth2', 'jwt']
+                    default='decs3o',
                     ),
                 controller_url=dict(
                     type='str',
                     required=True
                     ),
+                domain=dict(
+                    type='str',
+                    fallback=(env_fallback, ['DECORT_DOMAIN']),
+                ),
                 jwt=dict(
                     type='str',
                     fallback=(env_fallback, ['DECORT_JWT']),
@@ -482,14 +509,35 @@ class DecortController(object):
                     type='str',
                     fallback=(env_fallback, ['DECORT_OAUTH2_URL'])
                     ),
+                password=dict(
+                    type='str',
+                    fallback=(env_fallback, ['DECORT_PASSWORD']),
+                ),
+                username=dict(
+                    type='str',
+                    fallback=(env_fallback, ['DECORT_USERNAME']),
+                ),
                 verify_ssl=dict(
                     type='bool',
                     default=True
                     ),
             ),
             required_if=[
-                ('authenticator', 'oauth2',
+                (
-                    ('oauth2_url', 'app_id', 'app_secret')),
+                    'authenticator', 'oauth2',
+                    ('oauth2_url', 'app_id', 'app_secret'),
+                ),
+                (
+                    'authenticator', 'decs3o',
+                    ('oauth2_url', 'app_id', 'app_secret'),
+                ),
+                (
+                    'authenticator', 'bvs',
+                    (
+                        'oauth2_url', 'app_id', 'app_secret',
+                        'domain', 'username', 'password',
+                    ),
+                ),
                 ('authenticator', 'jwt', ('jwt',))
             ],
         )
@@ -514,15 +562,16 @@ class DecortController(object):
         else:
             self.amodule.exit_json(**self.result)
 
-    def message(self, msg: str):
+    def message(self, msg: str | None = None, warning: bool = False):
         """
         Append message to the new line of the string
         `self.result['msg']`.
         """
-        if self.result.get('msg'):
+        key_name = 'warning' if warning else 'msg'
-            self.result['msg'] += f'\n{msg}'
+        if self.result.get(key_name):
+            self.result[key_name] += f'\n{msg}'
         else:
-            self.result['msg'] = msg
+            self.result[key_name] = msg
 
     def pack_amodule_init_args(self, **kwargs) -> dict:
         """
@@ -570,8 +619,14 @@ class DecortController(object):
         else:
             return True
 
-    def obtain_oauth2_jwt(self):
+    def obtain_jwt(self):
-        """Obtain JWT from the Oauth2 provider using application ID and application secret provided , as specified at
+        if self.authenticator in ('oauth2', 'decs3o'):
+            self.jwt = self.obtain_decs3o_jwt()
+        elif self.authenticator == 'bvs':
+            self.jwt = self.obtain_bvs_jwt()
+
+    def obtain_decs3o_jwt(self):
+        """Obtain JWT from the Oauth2 DECS3O provider using application ID and application secret provided , as specified at
          class instance init method.
 
         If method fails to obtain JWT it will abort the execution of the script by calling AnsibleModule.fail_json()
@@ -620,6 +675,64 @@ class DecortController(object):
         self.jwt = token_get_resp.content.decode('utf8')
         return self.jwt
 
+    def obtain_bvs_jwt(self):
+        """
+        Obtain JWT from the Oauth2 BVS provider using
+        application ID, application secret, username and password provided
+
+        If method fails to obtain JWT it will abort the execution of the script
+        by calling self.exit(fail=True).
+
+        @return: JWT as string.
+        """
+        token_get_url = (
+            f'{self.oauth2_url}/realms/{self.domain}/'
+            f'protocol/openid-connect/token'
+        )
+        request_data = {
+            'grant_type': 'password',
+            'client_id': self.app_id,
+            'client_secret': self.app_secret,
+            'username': self.username,
+            'password': self.password,
+            'response_type': 'token',
+            'scope': 'openid',
+        }
+
+        token_get_resp = None
+        try:
+            token_get_resp = requests.post(
+                url=token_get_url,
+                data=request_data,
+                verify=self.verify_ssl,
+            )
+        except requests.exceptions.SSLError:
+            self.message(self.MESSAGES.ssl_error(url=token_get_url))
+            self.exit(fail=True)
+        except requests.exceptions.ConnectionError as con_error:
+            self.message(
+                f'Failed to connect to "{token_get_url}" '
+                f'to obtain JWT access token: {con_error}'
+            )
+            self.exit(fail=True)
+        except requests.exceptions.Timeout as timeout_error:
+            self.message(
+                f'Timeout when trying to connect to "{token_get_url}" '
+                f'to obtain JWT access token: {timeout_error}'
+            )
+            self.exit(fail=True)
+        if token_get_resp.status_code != 200:
+            self.message(
+                f'Failed to obtain JWT access token from '
+                f'oauth2_url "{token_get_url}" '
+                f'for app_id "{self.amodule.params["app_id"]}": '
+                f'HTTP status code {token_get_resp.status_code}, '
+                f'reason "{token_get_resp.reason}"'
+            )
+            self.exit(fail=True)
+        self.jwt = token_get_resp.json()['access_token']
+        return self.jwt
+
     def validate_jwt(self, arg_jwt=None):
         """Validate JWT against DECORT controller. JWT can be supplied as argument to this method. If None supplied as
         argument, JWT will be taken from class attribute. DECORT controller URL will always be taken from the class
@@ -632,15 +745,6 @@ class DecortController(object):
         AnsibleModule.fail_json() method.
         """
 
-        if self.authenticator not in ('oauth2', 'jwt'):
-            # sanity check - JWT is relevant in oauth2 or jwt authentication modes only
-            self.result['msg'] = "Cannot validate JWT for incompatible authentication mode '{}'".format(
-                self.authenticator)
-            self.amodule.fail_json(**self.result)
-            # The above call to fail_json will abort the script, so the following return statement will 
-            # never be executed
-            return False
-
         if not arg_jwt:
             # If no JWT is passed as argument to this method, we will validate JWT stored in the class 
             # instance (if any)
@@ -686,58 +790,6 @@ class DecortController(object):
         # If we fall through here, then everything went well.
         return True
 
-    def validate_legacy_user(self):
-        """Validate legacy user by obtaining a session key, which will be used for authenticating subsequent API calls
-        to DECORT controller.
-        If successful, the session key is stored in self.session_key and True is returned. If unsuccessful for any
-        reason, the method will abort.
-
-        @return: True on successful validation of the legacy user.
-        """
-
-        if self.authenticator != 'legacy':
-            self.result['failed'] = True
-            self.result['msg'] = "Cannot validate legacy user for incompatible authentication mode '{}'".format(
-                self.authenticator)
-            self.amodule.fail_json(**self.result)
-            return False
-
-        req_url = self.controller_url + "/restmachine/cloudapi/user/authenticate"
-        req_data = dict(username=self.user,
-                        password=self.password, )
-
-        try:
-            api_resp = requests.post(req_url, data=req_data, verify=self.verify_ssl)
-        except requests.exceptions.SSLError:
-            self.message(self.MESSAGES.ssl_error(url=req_url))
-            self.exit(fail=True)
-        except requests.exceptions.ConnectionError:
-            self.result['failed'] = True
-            self.result['msg'] = "Failed to connect to '{}' while validating legacy user".format(req_url)
-            self.amodule.fail_json(**self.result)
-            return False  # actually, this directive will never be executed as fail_json exits the script
-        except requests.exceptions.Timeout:
-            self.result['failed'] = True
-            self.result['msg'] = "Timeout when trying to connect to '{}' while validating legacy user".format(req_url)
-            self.amodule.fail_json(**self.result)
-            return False
-
-        if api_resp.status_code != 200:
-            self.result['failed'] = True
-            self.result['msg'] = ("Failed to validate legacy user access to DECORT controller URL '{}': "
-                                  "HTTP status code {}, reason '{}'").format(req_url,
-                                                                             api_resp.status_code,
-                                                                             api_resp.reason)
-            self.amodule.fail_json(**self.result)
-            return False
-
-        # Assign session key to the corresponding class attribute.
-        # Note that the above API call returns session key as a string with double quotes, which we need to
-        # remove before it can be used as 'session=...' parameter to DECORT controller API calls
-        self.session_key = api_resp.content.decode('utf8').replace('"', '')
-
-        return True
-
     def decort_api_call(
             self,
             arg_req_function,
@@ -779,10 +831,7 @@ class DecortController(object):
 
         req_url = self.controller_url + arg_api_name
 
-        if self.authenticator == 'legacy':
+        http_headers['Authorization'] = 'bearer {}'.format(self.jwt)
-            arg_params['authkey'] = self.session_key
-        elif self.authenticator in ('jwt', 'oauth2'):
-            http_headers['Authorization'] = 'bearer {}'.format(self.jwt)
 
         while retry_counter > 0:
             try:
@@ -1387,7 +1436,7 @@ class DecortController(object):
     def kvmvm_provision(self, rg_id,
                         comp_name,
                         cpu, ram,
-                        boot_disk, 
+                        boot_disk,
                         image_id,
                         chipset: Literal['Q35', 'i440fx'] = 'i440fx',
                         description="",
@@ -1397,7 +1446,8 @@ class DecortController(object):
                         start_on_create=True,
                         cpu_pin: bool = False,
                         hp_backed: bool = False,
-                        numa_affinity: Literal['none', 'loose', 'strict'] = 'none'):
+                        numa_affinity: Literal['none', 'loose', 'strict'] = 'none',
+                        preferred_cpu_cores: list[int] | None = None):
         """Manage KVM VM provisioning. To remove existing KVM VM compute instance use compute_remove method,
         to resize use compute_resize, to manage power state use compute_powerstate method.
 
@@ -1434,6 +1484,7 @@ class DecortController(object):
             'interfaces': '[]',  # we create VM without any network connections
             'chipset': chipset,
             'withoutBootDisk': not boot_disk,
+            'preferredCpu': preferred_cpu_cores,
         }
         if description:
             api_params['desc'] = description
@@ -1479,15 +1530,14 @@ class DecortController(object):
             ifaces_for_delete = ifaces
             nets_for_attach = new_networks
         else:
-            EMPTY = 'EMPTY'
-
             # Creating dictionaries in which the key is a net type + a net id
+            # + (optional) postfix
             # For empty networks a net id is the number of the empty network
             ifaces_dict = {}
             empty_ifaces_count = 0
             for iface in ifaces:
                 net_type = iface['netType']
-                if net_type == EMPTY:
+                if net_type == self.VMNetType.EMPTY.value:
                     empty_ifaces_count += 1
                     net_id = empty_ifaces_count
                 else:
@@ -1497,13 +1547,22 @@ class DecortController(object):
             new_nets_dict = {}
             empty_new_nets_count = 0
             for net in new_networks:
-                net_type = net["type"]
+                net_type = net['type']
-                if net_type == EMPTY:
+                if net_type == self.VMNetType.EMPTY.value:
                     empty_new_nets_count += 1
                     net_id = empty_new_nets_count
                 else:
                     net_id = net['id']
                 net_key = f'{net_type}{net_id}'
+
+                # If DPDK iface MTU is new then add postfix
+                if net_type == self.VMNetType.DPDK.value:
+                    net_mtu = net['mtu']
+                    if net_mtu is not None:
+                        iface = ifaces_dict.get(net_key)
+                        if iface and net_mtu != iface['mtu']:
+                            net_key = f'{net_key}_new-mtu'
+
                 new_nets_dict[net_key] = net
 
             # The networks that no need to be disconnected or reconnected
@@ -1569,6 +1628,7 @@ class DecortController(object):
                     'netType': net['type'],
                     'netId': net.get('id') or 0,
                     'ipAddr': net.get('ip_addr'),
+                    'mtu': net.get('mtu'),
                 },
             )
             self.set_changed()
@@ -1925,6 +1985,8 @@ class DecortController(object):
         hp_backed: Optional[bool] = None,
         numa_affinity: Optional[str] = None,
         description: Optional[str] = None,
+        auto_start: Optional[bool] = None,
+        preferred_cpu_cores: list[int] | None = None,
     ):
         OBJ = 'compute'
 
@@ -1939,6 +2001,10 @@ class DecortController(object):
                 'hpBacked': hp_backed,
                 'numaAffinity': numa_affinity,
                 'desc': description,
+                'autoStart': auto_start,
+                'preferredCpu': (
+                    [-1] if preferred_cpu_cores == [] else preferred_cpu_cores
+                ),
             },
         )
 
@@ -1951,6 +2017,8 @@ class DecortController(object):
             'hp_backed': hp_backed,
             'numa_affinity': numa_affinity,
             'description': description,
+            'auto_start': auto_start,
+            'preferred_cpu_cores': preferred_cpu_cores,
         }
         for param, value in params_to_check.items():
             if value is not None:
@@ -2015,6 +2083,19 @@ class DecortController(object):
 
         return api_resp.json()
 
+    @waypoint
+    @checkmode
+    def compute_rollback(self, compute_id: int, snapshot_label: str):
+        self.decort_api_call(
+            arg_req_function=requests.post,
+            arg_api_name='/restmachine/cloudapi/compute/snapshotRollback',
+            arg_params={
+                'computeId': compute_id,
+                'label': snapshot_label,
+            },
+        )
+        self.set_changed()
+
     ###################################
     # OS image manipulation methods
     ###################################
@@ -6474,3 +6555,136 @@ class DecortController(object):
                 self.result['changed'] = True    
 
         return
+
+    @waypoint
+    @checkmode
+    def snapshot_create(self, compute_id: int, label: str):
+        """
+        Implementation of functionality of the API method
+        `/cloudapi/compute/snapshotCreate`.
+        """
+        self.decort_api_call(
+            arg_req_function=requests.post,
+            arg_api_name='/restmachine/cloudapi/compute/snapshotCreate',
+            arg_params={
+                'computeId': compute_id,
+                'label': label,
+            },
+        )
+        self.set_changed()
+        self.message(
+            f'Snapshot {label} for VM ID {compute_id} created successfully.'
+        )
+
+    @waypoint
+    @checkmode
+    def snapshot_delete(
+        self,
+        compute_id: int,
+        label: str,
+    ):
+        """
+        Implementation of functionality of the API method
+        `/cloudapi/compute/snapshotDelete`.
+
+        The method `self.exit(fail=True)` will be
+        called if the time for scheduling or for deleting a snapshot
+        is exceeded, or if an error occurs during deletion.
+        """
+        snapshot_delete_response = self.decort_api_call(
+            arg_req_function=requests.post,
+            arg_api_name='/restmachine/cloudapi/compute/snapshotDelete',
+            arg_params={
+                'computeId': compute_id,
+                'label': label,
+                'asyncMode': True,
+            },
+        )
+        self.set_changed()
+        audit_id = snapshot_delete_response.text.strip('"')
+        task_link = (
+            f'{self.controller_url}/portal/#/system/tasks/{audit_id}'
+        )
+        params = {'auditId': audit_id}
+
+        task_schedule_timeout = 600
+        snapshot_delete_timeout = 120
+        sleep_interval = 5
+        while True:
+            task_response = self.decort_api_call(
+                arg_req_function=requests.post,
+                arg_api_name='/restmachine/cloudapi/tasks/get',
+                arg_params=params,
+            )
+            response_data = task_response.json()
+            match response_data['status']:
+                case 'SCHEDULED':
+                    if task_schedule_timeout <= 0:
+                        self.message(
+                            f'Time to schedule task to delete snapshot for '
+                            f'VM ID {compute_id} has been exceeded.'
+                            f'\nTask details: {task_link}'
+                        )
+                        self.exit(fail=True)
+                    task_schedule_timeout -= sleep_interval
+                case 'PROCESSING':
+                    if snapshot_delete_timeout <= 0:
+                        self.message(
+                            f'Time to delete snapshot for VM ID {compute_id} '
+                            f'has been exceeded.'
+                            f'\nTask details: {task_link}'
+                        )
+                        self.exit(fail=True)
+                    snapshot_delete_timeout -= sleep_interval
+                case 'ERROR':
+                    self.result['msg'] = (
+                        f'Deleting snapshot for VM ID {compute_id} failed:'
+                        f'{response_data["error"]}.'
+                        f'\nTask details: {task_link}'
+                    )
+                    self.exit(fail=True)
+                case 'OK':
+                    self.message(
+                        f'Snapshot {label} for VM ID {compute_id} '
+                        f'deleted successfully.'
+                    )
+                    break
+            time.sleep(sleep_interval)
+
+    @waypoint
+    def snapshot_list(self, compute_id: int) -> list:
+        """
+        Implementation of functionality of the API method
+        `/cloudapi/compute/snapshotList`.
+        """
+        snapshots_list_response = self.decort_api_call(
+            arg_req_function=requests.post,
+            arg_api_name='/restmachine/cloudapi/compute/snapshotList',
+            arg_params={
+                'computeId': compute_id,
+            }
+        )
+        return snapshots_list_response.json()['data']
+
+    @waypoint
+    def snapshot_usage(
+        self,
+        compute_id: int,
+        label: Optional[str],
+    ) -> tuple[dict, list[dict]]:
+        """
+        Implementation of functionality of the API method
+        `/cloudapi/compute/snapshotUsage`.
+        """
+        snapshot_usage_response = self.decort_api_call(
+            arg_req_function=requests.post,
+            arg_api_name='/restmachine/cloudapi/compute/snapshotUsage',
+            arg_params={
+                'computeId': compute_id,
+                'label': label,
+            }
+        )
+        snapshot_usage = snapshot_usage_response.json()
+        common_snapshot_usage_info = snapshot_usage[0]
+        snapshots_usage = snapshot_usage[1:]
+        return common_snapshot_usage_info, snapshots_usage

wiki/7.0.0/Home.md

@@ -0,0 +1,25 @@
+1. [Введение](./введение.md)
+   - [Введение](./введение.md#введение)
+   - [Системные требования](./введение.md#системные-требования)
+   - [Подготовка к работе](./введение.md#подготовка-к-работе)
+   - [Авторизация](./введение.md#авторизация)
+      - [Общие параметры модулей для авторизации](./введение.md#общие-параметры-модулей-для-авторизации)
+      - [Пример авторизации с помощью DECS3O](./введение.md#пример-авторизации-с-помощью-decs3o)
+      - [Пример авторизации с помощью BVS](./введение.md#пример-авторизации-с-помощью-bvs)
+      - [Пример авторизации с помощью JSON Web Token](./введение.md#пример-авторизации-с-помощью-json-web-token)
+1. Ansible модули DECORT:
+   - [Модуль decort_kvmvm](./модуль-decort_kvmvm.md) - управление виртуальными машинами
+   - [Модуль decort_osimage](./модуль-decort_osimage.md) - управление образами
+   - [Модуль decort_disk](./модуль-decort_disk.md) - управление дисками
+   - [Модуль decort_pfw](./модуль-decort_pfw.md) - управление правилами переадресации портов
+   - [Модуль decort_rg](./модуль-decort_rg.md) - управление ресурсными группами
+   - [Модуль decort_vins](./модуль-decort_vins.md) - управление внутренними сетями
+   - [Модуль decort_jwt](./модуль-decort_jwt.md) - получение авторизационного токена
+   - [Модуль decort_bservice](./модуль-decort_bservice.md) - управление базовыми службами
+   - [Модуль decort_group](./модуль-decort_group.md)- управление группами базовой службы
+   - [Модуль decort_k8s](./модуль-decort_k8s.md) - управление кластерами Kubernetes
+   - [Модуль decort_lb](./модуль-decort_lb.md) - управление балансировщиками нагрузки
+   - [Модуль decort_account_info](./модуль-decort_account_info.md) - получение информации об аккаунте
+   - [Модуль decort_account](./модуль-decort_account.md) - управление аккаунтами
+   - [Модуль decort_user_info](./модуль-decort_user_info.md) - получение информации о пользователе
+   - [Модуль decort_snapshot](./модуль-decort_snapshot.md) - управление снимками виртуальной машины

wiki/7.0.0/введение.md

@@ -0,0 +1,250 @@
+# Модули Ansible для управления облачными ресурсами в платформе DECORT
+## Введение
+
+Настоящая документация содержит руководство пользователя по библиотеке модулей decort для Ansible. С помощью этих модулей Вы сможете управлять созданием и конфигурированием облачных ресурсов в платформе DECORT (Digital Energy Cloud Orchestration Technology).
+
+По каждому модулю есть своя документация, в которой вы можете найти список доступных действий, подробную информацию о входных параметрах и возвращаемых данных, а также примеры использования.
+
+## Системные требования
+Убедитесь, что Ваша система соответствует требованиям для работы модуля DECORT.
+Системные требования для работы модуля:
+- Ansible 10.6.0
+- Python 3.10.12
+- PyJWT 2.10.1 Python module
+- requests 2.32.3 Python module
+- DynamiX Enterprise 4.2.0
+
+## Подготовка к работе
+
+Для начала работы необходимо, чтобы Ansible было известно местоположение файлов модулей. Для этого необходимо:
+- либо разместить директории **library** и **module_utils** в одной директории с плейбуками
+- либо в рабочей директории, из которой будет запускаться Ansible, разместить файл **ansible.cfg**, в котором задать пути к файлам модулей, например:
+```
+[defaults]
+library=./library
+module_utils=./module_utils
+```
+
+## Авторизация
+
+### Общие параметры модулей для авторизации
+
+<table>
+  <tr>
+    <th colspan="6">Параметр</th>
+    <th>Тип</th>
+    <th>Описание</th>
+  </tr>
+  <tr>
+    <td colspan="6">
+      app_id
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Идентификатор приложения, использующийся для получения токена в режимах 
+        <code>authenticator: bvs</code> или <code>authenticator: decs3o</code>. 
+        Данный параметр является обязательным для указанных режимов. Если
+        параметр не задан в playbook, модуль будет использовать значение
+        переменной окружения <code>DECORT_APP_ID</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      app_secret
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Секретный ключ приложения, использующийся для получения токена в режимах
+        <code>authenticator: bvs</code> или <code>authenticator: decs3o</code>.
+        Данный параметр является обязательным для указанных режимов. 
+        Так как он содержит секретную информацию, то его не рекомендуется 
+        задавать непосредственно в playbook. Если параметр не задан в playbook,
+        то модуль будет использовать значение переменной окружения
+        <code>DECORT_APP_SECRET</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      authenticator
+    </td>
+    <td>
+      (str)
+      <br>Значения:
+      <br/><code>bvs</code>
+      <br/><code>decs3o</code>
+      <br/><code>oauth2</code>
+      <br/><code>jwt</code>
+      <br>Default: <code>decs3o</code>
+    </td>
+    <td>
+      Режим аутентификации для получения токена. 
+        Значение <code>oauth2</code> является устаревшим и равнозначным 
+        <code>decs3o</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      controller_url
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      URL контроллера, соответствующего экземпляру облачной платформы
+        DECORT. Данный параметр является обязательным.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      domain
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Домен BVS, использующийся для получения токена в режиме 
+        <code>authenticator: bvs</code>. Данный параметр является 
+        обязательным для указанного режима. Если параметр не задан в playbook, 
+        модуль будет использовать значение переменной окружения 
+        <code>DECORT_DOMAIN</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      jwt
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      JSON Web Token (JWT), который будет использоваться для подключения
+        к контроллеру облачной платформы DECORT в режиме
+        <code>authenticator: jwt</code>. Данный параметр является
+        обязательным для указанного режима. Так как он содержит
+        потенциально секретную информацию, а сам JWT, как правило,
+        имеет ограниченное время жизни, то его не рекомендуется задавать
+        непосредственно в playbook. Если этот параметр не определен в
+        playbook, то модуль будет использовать значение переменной
+        окружения <code>DECORT_JWT</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      oauth2_url
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      URL авторизационного сервера, работающего по протоколу Oauth2,
+        который должен использоваться в режимах
+        <code>authenticator: bvs</code> 
+        или <code>authenticator: decs3o</code>. Данный параметр является
+        обязательным для указанных режимов. Если параметр не задан в
+        playbook, модуль будет использовать значение переменной
+        окружения <code>DECORT_OAUTH2_URL</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      password
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Пароль пользователя, который должен использоваться в режиме
+        <code>authenticator: bvs</code>. Данный параметр является
+        обязательным для указанного режима. Так как он содержит секретную 
+        информацию, то его не рекомендуется задавать непосредственно
+        в playbook. Если параметр не задан в playbook, модуль будет 
+        использовать значение переменной окружения 
+        <code>DECORT_PASSWORD</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      username
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Логин пользователя, который должен использоваться в режиме
+        <code>authenticator: bvs</code>. Данный параметр является
+        обязательным для указанного режима. Если параметр не задан в playbook, 
+        модуль будет использовать значение переменной окружения 
+        <code>DECORT_USERNAME</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      verify_ssl
+    </td>
+    <td>
+      (bool)
+      <br>Default: <code>true</code>
+    </td>
+    <td>
+      Позволяет отключить проверку SSL сертификатов при выполнении API
+        вызовов в адрес контроллера облачной инфраструктуры, например,
+        при работе с изолированной облачной инфраструктурой, использующей
+        самоподписанные сертификаты. Применяйте данный параметр с
+        осторожностью, предпочтительно в защищенных средах.
+    </td>
+  </tr>
+</table>
+
+### Пример авторизации с помощью DECS3O
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: DECS3O auth
+      decort_module_name:
+        # Специфичные для модулей параметры упущены
+        # Пример демонстрирует только параметры для авторизации
+        app_id: "{{ app_id }}"
+        app_secret: "{{ app_secret }}"
+        authenticator: decs3o
+        controller_url: https://dynamix.local
+        oauth2_url: https://sso-dynamix.local
+```
+
+### Пример авторизации с помощью BVS
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: BVS auth
+      decort_module_name:
+        # Специфичные для модулей параметры упущены
+        # Пример демонстрирует только параметры для авторизации
+        app_id: "{{ app_id }}"
+        app_secret: "{{ app_secret }}"
+        authenticator: bvs
+        controller_url: https://dynamix.local
+        oauth2_url: https://bvs.local
+        domain: dynamix
+        username: "{{ username }}"
+        password: "{{ password }}"
+```
+
+### Пример авторизации с помощью JSON Web Token
+
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Auth with JWT
+      decort_module_name:
+        # Специфичные для модулей параметры упущены
+        # Пример демонстрирует только параметры для авторизации
+        authenticator: jwt
+        controller_url: "{{ controller_url }}"
+        jwt: "{{ jwt }}"
+```

wiki/7.0.0/модуль-decort_account.md

@@ -0,0 +1,992 @@
+# Модуль decort_account
+## Обзор модуля
+
+Модуль **decort_account** предназначен для выполнения следующих действий над аккаунтом:
+- **удалить в корзину** (см. [параметр state](#state) и [примеры](#в-корзину))
+- **удалить безвозвратно** (см. [параметр state](#state) и [примеры](#безвозвратно))
+- **восстановить из корзины** (см. [параметр state](#state) и [примеры](#восстановить-из-корзины))
+- **выключить/включить** (см. [параметр state](#state) и [примеры](#выключитьвключить))
+- **изменить права доступа** (см. [параметр acl](#acl) и [примеры](#изменить-права-доступа))
+- **изменить имя** (см. [параметр name](#name) и [примеры](#переименовать))
+- **изменить квоты** (см. [параметр quotas](#quotas) и [примеры](#изменить-квоты))
+- **выключить/включить отправку уведомлений о предоставлении доступа к ресурсам** (см. [параметр access_emails](#access_emails) и [примеры](#выключитьвключить-отправку-уведомлений-о-предоставлении-доступа-к-ресурсам))
+- **изменить доступные пулы СХД** (см. [параметр sep_pools](#sep_pools) и [примеры](#изменить-доступные-пулы-схд))
+
+## Параметры модуля 
+Ниже приведен список параметров для модуля **decort_account** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+<table>
+  <tr>
+    <th colspan="6">Параметр</th>
+    <th>Тип</th>
+    <th>Описание</th>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="access_emails">
+        access_emails
+      </a>
+    </td>
+    <td>
+      (bool)
+    </td>
+    <td>
+      Выключение/включение отправки пользователям на эл. почту уведомлений о предоставлении доступа к ресурсам.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="acl">
+        acl
+      </a>
+    </td>
+    <td>
+      (dict)
+    </td>
+    <td>
+      Целевые права доступа.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      mode
+    </td>
+    <td>
+      (str)
+      <br>Значения:
+      <br><code>match</code>
+      <br><code>revoke</code>
+      <br><code>update</code>
+      <br>Default: <code>update</code>
+    </td>
+    <td>
+      Режим изменения прав доступа для указанных пользователей.
+      <br><code>match</code> - привести в соответствие для указанных
+        пользователей, удалить предоставленные для других.
+      <br><code>revoke</code> - отозвать для указанных пользователей,
+        если предоставлены.
+      <br><code>update</code> - привести в соответствие для указанных
+        пользователей, оставить без изменения предоставленные для
+        других.
+      </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      users
+    </td>
+    <td>
+      (list)
+    </td>
+    <td>
+      Список словарей, описывающих права доступа пользователей.
+      <br>Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td colspan="4">
+      rights
+    </td>
+    <td>
+      (str)
+      <br>Значения:
+      <br><code>R</code>
+      <br><code>RCX</code>
+      <br><code>ARCXDU</code>
+      <br>Default: <code>R</code>
+    </td>
+    <td>
+      Права доступа.
+      <br>При <code>mode: revoke</code> не используется.
+      <br>При <code>mode: match</code> и <code>mode: update</code>
+        права <code>ARCXDU</code> считаются соответствующими
+        правам <code>CXDRAU</code>.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td colspan="4">
+      id
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Идентификатор пользователя.
+      <br>Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      id
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Идентификатор целевого аккаунта.
+      <br>Обязательный параметр, если не задан параметр
+        <code>name</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="name">
+        name
+      </a>
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Имя целевого аккаунта.
+      <br>Может быть альтернативой параметру <code>id</code>,
+        за исключением случая, когда необходимо получить
+        информацию о безвозвратно удалённом объекте.
+      <br>Если задан совместно с параметром <code>id</code>,
+        то используется для переименования (целевое имя).
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="quotas">
+        quotas
+      </a>
+    </td>
+    <td>
+      (dict)
+    </td>
+    <td>
+      Целевые квоты.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      cpu
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Количество виртуальных процессоров.
+      <br><code>-1</code> - удалить квоту.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      disks_size
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Объём дисков в ГБ.
+      <br><code>-1</code> - удалить квоту.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      ext_traffic
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Объём трафика внешних сетей.
+      <br><code>-1</code> - удалить квоту.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      gpu
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Количество графических процессоров.
+      <br><code>-1</code> - удалить квоту.
+    </td>
+  </tr>
+   <tr>
+    <td></td>
+    <td colspan="5">
+      public_ip
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Количество внешних IP-адресов.
+      <br><code>-1</code> - удалить квоту.
+    </td>
+  </tr>
+  </tr>
+   <tr>
+    <td></td>
+    <td colspan="5">
+      ram
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Объём оперативной памяти в МБ.
+      <br><code>-1</code> - удалить квоту.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="sep_pools">
+        sep_pools
+      </a>
+    </td>
+    <td>
+      (list)
+    </td>
+    <td>
+      Список словарей, описывающих доступные пулы СХД.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      sep_id
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Идентификатор системы хранения данных.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      pool_names
+    </td>
+    <td>
+      (list)
+    </td>
+    <td>
+      Список названий пулов системы хранения данных.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="state">
+        state
+      </a>
+    </td>
+    <td>
+      (str)
+      <br>Значения:
+      <br><code>absent</code>
+      <br><code>absent_permanently</code>
+      <br><code>confirmed</code>
+      <br><code>disabled</code>
+      <br><code>present</code>
+      <br>Default: <code>present</code>
+    </td>
+    <td>
+      Целевое состояние.
+      <br><code>absent</code> - удалён в корзину, безвозвратно удалён
+        или не существует. Если существует и не удалён, то будет удалён
+        в корзину.
+      <br><code>absent_permanently</code> - безвозвратно удалён или
+        не существует. Если существует и не удалён или удалён в корзину,
+        то будет безвозвратно удалён.
+      <br> При значениях <code>absent</code> и <code>absent_permanently</code>
+        использование других параметров модуля, вызывающих изменение объекта,
+        не допускается.
+      <br><code>confirmed</code> - включён. Если выключен, то будет включён.
+        Если удалён в корзину, то будет восстановлен из корзины.
+      <br><code>disabled</code> - выключен. Если включён, то будет выключен.
+        Если удалён в корзину, то будет восстановлен из корзины и выключен.
+      <br><code>present</code> - существует и не удалён. Если удалён в
+        корзину, то будет восстановлен из корзины.
+    </td>
+  </tr>
+</table>
+
+## Возвращаемые значения
+
+Модуль **decort_account** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами:
+
+<table>
+  <tr>
+    <th colspan="6">
+      Ключ
+    </th>
+    <th>
+      Тип
+      <br>данных
+    </th>
+    <th>
+      Описание
+    </th>
+  </tr>
+  <tr>
+    <td colspan="6">
+      acl
+    </td>
+    <td>
+      list
+    </td>
+    <td>
+      Список словарей, описывающих доступы пользователей.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      canBeDeleted
+    </td>
+    <td>
+      bool
+    </td>
+    <td>
+      Может ли быть удалён.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      right
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Права.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      status
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Статус.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      type
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Тип.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      userGroupId
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Идентификатор пользователя или группы пользователей.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      company
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Название компании.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      companyurl
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      URL компании.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      computeFeatures
+    </td>
+    <td>
+      list
+    </td>
+    <td>
+      Список дополнительных возможностей гипервизора, доступных ВМ.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      computes_amount
+    </td>
+    <td>
+      dict
+    </td>
+    <td>
+      Количество ВМ по состоянию.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      started
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Количество запущенных ВМ.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      stopped
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Количество остановленных ВМ.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      cpu_allocation_parameter
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Режим выделения ЦП.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      cpu_allocation_ratio
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Коэффициент для режима выделения ЦП.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      createdBy
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Идентификатор пользователя, который создал.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      createdTime
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Unix-время создания.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      createdTime_readable
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Дата и время создания.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      deactivationTime
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Unix-время выключения.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      deactivationTime_readable
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Дата и время выключения.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      deletedBy
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Идентификатор пользователя, который удалил.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      deletedTime
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Unix-время удаления.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      deletedTime_readable
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Дата и время удаления.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      displayname
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Отображаемое имя.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      id
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Идентификатор.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      name
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Имя.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      resourceLimits
+    </td>
+    <td>
+      dict
+    </td>
+    <td>
+      Квоты на ресурсы.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      CU_C
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Количество виртуальных процессоров.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      CU_D
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Объём диска в ГБ.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      CU_DM
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Объём дисков в ГБ.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      CU_I
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Количество внешних IP-адресов.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      CU_M
+    </td>
+    <td>
+      float
+    </td>
+    <td>
+      Объём оперативной памяти в МБ.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      CU_NP
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Объём трафика внешних сетей.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      gpu_units
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Количество графических процессоров.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      sendAccessEmails
+    </td>
+    <td>
+      bool
+    </td>
+    <td>
+      Отправка пользователям на эл. почту уведомлений о предоставлении доступа.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      status
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Статус.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      uniqPools
+    </td>
+    <td>
+      list
+    </td>
+    <td>
+      Список доступных пулов СХД.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      updatedTime
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Unix-время обновления.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      updatedTime_readable
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Дата и время обновления.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      vins
+    </td>
+    <td>
+      list
+    </td>
+    <td>
+      Список идентификаторов внутренних сетей на уровне аккаунта.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      vinses_amount
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Количество внутренних сетей.
+    </td>
+  </tr>
+</table>
+
+## Примеры использования
+
+### Удалить
+
+#### В корзину
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Delete account
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        state: absent
+```
+
+#### Безвозвратно
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Delete account
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        state: absent_permanently
+```
+
+### Восстановить из корзины
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Restore account from recycle bin
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        state: present
+```
+
+### Выключить/включить
+
+#### Выключить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Disable account
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        state: disabled
+```
+
+#### Включить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Enable account
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        state: confirmed
+```
+
+### Изменить права доступа
+
+#### Отозвать
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Revoke user access rights
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        acl:
+          mode: revoke
+          users:
+            - id: "{{ user1_id }}"
+            - id: "{{ user2_id }}"
+```
+
+#### Обновить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Update user access rights
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        acl:
+          mode: update
+          users:
+            - id: "{{ user1_id }}"
+              rights: R
+            - id: "{{ user2_id }}"
+              rights: RCX
+```
+
+#### Привести в соответствие
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Match user access rights
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        acl:
+          mode: match
+          users:
+            - id: "{{ user1_id }}"
+              rights: ARCXDU
+            - id: "{{ user2_id }}"
+              rights: RCX
+```
+
+### Переименовать
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Rename account
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        name: "{{ account_new_name }}"
+```
+
+### Изменить квоты
+
+#### На объём дисков
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Update account quota of disks size
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        quotas:
+          disks_size: 500
+```
+
+#### На количество внешних IP-адресов
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Update account quota of public IP amount
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        quotas:
+          public_ip: 10
+```
+
+### Выключить/включить отправку уведомлений о предоставлении доступа к ресурсам
+
+#### Выключить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Disable sending access emails
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        access_emails: false
+```
+
+#### Включить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Enable sending access emails
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        access_emails: true
+```
+
+### Изменить доступные пулы СХД
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change available sep pools
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        sep_pools:
+          - sep_id: 1
+            pool_names: 
+              - pool1
+```

wiki/7.0.0/модуль-decort_bservice.md

@@ -0,0 +1,82 @@
+# Модуль decort_bservice
+
+## Обзор модуля decort_bservice
+
+Базовая служба (Basic Service) это несколько групп виртуальных серверов (compute), создаваемых и управляемых как единое целое.
+
+Все compute(s) в группе имеют одни и те же характеристики (cpu/ram/boot disk size/OS image + сетевые подключения). Для разных групп эти характеристики могут быть разными.
+
+Группы в составе Basic Service могут иметь отношения parent-child с другими группами. Наличие таких отношений определяет последовательность запуска групп ("сначала parents").
+
+На основе ресурсов, предоставляемых и управляемых через Basic Service, могут создаваться другие сервисы. 
+
+`Для взаимодействия с группами виртуальных серверов используется модуль decort_group.`
+
+Модуль decort_bservice предназначен для управления базовыми службами, в которых находятся группы виртуальных серверов.
+Данный модуль позволяет:
+- Создавать Basic Service
+- Удалять Basic Service (безвозвратно).
+- Включать/выключать Basic Service
+- Запускать Basic Service
+- Запрашивать информацию о Basic Service.
+
+
+## Параметры модуля decort_bservice
+Ниже приведен список параметров для модуля **decort_bservice** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+| Параметр | Тип, допустимые значения | Описание |
+| ------ | ------ | ------ |
+| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.|
+|account_name | (string) | Имя аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор (см. `account_id`), либо имя аккаунта. Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. |
+|state | Значения: `absent`, `disabled`, `enabled`, `present`, `check`. <br> Default: `present`| Целевое состояние базовой службы. Значения `present` и `enabled` равнозначны.|
+| started | (bool) <br> Default: `true` | Параметр, определяющий состояние добавленных виртуальных серверов в Basic Service. Запускать их, или нет. |
+| name | (string) | Имя базовой службы. Данный параметр является обязательным при создании базовой службы и при изменении если не задан `id`. |
+| sshuser | (string) | Имя пользователя, который будет создан на всех виртуальных серверах базовой службы. Используется в паре с `sshkey`. |
+| sshkey | (string) | SSH ключ, который будет загружен на все виртуальные сервера базовой службы. Используется в паре с `sshuser`. |
+| id | (int) | Уникальный целочисленный идентификатор базовой службы. Используется для поиска, изменения и удаления базовой службы. |
+| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы базовой службы. |
+| rg_name | (string) | Имя ресурсной группы базовой службы. |
+
+## Возвращаемые значения модуля decort_bservice
+
+Модуль decort_bservice возвращает информацию о базовой службе в виде словаря facts со следующими ключами:
+
+
+|Ключ |	Тип данных |	Описание|
+| ------ | ------ | ------ |
+|id |	int |	Уникальный целочисленный идентификатор базовой службы.|
+|name |	string | Имя базовой службы.|
+| techStatus | string | Технический статус базовой службы. |
+|state | string | Статус базовой службы.|
+| rg_id | int | Уникальный целочисленный идентификатор ресурсной группы, в которой находится базовая служба.|
+| account_id | int | Уникальный целочисленный идентификатор аккаунта, в котором находится ресурсная группа.|
+| groups | list | Список словарей с информацией о группах базовой службы.|
+
+
+## Пример использования модуля decort_bservice
+
+Данный пример создаёт базовую службу с именем databases.
+
+```
+  - name: Create Basic Service
+    decort_bservice:
+      authenticator: jwt
+      controller_url: "{{ controller_url }}"
+      jwt: "{{ auth_token }}"
+      name: databases
+      rg_id: "{{ rg_id }}"
+    register: db_bservice
+```
+
+Данный пример удаляет базовую службу с названием databases.
+```
+  - name: Delete Basic Service
+    decort_bservice:
+      authenticator: jwt
+      controller_url: "{{ controller_url }}"
+      jwt: "{{ auth_token }}"
+      state: absent
+      name: databases
+      rg_id: "{{ rg_id }}"
+    register: db_bservice
+```

wiki/7.0.0/модуль-decort_disk.md

@@ -0,0 +1,167 @@
+# Модуль decort_disk
+## Обзор модуля decort_disk
+
+Модуль decort_disk предназначен для управления дисками и позволяет производить с ними следующие действия:
+- создавать
+- удалять (в корзину или безвозвратно)
+- восстановливать из корзины
+- изменять:
+  - имя
+  - размер
+  - лимиты ввода/вывода
+  - включать/отключать общий доступ
+
+
+Обратите внимание:
+
+- Загрузочный диск для виртуальной машины создаётся и подключается автоматически в процессе создания этой машины.
+- Модуль decort_disk служит для управления дополнительными дисками (т.н. data-дисками);
+- Подключение дополнительных дисков, созданных посредством decort_disk, к виртуальным машинам выполняется с помощью модуля управления виртуальными машинами (см. модуль decort_kvmvm).
+
+## Параметры модуля decort_disk
+Ниже приведен список параметров для модуля **decort_disk** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+| Параметр | Тип, допустимые значения | Описание |
+| ------ | ------ | ------ |
+| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр `name`) должно быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.|
+|account_name | (string) | Имя аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр name) должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. |
+| description | (string)<br>Default: `Disk by decort_disk` | Текстовое описание диска. Данный параметр является опциональным и учитывается только при создании диска, а при всех прочих операциях игнорируется.|
+|id | (int) | Уникальный целочисленный идентификатор диска. Соответствующий диск должен существовать (таким образом, с помощью id нельзя создать новый диск, а только управлять уже имеющимися). Если задан данный параметр, то параметры `name`, `account_name` и `account_id` игнорируются.|
+| iops | (int)<br>Default: `2000` | Ограничение ввода/вывода диска. Используется при создании диска. |
+| force_detach | (bool)<br/>Default: `false` | Задаёт поведение платформы при попытке удалить диск, подключённый к виртуальной машине.<br/>По умолчанию, удаление подключённых дисков не разрешается, и попытка удалить такой диск приведёт к аварийному завершению модуля. Чтобы изменить это поведение, явно установите `force_detach: true`. |
+| limitIO | (dict) | Параметр, позволяющий ограничить скорость ввода/вывода диска как в iops, так и в байтах в секунду.  Обратите внимание, что параметры с total не задаются вместе с read/write. Все возможные подпараметры можно увидеть в примерах. |
+| name | (string) | Имя диска. Для идентификации диска требуется либо его `name` и информация об аккаунте (`account_id` или `account_name`), которому принадлежит диск, либо его `id`.|
+| permanently | (bool)<br>Default: `false` | Параметр, использующийся при удалении диска, при значении `true` - диск удалится навсегда, а при `false` - попадёт в корзину. |
+| place_with | (int) | Идентификатор образа диска, из которого следует взять параметр `sep_id`, чтобы разместить данный диск на той же системе хранения данных, что и указанный образ диска. Данный параметр является опциональным и используется только на стадии создания диска. Если задан `place_with`, то `sep_id` игнорируется.|
+| pool | (string) | Название пула на системе хранения данных, в рамках которой следует создать данный диск. Этот параметр используется только на стадии создания диска и игнорируется при операциях над уже существующими дисками. Параметр является опциональным, если не задан, то платформа будет использовать пул, который сконфигурирован на целевой системе хранения как пул по умолчанию. |
+| reason | (string)<br>Default: `Managed by Ansible decort_disk` | Причина, по которой было выполнено какое-либо действие. В данном модуле используется только при удалении диска. |
+| sep_id | (int) | Идентификатор системы хранения данных (Storage End-point). Данный параметр определяет систему хранения данных, на ресурсах которой создаётся диск. Используется только при создании диска и игнорируется при прочих операциях. Альтернативой данному параметру является `place_with`, позволяющий разместить диск на той же системе хранения, что и указанный образ диска, на базе которого создаётся виртуальная машина.|
+| shareable | (bool)<br>Default: `false` | Включение/отключение общего доступа к диску.
+| size | (int) | Размер диска в ГБ. Этот параметр является обязательным при создании диска. Если он задан для уже существующего диска, а текущий размер диска меньше заданного, то будет предпринята попытка увеличить размер диска. При прочих операциях данный параметр игнорируется.|
+| state | (str)<br>Значения:<br>`present`<br>`absent`<br>Default: `present` | Целевое состояние диска. |
+| type | (string)<br>Значения:<br>`B`<br>`D`<br>Default: `D` | Тип создаваемого диска. `B` - Boot/загрузочный, `D` - Data/с данными. |
+
+## Возвращаемые значения модуля decort_disk
+
+Модуль decort_disk возвращает информацию о диске в виде словаря facts со следующими ключами:
+
+
+|Ключ |	Тип данных |	Описание|
+| ------ | ------ | ------ |
+| account_id |	int |	Уникальный целочисленный идентификатор аккаунта, которому принадлежит диск.|
+| computes |	dict |	Словарь, в котором ключ - идентификатор, а значение - имя виртуальной машины, к которой в настоящий момент подключён диск. Если диск не подключён, то возвращается пустой словарь.|
+| gid |	int |	Идентификатор физического кластера (Grid ID), на ресурсах которого создан диск.|
+| id |	int |	Уникальный целочисленный идентификатор данного диска.|
+| iotune | dict | Текущие ограничения ввода/вывода диска. |
+| name |	string |	Имя диска. Обратите внимание, что имя диска не является уникальным с точки зрения системы хранения данных, на которой этот диск расположен.|
+| pool |	string |	Имя пула на системе хранения данных, в котором размещаются ресурсы диска.|
+|sep_id |	int |	Идентификатор системы хранения данных (Storage Endpoint), на которой размещаются ресурсы данного диска.|
+| size |	int |	Размер диска в ГБ.|
+| state |	string | Текущий статус диска. |
+
+
+## Пример использования модуля decort_disk
+
+В данном примере создаётся диск размером 50ГБ (`size: 50`), с ограничением ввода/вывода в 2000 iops, на ресурсах системы хранения данных под номером 1 (`sep_id: 1`) в пуле "data01".
+
+```
+- name: Manage disk
+  decort_disk:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    name: "DataDisk01"
+    size: 50
+    account_name: "MyAccount"
+    sep_id: 1
+    iops: 2000
+    description: "Disk example"
+    pool: data01
+  register: my_data_disk01
+```
+В следующих двух примерах для существующего диска с именем "DataDisk01" задаются все доступные лимиты на операции ввода/вывода.
+
+```
+- name: Manage disk
+  decort_disk:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    name: "DataDisk01"
+    account_name: "MyAccount"
+    limitIO:
+      read_bytes_sec: 10000
+      write_bytes_sec: 5000
+      read_iops_sec и write_iops_sec
+      read_iops_sec: 2500
+      write_iops_sec: 1000
+      read_bytes_sec_max: 11000
+      write_bytes_sec_max: 6000
+      read_iops_sec_max: 3000
+      write_iops_sec_max: 1500
+      size_iops_sec: 1000
+  register: my_data_disk01
+
+- name: Manage disk
+  decort_disk:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    name: "DataDisk01"
+    account_name: "MyAccount"
+    limitIO:
+      total_bytes_sec: 15000
+      total_iops_sec: 3500
+      total_bytes_sec_max: 17000
+      total_iops_sec_max: 4500
+      size_iops_sec: 1000
+  register: my_data_disk01
+```
+
+В данном примере выполняется восстановление удаленного диска с id 111 из корзины.
+
+```
+- name: Manage disk
+  decort_disk:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    id: 111
+    size: 10
+  register: my_data_disk01
+```
+
+В данном примере выполняется переименование диска с id 111 на новое имя "NewExampleDisk".
+
+```
+- name: Manage disk
+  decort_disk:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    id: 111
+    name: "NewExampleDisk"
+    size: 10
+  register: my_data_disk01
+```
+
+Здесь результат работы модуля decort_disk записывается в переменную my_data_disk01. Для получения идентификатора диска, например, при подключении его к виртуальной машине, следует воспользоваться показанной ниже конструкцией:
+
+```
+- name: Manage compute
+  decort_kvmvm:
+    << для краткости фрагмент опущен >>
+    data_disks:
+      - "{{ my_data_disk01.facts.id }}"
+    << для краткости фрагмент опущен >>
+```

wiki/7.0.0/модуль-decort_group.md

@@ -0,0 +1,97 @@
+# Модуль decort_group
+## Обзор модуля decort_group
+Модуль **decort_group** позволяет производить следующие действия над группами базовой службы:
+- создать
+- получить информацию
+- запустить/остановить
+- подключить/отключить сети (для существующей группы только внутренние сети)
+- изменить
+  - имя
+  - объём загрузочного диска
+  - количество ВМ
+  - роль
+  - количество виртуальных процессоров
+  - объём ОЗУ
+- удалить (безвозвратно)
+
+## Параметры модуля decort_group
+Ниже приведен список параметров для модуля **decort_group** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+| Параметр | Тип, допустимые значения | Описание |
+| ------ | ------ | ------ |
+| account_id | (int) | Идентификатор аккаунта. При идентификации диска по имени (см. параметр `name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. |
+| account_name | (string) | Имя аккаунта. При идентификации диска по имени (см. параметр `name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. |
+| boot_disk | (int) | Обьём загрузочного диска. |
+| bservice_id | (int) | Идентификатор базовой службы. Обязательный параметр. |
+| count | (int) | Количество виртуальных машин. |
+| cpu | (int) | Количество виртуальных процессоров. |
+| driver | (string)<br>Значения:<br>`KVM_X86`<br>`SVA_KVM_X86`<br>Default: `KVM_X86` | Драйвер. |
+| id | (int) | Идентификатор группы. |
+| image_id | (int) | Идентификатор образа. |
+| name | (str) | Имя группы.<br>Используется для идентификации группы, если не задан параметр `id`, а также для переименования группы, если параметр `id` задан. |
+| networks | (list) | Список словарей, описывающих сети, которые должны быть подключены.<br>Ключи словаря:<br>&bull; `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя) или `EXTNET` (внешняя)<br>&bull; `id` (int) (обязательный) - идентификатор сети |
+| ram | (int) | Объём оперативной памяти. |
+| role | (string) | Тег роли. |
+| state | (str)<br>Значения:<br>`present`<br>`absent`<br>`started`<br>`stopped`<br>`check`<br>Default: `present` | 
+| timeoutStart | (int) | Время отсрочки запуска группы после создания в секундах. |
+
+## Возвращаемые значения модуля decort_group
+
+Модуль **decort_group** возвращает информацию о диске в виде словаря facts со следующими ключами:
+
+
+|Ключ |	Тип данных |	Описание|
+| ------ | ------ | ------ |
+| account_id | int | Идентификатор аккаунта. |
+| Computes | list | Список словарей, содержащих информацию о виртуальных машинах группы.<br>Ключи словаря:<br>&bull; `id` (int) - идентификатор ВМ<br>&bull; `ipAddresses` (list) - список IP-адресов ВМ<br>&bull; `name` (str) - имя ВМ<br>&bull; `osUsers` (list) - список словарей, содержащих учётные данные пользователей ОС ВМ по умолчанию; ключи: `login` (str) и `password` (str) |
+| id | int | Идентификатор группы.|
+| name | string | Имя группы.|
+| rg_id | int | Идентификатор ресурсной группы. |
+| state | string | Состояние группы. |
+| techStatus | string | Технический статус группы. |
+
+## Пример использования модуля decort_group
+
+Данный пример создаёт группу с именем `test_group`.
+```
+- hosts: localhost
+  tasks:
+  - name: Create BS group
+    decort_group:
+      app_id: "{{ my_app_id }}"
+      app_secret: "{{ my_app_secret }}"
+      authenticator: oauth2
+      boot_disk: 10
+      bservice_id: 1823
+      controller_url: "https://ds1.digitalenergy.online"
+      count: 2
+      cpu: 2
+      image_id: 518
+      name: test_group
+      networks:
+        - type: VINS
+          id: 1987
+      oauth2_url: "https://sso.digitalenergy.online"
+      ram: 2
+      verify_ssl: false
+    register: group_test
+```
+
+Данный пример удаляет группу с именем `test_group`.
+
+```
+- hosts: localhost
+  tasks:
+  - name: Delete BS group 
+    decort_group:
+      app_id: "{{ my_app_id }}"
+      app_secret: "{{ my_app_secret }}"
+      authenticator: oauth2
+      bservice_id: 1823
+      controller_url: "https://ds1.digitalenergy.online"
+      name: test_group
+      oauth2_url: "https://sso.digitalenergy.online"
+      state: absent
+      verify_ssl: False
+    register: group_test
+```

wiki/7.0.0/модуль-decort_jwt.md

@@ -0,0 +1,48 @@
+# Модуль decort_jwt
+## Обзор модуля
+Модуль **decort_jwt** предназначен для получения авторизационного токена JWT (JSON Web Token). Данный модуль может быть полезен при массовом создании ресурсов (например, виртуальных машин), так как позволяет оптимизировать количество API вызовов для получения токена.
+
+По сути, данный модуль является провайдером информации и не управляет облачными ресурсами (всегда возвращает `changed: False`).
+
+## Параметры модуля decort_jwt
+Список параметров для модуля **decort_jwt** почти полностью совпадает с [общими параметрами модулей для авторизации](./введение.md#общие-параметры-модулей-для-авторизации).
+
+Отличия от общих параметров:
+- Параметр `controller_url` не используется.
+- Параметр `jwt` не используется.
+- В параметре `authenticator` не используется значение `jwt`.
+
+## Возвращаемые значения модуля decort_jwt
+| Ключ | Тип данных | Описание |
+|---| ------ | ------ |
+| jwt | str | JWT токен. |
+
+## Примеры использования
+### Пример получения JWT токена с помощью DECS3O
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Obtain JWT from DECS3O
+      decort_jwt:
+        app_id: "{{ app_id }}"
+        app_secret: "{{ app_secret }}"
+        authenticator: decs3o
+        oauth2_url: https://sso-dynamix.local
+```
+
+### Пример получения JWT токена с помощью BVS
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Obtain JWT from BVS
+      decort_jwt:
+        app_id: "{{ app_id }}"
+        app_secret: "{{ app_secret }}"
+        authenticator: bvs
+        oauth2_url: https://bvs.local
+        domain: dynamix
+        username: "{{ username }}"
+        password: "{{ password }}"
+```

wiki/7.0.0/модуль-decort_k8s.md

@@ -0,0 +1,112 @@
+# Модуль decort_k8s
+## Обзор модуля decort_k8s
+
+Модуль **decort_k8s** предназначен для выполнения следующих действий над кластерами Kubernetes:
+- создать
+- получить информацию
+- отключить/включить/запустить
+- изменить группы Worker-узлов
+- удалить (в корзину или безвозвратно)
+- восстановить из корзины
+
+## Параметры модуля decort_k8s 
+Ниже приведен список параметров для модуля **decort_k8s** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+| Параметр | Тип, допустимые значения | Описание |
+| ------ | ------ | ------ |
+| account_id | (int) | Идентификатор аккаунта. |
+| account_name | (string) | Имя аккаунта. |
+| additionalSANs | (list) | Список дополнительных SAN (Subject Alternative Names) для использования в процессе автоматического выписывания сертификата Кластера Kubernetes. Можно использовать IP-адреса и доменные имена.
+| cluster_conf | (dict) | Словарь с глобальными настройками и конфигурацией для всего кластера. Включает в себя такие настройки, как имя кластера, настройки DNS, методы аутентификации и другие конфигурации всего кластера. |
+| description | (string)<br>Default: `Created by decort ansible module` | Описание кластера. |
+| extnet_id | (int)<br>Default: `0` | Идентификатор внешней сети. Если задан `0`, то внешняя сеть выбирается автоматически. Если задан параметр `vins_id`, то значение данного параметра будет проигнорировано. Если задан `extnet_only: false`, то внешняя сеть будет подключена к создаваемой внутренней сети, а если `extnet_only: true`, то либо напрямую к каждому узлу кластера (если `with_lb: false`), либо напрямую к балансировщику нагрузки (если `with_lb: true`). |
+| extnet_only | (bool)<br>Default: `false` | Не использовать внутреннюю сеть, подключать напрямую к внешней. |
+| getConfig | (bool)<br>Default: `false` | Получить данные конфигурации для доступа к кластеру Kubernetes. |
+| ha_lb | (bool)<br>Default: `false` | Использовать схему высокой доступности для создаваемого балансировщика нагрузки (если `with_lb: true`). |
+| id | (int) | Идентификатор кластера Kubernetes. |
+| init_conf | (dict) | Словарь для определения настроек и действий, которые должны быть выполнены перед запуском любого другого компонента в кластере. Позволяет настраивать такие процессы, как регистрация узла, настройка сети и другие задачи инициализации.
+| join_conf | (dict) | Словарь для настройки поведения и параметров присоединения узла к кластеру. Включает в себя такие параметры, как control-plane-endpoint кластера, токен и certificate-key. |
+| k8ci_id | (int) | Идентификатор конфигурации кластера Kubernetes. |
+| kubeproxy_conf | (dict) | Словарь для настройки поведения и настроек Kube-proxy, отвечающего за сетевое проксирование и балансировку нагрузки внутри кластера. Включает в себя такие параметры, как режим прокси, диапазоны IP-адресов кластера и другие конфигурации, специфичные для Kube-proxy. |
+| kublet_conf | (dict) | Словарь для настройки поведения и настроек Kubelet, который является агентом основного узла, работающим на каждом узле кластера. Включает в себя такие параметры, как IP-адрес узла, распределение ресурсов, политики вытеснения модулей и другие конфигурации, специфичные для Kubelet. |
+| master_chipset | (string)<br>Значения:<br>`Q35`<br>`i440fx` | Эмулируемый чипсет master-узлов. Не применим при изменении существующего кластера. <br>Значение по умолчанию при создании: `i440fx`. |
+| master_count | (int)<br>Default: `1` | Количество Master-узлов. |
+| master_cpu | (int)<br>Default: `2` | Количество виртуальных процессоров на Master-узле. |
+| master_disk | (int)<br>Default: `10` | Объём загрузочного диска на Master-узле. |
+| master_pool | (str) | Пул СХД, заданной параметром `master_sepid`. |
+| master_ram | (int)<br>Default: `2048` | Объём оперативной памяти на Master-узле. |
+| master_sepid | (int) | Идентификатор СХД для Master-узла. Если не задан, то используется СХД образа Master-узла. |
+| name | (string) | Имя кластера Kubernetes. |
+| network_plugin | (str)<br>Значения:<br>`flannel`<br>`calico`<br>`weavenet`<br>Default: `flannel` | CNI plugin (модуль для управления сетевыми интерфейсами контейнера). Возможные значения могут быть ограничены в используемой конфигурации кластера Kubernetes (параметр `k8ci_id`) |
+| oidc_cert | (raw) | Сертификат X.509 для OIDC-провайдера.
+| permanent | (bool)<br>Default: `false` | Если выполняется удаление, то выполнить безвозвратное удаление (минуя корзину). |
+| rg_id | (int) | Идентификатор ресурсной группы. |
+| rg_name | (str) | Имя ресурсной группы. |
+| started | (bool)<br>Default: `true` | Запустить кластер.<br>Используется только для существующего кластера. |
+| state | (string)<br>Значения:<br>`present`<br>`absent`<br>`enabled`<br>`disabled`<br>`check`<br>Default: `present` | Целевое состояние кластера. |
+| vins_id | (int) | Идентификатор внутренней сети. Если не задан, то будет создана новая внутренняя сеть. Если задан, то заданная внутренняя сеть должна иметь подключение к внешней сети. Если задано `extnet_only: true`, то параметр игнорируется.
+| with_lb | (bool)<br>Default: `true` | Создание кластера Kubernetes с размещением Master-узлов за балансировщиком нагрузки. В ином случае каждый узел получит отдельный адрес из внешней сети.
+| workers | (list) | Список словарей, описывающих группы Worker-узлов.<br>Ключи словаря:<br>&bull; `annotations` (list) (необязательный) - список строк с annotations в формате: `key1=value1`; значение по умолчанию при создании: `[]`<br>&bull; `chipset` (str) (необязательный) - эмулируемый чипсет. Допустимые значения: `Q35`, `i440fx`; значение по умолчанию при создании: `i440fx`<br>&bull; `ci_user_data` (dict) (необязательный) - конфигурация для cloud-init; значение по умолчанию при создании: `{}`<br>&bull; `cpu` (int) (необязательный) - количество виртуальных процессоров на узле; значение по умолчанию при создании: `1`<br>&bull; `disk` (int) (необязательный) - объём загрузочного диска на узле;  если не задан при создании, размер диска будет равен размеру используемого образа<br>&bull; `labels` (list) (необязательный) - список строк с labels в формате: `label1=value1`;  значение по умолчанию при создании: `[]`. Метка `workersGroupName` является служебной в платформе и игнорируется при сравнении переданных меток с существующими<br>&bull; `name` (string) (обязательный) - имя группы Worker-узлов<br>&bull; `num` (int) (необязательный) - количество узлов;  значение по умолчанию при создании: `1`<br>&bull; `pool` (str) (необязательный) - пул СХД, заданной ключом `sep_id`; если не задан при создании, то пул будет выбран платформой<br>&bull; `ram` (int) (необязательный) - объём оперативной памяти на узле;  значение по умолчанию при создании: `1024`<br>&bull; `sep_id` (int) (необязательный) - идентификатор СХД; если не задан при создании, то используется СХД образа узла<br>&bull; `taints` (list) (необязательный) - список строк с taints в формате: `key1=value1:NoSchedule`; значение по умолчанию при создании: `[]`. |
+
+## Возвращаемые значения модуля decort_k8s
+
+Модуль **decort_k8s** возвращает информацию о кластере в виде словаря `facts` со следующими ключами:
+
+
+| Ключ | Тип  данных | Описание |
+| ------ | ------ | ------ |
+| account_id | int | Идентификатор аккаунта. |
+| config | str | Kuber config кластера.
+| id |	int | Идентификатор кластера. |
+| k8s_Masters | dict | Словарь с информацией о группе Master-узлов.<br>Ключи словаря:<br>&bull; `cpu` (int) - количество виртуальных процессоров<br>&bull; `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ<br>&bull; `disk` (int) - объём загрузочного диска<br>&bull; `id` (int) - идентификатор группы<br>&bull; `name` (str) - имя группы<br>&bull; `num` (int) - количество узлов<br>&bull; `ram` (int) - объём оперативной памяти
+| k8s_Workers | dict | Список словарей с информацией о группах Worker-узлов.<br>Ключи словаря:<br>&bull; `cpu` (int) - количество виртуальных процессоров<br>&bull; `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ<br>&bull; `disk` (int) - объём загрузочного диска<br>&bull; `id` (int) - идентификатор группы<br>&bull; `labels` (list) - список строк с labels<br>&bull; `name` (str) - имя группы<br>&bull; `num` (int) - количество узлов<br>&bull; `ram` (int) - объём оперативной памяти<br>&bull; `taints` (list) - список строк с taints
+| name | string | Имя кластера. |
+| rg_id | int | Идентификатор ресурсной группы. |
+| state | string |  Статус кластера. |
+| techStatus | string | Технический статус кластера. |
+| vins_id | int | Идентификатор внутренней сети кластера. |
+
+
+## Пример использования модуля decort_k8s 
+
+
+Пример создания кластера Kubernetes с именем `cluster-test` с получением Kuber config.
+```
+  - name: Create a k8s cluster named cluster-test
+    decort_k8s:
+      authenticator: jwt
+      controller_url: "https://ds1.digitalenergy.online"
+      getConfig: true
+      jwt: "{{ token.jwt }}"
+      k8ci_id: 18
+      name: cluster-test
+      rg_id:  125
+      workers:
+        - cpu: 10
+          disk: 10
+          name: wg1
+          num: 1
+          ram: 1024
+          chipset: i440fx
+          ci_user_data: {}
+          taints: 
+            - key=value:NoSchedule
+          annotations:
+            - key=value
+          labels: 
+            - label=value
+        - cpu: 10
+          disk: 10
+          name: wg2
+          num: 2
+          ram: 1024
+          chipset: Q35
+          ci_user_data: {}
+          taints: 
+            - key=value:NoSchedule
+          annotations:
+            - key=value
+          labels: 
+            - label=value
+    register: k8s_cluster
+```

wiki/7.0.0/модуль-decort_kvmvm.md

@@ -0,0 +1,887 @@
+# Модуль decort_kvmvm
+## Обзор модуля decort_kvmvm
+
+Модуль **decort_kvmvm** предназначен для выполнения следующих действий над виртуальными машинами:
+- **создать** (см. [примеры](#создать))
+  - **с указанием описания** (см. параметр **description** и [примеры](#с-указанием-описания))
+  - **с указанием объёма загрузочного диска** (см. параметр **boot_disk** и [примеры](#с-указанием-объёма-загрузочного-диска))
+  - **с указанием СХД** (см. параметры **sep_id** и **pool** и [примеры](#с-указанием-схд))
+  - **с указанием Cloud-init user data** (см. параметр **ci_user_data** и [примеры](#с-указанием-cloud-init-user-data))
+  - **с указанием SSH-ключа** (см. параметры **ssh_key** и **ssh_key_user** и [примеры](#с-указанием-ssh-ключа))
+  - **с указанием NUMA Affinity** (см. параметр **numa_affinity** и [примеры](#с-указанием-numa-affinity))
+  - **с указанием запуска на выделенных процессорах** (см. параметр **cpu_pin** и [примеры](#с-указанием-запуска-на-выделенных-процессорах))
+  - **с использованием Huge Pages** (см. параметр **hp_backed** и [примеры](#с-использованием-huge-pages))
+  - **с указанием custom_fields** (см. параметр **custom_fields** и [примеры](#с-указанием-custom_fields))
+  - **с указанием affinity-метки** (см. параметр **affinity_label** и [примеры](#с-указанием-affinity-метки))
+  - **с указанием affinity правил** (см. параметр **aff_rule** и [примеры](#с-указанием-affinity-правил))
+  - **с указанием anti-affinity правил** (см. параметр **aaff_rule** и [примеры](#с-указанием-anti-affinity-правил))
+  - **с указанием тэгов** (см. параметр **tag** и [примеры](#с-указанием-тэгов))
+  - **с образом** (см. параметры **image_id** и **image_name** и [примеры](#с-образом))
+  - **без образа** (см. параметры **image_id** и **image_name** и [примеры](#без-образа))
+    - **с загрузочным диском** (см. параметр **boot_disk** и [примеры](#с-загрузочным-диском))
+    - **без загрузочного диска** (см. параметр **boot_disk** и [примеры](#без-загрузочного-диска))
+  - **с включением автоматического запуска ВМ после перезапуска вычислительного узла, за которым она закреплена** (см. параметр **auto_start** и [примеры](#с-включением-автоматического-запуска-вм-после-перезапуска-вычислительного-узла-за-которым-она-закреплена))
+- **получить информацию** (см. [возвращаемые значения](#возвращаемые-значения-модуля-decort_kvmvm) и [примеры](#получение-основной-информации-о-виртуальной-машине))
+- **остановить/приостановить/запустить** (см. параметр **state** и [примеры](#остановитьприостановитьзапустить))
+- **подключить/отключить диски с данными** (см. параметр **data_disks** и [примеры](#подключитьотключить-диски-с-данными))
+- **подключить/отключить сети** (см. параметры **networks** и **network_order_changing** и [примеры](#подключитьотключить-сети))
+- **изменить** (см. [примеры](#изменить))
+  - **объём загрузочного диска в большую сторону** (см. параметр **boot_disk** и [примеры](#объём-загрузочного-диска-в-большую-сторону))
+  - **количество CPU** (см. параметр **cpu** и [примеры](#количество-cpu))
+  - **объём ОЗУ** (см. параметр **ram** и [примеры](#объём-озу))
+  - **тэги** (см. параметр **tag** и [примеры](#тэги))
+  - **affinity метку** (см. параметр **affinity_label** и [примеры](#affinity-метку))
+  - **affinity правила** (см. параметр **aff_rule** и [примеры](#affinity-правила))
+  - **anti-affinity правила** (см. параметр **aaff_rule** и [примеры](#anti-affinity-правила))
+  - **описание** (см. параметр **description** и [примеры](#описание))
+  - **чипсет** (см. параметр **chipset** и [примеры](#чипсет))
+  - **правило NUMA Affinity** (см. параметр **numa_affinity** и [примеры](#правило-numa-affinity))
+  - **использование CPU Pinning** (см. параметр **cpu_pin** и [примеры](#использование-cpu-pinning))
+  - **использование Huge Pages** (см. параметр **hp_backed** и [примеры](#использование-huge-pages))
+  - **имя** (см. параметр **name** и [примеры](#имя))
+  - **XML виртуальной машины** (см. параметр **custom_fields** и [примеры](#xml-виртуальной-машины))
+  - **автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена** (см. параметр **auto_start** и [примеры](#автоматический-запуск-вм-после-перезапуска-вычислительного-узла-за-которым-она-закреплена))
+- **удалить (безвозвратно)** (см. параметр **state** и [примеры](#безвозвратно))
+
+## Параметры модуля decort_kvmvm
+Ниже приведен список параметров для модуля **decort_kvmvm** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+| Параметр | Тип, допустимые значения | Описание |
+| ------ | ------ | ------ |
+| aaff_rule | (list) | Список словарей, описывающих anti-affinity правила.<br>Ключи словаря:<br>&bull; `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)<br>&bull; `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`<br>&bull; `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)<br>&bull; `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила<br>&bull; `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`).<br>Чтобы очистить anti-affinity правила, нужно указать пустой список `[]`. |
+| account_id | (int) | Идентификатор аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_id` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется.|
+| account_name | (string) | Имя аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_name` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется. |
+| aff_rule | (list) | Список словарей, описывающих affinity правила.<br>Ключи словаря:<br>&bull; `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)<br>&bull; `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`<br>&bull; `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)<br>&bull; `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила<br>&bull; `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`).<br>Чтобы очистить affinity правила, нужно указать пустой список `[]`. |
+| affinity_label | (str) | Метка affinity.<br>Чтобы очистить метку affinity, нужно указать пустую строку `""`. |
+| auto_start | (bool) | Включить/выключить автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена.<br> Если параметр не задан при создании ВМ, то значение будет выбрано платформой. |
+| boot_disk | (int) | Объём загрузочного диска виртуальной машины в ГБ. |
+| chipset | (string)<br>Значения:<br>`Q35`<br>`i440fx` | Эмулируемый чипсет. |
+| ci_user_data | (dict) | конфигурация для cloud-init
+| cpu | (int) | Количество виртуальных процессоров, выделяемых виртуальной машине. |
+| cpu_pin | (bool) | Запуск виртуальной машины на выделенных процессорах. Чтобы использовать эту функцию, система должна быть предварительно сконфигурирована путем выделения процессоров на физическом узле.<br>Значение по умолчанию при создании: `false`. |
+| custom_fields | (dict) | Словарь, управляющий XML виртуальной машины.<br>Ключи словаря:<br>&bull; `disable` (bool) - отключение управления виртуальной машиной через XML. Значение по умолчанию при создании: `true`<br>&bull; `fields` (dict) - поля для управления XML виртуальной машины. |
+| data_disks | (list) | Список идентификаторов дисков, которые следует подключить к данной виртуальной машине как дополнительные.<br>Чтобы отключить все диски, нужно указать пустой список `[]`.|
+| description | (string) | Опциональное описание виртуальной машины. |
+| hp_backed | (bool) | Использовать Huge Pages для выделения оперативной памяти виртуальной машины. Система должна быть предварительно сконфигурирована путем выделения Huge Pages на физическом узле. <br>Значение по умолчанию при создании: `false`.  |
+| id | (int) | Уникальный цифровой идентификатор виртуальной машины. Этот параметр используется как один из методов идентификации существующей ВМ (альтернатива – по комбинации `name`, `rg_name` и `account_name`). Если при вызове модуля **decort_kvmvm** существующая ВМ идентифицируется по `id`, то параметры `account_id`, `account_name`, `rg_id` и `rg_name` игнорируются. |
+| image_id | (int) | Уникальный цифровой идентификатор образа, на базе которого следует создать виртуальную машину. При создании задать этот параметр или параметр `image_name`. При любых других операциях данные параметры игнорируются. Если заданы оба этих параметра (`image_id` и `image_name`), то `image_name` игнорируется. |
+| image_name | (string) | Название образа, на базе которого следует создать ВМ. При создании требуется задать этот параметр или параметр `image_id`. При любых других операциях данные параметры игнорируются. |
+| name | (string) | Имя ВМ. Чтобы модуль **decort_kvmvm** мог управлять сервером по его названию, также необходимо задать комбинацию `account_name` и `rg_name` или `rg_id`. Если для существующей ВМ указаны и `name`, и `id`, то параметр `name` игнорируется и идентификация сервера выполняется по `id`.|
+| network_order_changing | (bool)<br>Default:<br>`false` | Соблюдение очерёдности сетей при их изменении.<br>Если `true`, то сравнение списка уже подключённых к ВМ сетей со списком из параметра `networks` будет производится <u>с учётом очерёдности сетей</u> и, <u>при выявлении несоответствия, сначала будет произведено отключение всех сетей от ВМ</u>, а затем подключение сетей в соответствии с параметром `networks`.<br> Если `false`, то очерёдность при сравнении учитываться не будет. Соответственно, сети, которые имеются в списке параметра `networks` и уже подключены к ВМ, переподключаться не будут, что может кратно уменьшить время выполнения изменения сетей. |
+| networks | (list) | Список словарей, описывающих сети ВМ.<br>Ключи словаря:<br>&bull; `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя), `EXTNET` (внешняя), `VFNIC` (вирт. функция), `DPDK`, `EMPTY` (без подключения к сети)<br>&bull; `id` (int) (необязательный) - идентификатор внутренней/внешней/DPDK сети или пула вирт. функций<br>&bull; `ip_addr` (string) (необязательный) - IP-адрес, используемый для подключения к данной сети; применимо только для `VINS` и `EXTNET`<br>&bull; `mtu` (int) (необязательный) - MTU интерфейса; применимо только для `DPDK`.<br>ВМ не может одновременно быть подключена к сети DPDK и к сети другого типа.<br>Чтобы отключить все сети, нужно указать пустой список `[]`. |
+| numa_affinity | (str)<br>Значения:<br>`strict`<br>`loose`<br>`none` | Правило применения NUMA affinity к виртуальной машине. <br>`strict` - строго с NUMA affinity, `loose` - использовать NUMA affinity, если возможно, `none` - отменить применение NUMA affinity. <br>Значение по умолчанию при создании: `none`. |
+| pool | (str) | Пул СХД, заданной параметром `sep_id`. Если пул не задан, то он будет выбран платформой.
+| ram | (int) | Объем оперативной памяти в МБ, выделенной данной ВМ. Параметр является обязательным при создании. Если указать его для уже существующей ВМ, то будет выполнена попытка изменить объем выделенной памяти. |
+| rg_id | (int) | Уникальный цифровой идентификатор уже существующей ресурсной группы, в которой будет создана новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ (альтернативой является задание комбинации `account_name` и `rg_name`).|
+| rg_name | (string) | Имя уже существующей ресурсной группы, в которой будет создаа новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ, когда задается пара `account_name` и `rg_name` (альтернативой является задание `rg_id`). Если заданы и `rg_id`, и `rg_name`, то параметр `rg_name` игнорируется.|
+| sep_id | (int) | Идентификатор СХД для загрузочного диска ВМ. Если не задан, то будет использоваться СХД образа.
+| ssh_key | (string) | Открытая часть SSH-ключа, который необходимо добавить на создаваемую ВМ для пользователя, заданного параметром `ssh_key_user`. Данный параметр применим только для ОС Linux, используется только при создании и игнорируется при других операциях. |
+| ssh_key_user | (string) | Имя пользователя в гостевой ОС (только для Linux), для которого добавляется SSH-ключ, заданный параметром `ssh_key`. Данный параметр является обязательным, если задан `ssh_key`. Используется только при создании и игнорируется при других операциях. |
+| state | (str)<br>Значения:<br>`present`<br>`absent`<br>`poweredon`<br>`poweredoff`<br>`halted`<br>`paused` | Целевое состояние ВМ.<br>`present` - виртуальная машина существует и не удалена. Если удалена в корзину, то будет восстановлена из корзины.<br>`absent` - виртуальная машина безвозвратно удалена. <br>`poweredon`  - виртуальная машина запущена. Если остановлена, то будет запущена. Если удалена в корзину, то будет восстановлена из корзины.<br>`poweredoff` - виртуальная машина остановлена. Если запущена, то будет остановлена.<br>`halted` - аналогично `poweredoff`.<br>`paused` - виртуальная машина приостановлена.<br>Значение по умолчанию при создании: `present`. |
+| tag | (dict) | Словарь, пары ключ-значение которого, описывают тэги для ВМ.<br>Чтобы очистить теги, нужно указать пустой словарь `{}`.|
+
+## Возвращаемые значения модуля decort_kvmvm
+
+Модуль **decort_kvmvm** возвращает информацию о виртуальной машине в виде словаря `facts` со следующими ключами:
+
+
+| Ключ | Тип данных | Описание |
+| ------ | ------ | ------ |
+| account_id | int | Идентификатор аккаунта. |
+| arch | string | Архитектура ВМ. |
+| auto_start | bool | Автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена. |
+| chipset | string | Эмулируемый чипсет. |
+| cpu | int | Количество виртуальных процессоров. |
+| cpu_pin | bool | Запуск виртуальной машины на выделенных процессорах. |
+| custom_fields | dict | Словарь, управляющий XML виртуальной машины. Если `null`, то управление виртуальной машиной через XML отключено, иначе - управление через XML включено. |
+| data_disks | list | Список идентификаторов дисков с данными, подключенных к ВМ. |
+| disk_size | int | Размер загрузочного диска в ГБ. |
+| hp_backed | bool | Использовать Huge Pages для выделения оперативной памяти виртуальной машины. |
+| id | int | Идентификатор ВМ. |
+| image_id | id | Идентификатор образа.
+| interfaces | list | Список словарей, описывающих сетевые интерфейсы ВМ. |
+| name | string | Имя ВМ. |
+| numa_affinity | str | Правило применения NUMA affinity к виртуальной машине. |
+| password | string | Пароль пользователя ОС по умолчанию. |
+| private_ips | list | Список IP-адресов на сетевых интерфейсах ВМ, которые подключены к внутренним сетям. |
+| public_ips | list | Список IP адресов на сетевых интерфейсах ВМ, которые подключены к внешним сетям. |
+| ram | int | Объём ОЗУ ВМ в МБ. |
+| rg_id | int | Идентификатор ресурсной группы, которой принадлежит данная ВМ. |
+| state | string | Состояние ВМ.|
+| tags | dict | Словарь, пары ключ-значение которого, описывают тэги ВМ.
+| tech_status | str | Технический статус ВМ.
+| username | string | Имя пользователя ОС по умолчанию. |
+| vnc_password | string | Пароль, используемый для подключения к ВМ через VNC. |
+
+## Примеры использования
+
+### Создать
+
+#### С указанием описания
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        chipset: Q35
+        description: vm description
+        state: present
+```
+
+#### С указанием объёма загрузочного диска
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        chipset: Q35
+        boot_disk: 10
+        state: present
+```
+
+#### С указанием СХД
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        chipset: Q35
+        sep_id: "{{ sep_id }}"
+        pool: "{{ sep_pool_name }}"
+        state: present
+```
+
+#### С указанием Cloud-init user data
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        chipset: Q35
+        ci_user_data: 
+          packages:
+            - apache2
+          write_files:
+            - content: |
+                <div>
+                Hello World!
+                </div>
+              owner: user:user
+              path: /var/www/html/index.html
+          hostname: test-apache
+          ssh_keys:
+            - rsa_public: ssh-rsa AAAAOasDmLxnD=  user@pc
+        state: present
+```
+
+#### С указанием SSH-ключа
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        chipset: Q35
+        ssh_key: ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAA...
+        ssh_key_user: user
+        state: present
+```
+
+#### С указанием NUMA Affinity
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        chipset: Q35
+        numa_affinity: strict
+        state: present
+```
+
+#### С указанием запуска на выделенных процессорах
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        chipset: Q35
+        cpu_pin: true
+        state: present
+```
+
+#### С использованием Huge Pages
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        chipset: Q35
+        hp_backed: true
+        state: present
+```
+
+#### С указанием custom_fields
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        custom_fields:
+          fields:
+            title: Title
+            cpu:
+              mode: custom
+              vendor: Intel
+              cache:
+                mode: disable
+              topology:
+                sockets: 1
+                cores: 14
+                threads: 1
+              match: minimum
+              check: partial
+        state: present
+```
+
+#### С указанием affinity-метки
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with affinity-label
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        chipset: Q35
+        affinity_label: label
+        state: present
+```
+
+#### С указанием affinity правил
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with affinity rules
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        chipset: Q35
+        aff_rule:
+          - topology: compute
+            policy: RECOMMENDED
+            mode: EQ
+            key: key
+            value: value
+        state: present
+```
+
+#### С указанием anti-affinity правил
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with anti-affinity rules
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        chipset: Q35
+        aaff_rule:
+          - topology: node
+            policy: REQUIRED
+            mode: ANY
+            key: key
+            value: value
+        state: present
+```
+
+#### С указанием тэгов
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with tags
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        chipset: Q35
+        tag: 
+          tag1_key: tag1_value
+          tag2_key: tag2_value
+        state: present
+```
+
+#### С образом
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        chipset: Q35
+        state: present
+```
+
+#### Без образа
+
+##### С загрузочным диском
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM without image and with boot disk
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        chipset: Q35
+        boot_disk: 10
+        state: present
+```
+
+##### Без загрузочного диска
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM without image and without boot disk
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        chipset: Q35
+        state: present
+```
+
+#### С включением автоматического запуска ВМ после перезапуска вычислительного узла, за которым она закреплена
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        chipset: Q35
+        auto_start: true
+        state: present
+```
+
+### Получение основной информации о виртуальной машине
+
+#### По идентификатору
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Get basic VM info by ID
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+```
+
+#### По имени
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Get basic VM info by name
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+```
+
+### Остановить/приостановить/запустить
+
+#### Остановить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Stop VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        state: poweredoff
+```
+
+#### Запустить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Start VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        state: poweredon
+```
+
+#### Приостановить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Pause VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        state: paused
+```
+
+### Подключить/отключить диски с данными
+
+#### Подключить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Connect data disks to VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        data_disks:
+          - "{{ datadisk1_id }}"
+          - "{{ datadisk2_id }}"
+```
+
+#### Отключить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Disconnect data disks from VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        data_disks: []
+```
+
+### Подключить/отключить сети
+
+#### Подключить не-DPDK сети
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Connect networks to VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        networks:
+          - type: VINS
+            id: "{{ vins_id }}"
+            ip_addr: 192.168.4.0
+          - type: EMPTY
+          - type: EXTNET
+            id: "{{ extnet_id }}"
+            ip_addr: 35.21.230.0
+          - type: VFNIC
+            id: "{{ vfpool_id }}"
+        state: poweredoff
+```
+
+#### Подключить не-DPDK сети с соблюдением очередности
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Connect networks to VM without network order changing
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        networks:
+          - type: VINS
+            id: "{{ vins_id }}"
+            ip_addr: 192.168.4.0
+          - type: EMPTY
+          - type: EXTNET
+            id: "{{ extnet_id }}"
+            ip_addr: 35.21.230.0
+          - type: VFNIC
+            id: "{{ vfpool_id }}"
+        network_order_changing: true
+        state: poweredoff
+```
+
+#### Подключить DPDK сети
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Connect DPDK networks to VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        networks:
+          - type: DPDK
+            id: "{{ dpdk1_id }}"
+          - type: EMPTY
+          - type: DPDK
+            id: "{{ dpdk2_id }}"
+            mtu: 1500
+        state: poweredoff
+```
+
+#### Отключить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Disconnect networks from VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        networks: []
+        state: poweredoff
+```
+
+### Изменить
+
+#### Объём загрузочного диска в большую сторону
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Increase boot disk size
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        boot_disk: 15
+        state: poweredoff
+```
+
+#### Количество CPU
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change CPU amount
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        cpu: 1
+        state: poweredoff
+```
+
+#### Объём ОЗУ
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change RAM size
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        ram: 512
+        state: poweredoff
+```
+
+#### Тэги
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change tags
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        tag:
+          tag1_key: tag1_value
+          tag2_key: tag2_value
+```
+
+#### Affinity метку
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change affinity label
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        affinity_label: Affinity label 1
+```
+
+#### Affinity правила
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change affinity rules
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        aff_rule:
+          - topology: compute
+            policy: REQUIRED
+            mode: EQ
+            key: app
+            value: main
+          - topology: node
+            policy: RECOMMENDED
+            mode: NE
+            key: state
+            value: started
+```
+
+#### Anti-affinity правила
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change anti-affinity rules
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        aaff_rule:
+          - topology: compute
+            policy: REQUIRED
+            mode: ANY
+            key: app
+            value: main
+```
+
+#### Описание
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change description
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        description: vm description
+```
+
+#### Чипсет
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change chipset
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        chipset: i440fx
+        state: poweredoff
+```
+
+#### Правило NUMA Affinity
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change NUMA affinity rule
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        numa_affinity: loose
+        state: poweredoff
+```
+
+#### Использование CPU Pinning
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change CPU Pinning usage
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        cpu_pin: true
+        state: poweredoff
+```
+
+#### Использование Huge Pages
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change Huge Pages usage
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        hp_backed: true
+        state: poweredoff
+```
+
+#### Имя
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Rename VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        name: "{{ new_vm_name }}"
+```
+
+#### XML виртуальной машины
+
+##### Изменение
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change XML management
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        custom_fields: 
+          fields:
+            cpu:
+              mode: custom
+              vendor: Intel
+              cache:
+                mode: enable
+            os:
+              type:
+                machine: pc-i440fx-artful
+```
+
+##### Отключение управления ВМ через XML
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Disable XML management
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        custom_fields: 
+          disable: true
+```
+
+#### Автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена
+
+##### Включить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Enable auto starting pinned VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        auto_start: true
+```
+
+##### Выключить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Disable auto starting of pinned VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        auto_start: false
+```
+
+### Удалить
+
+#### Безвозвратно
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Delete VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        state: absent
+```

wiki/7.0.0/модуль-decort_lb.md

@@ -0,0 +1,782 @@
+# Модуль decort_lb
+## Обзор модуля decort_lb
+
+Модуль **decort_lb** предназначен для выполнения следующих действий над балансировщиками нагрузки:
+- создать
+- получить информацию
+- отключить/включить/запустить/перезапустить
+- изменить конфигурации backend и frontend
+- удалить (в корзину или безвозвратно)
+- восстановить из корзины
+
+## Параметры модуля decort_lb 
+Ниже приведен список параметров для модуля **decort_lb** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+<table>
+  <tr>
+    <th colspan="3">Параметр</th>
+    <th>Тип</th>
+    <th>Описание</th>
+  </tr>
+  <tr>
+    <td colspan="3">
+      account_id
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Идентификатор аккаунта.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      account_name
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Имя аккаунта.
+      <br> Может быть альтернативой параметру <code>account_id</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      description
+    </td>
+    <td>
+      (str)
+      <br>Default: <code>Managed by Ansible module decort_lb</code>
+    </td>
+    <td>
+      Описание балансировщика.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      backends
+    </td>
+    <td>
+      (list)
+    </td>
+    <td>
+      Список словарей, описывающих конфигурации backend.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="2">
+      algorithm
+    </td>
+    <td>
+      (str)
+      <br>Значения:
+      <br><code>leastconn</code>
+      <br><code>roundrobin</code>
+      <br><code>static-rr</code>
+      <br>Default: <code>roundrobin</code>
+    </td>
+    <td>
+      Используемый алгоритм.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="2">
+      <a name="backend_default_settings">
+        default_settings
+      </a>
+    </td>
+    <td>
+      (dict)
+    </td>
+    <td>
+      Cловарь, описывающий параметры по умолчанию для backend-серверов.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      downinter
+    </td>
+    <td>
+      (int)
+      <br>Default: <code>1000</code>
+    </td>
+    <td>
+      Интервал в миллисекундах между двумя последовательными проверками
+        доступности сервера, который считается недоступным.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      fall
+    </td>
+    <td>
+      (int)
+      <br>Default: <code>2</code>
+    </td>
+    <td>
+      Количество последовательных неудачных проверок доступности, после
+        которых сервер, ранее считавшийся доступным, начинает считаться
+        недоступным и временно исключается из схемы балансировки.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      inter
+    </td>
+    <td>
+      (int)
+      <br>Default: <code>5000</code>
+    </td>
+    <td>
+      Интервал в миллисекундах между двумя последовательными проверками
+        доступности сервера, который считается доступным.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      maxconn
+    </td>
+    <td>
+      (int)
+      <br>Default: <code>250</code>
+    </td>
+    <td>
+      Лимит одновременных подключений к серверу. При достижении этого лимита
+        сервер временно исключается из схемы балансировки.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      maxqueue
+    </td>
+    <td>
+      (int)
+      <br>Default: <code>256</code>
+    </td>
+    <td>
+      Лимит соединений, ожидающих в очереди. Когда этот предел будет
+        достигнут, все последующие подключения будут перенаправлены
+        на другие серверы.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      rise
+    </td>
+    <td>
+      (int)
+      <br>Default: <code>2</code>
+    </td>
+    <td>
+      Количество проверок, которые должен пройти сервер, считавшийся
+      недоступным, чтобы начать считаться доступным и снова быть
+      включенным в схему балансировки.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      slowstart
+    </td>
+    <td>
+      (int)
+      <br>Default: <code>60000</code>
+    </td>
+    <td>
+      Интервал в миллисекундах с момента когда сервер начинает считаться
+        доступным, по истечении которого количество фактически разрешенных
+        подключений к этому серверу будет возвращено до 100% от
+        установленного лимита.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      weight
+    </td>
+    <td>
+      (int)
+      <br>Default: <code>100</code>
+    </td>
+    <td>
+      Вес сервера для использования в алгоритмах балансировки.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="2">
+      name
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Название backend. Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      ext_net_id
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Идентификатор внешней сети.
+      <br>Может быть не задан, если задан <code>vins_id</code> -
+        в таком случае балансировщик будет подключён только к
+        внутренней сети.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      <a name="frontends">
+        frontends
+      </a>
+    </td>
+    <td>
+      (list)
+    </td>
+    <td>
+      Список словарей, описывающих конфигурации frontend.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="2">
+      backend
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Название используемого backend. Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="2">
+      bindings
+    </td>
+    <td>
+      (list)
+    </td>
+    <td>
+      Список словарей, описывающих конфигурации binding. 
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      address
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      IP-адрес.
+      <br>Если не задан, то будет использоваться основной IP-адрес
+        балансировщика во внешней сети или, если подключена только
+        внутренняя сеть, основной IP-адрес балансировщика во внутренней сети.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      name
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Название. Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      port
+    </td>
+    <td>
+      (int)
+      <br>Значения:
+      <br><code>1</code>-<code>65535</code>
+    </td>
+    <td>
+      Порт. Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      ha_lb
+    </td>
+    <td>
+      bool
+      <br>Default: <code>false</code>
+    </td>
+    <td>
+      Использовать схему высокой доступности для создаваемого балансировщика.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      lb_id
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Идентификатор балансировщика нагрузки.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      lb_name
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Имя балансировщика.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      permanently
+    </td>
+    <td>
+      (bool)
+      <br>Default: <code>false</code>
+    </td>
+    <td>
+      Если выполняется удаление, то выполнить безвозвратное удаление
+        (минуя корзину).
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      rg_id
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Идентификатор ресурсной группы.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      rg_name
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Имя ресурсной группы.
+      <br> В комбинации с заданным аккаунтов может быть альтернативой
+        параметру <code>rg_id</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      servers
+    </td>
+    <td>
+      (list)
+    </td>
+    <td>
+      Список словарей, описывающих конфигурации backend-серверов.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="2">
+      address
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      IP-адрес. Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="2">
+      backends
+    </td>
+    <td>
+      (list)
+    </td>
+    <td>
+      Список словарей, описывающих параметры backend-сервера для разных
+        конфигураций backend.
+      <br>Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      check
+    </td>
+    <td>
+      (str)
+      <br>Значения:
+      <br><code>enabled</code>
+      <br><code>disabled</code>
+      <br>Default: <code>enabled</code>
+    </td>
+    <td>
+      Проверка доступности сервера.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      name
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Название конфигурации backend. Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      port
+    </td>
+    <td>
+      (int)
+      <br>Значения:
+      <br><code>1</code>-<code>65535</code>
+    </td>
+    <td>
+      Порт. Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      server_settings
+    </td>
+    <td>
+      (dict)
+    </td>
+    <td>
+      Словарь, описывающий параметры backend-сервера.
+      <br> Ключи данного словаря аналогичны ключам словаря
+      <a href=#backend_default_settings>
+        default_settings
+      </a>.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="2">
+      name
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Название. Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      state
+    </td>
+    <td>
+      (str)
+      <br>Значения:
+      <br><code>present</code>
+      <br><code>absent</code>
+      <br><code>enabled</code>
+      <br><code>disabled</code>
+      <br><code>restart</code>
+      <br>Default: <code>present</code>
+    </td>
+    <td>
+      Целевое состояние балансировщика нагрузки.
+      <br>Выполнение с <code>state=restart</code> позволяет выполнить
+        перезапуск балансировщика, соответственно, всегда возвращает
+        <code>changed: true</code>.
+      <br>Значения <code>present</code> и <code>enabled</code> равнозначны
+        и соответствуют включённому и запущенному балансировщику.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      vins_id
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Идентификатор внутренней сети.
+      <br>Может быть не задан, если задан <code>ext_net_id</code> -
+        в таком случае балансировщик будет подключён только к
+        внешней сети.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      vins_name
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Имя внутренней сети.
+      <br> В комбинации с заданной РГ может быть альтернативой для
+        параметра <code>vins_id</code>.
+    </td>
+  </tr>
+</table>
+
+## Возвращаемые значения модуля decort_lb
+
+Модуль **decort_lb** возвращает информацию о балансировщике в виде словаря `facts` со следующими ключами:
+
+<table>
+  <tr>
+    <th colspan="4">
+      Ключ
+    </th>
+    <th>
+      Тип
+      <br>данных
+    </th>
+    <th>
+      Описание
+    </th>
+  </tr>
+  <tr>
+    <td colspan="4">
+      backends
+    </td>
+    <td>
+      list
+    </td>
+    <td>
+      Список словарей, описывающих конфигурации backend.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="3">
+      algorithm
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Используемый алгоритм.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="3">
+      name
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Название конфигурации backend.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="3">
+      serverDefaultSettings
+    </td>
+    <td>
+      dict
+    </td>
+    <td>
+      Cловарь, описывающий параметры по умолчанию для backend-серверов.
+      <br> Ключи данного словаря аналогичны ключам словаря
+      <a href=#backend_default_settings>
+        default_settings
+      </a>.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="3">
+      servers
+    </td>
+    <td>
+      list
+    </td>
+    <td>
+      Список словарей, описывающих конфигурации backend-серверов.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td colspan="2">
+      address
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      IP-адрес.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td colspan="2">
+      check
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Проверка доступности сервера.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td colspan="2">
+      name
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Название.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td colspan="2">
+      port
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Порт.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td colspan="2">
+      serverSettings
+    </td>
+    <td>
+      dict
+    </td>
+    <td>
+      Cловарь, описывающий параметры backend-сервера.
+      <br> Ключи данного словаря аналогичны ключам словаря
+      <a href=#backend_default_settings>
+        default_settings
+      </a>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="4">
+      frontends
+    </td>
+    <td>
+      list
+    </td>
+    <td>
+      Список словарей, описывающих конфигурации frontend.
+      <br> Ключи данного словаря аналогичны ключам словарей списка
+      <a href=#frontends>
+        frontends
+      </a>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="4">
+      gid
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Идентификатор физического кластера (Grid ID).
+    </td>
+  </tr>
+  <tr>
+    <td colspan="4">
+      id
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Идентификатор балансировщика.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="4">
+      name
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Имя балансировщика.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="4">
+      rg_id
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Идентификатор ресурсной группы.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="4">
+      state
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Статус балансировщика.
+    </td>
+  </tr>
+</table>

wiki/7.0.0/модуль-decort_osimage.md

@@ -0,0 +1,124 @@
+# Модуль decort_osimage
+## Обзор модуля decort_osimage
+
+Модуль decort_osimage предназначен для выполнения следующих действий над образами, созданными в облачной платформе DECORT:
+- шаблонные образы:
+  - создать
+  - получить информацию
+  - изменить имя
+  - удалить
+- виртуальные образы
+  - создать
+  - получить информацию
+  - изменить
+    - имя
+    - целевой образ
+
+## Параметры модуля decort_osimage 
+Ниже приведен список параметров для модуля **decort_osimage** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+| Параметр | Тип, допустимые значения | Описание |
+| ------ | ------ | ------ |
+| account_Id | (int) | Уникальный целочисленный идентификатор аккаунта. Используется для поиска образов, а тажке для их создания. |
+| account_name | (string) | Имя аккаунта. Используется для получения уникального целочисленного идентификатора аккаунта. |
+| boottype | (string)<br>Default: `uefi` | Тип загрузки образа. Используется при создании образа.|
+| drivers | (string)<br>Default: `KVM_X86` | Тип виртуальных машин, подходящих для образа. Используется при создании образа.|
+| hotresize | (bool)<br>Default: `false` | Поддерживает ли образ "горячее" изменение размера. По умолчанию установлено `false`. Используется при создании образа операционной системы. |
+| image_id | (int) | Идентификатор шаблонного образа.
+| image_name | (str) | Имя шаблонного образа.
+| image_password | (string) | Опциональный пароль для образа. Используется при создании образа.|
+| image_username | (string) | Опциональное имя пользователя для образа. Используется при создании образа. |
+| imagetype | (string)<br>Default: `linux` | Тип образа. Используется при создании образа.|
+| passwordDL |  (string) | Пароль для скачивания по URL-адресу. Используется при создании образа. |
+| pool | (str) | Имя пула СХД. Используется для поиска существующего образа.
+| poolName | (string) | Имя пула СХД. Используется при создании образа. |
+| sepId | (integer) | Уникальный целочисленный идентификатор СХД. Используется при создании образа. |
+| sep_id | (int) | Идентификатор СХД. Используется для поиска существующего образа.
+| state | (string)<br>Значения:<br>`present`<br>`absent`<br>Default: `present` | Целевое состояние образа. `present` - существует, `absent` - удалён. |
+| url | (string) | URL-адрес, с которого будет загружен образ. Используется при создании образа.|
+| usernameDL | (string) | Имя пользователя для загрузки образа с заданного URL-адреса. Используется при создании образа. |
+| virt_id | (integer) | Уникальный целочисленный идентификатор виртуального образа. Может использоваться для получения информации о виртуальном образе, а также для привязки к нему другого образа.| 
+| virt_name | (string) | Имя виртуального образа. Используется для получения `virt_id`, а в последствии информации о виртуальном образе, а также для создания виртуального образа и привязки к нему другого образа.|
+
+
+## Возвращаемые значения модуля decort_osimage
+
+Модуль decort_osimage возвращает информацию об образе в виде словаря facts со следующими ключами:
+
+
+| Ключ | Тип  данных | Описание |
+| ------ | ------ | ------ |
+| accountId | int | Идентификатор аккаунта.
+| id | int | Уникальный целочисленный идентификатор данного образа. |
+| linkto | int | Уникальный целочисленный идентификатор образа, который привязан к данному виртуальному. |
+| name | string | Имя образа. |
+| pool | string | Имя пула на системе хранения данных, в котором находится данный образ.|
+| sep_id | int |	Идентификатор системы хранения данных, на которой хранится данный образ. |
+| size | int | Размер образа в ГБ. |
+| state | string |  Текущий статус образа. |
+| type | string | Тип образа. |
+
+
+
+## Пример использования модуля decort_osimage 
+
+
+Пример создания шаблонного образа с операционной системой Alpine Linux.
+```
+  - name: Create template image
+    decort_osimage:
+      account_Id: 12345
+      app_id: "{{ my_app_id }}"
+      app_secret: "{{ my_app_secret }}"
+      authenticator: oauth2
+      controller_url: "https://ds1.digitalenergy.online"
+      image_name: alpine_linux_3.19.1
+      url: https://dl-cdn.alpinelinux.org/alpine/v3.19/releases/cloud/nocloud_alpine-3.19.1-x86_64-uefi-cloudinit-r0.qcow2
+      verify_ssl: false
+    register: osimage
+```
+
+Пример получения информации о существующем шаблонном образе по его имени.
+
+```
+  - name: Get template image
+    decort_osimage:
+      account_Id: 12345
+      app_id: "{{ my_app_id }}"
+      app_secret: "{{ my_app_secret }}"
+      authenticator: oauth2
+      controller_url: "https://ds1.digitalenergy.online"
+      image_name: alpine_linux_3.19.1
+      verify_ssl: false
+    register: osimage
+```
+
+Пример создания виртуального образа. Также в случае, если виртуальный образ уже существует, но к нему привязан другой шаблонный образ, он привяжет к себе указанный в примере шаблонный образ.
+
+```
+  - name: Create virtual image 
+    decort_osimage:
+      app_id: "{{ my_app_id }}"
+      app_secret: "{{ my_app_secret }}"
+      authenticator: oauth2
+      controller_url: "https://ds1.digitalenergy.online"
+      image_name: alpine_linux_3.19.1
+      virt_name: alpine_last
+    register: osimage
+```
+Обратите внимание, что в данном примере можно использовать как `image_name`, так и `image_id`. Также можно использовать либо `virt_name`, либо `virt_id`.
+
+Пример переименования образа.
+
+```
+  - name: Rename template image 
+    decort_osimage:
+      app_id: "{{ my_app_id }}"
+      app_secret: "{{ my_app_secret }}"
+      authenticator: oauth2
+      controller_url: "https://ds1.digitalenergy.online"
+      image_name: alpine_linux_3.19.1_new_name
+      image_id: 54321
+    register: osimage
+```
+

wiki/7.0.0/модуль-decort_pfw.md

@@ -0,0 +1,66 @@
+# Модуль decort_pfw
+## Обзор модуля decort_pfw
+
+Модуль **decort_pfw** предназначен для настройки правил переадресации портов (port forwarding, destination NAT) на виртуальном маршрутизаторе заданной внутренней сети для заданной виртуальной машины.  
+Модуль поддерживает выполнение следующих действий над правилами:
+- добавить
+- получить информацию
+- удалить
+
+## Параметры модуля decort_pfw
+Ниже приведен список параметров для модуля **decort_pfw** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+| Параметр | Тип, допустимые значения | Описание|
+| ------ | ------ | ------ |
+| compute_id | (int) | Идентификатор виртуальной машины. IP-адрес, который данная ВМ имеет во внутренней сети, заданной параметром `vins_id`, будет использоваться как внутренний IP-адрес в правилах. Обязательный параметр. |
+| rules | (list) | Список словарей, описывающих правила переадресации портов для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`).<br>Ключи словаря:<br>&bull; `local_port` (int) (обязательный) - внутренний порт; значения: от `1` до `65535`<br>&bull; `proto` (str) (обязательный) - протокол; значения: `tcp` или `udp`<br>&bull; `public_port_end` (int) (необязательный) - верхняя граница диапазона внешних портов; значения: от значения ключа `public_port_start` до `65535`;<br>&bull; `public_port_start` (int) (обязательный) - нижняя граница диапазона внешних портов; значения: от `1` до `65535` |
+| state | (str)<br>Значения:<br/>`present`<br/>`absent`<br>Default: `present` | Целевое состояние правил.<br>Если `state=absent`, то, независимо от содержания параметра `rules`, будут удалены все правила для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`). |
+| vins_id | (int) | Идентификатор внутренней сети, на виртуальном маршрутизаторе которой настраиваются правила переадресации портов. Заданная ВМ (параметр `compute_id`) должна быть подключена к этой сети. Обязательный параметр. |
+
+
+## Возвращаемые значения модуля decort_pfw
+
+Модуль **decort_pfw** возвращает информацию о правилах переадресации портов и сопутствующую информацию в виде словаря `facts` со следующими ключами:
+
+
+|Ключ | Тип данных | Описание|
+| ------ | ------ | ------ |
+| compute_id | int | Идентификатор ВМ. |
+| public_ip | string | IP-адрес во внешней сети, настроенный на виртуальном маршрутизаторе внутренней сети. |
+| rules | list | Список словарей, описывающих правила переадресации портов.<br>Ключи словаря:<br>&bull; `id` (int) - идентификатор правила<br>&bull; `localIp` (str) - IP-адрес ВМ<br>&bull; `localPort` (int) - внутренний порт<br>&bull; `protocol` (str) - протокол<br>&bull; `publicPortEnd` (int) - верхняя граница диапазона внешних портов<br>&bull; `publicPortStart` (int) - нижняя граница диапазона внешних портов<br>&bull; `vmId` (int) - идентификатор ВМ<br>&bull; `vmName` (str) - имя ВМ |
+| state | string | Статус правил. Значения: `PRESENT` или `ABSENT`. |
+| vins_id | int | Идентификатор внутренней сети. |
+
+## Пример использования модуля decort_pfw
+
+В данном примере для существующей ВМ (параметр `compute_id`), подключённой к внутренней сети (параметр `vins_id`), настраиваются два правила переадресации портов:
+
+- Правило для одного порта: внешний порт `30022` на внутренний порт `22` по протоколу `tcp`.
+- Правило для диапазона портов: внешние порты с `30080` по `30085` на внутренние порты с `30080` по протоколу `udp`.
+
+```
+- name: Add port forwarding rules
+  decort_pfw:
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    authenticator: oauth2
+    compute_id: "{{ my_vm.facts.id }}"
+    controller_url: "https://cloud.digitalenergy.online"
+    oauth2_url: "https://sso.digitalenergy.online"
+    rules:
+      - local_port: 22
+        proto: tcp
+        public_port_start: 30022
+      - local_port: 30080
+        proto: udp
+        public_port_end: 30085
+        public_port_start: 30080
+    vins_id: "{{ my_vins.facts.id }}"
+  register: my_pfw_rules
+```
+
+В данном примере результат выполнения модуля **decort_pfw** записывается в переменную `my_pfw_rules`. Для доступа к списку правил используйте следующую конструкцию:
+
+```
+"{{ my_pfw_rules.facts.rules }}"
+```

wiki/7.0.0/модуль-decort_rg.md

@@ -0,0 +1,220 @@
+# Модуль decort_rg
+
+## Обзор модуля decort_rg
+
+Модуль decort_rg предназначен для создания, редактирования и удаления ресурсных групп (Resource Group, RG) в облачной платформе DECORT, а также для получения информации об уже существующей ресурсной группе. Модуль decort_rg позволяет:
+
+- создавать ресурсные группы
+- удалять ресурсные группы (в корзину или безвозвратно)
+- восстанавливать ресурсные группы из корзины
+- включать/отключать ресурсные группы
+- запрашивать информацию об уже существующих ресурсных группах
+- изменять ресурсные группы:
+  - переименовывать
+  - настраивать квоты
+  - задавать стандартную сеть
+  - настраивать права доступа для пользователей
+  - изменять доступные пулы СХД
+
+## Параметры модуля decort_rg
+Ниже приведен список параметров для модуля **decort_rg** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+| Параметр | Тип, допустимые значения | Описание |
+|----------|--------------------------|----------|
+| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то account_name игнорируется. |
+| account_name | (string) | Имя аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. |
+| access | (dict) | Параметр, позволяющий выдать, забрать или изменить права у пользователя в ресурсной группе. |
+| description | (string) | Текстовое описание ресурсной группы. Данный параметр является опциональным и учитывается только при создании ресурсной группы, а при всех прочих операциях игнорируется. |
+| def_netId | (int) | Уникальный целочисленный идентификатор внутренней или внешней сети. Используется для изменения сети по умолчанию в ресурсной группе. |
+| def_netType | (string) <br>Значения:<br>`PRIVATE`<br>`PUBLIC`<br>`NONE`<br>Default: `PRIVATE` | Тип сети по умолчанию в ресурсной группе. Используется при создании ресурсной группы, а также при изменении. |
+| extNetId | (int) | Уникальный целочисленный идентификатор внешней сети.<br>Если `def_netType: PRIVATE`, то указывает какую внешнюю сеть подключить к создаваемой внутренней сети, которая будет задана как сеть по умолчанию для создаваемой РГ.<br>Если `def_netType: PUBLIC`, то указывает какую внешнюю сеть задать как сеть по умолчанию для создаваемой РГ. |
+| extNetIp | (string) | IP-адрес для внешней сети, которая задана в параметре `extNetId`. |
+| ipcidr | (string) | IP-адрес внутренней сети. Используется при создании ресурсной группы, чтобы задать IP-адрес сети для создаваемой внутренней сети, которая создастся вместе с ресурсной группой. Используется при параметре `def_netType` в значении `PRIVATE`. |
+| owner | (string) | Владелец ресурсной группы. Задаётся при создании ресурсной группы, не обязателен. Если оставить пустое значение - владельцем ресурсной группы будет пользователь, создавший ресурсную группу. |
+| permanently | (bool)<br>Default: `false` | Параметр, использующийся при удалении ресурсной группы. При значении `true` - ресурсная группа удалится безвозвратно, а при `false` - попадёт в корзину. |
+| quotas | (dict) | Предназначено для задания или изменения квоты на ресурсы в составе данной ресурсной группы. |
+| rename | (string) | Новое имя ресурсной группы.<br>Возможно переименование только включенной ресурсной группы. |
+| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы. Является обязательным при изменении РГ если не заданы `rg_name` и `account_id`/`account_name` |
+| rg_name | (string) | Имя ресурсной группы. Данный параметр является обязательным при создании. |
+| sep_pools| (list) | Список словарей, описывающих доступные пулы СХД.<br>Ключи словаря:<br>&bull; `sep_id` (int) - идентификатор системы хранения данных.<br>&bull; `pool_names` (list) - список названий пулов системы хранения данных.<br>Чтобы очистить список доступных пулов, нужно указать пустой список `[]`.|
+| state | Значения:<br>`present`<br>`absent`<br>`enabled`<br>`disabled`<br>Default: `present` | Целевое состояние ресурсной группы. |
+
+## Возвращаемые значения модуля decort_rg
+
+Модуль decort_rg возвращает информацию о ресурсной группе в виде словаря facts со следующими ключами:
+| Ключ | Тип данных | Описание |
+|------|------------|----------|
+| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная ресурсная группа. |
+| gid | int | Идентификатор физического кластера (Grid ID), на базе которого развёрнута ресурсная группа. |
+| id | int | Уникальный целочисленный идентификатор ресурсной группы. |
+| name | string | Имя ресурсной группы. Обратите внимание, что это имя уникально только в рамках аккаунта, которому принадлежит данная ресурсная группа. |
+| state | string | Текущее состояние ресурсной группы. |
+| quota | dict | Текущие квоты ресурсной группы. |
+| resTypes | list | Список типов ресурсов, разрешенных к созданию в данной ресурсной группе. |
+| defNetId | int | Уникальный целочисленный идентификатор сети по умолчанию в данной ресурсной группе. |
+| defNetType | string | Тип сети по умолчанию в данной ресурсной группе. |
+| ViNS | list | Список идентификаторов внутренних сетей ресурсной группы. |
+| computes | list | Список идентификаторов виртуальных машин ресурсной группы. |
+| uniqPools | list | Список доступных пулов СХД. |
+
+## Пример использования модуля decort_rg
+
+В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount.
+
+```
+- name: manage resource group
+  decort_rg:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    account_name: "MyAccount"
+    rg_name: "MyRG"
+    state: present
+  register: my_rg
+  delegate_to: localhost
+```
+
+В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount, также задать квоты и выдать права на чтение пользователю MyUser.
+
+```
+- name: manage resource group
+  decort_rg:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    account_name: "MyAccount"
+    rg_name: "MyRG"
+    access:
+      action: "grant"
+      user: "MyUser"
+      right: "R"
+    quotas:
+      cpu: 16
+      ram: 16384
+      disk: 100
+      ext_ips: 20
+      net_transfer: 1000
+    state: present
+  register: my_rg
+  delegate_to: localhost
+```
+
+В данном примере показано, как выдать доступ на чтение и запись пользователю MyUser в ресурсной группе по имени MyRG в аккаунте MyAccount.
+
+```
+- name: manage resource group
+  decort_rg:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    account_name: "MyAccount"
+    rg_name: "MyRG"
+    access:
+      action: "grant"
+      user: "MyUser"
+      right: "RCX"
+    state: present
+  register: my_rg
+  delegate_to: localhost
+```
+
+В данном примере показано, как сменить квоту в ресурсной группе по имени MyRG в аккаунте MyAccount.
+
+```
+- name: manage resource group
+  decort_rg:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    account_name: "MyAccount"
+    rg_name: "MyRG"
+    quotas:
+      cpu: 16
+      ram: 16384
+      disk: 100
+      ext_ips: 20
+      net_transfer: 1000
+    state: present
+  register: my_rg
+  delegate_to: localhost
+```
+
+В данном примере показано, как изменить сеть по умолчанию в ресурсной группе по имени MyRG в аккаунте MyAccount.
+
+```
+- name: manage resource group
+  decort_rg:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    account_name: "MyAccount"
+    rg_name: "MyRG"
+    def_netType: "PRIVATE"
+    def_netId: 99
+    state: present
+  register: my_rg
+  delegate_to: localhost
+```
+
+В данном примере показано, как переименовать ресурсную группу по имени MyRG на новое имя "NewRg" в аккаунте MyAccount.
+
+```
+- name: manage resource group
+  decort_rg:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    account_name: "MyAccount"
+    rg_name: "MyRG"
+    rename: "NewRg"
+    rg_id: 27
+    state: present
+  register: my_rg
+  delegate_to: localhost
+```
+
+В данном примере результат работы модуля decort_rg записывается в переменную my_rg.
+
+Модули DECORT, которым для работы требуется ресурсная группа, в качестве одного из параметров, как правило, принимают идентификатор `rg_id`. Так, например, используя модуль `decort_kvmvm` для создания виртуального сервера необходимо указать ресурсную группу, к которой будет принадлежать этот виртуальный сервер. Сделать это можно следующим образом:
+
+```
+   <прочие детали опущены>
+   rg_id: "{{ my_rg.facts.id }}"
+```
+
+В данном примере показано, как изменить доступные пулы СХД в ресурсной группе по имени MyRG в аккаунте MyAccount.
+
+```
+- name: change available sep pools
+  decort_rg:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    account_name: "MyAccount"
+    rg_name: "MyRG"
+    sep_pools:
+      - sep_id: 1
+        pool_names:
+          - sep1_pool1
+          - sep1_pool2
+      - sep_id: 2
+        pool_names:
+          - sep2_pool1
+    state: present
+  register: my_rg
+  delegate_to: localhost
+```

wiki/7.0.0/модуль-decort_snapshot.md

@@ -0,0 +1,248 @@
+# Модуль decort_snapshot
+## Обзор модуля
+
+Модуль **decort_snapshot** предназначен для выполнения следующих действий над снимками виртуальных машин:
+- **создать** (см. [параметр state](#state) и [примеры](#создать))
+- **удалить** (см. [параметр state](#state) и [примеры](#удалить))
+- **получить основную информацию о снимке** (см. [возвращаемые значения](#основная-информация) и [примеры](#получить-основную-информацию-о-снимке))
+- **получить информацию о размере снимка** (см. [параметр usage](#usage), [возвращаемые значения](#размер-снимка) и [примеры](#получить-информацию-о-размере-снимка))
+
+## Параметры модуля
+Ниже приведен список параметров для модуля **decort_snapshot** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+<table>
+  <tr>
+    <th colspan="6">Параметр</th>
+    <th>Тип</th>
+    <th>Описание</th>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="label">
+        label
+      </a>
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Метка снимка виртуальной машины. Если метка не указана при создании, она будет сгенерирована автоматически на основе даты и времени - <code>vm_name_2024-12-10_16-40-52</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="state">
+        state
+      </a>
+    </td>
+    <td>
+      (str)
+      <br>Значения:
+      <br><code>absent</code>
+      <br><code>present</code>
+    </td>
+    <td>
+      Целевое состояние.
+      <br><code>absent</code> - снимок удален.
+      <br><code>present</code> - снимок существует.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="usage">
+        usage
+      </a>
+    </td>
+    <td>
+      (bool)
+      <br>Default:<code>false</code>
+    </td>
+    <td>
+      Получить информацию о реальном размере снимка виртуальной машины.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="vm_id">
+        vm_id
+      </a>
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Идентификатор виртуальной машины.
+      <br>Обязательный параметр.
+    </td>
+  </tr>
+</table>
+
+## Возвращаемые значения
+
+Модуль **decort_snapshot** возвращает информацию о снимке виртуальной машины в виде словаря `facts` со следующими ключами:
+
+### Основная информация
+
+<table>
+  <tr>
+    <th colspan="6">
+      Ключ
+    </th>
+    <th>
+      Тип
+      <br>данных
+    </th>
+    <th>
+      Описание
+    </th>
+  </tr>
+  <tr>
+    <td colspan="6">
+      disks
+    </td>
+    <td>
+      list
+    </td>
+    <td>
+      Диски
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      guid
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Идентификатор снимка
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      label
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Метка снимка
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      timestamp
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Временная метка создания снимка
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      vm_id
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Идентификатор виртуальной машины
+    </td>
+  </tr>
+</table>
+
+### Размер снимка
+<table>
+  <tr>
+    <th colspan="6">
+      Ключ
+    </th>
+    <th>
+      Тип
+      <br>данных
+    </th>
+    <th>
+      Описание
+    </th>
+  </tr>
+  <tr>
+    <td colspan="6">
+      stored
+    </td>
+    <td>
+      float
+    </td>
+    <td>
+      Размер снимка
+    </td>
+  </tr>
+</table>
+
+## Примеры использования
+
+### Создать
+
+#### С указанием метки
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create snapshot
+      decort_snapshot:
+        # Параметры для авторизации упущены
+        vm_id: "{{ vm_id }}"
+        label: "{{ snapshot_label }}"
+        state: present
+```
+
+#### Без указания метки
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create snapshot
+      decort_snapshot:
+        # Параметры для авторизации упущены
+        vm_id: "{{ vm_id }}"
+        state: present
+```
+
+### Удалить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Delete snapshot
+      decort_snapshot:
+        # Параметры для авторизации упущены
+        vm_id: "{{ vm_id }}"
+        label: "{{ snapshot_label }}"
+        state: absent
+```
+
+### Получить основную информацию о снимке
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Get basic snapshot info
+      decort_snapshot:
+        # Параметры для авторизации упущены
+        vm_id: "{{ vm_id }}"
+        label: "{{ snapshot_label }}"
+```
+
+### Получить информацию о размере снимка
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Get snapshot usage
+      decort_snapshot:
+        # Параметры для авторизации упущены
+        vm_id: "{{ vm_id }}"
+        label: "{{ snapshot_label }}"
+        usage: true
+```

wiki/7.0.0/модуль-decort_vins.md

@@ -0,0 +1,110 @@
+# Модуль decort_vins
+## Обзор модуля decort_vins
+
+Модуль decort_vins предназначен для управления внутренними сетями (Virtual Network Segment, ViNS) и позволяет производить с ними следующие действия:
+- создавать
+  - на уровне ресурсной группы (если РГ задана)
+  - на уровне аккаунта (если РГ не задана)
+- удалять (безвозвратно)
+- восстанавливать из корзины
+- запрашивать информацию
+- включать/отключать
+- соединять (необходимы права администратора)
+- изменять:
+  - включать/отключать SSH-доступ к виртуальному маршрутизатору (необходимы права администратора)
+  - включать/отключать режим **Custom Config** для виртуального маршрутизатора (необходимы права администратора)
+  - сохранять конфигурацию виртуального маршрутизатора для возможности последующего отката к ней (необходимы права администратора)
+
+## Параметры модуля decort_vins
+Ниже приведен список параметров для модуля **decort_vins** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+| Параметр |	Тип, допустимые значения |	Описание |
+| ------ | ------ | ------ |
+| account_id |	(int) |	Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная внутреняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.|
+| account_name |	(string) |	Имя аккаунта, которому принадлежит данная внутренняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр account_id). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.|
+|description |	(string)| Текстовое описание внутренней сети. Данный аргумент является опциональным и учитывается только при создании внутренней сети, а при всех прочих операциях игнорируется.|
+| ext_net_id | (int) | Идентификатор внешней сети, к которой должна быть подключена внутренняя сеть. Если задать значение `0`, то платформой будет выбрана внешняя сеть по умолчанию. |
+| ext_ip_addr |	(string) | IP-адрес внешней сети, заданной через параметр `ext_net_id`. Если не задан, то IP-адрес для внешней сети будет выбран платформой автоматически.
+| ipcidr |	(string) |	Адрес сети для создаваемой внутренней сети. Если этот параметр не задан, то платформа назначит адрес автоматически. Обратите внимание, что внутренние сети, принадлежащие одному и тому же аккаунту, не могут иметь пересекающихся сетей.|
+|rg_id |	(int) |	Идентификатор ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_id` и `rg_name`, то `rg_name` игнорируется.|
+| rg_name |	(string) |	Имя ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_name` и `rg_id`, то `rg_name` игнорируется.|
+| state | (string)<br>Значения:<br/>`present`<br/>`absent`<br/>`enabled`<br/>`disabled`<br/>Default: `present` | Целевое состояние внутренней сети. |
+| vins_id |	(int) |	Идентификатор внутренней сети. Соответствующая внутренная сеть должна существовать. Таким образом, с помощью `vins_id` нельзя создать новую внутреннюю сеть, а только управлять уже имеющимися. Если задан данный параметр, то параметры `vins_name`, `account_name`, `account_id`, `rg_name` и `rg_id` игнорируются.|
+| vins_name| 	(string) |	Имя внутренней сети. Для идентификации внутренней сети требуется либо `vins_name` и информация об аккаунте/ресурсной группе, которой принадлежит сеть, либо `vins_id`. Обратите внимание, что это имя уникально только в рамках ресурсной группы или аккаунта, на уровне которого существует данная внутренняя сеть.|
+| mgmtaddr | (list) | Список существующих IP-адресов виртуального маршрутизатора во внутренней сети, через которые необходимо разрешить SSH-доступ к виртуальному маршрутизатору.
+| custom_config | (bool)<br>Default: `false` | Включить/отключить режим пользовательской конфигурации виртуального маршрутизатора. |
+| config_save | (bool)<br>Default: `false` | Выполнить сохранение текущей конфигурации виртуального маршрутизатора для возможности последующего отката к ней. |
+| connect_to | (list) | Список словарей, содержащих информацию о внутренних сетях, к которым необходимо подключить данную. См. примеры.
+
+## Возвращаемые значения модуля decort_vins
+
+Модуль decort_vins возвращает информацию о внутренней сети в виде словаря facts со следующими ключами:
+
+| Ключ | Тип данных | Описание |
+| --- | --- | --- |
+| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит внутренняя сеть. |
+| custom_net_addr | (list) | Список IP-адресов пользовательских интерфейсов виртуального маршрутизатора
+| ext_ip_addr | (string) | IP-адрес интерфейса, которым виртуальный маршрутизатор подключён к внешней сети. |
+| ext_net_id | (int) | Идентификатор внешней сети, к которой подключена внутренняя сеть. `-1` означает, что внутренняя сеть не подключёна к внешней сети. |
+| gid | (int) | Идентификатор физического кластера (Grid ID), на базе которого развёрнуты ресурсы данной внутренней сети. |
+| id | (int) | Уникальный целочисленный идентификатор внутренней сети. |
+| name | (string) | Имя внутренней сети. |
+| int_net_addr | (string) | Адрес внутренней сети. |
+| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы, которой принадлежит данная внутренняя сеть. Если данная внутренняя сеть создана на уровне аккаунта, то `rg_id=0`. |
+| ssh_ipaddr | (list) | Список IP-адресов виртуального маршрутизатора во внутренней сети, на которых включён SSH-доступ к нему.
+| ssh_password | (str) | Пароль для SSH-доступа к виртуальному маршрутизатору.
+| ssh_port | (int) | Номер порта для SSH-подключения к виртуальному маршрутизатору.
+| state | (string) | Состояние внутренней сети. |
+
+
+
+## Пример использования модуля decort_vins
+
+В данном примере создаётся внутренняя сеть с именем "MyVins01" (vins_name: "MyVins01").
+
+Внутренняя сеть создаётся на уровне ресурсной группы "MyRg01" (rg_name: "MyRg01"), принадлежащей аккаунту "MyMainAccount" (account_name: "MyMainAccount"). Внутренняя сеть будет иметь подключение во внешнюю сеть по умолчанию (ext_net_id: 0).
+```
+  - name: Manage ViNS on resource group level
+    decort_vins:
+      account_name: "MyMainAccount"
+      rg_name: "MyRg01"
+      authenticator: jwt
+      jwt: "{{ my_jwt.jwt }}"
+      controller_url: "https://ds1.digitalenergy.online"
+      ext_net_id: 0
+      vins_name: "MyVins01"
+    register: my_vins
+  ```
+
+Здесь результат исполнения модуля decort_vins записывается в переменную my_vins, которую можно дальше использовать в Ansible playbooks. Ниже показано, как получить и использовать идентификатор внутренней сети для подключения к нему виртуального сервера.
+```
+- name: Manage virtual machine
+  decort_kvmvm:
+    << для краткости фрагмент опущен >>
+    networks:
+      - type: VINS
+        id: "{{ my_vins.facts.id }}"
+    << для краткости фрагмент опущен >>
+```
+
+В данном примере идёт создание внутренней сети, а потом её привязка к внутренним сетям с id 864 и 196.
+```
+  - name: Manage ViNS on resource group level
+    decort_vins:
+      authenticator: jwt
+      jwt: "{{ my_jwt.jwt }}"
+      controller_url: "https://cloud.digitalenergy.online"
+      vins_name: "ViNS_connected_by_decort_vins_module"
+      rg_id: 98
+      connect_to:
+       - id: 864
+         ipaddr: 192.168.5.66
+         netmask: 24
+       - id: 196
+         ipaddr: 192.168.9.133
+         netmask: 24
+    register: managed_vins
+
+```
+
+

wiki/7.1.0/Home.md

@@ -0,0 +1,25 @@
+1. [Введение](./введение.md)
+   - [Введение](./введение.md#введение)
+   - [Системные требования](./введение.md#системные-требования)
+   - [Подготовка к работе](./введение.md#подготовка-к-работе)
+   - [Авторизация](./введение.md#авторизация)
+      - [Общие параметры модулей для авторизации](./введение.md#общие-параметры-модулей-для-авторизации)
+      - [Пример авторизации с помощью DECS3O](./введение.md#пример-авторизации-с-помощью-decs3o)
+      - [Пример авторизации с помощью BVS](./введение.md#пример-авторизации-с-помощью-bvs)
+      - [Пример авторизации с помощью JSON Web Token](./введение.md#пример-авторизации-с-помощью-json-web-token)
+2. Ansible модули DECORT:
+   - [Модуль decort_kvmvm](./модуль-decort_kvmvm.md) - управление виртуальными машинами
+   - [Модуль decort_osimage](./модуль-decort_osimage.md) - управление образами
+   - [Модуль decort_disk](./модуль-decort_disk.md) - управление дисками
+   - [Модуль decort_pfw](./модуль-decort_pfw.md) - управление правилами переадресации портов
+   - [Модуль decort_rg](./модуль-decort_rg.md) - управление ресурсными группами
+   - [Модуль decort_vins](./модуль-decort_vins.md) - управление внутренними сетями
+   - [Модуль decort_jwt](./модуль-decort_jwt.md) - получение авторизационного токена
+   - [Модуль decort_bservice](./модуль-decort_bservice.md) - управление базовыми службами
+   - [Модуль decort_group](./модуль-decort_group.md)- управление группами базовой службы
+   - [Модуль decort_k8s](./модуль-decort_k8s.md) - управление кластерами Kubernetes
+   - [Модуль decort_lb](./модуль-decort_lb.md) - управление балансировщиками нагрузки
+   - [Модуль decort_account_info](./модуль-decort_account_info.md) - получение информации об аккаунте
+   - [Модуль decort_account](./модуль-decort_account.md) - управление аккаунтами
+   - [Модуль decort_user_info](./модуль-decort_user_info.md) - получение информации о пользователе
+   - [Модуль decort_snapshot](./модуль-decort_snapshot.md) - управление снимками виртуальной машины

wiki/7.1.0/введение.md

@@ -0,0 +1,250 @@
+# Модули Ansible для управления облачными ресурсами в платформе DECORT
+## Введение
+
+Настоящая документация содержит руководство пользователя по библиотеке модулей decort для Ansible. С помощью этих модулей Вы сможете управлять созданием и конфигурированием облачных ресурсов в платформе DECORT (Digital Energy Cloud Orchestration Technology).
+
+По каждому модулю есть своя документация, в которой вы можете найти список доступных действий, подробную информацию о входных параметрах и возвращаемых данных, а также примеры использования.
+
+## Системные требования
+Убедитесь, что Ваша система соответствует требованиям для работы модуля DECORT.
+Системные требования для работы модуля:
+- Ansible 10.6.0
+- Python 3.10.12
+- PyJWT 2.10.1 Python module
+- requests 2.32.3 Python module
+- DynamiX Enterprise 4.2.0
+
+## Подготовка к работе
+
+Для начала работы необходимо, чтобы Ansible было известно местоположение файлов модулей. Для этого необходимо:
+- либо разместить директории **library** и **module_utils** в одной директории с плейбуками
+- либо в рабочей директории, из которой будет запускаться Ansible, разместить файл **ansible.cfg**, в котором задать пути к файлам модулей, например:
+```
+[defaults]
+library=./library
+module_utils=./module_utils
+```
+
+## Авторизация
+
+### Общие параметры модулей для авторизации
+
+<table>
+  <tr>
+    <th colspan="6">Параметр</th>
+    <th>Тип</th>
+    <th>Описание</th>
+  </tr>
+  <tr>
+    <td colspan="6">
+      app_id
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Идентификатор приложения, использующийся для получения токена в режимах 
+        <code>authenticator: bvs</code> или <code>authenticator: decs3o</code>. 
+        Данный параметр является обязательным для указанных режимов. Если
+        параметр не задан в playbook, модуль будет использовать значение
+        переменной окружения <code>DECORT_APP_ID</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      app_secret
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Секретный ключ приложения, использующийся для получения токена в режимах
+        <code>authenticator: bvs</code> или <code>authenticator: decs3o</code>.
+        Данный параметр является обязательным для указанных режимов. 
+        Так как он содержит секретную информацию, то его не рекомендуется 
+        задавать непосредственно в playbook. Если параметр не задан в playbook,
+        то модуль будет использовать значение переменной окружения
+        <code>DECORT_APP_SECRET</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      authenticator
+    </td>
+    <td>
+      (str)
+      <br>Значения:
+      <br/><code>bvs</code>
+      <br/><code>decs3o</code>
+      <br/><code>oauth2</code>
+      <br/><code>jwt</code>
+      <br>Default: <code>decs3o</code>
+    </td>
+    <td>
+      Режим аутентификации для получения токена. 
+        Значение <code>oauth2</code> является устаревшим и равнозначным 
+        <code>decs3o</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      controller_url
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      URL контроллера, соответствующего экземпляру облачной платформы
+        DECORT. Данный параметр является обязательным.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      domain
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Домен BVS, использующийся для получения токена в режиме 
+        <code>authenticator: bvs</code>. Данный параметр является 
+        обязательным для указанного режима. Если параметр не задан в playbook, 
+        модуль будет использовать значение переменной окружения 
+        <code>DECORT_DOMAIN</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      jwt
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      JSON Web Token (JWT), который будет использоваться для подключения
+        к контроллеру облачной платформы DECORT в режиме
+        <code>authenticator: jwt</code>. Данный параметр является
+        обязательным для указанного режима. Так как он содержит
+        потенциально секретную информацию, а сам JWT, как правило,
+        имеет ограниченное время жизни, то его не рекомендуется задавать
+        непосредственно в playbook. Если этот параметр не определен в
+        playbook, то модуль будет использовать значение переменной
+        окружения <code>DECORT_JWT</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      oauth2_url
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      URL авторизационного сервера, работающего по протоколу Oauth2,
+        который должен использоваться в режимах
+        <code>authenticator: bvs</code> 
+        или <code>authenticator: decs3o</code>. Данный параметр является
+        обязательным для указанных режимов. Если параметр не задан в
+        playbook, модуль будет использовать значение переменной
+        окружения <code>DECORT_OAUTH2_URL</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      password
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Пароль пользователя, который должен использоваться в режиме
+        <code>authenticator: bvs</code>. Данный параметр является
+        обязательным для указанного режима. Так как он содержит секретную 
+        информацию, то его не рекомендуется задавать непосредственно
+        в playbook. Если параметр не задан в playbook, модуль будет 
+        использовать значение переменной окружения 
+        <code>DECORT_PASSWORD</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      username
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Логин пользователя, который должен использоваться в режиме
+        <code>authenticator: bvs</code>. Данный параметр является
+        обязательным для указанного режима. Если параметр не задан в playbook, 
+        модуль будет использовать значение переменной окружения 
+        <code>DECORT_USERNAME</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      verify_ssl
+    </td>
+    <td>
+      (bool)
+      <br>Default: <code>true</code>
+    </td>
+    <td>
+      Позволяет отключить проверку SSL сертификатов при выполнении API
+        вызовов в адрес контроллера облачной инфраструктуры, например,
+        при работе с изолированной облачной инфраструктурой, использующей
+        самоподписанные сертификаты. Применяйте данный параметр с
+        осторожностью, предпочтительно в защищенных средах.
+    </td>
+  </tr>
+</table>
+
+### Пример авторизации с помощью DECS3O
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: DECS3O auth
+      decort_module_name:
+        # Специфичные для модулей параметры упущены
+        # Пример демонстрирует только параметры для авторизации
+        app_id: "{{ app_id }}"
+        app_secret: "{{ app_secret }}"
+        authenticator: decs3o
+        controller_url: https://dynamix.local
+        oauth2_url: https://sso-dynamix.local
+```
+
+### Пример авторизации с помощью BVS
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: BVS auth
+      decort_module_name:
+        # Специфичные для модулей параметры упущены
+        # Пример демонстрирует только параметры для авторизации
+        app_id: "{{ app_id }}"
+        app_secret: "{{ app_secret }}"
+        authenticator: bvs
+        controller_url: https://dynamix.local
+        oauth2_url: https://bvs.local
+        domain: dynamix
+        username: "{{ username }}"
+        password: "{{ password }}"
+```
+
+### Пример авторизации с помощью JSON Web Token
+
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Auth with JWT
+      decort_module_name:
+        # Специфичные для модулей параметры упущены
+        # Пример демонстрирует только параметры для авторизации
+        authenticator: jwt
+        controller_url: "{{ controller_url }}"
+        jwt: "{{ jwt }}"
+```

wiki/7.1.0/модуль-decort_account.md

@@ -0,0 +1,992 @@
+# Модуль decort_account
+## Обзор модуля
+
+Модуль **decort_account** предназначен для выполнения следующих действий над аккаунтом:
+- **удалить в корзину** (см. [параметр state](#state) и [примеры](#в-корзину))
+- **удалить безвозвратно** (см. [параметр state](#state) и [примеры](#безвозвратно))
+- **восстановить из корзины** (см. [параметр state](#state) и [примеры](#восстановить-из-корзины))
+- **выключить/включить** (см. [параметр state](#state) и [примеры](#выключитьвключить))
+- **изменить права доступа** (см. [параметр acl](#acl) и [примеры](#изменить-права-доступа))
+- **изменить имя** (см. [параметр name](#name) и [примеры](#переименовать))
+- **изменить квоты** (см. [параметр quotas](#quotas) и [примеры](#изменить-квоты))
+- **выключить/включить отправку уведомлений о предоставлении доступа к ресурсам** (см. [параметр access_emails](#access_emails) и [примеры](#выключитьвключить-отправку-уведомлений-о-предоставлении-доступа-к-ресурсам))
+- **изменить доступные пулы СХД** (см. [параметр sep_pools](#sep_pools) и [примеры](#изменить-доступные-пулы-схд))
+
+## Параметры модуля 
+Ниже приведен список параметров для модуля **decort_account** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+<table>
+  <tr>
+    <th colspan="6">Параметр</th>
+    <th>Тип</th>
+    <th>Описание</th>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="access_emails">
+        access_emails
+      </a>
+    </td>
+    <td>
+      (bool)
+    </td>
+    <td>
+      Выключение/включение отправки пользователям на эл. почту уведомлений о предоставлении доступа к ресурсам.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="acl">
+        acl
+      </a>
+    </td>
+    <td>
+      (dict)
+    </td>
+    <td>
+      Целевые права доступа.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      mode
+    </td>
+    <td>
+      (str)
+      <br>Значения:
+      <br><code>match</code>
+      <br><code>revoke</code>
+      <br><code>update</code>
+      <br>Default: <code>update</code>
+    </td>
+    <td>
+      Режим изменения прав доступа для указанных пользователей.
+      <br><code>match</code> - привести в соответствие для указанных
+        пользователей, удалить предоставленные для других.
+      <br><code>revoke</code> - отозвать для указанных пользователей,
+        если предоставлены.
+      <br><code>update</code> - привести в соответствие для указанных
+        пользователей, оставить без изменения предоставленные для
+        других.
+      </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      users
+    </td>
+    <td>
+      (list)
+    </td>
+    <td>
+      Список словарей, описывающих права доступа пользователей.
+      <br>Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td colspan="4">
+      rights
+    </td>
+    <td>
+      (str)
+      <br>Значения:
+      <br><code>R</code>
+      <br><code>RCX</code>
+      <br><code>ARCXDU</code>
+      <br>Default: <code>R</code>
+    </td>
+    <td>
+      Права доступа.
+      <br>При <code>mode: revoke</code> не используется.
+      <br>При <code>mode: match</code> и <code>mode: update</code>
+        права <code>ARCXDU</code> считаются соответствующими
+        правам <code>CXDRAU</code>.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td colspan="4">
+      id
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Идентификатор пользователя.
+      <br>Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      id
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Идентификатор целевого аккаунта.
+      <br>Обязательный параметр, если не задан параметр
+        <code>name</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="name">
+        name
+      </a>
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Имя целевого аккаунта.
+      <br>Может быть альтернативой параметру <code>id</code>,
+        за исключением случая, когда необходимо получить
+        информацию о безвозвратно удалённом объекте.
+      <br>Если задан совместно с параметром <code>id</code>,
+        то используется для переименования (целевое имя).
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="quotas">
+        quotas
+      </a>
+    </td>
+    <td>
+      (dict)
+    </td>
+    <td>
+      Целевые квоты.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      cpu
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Количество виртуальных процессоров.
+      <br><code>-1</code> - удалить квоту.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      disks_size
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Объём дисков в ГБ.
+      <br><code>-1</code> - удалить квоту.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      ext_traffic
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Объём трафика внешних сетей.
+      <br><code>-1</code> - удалить квоту.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      gpu
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Количество графических процессоров.
+      <br><code>-1</code> - удалить квоту.
+    </td>
+  </tr>
+   <tr>
+    <td></td>
+    <td colspan="5">
+      public_ip
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Количество внешних IP-адресов.
+      <br><code>-1</code> - удалить квоту.
+    </td>
+  </tr>
+  </tr>
+   <tr>
+    <td></td>
+    <td colspan="5">
+      ram
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Объём оперативной памяти в МБ.
+      <br><code>-1</code> - удалить квоту.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="sep_pools">
+        sep_pools
+      </a>
+    </td>
+    <td>
+      (list)
+    </td>
+    <td>
+      Список словарей, описывающих доступные пулы СХД.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      sep_id
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Идентификатор системы хранения данных.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      pool_names
+    </td>
+    <td>
+      (list)
+    </td>
+    <td>
+      Список названий пулов системы хранения данных.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="state">
+        state
+      </a>
+    </td>
+    <td>
+      (str)
+      <br>Значения:
+      <br><code>absent</code>
+      <br><code>absent_permanently</code>
+      <br><code>confirmed</code>
+      <br><code>disabled</code>
+      <br><code>present</code>
+      <br>Default: <code>present</code>
+    </td>
+    <td>
+      Целевое состояние.
+      <br><code>absent</code> - удалён в корзину, безвозвратно удалён
+        или не существует. Если существует и не удалён, то будет удалён
+        в корзину.
+      <br><code>absent_permanently</code> - безвозвратно удалён или
+        не существует. Если существует и не удалён или удалён в корзину,
+        то будет безвозвратно удалён.
+      <br> При значениях <code>absent</code> и <code>absent_permanently</code>
+        использование других параметров модуля, вызывающих изменение объекта,
+        не допускается.
+      <br><code>confirmed</code> - включён. Если выключен, то будет включён.
+        Если удалён в корзину, то будет восстановлен из корзины.
+      <br><code>disabled</code> - выключен. Если включён, то будет выключен.
+        Если удалён в корзину, то будет восстановлен из корзины и выключен.
+      <br><code>present</code> - существует и не удалён. Если удалён в
+        корзину, то будет восстановлен из корзины.
+    </td>
+  </tr>
+</table>
+
+## Возвращаемые значения
+
+Модуль **decort_account** возвращает информацию об аккаунте в виде словаря `facts` со следующими ключами:
+
+<table>
+  <tr>
+    <th colspan="6">
+      Ключ
+    </th>
+    <th>
+      Тип
+      <br>данных
+    </th>
+    <th>
+      Описание
+    </th>
+  </tr>
+  <tr>
+    <td colspan="6">
+      acl
+    </td>
+    <td>
+      list
+    </td>
+    <td>
+      Список словарей, описывающих доступы пользователей.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      canBeDeleted
+    </td>
+    <td>
+      bool
+    </td>
+    <td>
+      Может ли быть удалён.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      right
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Права.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      status
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Статус.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      type
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Тип.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      userGroupId
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Идентификатор пользователя или группы пользователей.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      company
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Название компании.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      companyurl
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      URL компании.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      computeFeatures
+    </td>
+    <td>
+      list
+    </td>
+    <td>
+      Список дополнительных возможностей гипервизора, доступных ВМ.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      computes_amount
+    </td>
+    <td>
+      dict
+    </td>
+    <td>
+      Количество ВМ по состоянию.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      started
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Количество запущенных ВМ.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      stopped
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Количество остановленных ВМ.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      cpu_allocation_parameter
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Режим выделения ЦП.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      cpu_allocation_ratio
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Коэффициент для режима выделения ЦП.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      createdBy
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Идентификатор пользователя, который создал.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      createdTime
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Unix-время создания.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      createdTime_readable
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Дата и время создания.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      deactivationTime
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Unix-время выключения.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      deactivationTime_readable
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Дата и время выключения.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      deletedBy
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Идентификатор пользователя, который удалил.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      deletedTime
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Unix-время удаления.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      deletedTime_readable
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Дата и время удаления.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      displayname
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Отображаемое имя.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      id
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Идентификатор.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      name
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Имя.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      resourceLimits
+    </td>
+    <td>
+      dict
+    </td>
+    <td>
+      Квоты на ресурсы.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      CU_C
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Количество виртуальных процессоров.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      CU_D
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Объём диска в ГБ.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      CU_DM
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Объём дисков в ГБ.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      CU_I
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Количество внешних IP-адресов.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      CU_M
+    </td>
+    <td>
+      float
+    </td>
+    <td>
+      Объём оперативной памяти в МБ.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      CU_NP
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Объём трафика внешних сетей.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="5">
+      gpu_units
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Количество графических процессоров.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      sendAccessEmails
+    </td>
+    <td>
+      bool
+    </td>
+    <td>
+      Отправка пользователям на эл. почту уведомлений о предоставлении доступа.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      status
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Статус.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      uniqPools
+    </td>
+    <td>
+      list
+    </td>
+    <td>
+      Список доступных пулов СХД.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      updatedTime
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Unix-время обновления.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      updatedTime_readable
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Дата и время обновления.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      vins
+    </td>
+    <td>
+      list
+    </td>
+    <td>
+      Список идентификаторов внутренних сетей на уровне аккаунта.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      vinses_amount
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Количество внутренних сетей.
+    </td>
+  </tr>
+</table>
+
+## Примеры использования
+
+### Удалить
+
+#### В корзину
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Delete account
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        state: absent
+```
+
+#### Безвозвратно
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Delete account
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        state: absent_permanently
+```
+
+### Восстановить из корзины
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Restore account from recycle bin
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        state: present
+```
+
+### Выключить/включить
+
+#### Выключить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Disable account
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        state: disabled
+```
+
+#### Включить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Enable account
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        state: confirmed
+```
+
+### Изменить права доступа
+
+#### Отозвать
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Revoke user access rights
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        acl:
+          mode: revoke
+          users:
+            - id: "{{ user1_id }}"
+            - id: "{{ user2_id }}"
+```
+
+#### Обновить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Update user access rights
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        acl:
+          mode: update
+          users:
+            - id: "{{ user1_id }}"
+              rights: R
+            - id: "{{ user2_id }}"
+              rights: RCX
+```
+
+#### Привести в соответствие
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Match user access rights
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        acl:
+          mode: match
+          users:
+            - id: "{{ user1_id }}"
+              rights: ARCXDU
+            - id: "{{ user2_id }}"
+              rights: RCX
+```
+
+### Переименовать
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Rename account
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        name: "{{ account_new_name }}"
+```
+
+### Изменить квоты
+
+#### На объём дисков
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Update account quota of disks size
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        quotas:
+          disks_size: 500
+```
+
+#### На количество внешних IP-адресов
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Update account quota of public IP amount
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        quotas:
+          public_ip: 10
+```
+
+### Выключить/включить отправку уведомлений о предоставлении доступа к ресурсам
+
+#### Выключить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Disable sending access emails
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        access_emails: false
+```
+
+#### Включить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Enable sending access emails
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        access_emails: true
+```
+
+### Изменить доступные пулы СХД
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change available sep pools
+      decort_account:
+        # Параметры для авторизации упущены
+        id: "{{ account_id }}"
+        sep_pools:
+          - sep_id: 1
+            pool_names: 
+              - pool1
+```

wiki/7.1.0/модуль-decort_bservice.md

@@ -0,0 +1,82 @@
+# Модуль decort_bservice
+
+## Обзор модуля decort_bservice
+
+Базовая служба (Basic Service) это несколько групп виртуальных серверов (compute), создаваемых и управляемых как единое целое.
+
+Все compute(s) в группе имеют одни и те же характеристики (cpu/ram/boot disk size/OS image + сетевые подключения). Для разных групп эти характеристики могут быть разными.
+
+Группы в составе Basic Service могут иметь отношения parent-child с другими группами. Наличие таких отношений определяет последовательность запуска групп ("сначала parents").
+
+На основе ресурсов, предоставляемых и управляемых через Basic Service, могут создаваться другие сервисы. 
+
+`Для взаимодействия с группами виртуальных серверов используется модуль decort_group.`
+
+Модуль decort_bservice предназначен для управления базовыми службами, в которых находятся группы виртуальных серверов.
+Данный модуль позволяет:
+- Создавать Basic Service
+- Удалять Basic Service (безвозвратно).
+- Включать/выключать Basic Service
+- Запускать Basic Service
+- Запрашивать информацию о Basic Service.
+
+
+## Параметры модуля decort_bservice
+Ниже приведен список параметров для модуля **decort_bservice** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+| Параметр | Тип, допустимые значения | Описание |
+| ------ | ------ | ------ |
+| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.|
+|account_name | (string) | Имя аккаунта, которому принадлежит ресурсная группа. При идентификации базовой службы и ресурсной группы по именам (см. параметры `name` и `rg_name`) должен быть задан либо идентификатор (см. `account_id`), либо имя аккаунта. Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. |
+|state | Значения: `absent`, `disabled`, `enabled`, `present`, `check`. <br> Default: `present`| Целевое состояние базовой службы. Значения `present` и `enabled` равнозначны.|
+| started | (bool) <br> Default: `true` | Параметр, определяющий состояние добавленных виртуальных серверов в Basic Service. Запускать их, или нет. |
+| name | (string) | Имя базовой службы. Данный параметр является обязательным при создании базовой службы и при изменении если не задан `id`. |
+| sshuser | (string) | Имя пользователя, который будет создан на всех виртуальных серверах базовой службы. Используется в паре с `sshkey`. |
+| sshkey | (string) | SSH ключ, который будет загружен на все виртуальные сервера базовой службы. Используется в паре с `sshuser`. |
+| id | (int) | Уникальный целочисленный идентификатор базовой службы. Используется для поиска, изменения и удаления базовой службы. |
+| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы базовой службы. |
+| rg_name | (string) | Имя ресурсной группы базовой службы. |
+
+## Возвращаемые значения модуля decort_bservice
+
+Модуль decort_bservice возвращает информацию о базовой службе в виде словаря facts со следующими ключами:
+
+
+|Ключ |	Тип данных |	Описание|
+| ------ | ------ | ------ |
+|id |	int |	Уникальный целочисленный идентификатор базовой службы.|
+|name |	string | Имя базовой службы.|
+| techStatus | string | Технический статус базовой службы. |
+|state | string | Статус базовой службы.|
+| rg_id | int | Уникальный целочисленный идентификатор ресурсной группы, в которой находится базовая служба.|
+| account_id | int | Уникальный целочисленный идентификатор аккаунта, в котором находится ресурсная группа.|
+| groups | list | Список словарей с информацией о группах базовой службы.|
+
+
+## Пример использования модуля decort_bservice
+
+Данный пример создаёт базовую службу с именем databases.
+
+```
+  - name: Create Basic Service
+    decort_bservice:
+      authenticator: jwt
+      controller_url: "{{ controller_url }}"
+      jwt: "{{ auth_token }}"
+      name: databases
+      rg_id: "{{ rg_id }}"
+    register: db_bservice
+```
+
+Данный пример удаляет базовую службу с названием databases.
+```
+  - name: Delete Basic Service
+    decort_bservice:
+      authenticator: jwt
+      controller_url: "{{ controller_url }}"
+      jwt: "{{ auth_token }}"
+      state: absent
+      name: databases
+      rg_id: "{{ rg_id }}"
+    register: db_bservice
+```

wiki/7.1.0/модуль-decort_disk.md

@@ -0,0 +1,167 @@
+# Модуль decort_disk
+## Обзор модуля decort_disk
+
+Модуль decort_disk предназначен для управления дисками и позволяет производить с ними следующие действия:
+- создавать
+- удалять (в корзину или безвозвратно)
+- восстановливать из корзины
+- изменять:
+  - имя
+  - размер
+  - лимиты ввода/вывода
+  - включать/отключать общий доступ
+
+
+Обратите внимание:
+
+- Загрузочный диск для виртуальной машины создаётся и подключается автоматически в процессе создания этой машины.
+- Модуль decort_disk служит для управления дополнительными дисками (т.н. data-дисками);
+- Подключение дополнительных дисков, созданных посредством decort_disk, к виртуальным машинам выполняется с помощью модуля управления виртуальными машинами (см. модуль decort_kvmvm).
+
+## Параметры модуля decort_disk
+Ниже приведен список параметров для модуля **decort_disk** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+| Параметр | Тип, допустимые значения | Описание |
+| ------ | ------ | ------ |
+| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр `name`) должно быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.|
+|account_name | (string) | Имя аккаунта, которому принадлежит данный диск. При идентификации диска по имени (см. параметр name) должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. |
+| description | (string)<br>Default: `Disk by decort_disk` | Текстовое описание диска. Данный параметр является опциональным и учитывается только при создании диска, а при всех прочих операциях игнорируется.|
+|id | (int) | Уникальный целочисленный идентификатор диска. Соответствующий диск должен существовать (таким образом, с помощью id нельзя создать новый диск, а только управлять уже имеющимися). Если задан данный параметр, то параметры `name`, `account_name` и `account_id` игнорируются.|
+| iops | (int)<br>Default: `2000` | Ограничение ввода/вывода диска. Используется при создании диска. |
+| force_detach | (bool)<br/>Default: `false` | Задаёт поведение платформы при попытке удалить диск, подключённый к виртуальной машине.<br/>По умолчанию, удаление подключённых дисков не разрешается, и попытка удалить такой диск приведёт к аварийному завершению модуля. Чтобы изменить это поведение, явно установите `force_detach: true`. |
+| limitIO | (dict) | Параметр, позволяющий ограничить скорость ввода/вывода диска как в iops, так и в байтах в секунду.  Обратите внимание, что параметры с total не задаются вместе с read/write. Все возможные подпараметры можно увидеть в примерах. |
+| name | (string) | Имя диска. Для идентификации диска требуется либо его `name` и информация об аккаунте (`account_id` или `account_name`), которому принадлежит диск, либо его `id`.|
+| permanently | (bool)<br>Default: `false` | Параметр, использующийся при удалении диска, при значении `true` - диск удалится навсегда, а при `false` - попадёт в корзину. |
+| place_with | (int) | Идентификатор образа диска, из которого следует взять параметр `sep_id`, чтобы разместить данный диск на той же системе хранения данных, что и указанный образ диска. Данный параметр является опциональным и используется только на стадии создания диска. Если задан `place_with`, то `sep_id` игнорируется.|
+| pool | (string) | Название пула на системе хранения данных, в рамках которой следует создать данный диск. Этот параметр используется только на стадии создания диска и игнорируется при операциях над уже существующими дисками. Параметр является опциональным, если не задан, то платформа будет использовать пул, который сконфигурирован на целевой системе хранения как пул по умолчанию. |
+| reason | (string)<br>Default: `Managed by Ansible decort_disk` | Причина, по которой было выполнено какое-либо действие. В данном модуле используется только при удалении диска. |
+| sep_id | (int) | Идентификатор системы хранения данных (Storage End-point). Данный параметр определяет систему хранения данных, на ресурсах которой создаётся диск. Используется только при создании диска и игнорируется при прочих операциях. Альтернативой данному параметру является `place_with`, позволяющий разместить диск на той же системе хранения, что и указанный образ диска, на базе которого создаётся виртуальная машина.|
+| shareable | (bool)<br>Default: `false` | Включение/отключение общего доступа к диску.
+| size | (int) | Размер диска в ГБ. Этот параметр является обязательным при создании диска. Если он задан для уже существующего диска, а текущий размер диска меньше заданного, то будет предпринята попытка увеличить размер диска. При прочих операциях данный параметр игнорируется.|
+| state | (str)<br>Значения:<br>`present`<br>`absent`<br>Default: `present` | Целевое состояние диска. |
+| type | (string)<br>Значения:<br>`B`<br>`D`<br>Default: `D` | Тип создаваемого диска. `B` - Boot/загрузочный, `D` - Data/с данными. |
+
+## Возвращаемые значения модуля decort_disk
+
+Модуль decort_disk возвращает информацию о диске в виде словаря facts со следующими ключами:
+
+
+|Ключ |	Тип данных |	Описание|
+| ------ | ------ | ------ |
+| account_id |	int |	Уникальный целочисленный идентификатор аккаунта, которому принадлежит диск.|
+| computes |	dict |	Словарь, в котором ключ - идентификатор, а значение - имя виртуальной машины, к которой в настоящий момент подключён диск. Если диск не подключён, то возвращается пустой словарь.|
+| gid |	int |	Идентификатор физического кластера (Grid ID), на ресурсах которого создан диск.|
+| id |	int |	Уникальный целочисленный идентификатор данного диска.|
+| iotune | dict | Текущие ограничения ввода/вывода диска. |
+| name |	string |	Имя диска. Обратите внимание, что имя диска не является уникальным с точки зрения системы хранения данных, на которой этот диск расположен.|
+| pool |	string |	Имя пула на системе хранения данных, в котором размещаются ресурсы диска.|
+|sep_id |	int |	Идентификатор системы хранения данных (Storage Endpoint), на которой размещаются ресурсы данного диска.|
+| size |	int |	Размер диска в ГБ.|
+| state |	string | Текущий статус диска. |
+
+
+## Пример использования модуля decort_disk
+
+В данном примере создаётся диск размером 50ГБ (`size: 50`), с ограничением ввода/вывода в 2000 iops, на ресурсах системы хранения данных под номером 1 (`sep_id: 1`) в пуле "data01".
+
+```
+- name: Manage disk
+  decort_disk:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    name: "DataDisk01"
+    size: 50
+    account_name: "MyAccount"
+    sep_id: 1
+    iops: 2000
+    description: "Disk example"
+    pool: data01
+  register: my_data_disk01
+```
+В следующих двух примерах для существующего диска с именем "DataDisk01" задаются все доступные лимиты на операции ввода/вывода.
+
+```
+- name: Manage disk
+  decort_disk:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    name: "DataDisk01"
+    account_name: "MyAccount"
+    limitIO:
+      read_bytes_sec: 10000
+      write_bytes_sec: 5000
+      read_iops_sec и write_iops_sec
+      read_iops_sec: 2500
+      write_iops_sec: 1000
+      read_bytes_sec_max: 11000
+      write_bytes_sec_max: 6000
+      read_iops_sec_max: 3000
+      write_iops_sec_max: 1500
+      size_iops_sec: 1000
+  register: my_data_disk01
+
+- name: Manage disk
+  decort_disk:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    name: "DataDisk01"
+    account_name: "MyAccount"
+    limitIO:
+      total_bytes_sec: 15000
+      total_iops_sec: 3500
+      total_bytes_sec_max: 17000
+      total_iops_sec_max: 4500
+      size_iops_sec: 1000
+  register: my_data_disk01
+```
+
+В данном примере выполняется восстановление удаленного диска с id 111 из корзины.
+
+```
+- name: Manage disk
+  decort_disk:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    id: 111
+    size: 10
+  register: my_data_disk01
+```
+
+В данном примере выполняется переименование диска с id 111 на новое имя "NewExampleDisk".
+
+```
+- name: Manage disk
+  decort_disk:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    id: 111
+    name: "NewExampleDisk"
+    size: 10
+  register: my_data_disk01
+```
+
+Здесь результат работы модуля decort_disk записывается в переменную my_data_disk01. Для получения идентификатора диска, например, при подключении его к виртуальной машине, следует воспользоваться показанной ниже конструкцией:
+
+```
+- name: Manage compute
+  decort_kvmvm:
+    << для краткости фрагмент опущен >>
+    data_disks:
+      - "{{ my_data_disk01.facts.id }}"
+    << для краткости фрагмент опущен >>
+```

wiki/7.1.0/модуль-decort_group.md

@@ -0,0 +1,97 @@
+# Модуль decort_group
+## Обзор модуля decort_group
+Модуль **decort_group** позволяет производить следующие действия над группами базовой службы:
+- создать
+- получить информацию
+- запустить/остановить
+- подключить/отключить сети (для существующей группы только внутренние сети)
+- изменить
+  - имя
+  - объём загрузочного диска
+  - количество ВМ
+  - роль
+  - количество виртуальных процессоров
+  - объём ОЗУ
+- удалить (безвозвратно)
+
+## Параметры модуля decort_group
+Ниже приведен список параметров для модуля **decort_group** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+| Параметр | Тип, допустимые значения | Описание |
+| ------ | ------ | ------ |
+| account_id | (int) | Идентификатор аккаунта. При идентификации диска по имени (см. параметр `name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. |
+| account_name | (string) | Имя аккаунта. При идентификации диска по имени (см. параметр `name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. |
+| boot_disk | (int) | Обьём загрузочного диска. |
+| bservice_id | (int) | Идентификатор базовой службы. Обязательный параметр. |
+| count | (int) | Количество виртуальных машин. |
+| cpu | (int) | Количество виртуальных процессоров. |
+| driver | (string)<br>Значения:<br>`KVM_X86`<br>`SVA_KVM_X86`<br>Default: `KVM_X86` | Драйвер. |
+| id | (int) | Идентификатор группы. |
+| image_id | (int) | Идентификатор образа. |
+| name | (str) | Имя группы.<br>Используется для идентификации группы, если не задан параметр `id`, а также для переименования группы, если параметр `id` задан. |
+| networks | (list) | Список словарей, описывающих сети, которые должны быть подключены.<br>Ключи словаря:<br>&bull; `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя) или `EXTNET` (внешняя)<br>&bull; `id` (int) (обязательный) - идентификатор сети |
+| ram | (int) | Объём оперативной памяти. |
+| role | (string) | Тег роли. |
+| state | (str)<br>Значения:<br>`present`<br>`absent`<br>`started`<br>`stopped`<br>`check`<br>Default: `present` | 
+| timeoutStart | (int) | Время отсрочки запуска группы после создания в секундах. |
+
+## Возвращаемые значения модуля decort_group
+
+Модуль **decort_group** возвращает информацию о диске в виде словаря facts со следующими ключами:
+
+
+|Ключ |	Тип данных |	Описание|
+| ------ | ------ | ------ |
+| account_id | int | Идентификатор аккаунта. |
+| Computes | list | Список словарей, содержащих информацию о виртуальных машинах группы.<br>Ключи словаря:<br>&bull; `id` (int) - идентификатор ВМ<br>&bull; `ipAddresses` (list) - список IP-адресов ВМ<br>&bull; `name` (str) - имя ВМ<br>&bull; `osUsers` (list) - список словарей, содержащих учётные данные пользователей ОС ВМ по умолчанию; ключи: `login` (str) и `password` (str) |
+| id | int | Идентификатор группы.|
+| name | string | Имя группы.|
+| rg_id | int | Идентификатор ресурсной группы. |
+| state | string | Состояние группы. |
+| techStatus | string | Технический статус группы. |
+
+## Пример использования модуля decort_group
+
+Данный пример создаёт группу с именем `test_group`.
+```
+- hosts: localhost
+  tasks:
+  - name: Create BS group
+    decort_group:
+      app_id: "{{ my_app_id }}"
+      app_secret: "{{ my_app_secret }}"
+      authenticator: oauth2
+      boot_disk: 10
+      bservice_id: 1823
+      controller_url: "https://ds1.digitalenergy.online"
+      count: 2
+      cpu: 2
+      image_id: 518
+      name: test_group
+      networks:
+        - type: VINS
+          id: 1987
+      oauth2_url: "https://sso.digitalenergy.online"
+      ram: 2
+      verify_ssl: false
+    register: group_test
+```
+
+Данный пример удаляет группу с именем `test_group`.
+
+```
+- hosts: localhost
+  tasks:
+  - name: Delete BS group 
+    decort_group:
+      app_id: "{{ my_app_id }}"
+      app_secret: "{{ my_app_secret }}"
+      authenticator: oauth2
+      bservice_id: 1823
+      controller_url: "https://ds1.digitalenergy.online"
+      name: test_group
+      oauth2_url: "https://sso.digitalenergy.online"
+      state: absent
+      verify_ssl: False
+    register: group_test
+```

wiki/7.1.0/модуль-decort_jwt.md

@@ -0,0 +1,48 @@
+# Модуль decort_jwt
+## Обзор модуля
+Модуль **decort_jwt** предназначен для получения авторизационного токена JWT (JSON Web Token). Данный модуль может быть полезен при массовом создании ресурсов (например, виртуальных машин), так как позволяет оптимизировать количество API вызовов для получения токена.
+
+По сути, данный модуль является провайдером информации и не управляет облачными ресурсами (всегда возвращает `changed: False`).
+
+## Параметры модуля decort_jwt
+Список параметров для модуля **decort_jwt** почти полностью совпадает с [общими параметрами модулей для авторизации](./введение.md#общие-параметры-модулей-для-авторизации).
+
+Отличия от общих параметров:
+- Параметр `controller_url` не используется.
+- Параметр `jwt` не используется.
+- В параметре `authenticator` не используется значение `jwt`.
+
+## Возвращаемые значения модуля decort_jwt
+| Ключ | Тип данных | Описание |
+|---| ------ | ------ |
+| jwt | str | JWT токен. |
+
+## Примеры использования
+### Пример получения JWT токена с помощью DECS3O
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Obtain JWT from DECS3O
+      decort_jwt:
+        app_id: "{{ app_id }}"
+        app_secret: "{{ app_secret }}"
+        authenticator: decs3o
+        oauth2_url: https://sso-dynamix.local
+```
+
+### Пример получения JWT токена с помощью BVS
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Obtain JWT from BVS
+      decort_jwt:
+        app_id: "{{ app_id }}"
+        app_secret: "{{ app_secret }}"
+        authenticator: bvs
+        oauth2_url: https://bvs.local
+        domain: dynamix
+        username: "{{ username }}"
+        password: "{{ password }}"
+```

wiki/7.1.0/модуль-decort_k8s.md

@@ -0,0 +1,112 @@
+# Модуль decort_k8s
+## Обзор модуля decort_k8s
+
+Модуль **decort_k8s** предназначен для выполнения следующих действий над кластерами Kubernetes:
+- создать
+- получить информацию
+- отключить/включить/запустить
+- изменить группы Worker-узлов
+- удалить (в корзину или безвозвратно)
+- восстановить из корзины
+
+## Параметры модуля decort_k8s 
+Ниже приведен список параметров для модуля **decort_k8s** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+| Параметр | Тип, допустимые значения | Описание |
+| ------ | ------ | ------ |
+| account_id | (int) | Идентификатор аккаунта. |
+| account_name | (string) | Имя аккаунта. |
+| additionalSANs | (list) | Список дополнительных SAN (Subject Alternative Names) для использования в процессе автоматического выписывания сертификата Кластера Kubernetes. Можно использовать IP-адреса и доменные имена.
+| cluster_conf | (dict) | Словарь с глобальными настройками и конфигурацией для всего кластера. Включает в себя такие настройки, как имя кластера, настройки DNS, методы аутентификации и другие конфигурации всего кластера. |
+| description | (string)<br>Default: `Created by decort ansible module` | Описание кластера. |
+| extnet_id | (int)<br>Default: `0` | Идентификатор внешней сети. Если задан `0`, то внешняя сеть выбирается автоматически. Если задан параметр `vins_id`, то значение данного параметра будет проигнорировано. Если задан `extnet_only: false`, то внешняя сеть будет подключена к создаваемой внутренней сети, а если `extnet_only: true`, то либо напрямую к каждому узлу кластера (если `with_lb: false`), либо напрямую к балансировщику нагрузки (если `with_lb: true`). |
+| extnet_only | (bool)<br>Default: `false` | Не использовать внутреннюю сеть, подключать напрямую к внешней. |
+| getConfig | (bool)<br>Default: `false` | Получить данные конфигурации для доступа к кластеру Kubernetes. |
+| ha_lb | (bool)<br>Default: `false` | Использовать схему высокой доступности для создаваемого балансировщика нагрузки (если `with_lb: true`). |
+| id | (int) | Идентификатор кластера Kubernetes. |
+| init_conf | (dict) | Словарь для определения настроек и действий, которые должны быть выполнены перед запуском любого другого компонента в кластере. Позволяет настраивать такие процессы, как регистрация узла, настройка сети и другие задачи инициализации.
+| join_conf | (dict) | Словарь для настройки поведения и параметров присоединения узла к кластеру. Включает в себя такие параметры, как control-plane-endpoint кластера, токен и certificate-key. |
+| k8ci_id | (int) | Идентификатор конфигурации кластера Kubernetes. |
+| kubeproxy_conf | (dict) | Словарь для настройки поведения и настроек Kube-proxy, отвечающего за сетевое проксирование и балансировку нагрузки внутри кластера. Включает в себя такие параметры, как режим прокси, диапазоны IP-адресов кластера и другие конфигурации, специфичные для Kube-proxy. |
+| kublet_conf | (dict) | Словарь для настройки поведения и настроек Kubelet, который является агентом основного узла, работающим на каждом узле кластера. Включает в себя такие параметры, как IP-адрес узла, распределение ресурсов, политики вытеснения модулей и другие конфигурации, специфичные для Kubelet. |
+| master_chipset | (string)<br>Значения:<br>`Q35`<br>`i440fx` | Эмулируемый чипсет master-узлов. Не применим при изменении существующего кластера. <br>Значение по умолчанию при создании: `i440fx`. |
+| master_count | (int)<br>Default: `1` | Количество Master-узлов. |
+| master_cpu | (int)<br>Default: `2` | Количество виртуальных процессоров на Master-узле. |
+| master_disk | (int)<br>Default: `10` | Объём загрузочного диска на Master-узле. |
+| master_pool | (str) | Пул СХД, заданной параметром `master_sepid`. |
+| master_ram | (int)<br>Default: `2048` | Объём оперативной памяти на Master-узле. |
+| master_sepid | (int) | Идентификатор СХД для Master-узла. Если не задан, то используется СХД образа Master-узла. |
+| name | (string) | Имя кластера Kubernetes. |
+| network_plugin | (str)<br>Значения:<br>`flannel`<br>`calico`<br>`weavenet`<br>Default: `flannel` | CNI plugin (модуль для управления сетевыми интерфейсами контейнера). Возможные значения могут быть ограничены в используемой конфигурации кластера Kubernetes (параметр `k8ci_id`) |
+| oidc_cert | (raw) | Сертификат X.509 для OIDC-провайдера.
+| permanent | (bool)<br>Default: `false` | Если выполняется удаление, то выполнить безвозвратное удаление (минуя корзину). |
+| rg_id | (int) | Идентификатор ресурсной группы. |
+| rg_name | (str) | Имя ресурсной группы. |
+| started | (bool)<br>Default: `true` | Запустить кластер.<br>Используется только для существующего кластера. |
+| state | (string)<br>Значения:<br>`present`<br>`absent`<br>`enabled`<br>`disabled`<br>`check`<br>Default: `present` | Целевое состояние кластера. |
+| vins_id | (int) | Идентификатор внутренней сети. Если не задан, то будет создана новая внутренняя сеть. Если задан, то заданная внутренняя сеть должна иметь подключение к внешней сети. Если задано `extnet_only: true`, то параметр игнорируется.
+| with_lb | (bool)<br>Default: `true` | Создание кластера Kubernetes с размещением Master-узлов за балансировщиком нагрузки. В ином случае каждый узел получит отдельный адрес из внешней сети.
+| workers | (list) | Список словарей, описывающих группы Worker-узлов.<br>Ключи словаря:<br>&bull; `annotations` (list) (необязательный) - список строк с annotations в формате: `key1=value1`; значение по умолчанию при создании: `[]`<br>&bull; `chipset` (str) (необязательный) - эмулируемый чипсет. Допустимые значения: `Q35`, `i440fx`; значение по умолчанию при создании: `i440fx`<br>&bull; `ci_user_data` (dict) (необязательный) - конфигурация для cloud-init; значение по умолчанию при создании: `{}`<br>&bull; `cpu` (int) (необязательный) - количество виртуальных процессоров на узле; значение по умолчанию при создании: `1`<br>&bull; `disk` (int) (необязательный) - объём загрузочного диска на узле;  если не задан при создании, размер диска будет равен размеру используемого образа<br>&bull; `labels` (list) (необязательный) - список строк с labels в формате: `label1=value1`;  значение по умолчанию при создании: `[]`. Метка `workersGroupName` является служебной в платформе и игнорируется при сравнении переданных меток с существующими<br>&bull; `name` (string) (обязательный) - имя группы Worker-узлов<br>&bull; `num` (int) (необязательный) - количество узлов;  значение по умолчанию при создании: `1`<br>&bull; `pool` (str) (необязательный) - пул СХД, заданной ключом `sep_id`; если не задан при создании, то пул будет выбран платформой<br>&bull; `ram` (int) (необязательный) - объём оперативной памяти на узле;  значение по умолчанию при создании: `1024`<br>&bull; `sep_id` (int) (необязательный) - идентификатор СХД; если не задан при создании, то используется СХД образа узла<br>&bull; `taints` (list) (необязательный) - список строк с taints в формате: `key1=value1:NoSchedule`; значение по умолчанию при создании: `[]`. |
+
+## Возвращаемые значения модуля decort_k8s
+
+Модуль **decort_k8s** возвращает информацию о кластере в виде словаря `facts` со следующими ключами:
+
+
+| Ключ | Тип  данных | Описание |
+| ------ | ------ | ------ |
+| account_id | int | Идентификатор аккаунта. |
+| config | str | Kuber config кластера.
+| id |	int | Идентификатор кластера. |
+| k8s_Masters | dict | Словарь с информацией о группе Master-узлов.<br>Ключи словаря:<br>&bull; `cpu` (int) - количество виртуальных процессоров<br>&bull; `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ<br>&bull; `disk` (int) - объём загрузочного диска<br>&bull; `id` (int) - идентификатор группы<br>&bull; `name` (str) - имя группы<br>&bull; `num` (int) - количество узлов<br>&bull; `ram` (int) - объём оперативной памяти
+| k8s_Workers | dict | Список словарей с информацией о группах Worker-узлов.<br>Ключи словаря:<br>&bull; `cpu` (int) - количество виртуальных процессоров<br>&bull; `detailedInfo` (list) - список словарей с информацией об узлах; ключи словаря: `id` (int) - идентификатор ВМ, `name` (str) - имя ВМ, `status` (str) - статус ВМ, `techStatus` (str) - технический статус ВМ<br>&bull; `disk` (int) - объём загрузочного диска<br>&bull; `id` (int) - идентификатор группы<br>&bull; `labels` (list) - список строк с labels<br>&bull; `name` (str) - имя группы<br>&bull; `num` (int) - количество узлов<br>&bull; `ram` (int) - объём оперативной памяти<br>&bull; `taints` (list) - список строк с taints
+| name | string | Имя кластера. |
+| rg_id | int | Идентификатор ресурсной группы. |
+| state | string |  Статус кластера. |
+| techStatus | string | Технический статус кластера. |
+| vins_id | int | Идентификатор внутренней сети кластера. |
+
+
+## Пример использования модуля decort_k8s 
+
+
+Пример создания кластера Kubernetes с именем `cluster-test` с получением Kuber config.
+```
+  - name: Create a k8s cluster named cluster-test
+    decort_k8s:
+      authenticator: jwt
+      controller_url: "https://ds1.digitalenergy.online"
+      getConfig: true
+      jwt: "{{ token.jwt }}"
+      k8ci_id: 18
+      name: cluster-test
+      rg_id:  125
+      workers:
+        - cpu: 10
+          disk: 10
+          name: wg1
+          num: 1
+          ram: 1024
+          chipset: i440fx
+          ci_user_data: {}
+          taints: 
+            - key=value:NoSchedule
+          annotations:
+            - key=value
+          labels: 
+            - label=value
+        - cpu: 10
+          disk: 10
+          name: wg2
+          num: 2
+          ram: 1024
+          chipset: Q35
+          ci_user_data: {}
+          taints: 
+            - key=value:NoSchedule
+          annotations:
+            - key=value
+          labels: 
+            - label=value
+    register: k8s_cluster
+```

wiki/7.1.0/модуль-decort_kvmvm.md

@@ -0,0 +1,945 @@
+# Модуль decort_kvmvm
+## Обзор модуля decort_kvmvm
+
+Модуль **decort_kvmvm** предназначен для выполнения следующих действий над виртуальными машинами:
+- **создать** (см. [примеры](#создать))
+  - **с указанием описания** (см. параметр **description** и [примеры](#с-указанием-описания))
+  - **с указанием объёма загрузочного диска** (см. параметр **boot_disk** и [примеры](#с-указанием-объёма-загрузочного-диска))
+  - **с указанием СХД** (см. параметры **sep_id** и **pool** и [примеры](#с-указанием-схд))
+  - **с указанием Cloud-init user data** (см. параметр **ci_user_data** и [примеры](#с-указанием-cloud-init-user-data))
+  - **с указанием SSH-ключа** (см. параметры **ssh_key** и **ssh_key_user** и [примеры](#с-указанием-ssh-ключа))
+  - **с указанием NUMA Affinity** (см. параметр **numa_affinity** и [примеры](#с-указанием-numa-affinity))
+  - **с указанием запуска на выделенных ядрах ЦП** (см. параметр **cpu_pin** и [примеры](#с-указанием-запуска-на-выделенных-ядрах-цп))
+  - **с использованием Huge Pages** (см. параметр **hp_backed** и [примеры](#с-использованием-huge-pages))
+  - **с указанием custom_fields** (см. параметр **custom_fields** и [примеры](#с-указанием-custom_fields))
+  - **с указанием affinity-метки** (см. параметр **affinity_label** и [примеры](#с-указанием-affinity-метки))
+  - **с указанием affinity правил** (см. параметр **aff_rule** и [примеры](#с-указанием-affinity-правил))
+  - **с указанием anti-affinity правил** (см. параметр **aaff_rule** и [примеры](#с-указанием-anti-affinity-правил))
+  - **с указанием тэгов** (см. параметр **tag** и [примеры](#с-указанием-тэгов))
+  - **с образом** (см. параметры **image_id** и **image_name** и [примеры](#с-образом))
+  - **без образа** (см. параметры **image_id** и **image_name** и [примеры](#без-образа))
+    - **с загрузочным диском** (см. параметр **boot_disk** и [примеры](#с-загрузочным-диском))
+    - **без загрузочного диска** (см. параметр **boot_disk** и [примеры](#без-загрузочного-диска))
+  - **с включением автоматического запуска ВМ после перезапуска вычислительного узла, за которым она закреплена** (см. параметр **auto_start** и [примеры](#с-включением-автоматического-запуска-вм-после-перезапуска-вычислительного-узла-за-которым-она-закреплена))
+  - **с указанием чипсета** (см. параметр **chipset** и [примеры](#с-указанием-чипсета))
+  - **с указанием предпочтительных ядер** (см. параметр **preferred_cpu_cores** и [примеры](#с-указанием-предпочтительных-ядер))
+- **получить информацию** (см. [возвращаемые значения](#возвращаемые-значения-модуля-decort_kvmvm) и [примеры](#получение-основной-информации-о-виртуальной-машине))
+- **остановить/приостановить/запустить** (см. параметр **state** и [примеры](#остановитьприостановитьзапустить))
+- **подключить/отключить диски с данными** (см. параметр **data_disks** и [примеры](#подключитьотключить-диски-с-данными))
+- **подключить/отключить сети** (см. параметры **networks** и **network_order_changing** и [примеры](#подключитьотключить-сети))
+- **откатить ВМ к состоянию снимка** (см. параметры **rollback_to** и [примеры](#откатить-вм-к-состоянию-снимка))
+- **изменить** (см. [примеры](#изменить))
+  - **объём загрузочного диска в большую сторону** (см. параметр **boot_disk** и [примеры](#объём-загрузочного-диска-в-большую-сторону))
+  - **количество ЦП** (см. параметр **cpu** и [примеры](#количество-цп))
+  - **объём ОЗУ** (см. параметр **ram** и [примеры](#объём-озу))
+  - **тэги** (см. параметр **tag** и [примеры](#тэги))
+  - **affinity метку** (см. параметр **affinity_label** и [примеры](#affinity-метку))
+  - **affinity правила** (см. параметр **aff_rule** и [примеры](#affinity-правила))
+  - **anti-affinity правила** (см. параметр **aaff_rule** и [примеры](#anti-affinity-правила))
+  - **описание** (см. параметр **description** и [примеры](#описание))
+  - **чипсет** (см. параметр **chipset** и [примеры](#чипсет))
+  - **правило NUMA Affinity** (см. параметр **numa_affinity** и [примеры](#правило-numa-affinity))
+  - **запуск на выделенных ядрах ЦП** (см. параметр **cpu_pin** и [примеры](#запуск-на-выделенных-ядрах-цп))
+  - **использование Huge Pages** (см. параметр **hp_backed** и [примеры](#использование-huge-pages))
+  - **имя** (см. параметр **name** и [примеры](#имя))
+  - **XML виртуальной машины** (см. параметр **custom_fields** и [примеры](#xml-виртуальной-машины))
+  - **автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена** (см. параметр **auto_start** и [примеры](#автоматический-запуск-вм-после-перезапуска-вычислительного-узла-за-которым-она-закреплена))
+  - **предпочтительные ядра** (см. параметр **preferred_cpu_cores** и [примеры](#предпочтительные-ядра))
+- **удалить (безвозвратно)** (см. параметр **state** и [примеры](#безвозвратно))
+
+## Параметры модуля decort_kvmvm
+Ниже приведен список параметров для модуля **decort_kvmvm** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+| Параметр | Тип, допустимые значения | Описание |
+| ------ | ------ | ------ |
+| aaff_rule | (list) | Список словарей, описывающих anti-affinity правила.<br>Ключи словаря:<br>&bull; `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)<br>&bull; `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`<br>&bull; `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)<br>&bull; `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила<br>&bull; `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`).<br>Чтобы очистить anti-affinity правила, нужно указать пустой список `[]`. |
+| account_id | (int) | Идентификатор аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_id` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется.|
+| account_name | (string) | Имя аккаунта. Этот параметр является опциональным и используется в сценариях, когда уже существующая ресурсная группа задается комбинацией `account_name` и `rg_name`. Если задан `account_id`, то `account_name` игнорируется. |
+| aff_rule | (list) | Список словарей, описывающих affinity правила.<br>Ключи словаря:<br>&bull; `topology` (string) (обязательный) - назначение правила; значения: `node` (узел) или `compute` (ВМ)<br>&bull; `policy` (string) (обязательный) - степень "необходимости" этого правила; значения: `RECOMMENDED` или `REQUIRED`<br>&bull; `mode` (string) (обязательный) - режим сравнения; значения: `EQ` (должно соответствовать), `NE` (не должно соответствовать), `ANY` (любое)<br>&bull; `key` (string) (обязательный) - ключ, который учитывается при анализе данного правила<br>&bull; `value` (string) (обязательный) - значение ключа, учитываемого при анализе данного правила (зависит от ключа `mode`).<br>Чтобы очистить affinity правила, нужно указать пустой список `[]`. |
+| affinity_label | (str) | Метка affinity.<br>Чтобы очистить метку affinity, нужно указать пустую строку `""`. |
+| auto_start | (bool) | Включить/выключить автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена.<br> Если параметр не задан при создании ВМ, то значение будет выбрано платформой. |
+| boot_disk | (int) | Объём загрузочного диска виртуальной машины в ГБ. |
+| chipset | (string)<br>Значения:<br>`Q35`<br>`i440fx` | Эмулируемый чипсет. Значение по умолчанию при создании: `i440fx`.|
+| ci_user_data | (dict) | конфигурация для cloud-init
+| cpu | (int) | Количество виртуальных процессоров, выделяемых виртуальной машине. |
+| cpu_pin | (bool) | Запуск виртуальной машины на выделенных ядрах ЦП. <br>Значение по умолчанию при создании: `false`. |
+| custom_fields | (dict) | Словарь, управляющий XML виртуальной машины.<br>Ключи словаря:<br>&bull; `disable` (bool) - отключение управления виртуальной машиной через XML. Значение по умолчанию при создании: `true`<br>&bull; `fields` (dict) - поля для управления XML виртуальной машины. |
+| data_disks | (list) | Список идентификаторов дисков, которые следует подключить к данной виртуальной машине как дополнительные.<br>Чтобы отключить все диски, нужно указать пустой список `[]`.|
+| description | (string) | Опциональное описание виртуальной машины. |
+| hp_backed | (bool) | Использовать Huge Pages для выделения оперативной памяти виртуальной машины. Система должна быть предварительно сконфигурирована путем выделения Huge Pages на физическом узле. <br>Значение по умолчанию при создании: `false`.  |
+| id | (int) | Уникальный цифровой идентификатор виртуальной машины. Этот параметр используется как один из методов идентификации существующей ВМ (альтернатива – по комбинации `name`, `rg_name` и `account_name`). Если при вызове модуля **decort_kvmvm** существующая ВМ идентифицируется по `id`, то параметры `account_id`, `account_name`, `rg_id` и `rg_name` игнорируются. |
+| image_id | (int) | Уникальный цифровой идентификатор образа, на базе которого следует создать виртуальную машину. При создании задать этот параметр или параметр `image_name`. При любых других операциях данные параметры игнорируются. Если заданы оба этих параметра (`image_id` и `image_name`), то `image_name` игнорируется. |
+| image_name | (string) | Название образа, на базе которого следует создать ВМ. При создании требуется задать этот параметр или параметр `image_id`. При любых других операциях данные параметры игнорируются. |
+| name | (string) | Имя ВМ. Чтобы модуль **decort_kvmvm** мог управлять сервером по его названию, также необходимо задать комбинацию `account_name` и `rg_name` или `rg_id`. Если для существующей ВМ указаны и `name`, и `id`, то параметр `name` игнорируется и идентификация сервера выполняется по `id`.|
+| network_order_changing | (bool)<br>Default:<br>`false` | Соблюдение очерёдности сетей при их изменении.<br>Если `true`, то сравнение списка уже подключённых к ВМ сетей со списком из параметра `networks` будет производится <u>с учётом очерёдности сетей</u> и, <u>при выявлении несоответствия, сначала будет произведено отключение всех сетей от ВМ</u>, а затем подключение сетей в соответствии с параметром `networks`.<br> Если `false`, то очерёдность при сравнении учитываться не будет. Соответственно, сети, которые имеются в списке параметра `networks` и уже подключены к ВМ, переподключаться не будут, что может кратно уменьшить время выполнения изменения сетей. |
+| networks | (list) | Список словарей, описывающих сети ВМ.<br>Ключи словаря:<br>&bull; `type` (string) (обязательный) - тип сети; значения: `VINS` (внутренняя), `EXTNET` (внешняя), `VFNIC` (вирт. функция), `DPDK`, `EMPTY` (без подключения к сети)<br>&bull; `id` (int) (необязательный) - идентификатор внутренней/внешней/DPDK сети или пула вирт. функций<br>&bull; `ip_addr` (string) (необязательный) - IP-адрес, используемый для подключения к данной сети; применимо только для `VINS` и `EXTNET`<br>&bull; `mtu` (int) (необязательный) - MTU интерфейса; применимо только для `DPDK`.<br>ВМ не может одновременно быть подключена к сети DPDK и к сети другого типа.<br>Чтобы отключить все сети, нужно указать пустой список `[]`. |
+| numa_affinity | (str)<br>Значения:<br>`strict`<br>`loose`<br>`none` | Правило применения NUMA affinity к виртуальной машине. <br>`strict` - строго с NUMA affinity, `loose` - использовать NUMA affinity, если возможно, `none` - отменить применение NUMA affinity. <br>Значение по умолчанию при создании: `none`. |
+| pool | (str) | Пул СХД, заданной параметром `sep_id`. Если пул не задан, то он будет выбран платформой.
+| preferred_cpu_cores | (list) | Список номеров предпочтительных выделенных ядер ЦП (см. параметр `cpu_pin`). Чтобы очистить список номеров предпочтительных выделенных ядер ЦП, нужно указать пустой список `[]`. |
+| ram | (int) | Объем оперативной памяти в МБ, выделенной данной ВМ. Параметр является обязательным при создании. Если указать его для уже существующей ВМ, то будет выполнена попытка изменить объем выделенной памяти. |
+| rg_id | (int) | Уникальный цифровой идентификатор уже существующей ресурсной группы, в которой будет создана новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ (альтернативой является задание комбинации `account_name` и `rg_name`).|
+| rg_name | (string) | Имя уже существующей ресурсной группы, в которой будет создаа новая или находится уже существующая ВМ. Данный параметр является одним из методов идентификации существующей РГ, когда задается пара `account_name` и `rg_name` (альтернативой является задание `rg_id`). Если заданы и `rg_id`, и `rg_name`, то параметр `rg_name` игнорируется.|
+| rollback_to | (string) | Имя снимка, к состоянию которого необходимо совершить откат ВМ. |
+| sep_id | (int) | Идентификатор СХД для загрузочного диска ВМ. Если не задан, то будет использоваться СХД образа.
+| ssh_key | (string) | Открытая часть SSH-ключа, который необходимо добавить на создаваемую ВМ для пользователя, заданного параметром `ssh_key_user`. Данный параметр применим только для ОС Linux, используется только при создании и игнорируется при других операциях. |
+| ssh_key_user | (string) | Имя пользователя в гостевой ОС (только для Linux), для которого добавляется SSH-ключ, заданный параметром `ssh_key`. Данный параметр является обязательным, если задан `ssh_key`. Используется только при создании и игнорируется при других операциях. |
+| state | (str)<br>Значения:<br>`present`<br>`absent`<br>`poweredon`<br>`poweredoff`<br>`halted`<br>`paused` | Целевое состояние ВМ.<br>`present` - виртуальная машина существует и не удалена. Если удалена в корзину, то будет восстановлена из корзины.<br>`absent` - виртуальная машина безвозвратно удалена. <br>`poweredon`  - виртуальная машина запущена. Если остановлена, то будет запущена. Если удалена в корзину, то будет восстановлена из корзины.<br>`poweredoff` - виртуальная машина остановлена. Если запущена, то будет остановлена.<br>`halted` - аналогично `poweredoff`.<br>`paused` - виртуальная машина приостановлена.<br>Значение по умолчанию при создании: `present`. |
+| tag | (dict) | Словарь, пары ключ-значение которого, описывают тэги для ВМ.<br>Чтобы очистить теги, нужно указать пустой словарь `{}`.|
+
+## Возвращаемые значения модуля decort_kvmvm
+
+Модуль **decort_kvmvm** возвращает информацию о виртуальной машине в виде словаря `facts` со следующими ключами:
+
+
+| Ключ | Тип данных | Описание |
+| ------ | ------ | ------ |
+| account_id | int | Идентификатор аккаунта. |
+| arch | string | Архитектура ВМ. |
+| auto_start | bool | Автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена. |
+| chipset | string | Эмулируемый чипсет. |
+| cpu | int | Количество виртуальных процессоров. |
+| cpu_pin | bool | Запуск виртуальной машины на выделенных ядрах ЦП. |
+| custom_fields | dict | Словарь, управляющий XML виртуальной машины. Если `null`, то управление виртуальной машиной через XML отключено, иначе - управление через XML включено. |
+| data_disks | list | Список идентификаторов дисков с данными, подключенных к ВМ. |
+| disk_size | int | Размер загрузочного диска в ГБ. |
+| hp_backed | bool | Использовать Huge Pages для выделения оперативной памяти виртуальной машины. |
+| id | int | Идентификатор ВМ. |
+| image_id | id | Идентификатор образа.
+| interfaces | list | Список словарей, описывающих сетевые интерфейсы ВМ. |
+| name | string | Имя ВМ. |
+| numa_affinity | str | Правило применения NUMA affinity к виртуальной машине. |
+| password | string | Пароль пользователя ОС по умолчанию. |
+| preferred_cpu_cores | list | Список номеров предпочтительных выделенных ядер ЦП. |
+| private_ips | list | Список IP-адресов на сетевых интерфейсах ВМ, которые подключены к внутренним сетям. |
+| public_ips | list | Список IP адресов на сетевых интерфейсах ВМ, которые подключены к внешним сетям. |
+| ram | int | Объём ОЗУ ВМ в МБ. |
+| rg_id | int | Идентификатор ресурсной группы, которой принадлежит данная ВМ. |
+| snapshots | list | Список словарей, описывающих снимки ВМ. |
+| state | string | Состояние ВМ.|
+| tags | dict | Словарь, пары ключ-значение которого, описывают тэги ВМ.
+| tech_status | str | Технический статус ВМ.
+| username | string | Имя пользователя ОС по умолчанию. |
+| vnc_password | string | Пароль, используемый для подключения к ВМ через VNC. |
+
+## Примеры использования
+
+### Создать
+
+#### С указанием описания
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        description: vm description
+        state: present
+```
+
+#### С указанием объёма загрузочного диска
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        boot_disk: 10
+        state: present
+```
+
+#### С указанием СХД
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        sep_id: "{{ sep_id }}"
+        pool: "{{ sep_pool_name }}"
+        state: present
+```
+
+#### С указанием Cloud-init user data
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        ci_user_data: 
+          packages:
+            - apache2
+          write_files:
+            - content: |
+                <div>
+                Hello World!
+                </div>
+              owner: user:user
+              path: /var/www/html/index.html
+          hostname: test-apache
+          ssh_keys:
+            - rsa_public: ssh-rsa AAAAOasDmLxnD=  user@pc
+        state: present
+```
+
+#### С указанием SSH-ключа
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        ssh_key: ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAA...
+        ssh_key_user: user
+        state: present
+```
+
+#### С указанием NUMA Affinity
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        numa_affinity: strict
+        state: present
+```
+
+#### С указанием запуска на выделенных ядрах ЦП
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        cpu_pin: true
+        state: present
+```
+
+#### С использованием Huge Pages
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        hp_backed: true
+        state: present
+```
+
+#### С указанием custom_fields
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        custom_fields:
+          fields:
+            title: Title
+            cpu:
+              mode: custom
+              vendor: Intel
+              cache:
+                mode: disable
+              topology:
+                sockets: 1
+                cores: 14
+                threads: 1
+              match: minimum
+              check: partial
+        state: present
+```
+
+#### С указанием affinity-метки
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with affinity-label
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        affinity_label: label
+        state: present
+```
+
+#### С указанием affinity правил
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with affinity rules
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        aff_rule:
+          - topology: compute
+            policy: RECOMMENDED
+            mode: EQ
+            key: key
+            value: value
+        state: present
+```
+
+#### С указанием anti-affinity правил
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with anti-affinity rules
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        aaff_rule:
+          - topology: node
+            policy: REQUIRED
+            mode: ANY
+            key: key
+            value: value
+        state: present
+```
+
+#### С указанием тэгов
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with tags
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        tag: 
+          tag1_key: tag1_value
+          tag2_key: tag2_value
+        state: present
+```
+
+#### С образом
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with image
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        image_id: "{{ image_id }}"
+        state: present
+```
+
+#### Без образа
+
+##### С загрузочным диском
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM without image and with boot disk
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        boot_disk: 10
+        state: present
+```
+
+##### Без загрузочного диска
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM without image and without boot disk
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        state: present
+```
+
+#### С включением автоматического запуска ВМ после перезапуска вычислительного узла, за которым она закреплена
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        auto_start: true
+        state: present
+```
+
+#### С указанием чипсета
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        chipset: Q35
+        state: present
+```
+
+### С указанием предпочтительных ядер
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create VM with preferred CPU cores
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+        cpu: 1
+        ram: 512
+        cpu_pin: true
+        preferred_cpu_cores:
+          - 0
+          - 1
+        state: present
+```
+
+### Получение основной информации о виртуальной машине
+
+#### По идентификатору
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Get basic VM info by ID
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+```
+
+#### По имени
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Get basic VM info by name
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        rg_id: "{{ rg_id }}"
+        name: "{{ vm_name }}"
+```
+
+### Остановить/приостановить/запустить
+
+#### Остановить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Stop VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        state: poweredoff
+```
+
+#### Запустить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Start VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        state: poweredon
+```
+
+#### Приостановить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Pause VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        state: paused
+```
+
+### Подключить/отключить диски с данными
+
+#### Подключить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Connect data disks to VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        data_disks:
+          - "{{ datadisk1_id }}"
+          - "{{ datadisk2_id }}"
+```
+
+#### Отключить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Disconnect data disks from VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        data_disks: []
+```
+
+### Подключить/отключить сети
+
+#### Подключить не-DPDK сети
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Connect networks to VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        networks:
+          - type: VINS
+            id: "{{ vins_id }}"
+            ip_addr: 192.168.4.0
+          - type: EMPTY
+          - type: EXTNET
+            id: "{{ extnet_id }}"
+            ip_addr: 35.21.230.0
+          - type: VFNIC
+            id: "{{ vfpool_id }}"
+        state: poweredoff
+```
+
+#### Подключить не-DPDK сети с соблюдением очередности
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Connect networks to VM without network order changing
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        networks:
+          - type: VINS
+            id: "{{ vins_id }}"
+            ip_addr: 192.168.4.0
+          - type: EMPTY
+          - type: EXTNET
+            id: "{{ extnet_id }}"
+            ip_addr: 35.21.230.0
+          - type: VFNIC
+            id: "{{ vfpool_id }}"
+        network_order_changing: true
+        state: poweredoff
+```
+
+#### Подключить DPDK сети
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Connect DPDK networks to VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        hp_backed: true
+        networks:
+          - type: DPDK
+            id: "{{ dpdk1_id }}"
+          - type: EMPTY
+          - type: DPDK
+            id: "{{ dpdk2_id }}"
+            mtu: 1500
+        state: poweredoff
+```
+
+#### Отключить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Disconnect networks from VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        networks: []
+        state: poweredoff
+```
+
+### Откатить ВМ к состоянию снимка
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Rollback VM to snapshot
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        rollback_to: snapshot_01
+        state: poweredoff
+```
+
+### Изменить
+
+#### Объём загрузочного диска в большую сторону
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Increase boot disk size
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        boot_disk: 15
+        state: poweredoff
+```
+
+#### Количество ЦП
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change CPU amount
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        cpu: 1
+        state: poweredoff
+```
+
+#### Объём ОЗУ
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change RAM size
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        ram: 512
+        state: poweredoff
+```
+
+#### Тэги
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change tags
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        tag:
+          tag1_key: tag1_value
+          tag2_key: tag2_value
+```
+
+#### Affinity метку
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change affinity label
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        affinity_label: Affinity label 1
+```
+
+#### Affinity правила
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change affinity rules
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        aff_rule:
+          - topology: compute
+            policy: REQUIRED
+            mode: EQ
+            key: app
+            value: main
+          - topology: node
+            policy: RECOMMENDED
+            mode: NE
+            key: state
+            value: started
+```
+
+#### Anti-affinity правила
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change anti-affinity rules
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        aaff_rule:
+          - topology: compute
+            policy: REQUIRED
+            mode: ANY
+            key: app
+            value: main
+```
+
+#### Описание
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change description
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        description: vm description
+```
+
+#### Чипсет
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change chipset
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        chipset: i440fx
+        state: poweredoff
+```
+
+#### Правило NUMA Affinity
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change NUMA affinity rule
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        numa_affinity: loose
+        state: poweredoff
+```
+
+#### Запуск на выделенных ядрах ЦП
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change CPU Pinning usage
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        cpu_pin: true
+        state: poweredoff
+```
+
+#### Использование Huge Pages
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change Huge Pages usage
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        hp_backed: true
+        state: poweredoff
+```
+
+#### Имя
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Rename VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        name: "{{ new_vm_name }}"
+```
+
+#### XML виртуальной машины
+
+##### Изменение
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change XML management
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        custom_fields: 
+          fields:
+            cpu:
+              mode: custom
+              vendor: Intel
+              cache:
+                mode: enable
+            os:
+              type:
+                machine: pc-i440fx-artful
+```
+
+##### Отключение управления ВМ через XML
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Disable XML management
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        custom_fields: 
+          disable: true
+```
+
+#### Автоматический запуск ВМ после перезапуска вычислительного узла, за которым она закреплена
+
+##### Включить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Enable auto starting pinned VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        auto_start: true
+```
+
+##### Выключить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Disable auto starting of pinned VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        auto_start: false
+```
+
+#### Предпочтительные ядра
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Change preferred CPU cores
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        cpu_pin: true
+        preferred_cpu_cores:
+          - 0
+          - 1
+          - 2
+        state: poweredoff
+```
+
+### Удалить
+
+#### Безвозвратно
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Delete VM
+      decort_kvmvm:
+        # Параметры для авторизации упущены
+        id: "{{ vm_id }}"
+        state: absent
+```

wiki/7.1.0/модуль-decort_lb.md

@@ -0,0 +1,782 @@
+# Модуль decort_lb
+## Обзор модуля decort_lb
+
+Модуль **decort_lb** предназначен для выполнения следующих действий над балансировщиками нагрузки:
+- создать
+- получить информацию
+- отключить/включить/запустить/перезапустить
+- изменить конфигурации backend и frontend
+- удалить (в корзину или безвозвратно)
+- восстановить из корзины
+
+## Параметры модуля decort_lb 
+Ниже приведен список параметров для модуля **decort_lb** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+<table>
+  <tr>
+    <th colspan="3">Параметр</th>
+    <th>Тип</th>
+    <th>Описание</th>
+  </tr>
+  <tr>
+    <td colspan="3">
+      account_id
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Идентификатор аккаунта.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      account_name
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Имя аккаунта.
+      <br> Может быть альтернативой параметру <code>account_id</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      description
+    </td>
+    <td>
+      (str)
+      <br>Default: <code>Managed by Ansible module decort_lb</code>
+    </td>
+    <td>
+      Описание балансировщика.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      backends
+    </td>
+    <td>
+      (list)
+    </td>
+    <td>
+      Список словарей, описывающих конфигурации backend.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="2">
+      algorithm
+    </td>
+    <td>
+      (str)
+      <br>Значения:
+      <br><code>leastconn</code>
+      <br><code>roundrobin</code>
+      <br><code>static-rr</code>
+      <br>Default: <code>roundrobin</code>
+    </td>
+    <td>
+      Используемый алгоритм.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="2">
+      <a name="backend_default_settings">
+        default_settings
+      </a>
+    </td>
+    <td>
+      (dict)
+    </td>
+    <td>
+      Cловарь, описывающий параметры по умолчанию для backend-серверов.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      downinter
+    </td>
+    <td>
+      (int)
+      <br>Default: <code>1000</code>
+    </td>
+    <td>
+      Интервал в миллисекундах между двумя последовательными проверками
+        доступности сервера, который считается недоступным.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      fall
+    </td>
+    <td>
+      (int)
+      <br>Default: <code>2</code>
+    </td>
+    <td>
+      Количество последовательных неудачных проверок доступности, после
+        которых сервер, ранее считавшийся доступным, начинает считаться
+        недоступным и временно исключается из схемы балансировки.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      inter
+    </td>
+    <td>
+      (int)
+      <br>Default: <code>5000</code>
+    </td>
+    <td>
+      Интервал в миллисекундах между двумя последовательными проверками
+        доступности сервера, который считается доступным.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      maxconn
+    </td>
+    <td>
+      (int)
+      <br>Default: <code>250</code>
+    </td>
+    <td>
+      Лимит одновременных подключений к серверу. При достижении этого лимита
+        сервер временно исключается из схемы балансировки.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      maxqueue
+    </td>
+    <td>
+      (int)
+      <br>Default: <code>256</code>
+    </td>
+    <td>
+      Лимит соединений, ожидающих в очереди. Когда этот предел будет
+        достигнут, все последующие подключения будут перенаправлены
+        на другие серверы.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      rise
+    </td>
+    <td>
+      (int)
+      <br>Default: <code>2</code>
+    </td>
+    <td>
+      Количество проверок, которые должен пройти сервер, считавшийся
+      недоступным, чтобы начать считаться доступным и снова быть
+      включенным в схему балансировки.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      slowstart
+    </td>
+    <td>
+      (int)
+      <br>Default: <code>60000</code>
+    </td>
+    <td>
+      Интервал в миллисекундах с момента когда сервер начинает считаться
+        доступным, по истечении которого количество фактически разрешенных
+        подключений к этому серверу будет возвращено до 100% от
+        установленного лимита.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      weight
+    </td>
+    <td>
+      (int)
+      <br>Default: <code>100</code>
+    </td>
+    <td>
+      Вес сервера для использования в алгоритмах балансировки.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="2">
+      name
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Название backend. Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      ext_net_id
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Идентификатор внешней сети.
+      <br>Может быть не задан, если задан <code>vins_id</code> -
+        в таком случае балансировщик будет подключён только к
+        внутренней сети.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      <a name="frontends">
+        frontends
+      </a>
+    </td>
+    <td>
+      (list)
+    </td>
+    <td>
+      Список словарей, описывающих конфигурации frontend.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="2">
+      backend
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Название используемого backend. Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="2">
+      bindings
+    </td>
+    <td>
+      (list)
+    </td>
+    <td>
+      Список словарей, описывающих конфигурации binding. 
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      address
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      IP-адрес.
+      <br>Если не задан, то будет использоваться основной IP-адрес
+        балансировщика во внешней сети или, если подключена только
+        внутренняя сеть, основной IP-адрес балансировщика во внутренней сети.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      name
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Название. Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      port
+    </td>
+    <td>
+      (int)
+      <br>Значения:
+      <br><code>1</code>-<code>65535</code>
+    </td>
+    <td>
+      Порт. Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      ha_lb
+    </td>
+    <td>
+      bool
+      <br>Default: <code>false</code>
+    </td>
+    <td>
+      Использовать схему высокой доступности для создаваемого балансировщика.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      lb_id
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Идентификатор балансировщика нагрузки.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      lb_name
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Имя балансировщика.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      permanently
+    </td>
+    <td>
+      (bool)
+      <br>Default: <code>false</code>
+    </td>
+    <td>
+      Если выполняется удаление, то выполнить безвозвратное удаление
+        (минуя корзину).
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      rg_id
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Идентификатор ресурсной группы.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      rg_name
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Имя ресурсной группы.
+      <br> В комбинации с заданным аккаунтов может быть альтернативой
+        параметру <code>rg_id</code>
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      servers
+    </td>
+    <td>
+      (list)
+    </td>
+    <td>
+      Список словарей, описывающих конфигурации backend-серверов.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="2">
+      address
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      IP-адрес. Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="2">
+      backends
+    </td>
+    <td>
+      (list)
+    </td>
+    <td>
+      Список словарей, описывающих параметры backend-сервера для разных
+        конфигураций backend.
+      <br>Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      check
+    </td>
+    <td>
+      (str)
+      <br>Значения:
+      <br><code>enabled</code>
+      <br><code>disabled</code>
+      <br>Default: <code>enabled</code>
+    </td>
+    <td>
+      Проверка доступности сервера.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      name
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Название конфигурации backend. Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      port
+    </td>
+    <td>
+      (int)
+      <br>Значения:
+      <br><code>1</code>-<code>65535</code>
+    </td>
+    <td>
+      Порт. Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td>
+      server_settings
+    </td>
+    <td>
+      (dict)
+    </td>
+    <td>
+      Словарь, описывающий параметры backend-сервера.
+      <br> Ключи данного словаря аналогичны ключам словаря
+      <a href=#backend_default_settings>
+        default_settings
+      </a>.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="2">
+      name
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Название. Обязательный параметр.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      state
+    </td>
+    <td>
+      (str)
+      <br>Значения:
+      <br><code>present</code>
+      <br><code>absent</code>
+      <br><code>enabled</code>
+      <br><code>disabled</code>
+      <br><code>restart</code>
+      <br>Default: <code>present</code>
+    </td>
+    <td>
+      Целевое состояние балансировщика нагрузки.
+      <br>Выполнение с <code>state=restart</code> позволяет выполнить
+        перезапуск балансировщика, соответственно, всегда возвращает
+        <code>changed: true</code>.
+      <br>Значения <code>present</code> и <code>enabled</code> равнозначны
+        и соответствуют включённому и запущенному балансировщику.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      vins_id
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Идентификатор внутренней сети.
+      <br>Может быть не задан, если задан <code>ext_net_id</code> -
+        в таком случае балансировщик будет подключён только к
+        внешней сети.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="3">
+      vins_name
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Имя внутренней сети.
+      <br> В комбинации с заданной РГ может быть альтернативой для
+        параметра <code>vins_id</code>.
+    </td>
+  </tr>
+</table>
+
+## Возвращаемые значения модуля decort_lb
+
+Модуль **decort_lb** возвращает информацию о балансировщике в виде словаря `facts` со следующими ключами:
+
+<table>
+  <tr>
+    <th colspan="4">
+      Ключ
+    </th>
+    <th>
+      Тип
+      <br>данных
+    </th>
+    <th>
+      Описание
+    </th>
+  </tr>
+  <tr>
+    <td colspan="4">
+      backends
+    </td>
+    <td>
+      list
+    </td>
+    <td>
+      Список словарей, описывающих конфигурации backend.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="3">
+      algorithm
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Используемый алгоритм.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="3">
+      name
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Название конфигурации backend.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="3">
+      serverDefaultSettings
+    </td>
+    <td>
+      dict
+    </td>
+    <td>
+      Cловарь, описывающий параметры по умолчанию для backend-серверов.
+      <br> Ключи данного словаря аналогичны ключам словаря
+      <a href=#backend_default_settings>
+        default_settings
+      </a>.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td colspan="3">
+      servers
+    </td>
+    <td>
+      list
+    </td>
+    <td>
+      Список словарей, описывающих конфигурации backend-серверов.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td colspan="2">
+      address
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      IP-адрес.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td colspan="2">
+      check
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Проверка доступности сервера.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td colspan="2">
+      name
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Название.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td colspan="2">
+      port
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Порт.
+    </td>
+  </tr>
+  <tr>
+    <td></td>
+    <td></td>
+    <td colspan="2">
+      serverSettings
+    </td>
+    <td>
+      dict
+    </td>
+    <td>
+      Cловарь, описывающий параметры backend-сервера.
+      <br> Ключи данного словаря аналогичны ключам словаря
+      <a href=#backend_default_settings>
+        default_settings
+      </a>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="4">
+      frontends
+    </td>
+    <td>
+      list
+    </td>
+    <td>
+      Список словарей, описывающих конфигурации frontend.
+      <br> Ключи данного словаря аналогичны ключам словарей списка
+      <a href=#frontends>
+        frontends
+      </a>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="4">
+      gid
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Идентификатор физического кластера (Grid ID).
+    </td>
+  </tr>
+  <tr>
+    <td colspan="4">
+      id
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Идентификатор балансировщика.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="4">
+      name
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Имя балансировщика.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="4">
+      rg_id
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Идентификатор ресурсной группы.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="4">
+      state
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Статус балансировщика.
+    </td>
+  </tr>
+</table>

wiki/7.1.0/модуль-decort_osimage.md

@@ -0,0 +1,124 @@
+# Модуль decort_osimage
+## Обзор модуля decort_osimage
+
+Модуль decort_osimage предназначен для выполнения следующих действий над образами, созданными в облачной платформе DECORT:
+- шаблонные образы:
+  - создать
+  - получить информацию
+  - изменить имя
+  - удалить
+- виртуальные образы
+  - создать
+  - получить информацию
+  - изменить
+    - имя
+    - целевой образ
+
+## Параметры модуля decort_osimage 
+Ниже приведен список параметров для модуля **decort_osimage** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+| Параметр | Тип, допустимые значения | Описание |
+| ------ | ------ | ------ |
+| account_Id | (int) | Уникальный целочисленный идентификатор аккаунта. Используется для поиска образов, а тажке для их создания. |
+| account_name | (string) | Имя аккаунта. Используется для получения уникального целочисленного идентификатора аккаунта. |
+| boottype | (string)<br>Default: `uefi` | Тип загрузки образа. Используется при создании образа.|
+| drivers | (string)<br>Default: `KVM_X86` | Тип виртуальных машин, подходящих для образа. Используется при создании образа.|
+| hotresize | (bool)<br>Default: `false` | Поддерживает ли образ "горячее" изменение размера. По умолчанию установлено `false`. Используется при создании образа операционной системы. |
+| image_id | (int) | Идентификатор шаблонного образа.
+| image_name | (str) | Имя шаблонного образа.
+| image_password | (string) | Опциональный пароль для образа. Используется при создании образа.|
+| image_username | (string) | Опциональное имя пользователя для образа. Используется при создании образа. |
+| imagetype | (string)<br>Default: `linux` | Тип образа. Используется при создании образа.|
+| passwordDL |  (string) | Пароль для скачивания по URL-адресу. Используется при создании образа. |
+| pool | (str) | Имя пула СХД. Используется для поиска существующего образа.
+| poolName | (string) | Имя пула СХД. Используется при создании образа. |
+| sepId | (integer) | Уникальный целочисленный идентификатор СХД. Используется при создании образа. |
+| sep_id | (int) | Идентификатор СХД. Используется для поиска существующего образа.
+| state | (string)<br>Значения:<br>`present`<br>`absent`<br>Default: `present` | Целевое состояние образа. `present` - существует, `absent` - удалён. |
+| url | (string) | URL-адрес, с которого будет загружен образ. Используется при создании образа.|
+| usernameDL | (string) | Имя пользователя для загрузки образа с заданного URL-адреса. Используется при создании образа. |
+| virt_id | (integer) | Уникальный целочисленный идентификатор виртуального образа. Может использоваться для получения информации о виртуальном образе, а также для привязки к нему другого образа.| 
+| virt_name | (string) | Имя виртуального образа. Используется для получения `virt_id`, а в последствии информации о виртуальном образе, а также для создания виртуального образа и привязки к нему другого образа.|
+
+
+## Возвращаемые значения модуля decort_osimage
+
+Модуль decort_osimage возвращает информацию об образе в виде словаря facts со следующими ключами:
+
+
+| Ключ | Тип  данных | Описание |
+| ------ | ------ | ------ |
+| accountId | int | Идентификатор аккаунта.
+| id | int | Уникальный целочисленный идентификатор данного образа. |
+| linkto | int | Уникальный целочисленный идентификатор образа, который привязан к данному виртуальному. |
+| name | string | Имя образа. |
+| pool | string | Имя пула на системе хранения данных, в котором находится данный образ.|
+| sep_id | int |	Идентификатор системы хранения данных, на которой хранится данный образ. |
+| size | int | Размер образа в ГБ. |
+| state | string |  Текущий статус образа. |
+| type | string | Тип образа. |
+
+
+
+## Пример использования модуля decort_osimage 
+
+
+Пример создания шаблонного образа с операционной системой Alpine Linux.
+```
+  - name: Create template image
+    decort_osimage:
+      account_Id: 12345
+      app_id: "{{ my_app_id }}"
+      app_secret: "{{ my_app_secret }}"
+      authenticator: oauth2
+      controller_url: "https://ds1.digitalenergy.online"
+      image_name: alpine_linux_3.19.1
+      url: https://dl-cdn.alpinelinux.org/alpine/v3.19/releases/cloud/nocloud_alpine-3.19.1-x86_64-uefi-cloudinit-r0.qcow2
+      verify_ssl: false
+    register: osimage
+```
+
+Пример получения информации о существующем шаблонном образе по его имени.
+
+```
+  - name: Get template image
+    decort_osimage:
+      account_Id: 12345
+      app_id: "{{ my_app_id }}"
+      app_secret: "{{ my_app_secret }}"
+      authenticator: oauth2
+      controller_url: "https://ds1.digitalenergy.online"
+      image_name: alpine_linux_3.19.1
+      verify_ssl: false
+    register: osimage
+```
+
+Пример создания виртуального образа. Также в случае, если виртуальный образ уже существует, но к нему привязан другой шаблонный образ, он привяжет к себе указанный в примере шаблонный образ.
+
+```
+  - name: Create virtual image 
+    decort_osimage:
+      app_id: "{{ my_app_id }}"
+      app_secret: "{{ my_app_secret }}"
+      authenticator: oauth2
+      controller_url: "https://ds1.digitalenergy.online"
+      image_name: alpine_linux_3.19.1
+      virt_name: alpine_last
+    register: osimage
+```
+Обратите внимание, что в данном примере можно использовать как `image_name`, так и `image_id`. Также можно использовать либо `virt_name`, либо `virt_id`.
+
+Пример переименования образа.
+
+```
+  - name: Rename template image 
+    decort_osimage:
+      app_id: "{{ my_app_id }}"
+      app_secret: "{{ my_app_secret }}"
+      authenticator: oauth2
+      controller_url: "https://ds1.digitalenergy.online"
+      image_name: alpine_linux_3.19.1_new_name
+      image_id: 54321
+    register: osimage
+```
+

wiki/7.1.0/модуль-decort_pfw.md

@@ -0,0 +1,66 @@
+# Модуль decort_pfw
+## Обзор модуля decort_pfw
+
+Модуль **decort_pfw** предназначен для настройки правил переадресации портов (port forwarding, destination NAT) на виртуальном маршрутизаторе заданной внутренней сети для заданной виртуальной машины.  
+Модуль поддерживает выполнение следующих действий над правилами:
+- добавить
+- получить информацию
+- удалить
+
+## Параметры модуля decort_pfw
+Ниже приведен список параметров для модуля **decort_pfw** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+| Параметр | Тип, допустимые значения | Описание|
+| ------ | ------ | ------ |
+| compute_id | (int) | Идентификатор виртуальной машины. IP-адрес, который данная ВМ имеет во внутренней сети, заданной параметром `vins_id`, будет использоваться как внутренний IP-адрес в правилах. Обязательный параметр. |
+| rules | (list) | Список словарей, описывающих правила переадресации портов для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`).<br>Ключи словаря:<br>&bull; `local_port` (int) (обязательный) - внутренний порт; значения: от `1` до `65535`<br>&bull; `proto` (str) (обязательный) - протокол; значения: `tcp` или `udp`<br>&bull; `public_port_end` (int) (необязательный) - верхняя граница диапазона внешних портов; значения: от значения ключа `public_port_start` до `65535`;<br>&bull; `public_port_start` (int) (обязательный) - нижняя граница диапазона внешних портов; значения: от `1` до `65535` |
+| state | (str)<br>Значения:<br/>`present`<br/>`absent`<br>Default: `present` | Целевое состояние правил.<br>Если `state=absent`, то, независимо от содержания параметра `rules`, будут удалены все правила для заданной ВМ (параметр `compute_id`) на виртуальном маршрутизаторе заданной внутренней сети (параметр `vins_id`). |
+| vins_id | (int) | Идентификатор внутренней сети, на виртуальном маршрутизаторе которой настраиваются правила переадресации портов. Заданная ВМ (параметр `compute_id`) должна быть подключена к этой сети. Обязательный параметр. |
+
+
+## Возвращаемые значения модуля decort_pfw
+
+Модуль **decort_pfw** возвращает информацию о правилах переадресации портов и сопутствующую информацию в виде словаря `facts` со следующими ключами:
+
+
+|Ключ | Тип данных | Описание|
+| ------ | ------ | ------ |
+| compute_id | int | Идентификатор ВМ. |
+| public_ip | string | IP-адрес во внешней сети, настроенный на виртуальном маршрутизаторе внутренней сети. |
+| rules | list | Список словарей, описывающих правила переадресации портов.<br>Ключи словаря:<br>&bull; `id` (int) - идентификатор правила<br>&bull; `localIp` (str) - IP-адрес ВМ<br>&bull; `localPort` (int) - внутренний порт<br>&bull; `protocol` (str) - протокол<br>&bull; `publicPortEnd` (int) - верхняя граница диапазона внешних портов<br>&bull; `publicPortStart` (int) - нижняя граница диапазона внешних портов<br>&bull; `vmId` (int) - идентификатор ВМ<br>&bull; `vmName` (str) - имя ВМ |
+| state | string | Статус правил. Значения: `PRESENT` или `ABSENT`. |
+| vins_id | int | Идентификатор внутренней сети. |
+
+## Пример использования модуля decort_pfw
+
+В данном примере для существующей ВМ (параметр `compute_id`), подключённой к внутренней сети (параметр `vins_id`), настраиваются два правила переадресации портов:
+
+- Правило для одного порта: внешний порт `30022` на внутренний порт `22` по протоколу `tcp`.
+- Правило для диапазона портов: внешние порты с `30080` по `30085` на внутренние порты с `30080` по протоколу `udp`.
+
+```
+- name: Add port forwarding rules
+  decort_pfw:
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    authenticator: oauth2
+    compute_id: "{{ my_vm.facts.id }}"
+    controller_url: "https://cloud.digitalenergy.online"
+    oauth2_url: "https://sso.digitalenergy.online"
+    rules:
+      - local_port: 22
+        proto: tcp
+        public_port_start: 30022
+      - local_port: 30080
+        proto: udp
+        public_port_end: 30085
+        public_port_start: 30080
+    vins_id: "{{ my_vins.facts.id }}"
+  register: my_pfw_rules
+```
+
+В данном примере результат выполнения модуля **decort_pfw** записывается в переменную `my_pfw_rules`. Для доступа к списку правил используйте следующую конструкцию:
+
+```
+"{{ my_pfw_rules.facts.rules }}"
+```

wiki/7.1.0/модуль-decort_rg.md

@@ -0,0 +1,220 @@
+# Модуль decort_rg
+
+## Обзор модуля decort_rg
+
+Модуль decort_rg предназначен для создания, редактирования и удаления ресурсных групп (Resource Group, RG) в облачной платформе DECORT, а также для получения информации об уже существующей ресурсной группе. Модуль decort_rg позволяет:
+
+- создавать ресурсные группы
+- удалять ресурсные группы (в корзину или безвозвратно)
+- восстанавливать ресурсные группы из корзины
+- включать/отключать ресурсные группы
+- запрашивать информацию об уже существующих ресурсных группах
+- изменять ресурсные группы:
+  - переименовывать
+  - настраивать квоты
+  - задавать стандартную сеть
+  - настраивать права доступа для пользователей
+  - изменять доступные пулы СХД
+
+## Параметры модуля decort_rg
+Ниже приведен список параметров для модуля **decort_rg** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+| Параметр | Тип, допустимые значения | Описание |
+|----------|--------------------------|----------|
+| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то account_name игнорируется. |
+| account_name | (string) | Имя аккаунта, в рамках которого создаётся или уже существует данная ресурсная группа. Должно быть задано либо имя, либо идентификатор учётной записи (см. параметр `account_id`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется. |
+| access | (dict) | Параметр, позволяющий выдать, забрать или изменить права у пользователя в ресурсной группе. |
+| description | (string) | Текстовое описание ресурсной группы. Данный параметр является опциональным и учитывается только при создании ресурсной группы, а при всех прочих операциях игнорируется. |
+| def_netId | (int) | Уникальный целочисленный идентификатор внутренней или внешней сети. Используется для изменения сети по умолчанию в ресурсной группе. |
+| def_netType | (string) <br>Значения:<br>`PRIVATE`<br>`PUBLIC`<br>`NONE`<br>Default: `PRIVATE` | Тип сети по умолчанию в ресурсной группе. Используется при создании ресурсной группы, а также при изменении. |
+| extNetId | (int) | Уникальный целочисленный идентификатор внешней сети.<br>Если `def_netType: PRIVATE`, то указывает какую внешнюю сеть подключить к создаваемой внутренней сети, которая будет задана как сеть по умолчанию для создаваемой РГ.<br>Если `def_netType: PUBLIC`, то указывает какую внешнюю сеть задать как сеть по умолчанию для создаваемой РГ. |
+| extNetIp | (string) | IP-адрес для внешней сети, которая задана в параметре `extNetId`. |
+| ipcidr | (string) | IP-адрес внутренней сети. Используется при создании ресурсной группы, чтобы задать IP-адрес сети для создаваемой внутренней сети, которая создастся вместе с ресурсной группой. Используется при параметре `def_netType` в значении `PRIVATE`. |
+| owner | (string) | Владелец ресурсной группы. Задаётся при создании ресурсной группы, не обязателен. Если оставить пустое значение - владельцем ресурсной группы будет пользователь, создавший ресурсную группу. |
+| permanently | (bool)<br>Default: `false` | Параметр, использующийся при удалении ресурсной группы. При значении `true` - ресурсная группа удалится безвозвратно, а при `false` - попадёт в корзину. |
+| quotas | (dict) | Предназначено для задания или изменения квоты на ресурсы в составе данной ресурсной группы. |
+| rename | (string) | Новое имя ресурсной группы.<br>Возможно переименование только включенной ресурсной группы. |
+| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы. Является обязательным при изменении РГ если не заданы `rg_name` и `account_id`/`account_name` |
+| rg_name | (string) | Имя ресурсной группы. Данный параметр является обязательным при создании. |
+| sep_pools| (list) | Список словарей, описывающих доступные пулы СХД.<br>Ключи словаря:<br>&bull; `sep_id` (int) - идентификатор системы хранения данных.<br>&bull; `pool_names` (list) - список названий пулов системы хранения данных.<br>Чтобы очистить список доступных пулов, нужно указать пустой список `[]`.|
+| state | Значения:<br>`present`<br>`absent`<br>`enabled`<br>`disabled`<br>Default: `present` | Целевое состояние ресурсной группы. |
+
+## Возвращаемые значения модуля decort_rg
+
+Модуль decort_rg возвращает информацию о ресурсной группе в виде словаря facts со следующими ключами:
+| Ключ | Тип данных | Описание |
+|------|------------|----------|
+| account_id | int | Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная ресурсная группа. |
+| gid | int | Идентификатор физического кластера (Grid ID), на базе которого развёрнута ресурсная группа. |
+| id | int | Уникальный целочисленный идентификатор ресурсной группы. |
+| name | string | Имя ресурсной группы. Обратите внимание, что это имя уникально только в рамках аккаунта, которому принадлежит данная ресурсная группа. |
+| state | string | Текущее состояние ресурсной группы. |
+| quota | dict | Текущие квоты ресурсной группы. |
+| resTypes | list | Список типов ресурсов, разрешенных к созданию в данной ресурсной группе. |
+| defNetId | int | Уникальный целочисленный идентификатор сети по умолчанию в данной ресурсной группе. |
+| defNetType | string | Тип сети по умолчанию в данной ресурсной группе. |
+| ViNS | list | Список идентификаторов внутренних сетей ресурсной группы. |
+| computes | list | Список идентификаторов виртуальных машин ресурсной группы. |
+| uniqPools | list | Список доступных пулов СХД. |
+
+## Пример использования модуля decort_rg
+
+В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount.
+
+```
+- name: manage resource group
+  decort_rg:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    account_name: "MyAccount"
+    rg_name: "MyRG"
+    state: present
+  register: my_rg
+  delegate_to: localhost
+```
+
+В данном примере показано, как создать ресурсную группу по имени MyRG в аккаунте MyAccount, также задать квоты и выдать права на чтение пользователю MyUser.
+
+```
+- name: manage resource group
+  decort_rg:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    account_name: "MyAccount"
+    rg_name: "MyRG"
+    access:
+      action: "grant"
+      user: "MyUser"
+      right: "R"
+    quotas:
+      cpu: 16
+      ram: 16384
+      disk: 100
+      ext_ips: 20
+      net_transfer: 1000
+    state: present
+  register: my_rg
+  delegate_to: localhost
+```
+
+В данном примере показано, как выдать доступ на чтение и запись пользователю MyUser в ресурсной группе по имени MyRG в аккаунте MyAccount.
+
+```
+- name: manage resource group
+  decort_rg:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    account_name: "MyAccount"
+    rg_name: "MyRG"
+    access:
+      action: "grant"
+      user: "MyUser"
+      right: "RCX"
+    state: present
+  register: my_rg
+  delegate_to: localhost
+```
+
+В данном примере показано, как сменить квоту в ресурсной группе по имени MyRG в аккаунте MyAccount.
+
+```
+- name: manage resource group
+  decort_rg:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    account_name: "MyAccount"
+    rg_name: "MyRG"
+    quotas:
+      cpu: 16
+      ram: 16384
+      disk: 100
+      ext_ips: 20
+      net_transfer: 1000
+    state: present
+  register: my_rg
+  delegate_to: localhost
+```
+
+В данном примере показано, как изменить сеть по умолчанию в ресурсной группе по имени MyRG в аккаунте MyAccount.
+
+```
+- name: manage resource group
+  decort_rg:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    account_name: "MyAccount"
+    rg_name: "MyRG"
+    def_netType: "PRIVATE"
+    def_netId: 99
+    state: present
+  register: my_rg
+  delegate_to: localhost
+```
+
+В данном примере показано, как переименовать ресурсную группу по имени MyRG на новое имя "NewRg" в аккаунте MyAccount.
+
+```
+- name: manage resource group
+  decort_rg:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    account_name: "MyAccount"
+    rg_name: "MyRG"
+    rename: "NewRg"
+    rg_id: 27
+    state: present
+  register: my_rg
+  delegate_to: localhost
+```
+
+В данном примере результат работы модуля decort_rg записывается в переменную my_rg.
+
+Модули DECORT, которым для работы требуется ресурсная группа, в качестве одного из параметров, как правило, принимают идентификатор `rg_id`. Так, например, используя модуль `decort_kvmvm` для создания виртуального сервера необходимо указать ресурсную группу, к которой будет принадлежать этот виртуальный сервер. Сделать это можно следующим образом:
+
+```
+   <прочие детали опущены>
+   rg_id: "{{ my_rg.facts.id }}"
+```
+
+В данном примере показано, как изменить доступные пулы СХД в ресурсной группе по имени MyRG в аккаунте MyAccount.
+
+```
+- name: change available sep pools
+  decort_rg:
+    authenticator: oauth2
+    app_id: "{{ my_app_id }}"
+    app_secret: "{{ my_app_secret }}"
+    oauth2_url: "https://sso.digitalenergy.online"
+    controller_url: "https://cloud.digitalenergy.online"
+    account_name: "MyAccount"
+    rg_name: "MyRG"
+    sep_pools:
+      - sep_id: 1
+        pool_names:
+          - sep1_pool1
+          - sep1_pool2
+      - sep_id: 2
+        pool_names:
+          - sep2_pool1
+    state: present
+  register: my_rg
+  delegate_to: localhost
+```

wiki/7.1.0/модуль-decort_snapshot.md

@@ -0,0 +1,248 @@
+# Модуль decort_snapshot
+## Обзор модуля
+
+Модуль **decort_snapshot** предназначен для выполнения следующих действий над снимками виртуальных машин:
+- **создать** (см. [параметр state](#state) и [примеры](#создать))
+- **удалить** (см. [параметр state](#state) и [примеры](#удалить))
+- **получить основную информацию о снимке** (см. [возвращаемые значения](#основная-информация) и [примеры](#получить-основную-информацию-о-снимке))
+- **получить информацию о размере снимка** (см. [параметр usage](#usage), [возвращаемые значения](#размер-снимка) и [примеры](#получить-информацию-о-размере-снимка))
+
+## Параметры модуля
+Ниже приведен список параметров для модуля **decort_snapshot** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+<table>
+  <tr>
+    <th colspan="6">Параметр</th>
+    <th>Тип</th>
+    <th>Описание</th>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="label">
+        label
+      </a>
+    </td>
+    <td>
+      (str)
+    </td>
+    <td>
+      Метка снимка виртуальной машины. Если метка не указана при создании, она будет сгенерирована автоматически на основе даты и времени - <code>vm_name_2024-12-10_16-40-52</code>.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="state">
+        state
+      </a>
+    </td>
+    <td>
+      (str)
+      <br>Значения:
+      <br><code>absent</code>
+      <br><code>present</code>
+    </td>
+    <td>
+      Целевое состояние.
+      <br><code>absent</code> - снимок удален.
+      <br><code>present</code> - снимок существует.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="usage">
+        usage
+      </a>
+    </td>
+    <td>
+      (bool)
+      <br>Default:<code>false</code>
+    </td>
+    <td>
+      Получить информацию о реальном размере снимка виртуальной машины.
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      <a name="vm_id">
+        vm_id
+      </a>
+    </td>
+    <td>
+      (int)
+    </td>
+    <td>
+      Идентификатор виртуальной машины.
+      <br>Обязательный параметр.
+    </td>
+  </tr>
+</table>
+
+## Возвращаемые значения
+
+Модуль **decort_snapshot** возвращает информацию о снимке виртуальной машины в виде словаря `facts` со следующими ключами:
+
+### Основная информация
+
+<table>
+  <tr>
+    <th colspan="6">
+      Ключ
+    </th>
+    <th>
+      Тип
+      <br>данных
+    </th>
+    <th>
+      Описание
+    </th>
+  </tr>
+  <tr>
+    <td colspan="6">
+      disks
+    </td>
+    <td>
+      list
+    </td>
+    <td>
+      Диски
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      guid
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Идентификатор снимка
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      label
+    </td>
+    <td>
+      str
+    </td>
+    <td>
+      Метка снимка
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      timestamp
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Временная метка создания снимка
+    </td>
+  </tr>
+  <tr>
+    <td colspan="6">
+      vm_id
+    </td>
+    <td>
+      int
+    </td>
+    <td>
+      Идентификатор виртуальной машины
+    </td>
+  </tr>
+</table>
+
+### Размер снимка
+<table>
+  <tr>
+    <th colspan="6">
+      Ключ
+    </th>
+    <th>
+      Тип
+      <br>данных
+    </th>
+    <th>
+      Описание
+    </th>
+  </tr>
+  <tr>
+    <td colspan="6">
+      stored
+    </td>
+    <td>
+      float
+    </td>
+    <td>
+      Размер снимка
+    </td>
+  </tr>
+</table>
+
+## Примеры использования
+
+### Создать
+
+#### С указанием метки
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create snapshot
+      decort_snapshot:
+        # Параметры для авторизации упущены
+        vm_id: "{{ vm_id }}"
+        label: "{{ snapshot_label }}"
+        state: present
+```
+
+#### Без указания метки
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Create snapshot
+      decort_snapshot:
+        # Параметры для авторизации упущены
+        vm_id: "{{ vm_id }}"
+        state: present
+```
+
+### Удалить
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Delete snapshot
+      decort_snapshot:
+        # Параметры для авторизации упущены
+        vm_id: "{{ vm_id }}"
+        label: "{{ snapshot_label }}"
+        state: absent
+```
+
+### Получить основную информацию о снимке
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Get basic snapshot info
+      decort_snapshot:
+        # Параметры для авторизации упущены
+        vm_id: "{{ vm_id }}"
+        label: "{{ snapshot_label }}"
+```
+
+### Получить информацию о размере снимка
+```
+- name: Example
+  hosts: localhost
+  tasks:
+    - name: Get snapshot usage
+      decort_snapshot:
+        # Параметры для авторизации упущены
+        vm_id: "{{ vm_id }}"
+        label: "{{ snapshot_label }}"
+        usage: true
+```

wiki/7.1.0/модуль-decort_vins.md

@@ -0,0 +1,110 @@
+# Модуль decort_vins
+## Обзор модуля decort_vins
+
+Модуль decort_vins предназначен для управления внутренними сетями (Virtual Network Segment, ViNS) и позволяет производить с ними следующие действия:
+- создавать
+  - на уровне ресурсной группы (если РГ задана)
+  - на уровне аккаунта (если РГ не задана)
+- удалять (безвозвратно)
+- восстанавливать из корзины
+- запрашивать информацию
+- включать/отключать
+- соединять (необходимы права администратора)
+- изменять:
+  - включать/отключать SSH-доступ к виртуальному маршрутизатору (необходимы права администратора)
+  - включать/отключать режим **Custom Config** для виртуального маршрутизатора (необходимы права администратора)
+  - сохранять конфигурацию виртуального маршрутизатора для возможности последующего отката к ней (необходимы права администратора)
+
+## Параметры модуля decort_vins
+Ниже приведен список параметров для модуля **decort_vins** (за исключением [общих параметров авторизации](./введение.md#общие-параметры-модулей-для-авторизации)):
+
+| Параметр |	Тип, допустимые значения |	Описание |
+| ------ | ------ | ------ |
+| account_id |	(int) |	Уникальный целочисленный идентификатор аккаунта, которому принадлежит данная внутреняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должен быть задан либо идентификатор, либо имя аккаунта (см. параметр `account_name`). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.|
+| account_name |	(string) |	Имя аккаунта, которому принадлежит данная внутренняя сеть. При идентификации внутренней сети по имени (см. параметр `vins_name`) должно быть задано либо имя, либо идентификатор аккаунта (см. параметр account_id). Если одновременно заданы и `account_id`, и `account_name`, то `account_name` игнорируется.|
+|description |	(string)| Текстовое описание внутренней сети. Данный аргумент является опциональным и учитывается только при создании внутренней сети, а при всех прочих операциях игнорируется.|
+| ext_net_id | (int) | Идентификатор внешней сети, к которой должна быть подключена внутренняя сеть. Если задать значение `0`, то платформой будет выбрана внешняя сеть по умолчанию. |
+| ext_ip_addr |	(string) | IP-адрес внешней сети, заданной через параметр `ext_net_id`. Если не задан, то IP-адрес для внешней сети будет выбран платформой автоматически.
+| ipcidr |	(string) |	Адрес сети для создаваемой внутренней сети. Если этот параметр не задан, то платформа назначит адрес автоматически. Обратите внимание, что внутренние сети, принадлежащие одному и тому же аккаунту, не могут иметь пересекающихся сетей.|
+|rg_id |	(int) |	Идентификатор ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_id` и `rg_name`, то `rg_name` игнорируется.|
+| rg_name |	(string) |	Имя ресурсной группы, в которой должна быть создана или уже существует внутренняя сеть. Если одновременно заданы `rg_name` и `rg_id`, то `rg_name` игнорируется.|
+| state | (string)<br>Значения:<br/>`present`<br/>`absent`<br/>`enabled`<br/>`disabled`<br/>Default: `present` | Целевое состояние внутренней сети. |
+| vins_id |	(int) |	Идентификатор внутренней сети. Соответствующая внутренная сеть должна существовать. Таким образом, с помощью `vins_id` нельзя создать новую внутреннюю сеть, а только управлять уже имеющимися. Если задан данный параметр, то параметры `vins_name`, `account_name`, `account_id`, `rg_name` и `rg_id` игнорируются.|
+| vins_name| 	(string) |	Имя внутренней сети. Для идентификации внутренней сети требуется либо `vins_name` и информация об аккаунте/ресурсной группе, которой принадлежит сеть, либо `vins_id`. Обратите внимание, что это имя уникально только в рамках ресурсной группы или аккаунта, на уровне которого существует данная внутренняя сеть.|
+| mgmtaddr | (list) | Список существующих IP-адресов виртуального маршрутизатора во внутренней сети, через которые необходимо разрешить SSH-доступ к виртуальному маршрутизатору.
+| custom_config | (bool)<br>Default: `false` | Включить/отключить режим пользовательской конфигурации виртуального маршрутизатора. |
+| config_save | (bool)<br>Default: `false` | Выполнить сохранение текущей конфигурации виртуального маршрутизатора для возможности последующего отката к ней. |
+| connect_to | (list) | Список словарей, содержащих информацию о внутренних сетях, к которым необходимо подключить данную. См. примеры.
+
+## Возвращаемые значения модуля decort_vins
+
+Модуль decort_vins возвращает информацию о внутренней сети в виде словаря facts со следующими ключами:
+
+| Ключ | Тип данных | Описание |
+| --- | --- | --- |
+| account_id | (int) | Уникальный целочисленный идентификатор аккаунта, которому принадлежит внутренняя сеть. |
+| custom_net_addr | (list) | Список IP-адресов пользовательских интерфейсов виртуального маршрутизатора
+| ext_ip_addr | (string) | IP-адрес интерфейса, которым виртуальный маршрутизатор подключён к внешней сети. |
+| ext_net_id | (int) | Идентификатор внешней сети, к которой подключена внутренняя сеть. `-1` означает, что внутренняя сеть не подключёна к внешней сети. |
+| gid | (int) | Идентификатор физического кластера (Grid ID), на базе которого развёрнуты ресурсы данной внутренней сети. |
+| id | (int) | Уникальный целочисленный идентификатор внутренней сети. |
+| name | (string) | Имя внутренней сети. |
+| int_net_addr | (string) | Адрес внутренней сети. |
+| rg_id | (int) | Уникальный целочисленный идентификатор ресурсной группы, которой принадлежит данная внутренняя сеть. Если данная внутренняя сеть создана на уровне аккаунта, то `rg_id=0`. |
+| ssh_ipaddr | (list) | Список IP-адресов виртуального маршрутизатора во внутренней сети, на которых включён SSH-доступ к нему.
+| ssh_password | (str) | Пароль для SSH-доступа к виртуальному маршрутизатору.
+| ssh_port | (int) | Номер порта для SSH-подключения к виртуальному маршрутизатору.
+| state | (string) | Состояние внутренней сети. |
+
+
+
+## Пример использования модуля decort_vins
+
+В данном примере создаётся внутренняя сеть с именем "MyVins01" (vins_name: "MyVins01").
+
+Внутренняя сеть создаётся на уровне ресурсной группы "MyRg01" (rg_name: "MyRg01"), принадлежащей аккаунту "MyMainAccount" (account_name: "MyMainAccount"). Внутренняя сеть будет иметь подключение во внешнюю сеть по умолчанию (ext_net_id: 0).
+```
+  - name: Manage ViNS on resource group level
+    decort_vins:
+      account_name: "MyMainAccount"
+      rg_name: "MyRg01"
+      authenticator: jwt
+      jwt: "{{ my_jwt.jwt }}"
+      controller_url: "https://ds1.digitalenergy.online"
+      ext_net_id: 0
+      vins_name: "MyVins01"
+    register: my_vins
+  ```
+
+Здесь результат исполнения модуля decort_vins записывается в переменную my_vins, которую можно дальше использовать в Ansible playbooks. Ниже показано, как получить и использовать идентификатор внутренней сети для подключения к нему виртуального сервера.
+```
+- name: Manage virtual machine
+  decort_kvmvm:
+    << для краткости фрагмент опущен >>
+    networks:
+      - type: VINS
+        id: "{{ my_vins.facts.id }}"
+    << для краткости фрагмент опущен >>
+```
+
+В данном примере идёт создание внутренней сети, а потом её привязка к внутренним сетям с id 864 и 196.
+```
+  - name: Manage ViNS on resource group level
+    decort_vins:
+      authenticator: jwt
+      jwt: "{{ my_jwt.jwt }}"
+      controller_url: "https://cloud.digitalenergy.online"
+      vins_name: "ViNS_connected_by_decort_vins_module"
+      rg_id: 98
+      connect_to:
+       - id: 864
+         ipaddr: 192.168.5.66
+         netmask: 24
+       - id: 196
+         ipaddr: 192.168.9.133
+         netmask: 24
+    register: managed_vins
+
+```
+
+

wiki/Home.md

@@ -1,5 +1,7 @@
 ## Документация:
 
+- [Модули Ansible версии 7.1.0](./7.1.0/Home.md)
+- [Модули Ansible версии 7.0.0](./7.0.0/Home.md)
 - [Модули Ansible версии 6.1.0](./6.1.0/Home.md)
 - [Модули Ansible версии 6.0.0](./6.0.0/Home.md)
 - [Модули Ansible версии 5.6.0](./5.6.0/Home.md)