improved vmss documentation (#43590)

lib/ansible/modules/cloud/azure/azure_rm_virtualmachine_scaleset_facts.py

@@ -73,39 +73,150 @@ RETURN = '''
 azure_vmss:
     description: List of virtual machine scale sets
     returned: always
-    type: list
+    type: complex
-    example: [{
+    contains:
-        "admin_username": "testuser",
+        admin_username:
-        "capacity": 2,
+            description:
-        "data_disks": [
+                - Admin username used to access the host after it is created.
-            {
+            returned: always
-                "caching": "ReadWrite",
+            type: str
-                "disk_size_gb": 64,
+            sample: adminuser
-                "lun": 0,
+        capacity:
-                "managed_disk_type": "Standard_LRS"
+            description:
-            }
+                - Capacity of VMSS.
-        ],
+            returned: always
-        "image": {
+            type: int
-            "offer": "CoreOS",
+            sample: 2
-            "publisher": "CoreOS",
+        data_disks:
-            "sku": "Stable",
+            description:
-            "version": "899.17.0"
+                - List of attached data disks.
-        },
+            returned: always
-        "load_balancer": null,
+            type: complex
-        "location": "eastus",
+            contains:
-        "managed_disk_type": "Standard_LRS",
+                caching:
-        "name": "testVMSSeb4fd3c704",
+                    description:
-        "os_disk_caching": "ReadWrite",
+                        - Type of data disk caching.
-        "os_type": "Linux",
+                    type: str
-        "resource_group": "myresourcegroup",
+                    sample: ReadOnly
-        "ssh_password_enabled": false,
+                disk_size_gb:
-        "state": "present",
+                    description:
-        "subnet_name": null,
+                        - The initial disk size in GB for blank data disks
-        "tier": "Standard",
+                    type: int
-        "upgrade_policy": "Manual",
+                    sample: 64
-        "virtual_network_name": null,
+                lun:
-        "vm_size": "Standard_DS1_v2"
+                    description:
-    }]
+                        - The logical unit number for data disk
+                    type: int
+                    sample: 0
+                managed_disk_type:
+                    description:
+                        - Managed data disk type
+                    type: str
+                    sample: Standard_LRS
+        image:
+            description:
+                - Image specification
+            returned: always
+            type: complex
+            contains:
+                offer:
+                    description:
+                        - Offer.
+                    type: str
+                    sample: RHEL
+                publisher:
+                    description:
+                        - Publisher name.
+                    type: str
+                    sample: RedHat
+                sku:
+                    description:
+                        - SKU name.
+                    type: str
+                    sample: 7-RAW
+                version:
+                    description:
+                        - Image version.
+                    type: str
+                    sample: 7.5.2018050901
+        load_balancer:
+            description:
+                - Load balancer name.
+            returned: always
+            type: str
+            sample: testlb
+        location:
+            description:
+                - Resource location.
+            type: str
+            returned: always
+            sample: japaneast
+        managed_disk_type:
+            description:
+                - Managed data disk type
+            type: str
+            returned: always
+            sample: Standard_LRS
+        name:
+            description:
+                - Resource name.
+            returned: always
+            type: str
+            sample: myvmss
+        os_disk_caching:
+            description:
+                - Type of OS disk caching.
+            type: str
+            returned: always
+            sample: ReadOnly
+        os_type:
+            description:
+                - Base type of operating system.
+            type: str
+            returned: always
+            sample: Linux
+        resource_group:
+            description:
+                - Resource group.
+            type: str
+            returned: always
+            sample: testrg
+        ssh_password_enabled:
+            description:
+                - Is SSH password authentication enabled. Valid only for Linux.
+            type: bool
+            returned: always
+            sample: true
+        subnet_name:
+            description:
+                - Subnet name.
+            type: str
+            returned: always
+            sample: testsubnet
+        tier:
+            description:
+                - SKU Tier.
+            type: str
+            returned: always
+            sample: Basic
+        upgrade_policy:
+            description:
+                - Upgrade policy.
+            type: str
+            returned: always
+            sample: Manual
+        virtual_network_name:
+            description:
+                - Associated virtual network name.
+            type: str
+            returned: always
+            sample: testvn
+        vm_size:
+            description:
+                - Virtual machine size.
+            type: str
+            returned: always
+            sample: Standard_D4
 '''  # NOQA
 
 from ansible.module_utils.azure_rm_common import AzureRMModuleBase