adjusting curated response format, notification of raw format depreciation. (#43587)

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

@@ -38,6 +38,7 @@ options:
             - If C(raw) is selected information will be returned in raw format from Azure Python SDK.
             - If C(curated) is selected the structure will be identical to input parameters of azure_rm_virtualmachine_scaleset module.
             - In Ansible 2.5 and lower facts are always returned in raw format.
+            - Please note that this option will be deprecated in 2.10 when curated format will become the only supported format.
         default: 'raw'
         choices:
             - 'curated'
@@ -70,7 +71,7 @@ EXAMPLES = '''
 '''
 
 RETURN = '''
-azure_vmss:
+vmss:
     description: List of virtual machine scale sets
     returned: always
     type: complex
@@ -345,6 +346,10 @@ class AzureRMVirtualMachineScaleSetFacts(AzureRMModuleBase):
 
                 self.results['ansible_facts']['azure_vmss'][index] = updated
 
+            # proper result format we want to support in the future
+            # dropping 'ansible_facts' and shorter name 'vmss'
+            self.results['vmss'] = self.results['ansible_facts']['azure_vmss']
+
         return self.results
 
     def get_item(self):

test/integration/targets/azure_rm_virtualmachine_scaleset/tasks/main.yml

@@ -100,7 +100,7 @@
 
 - name: Get scaleset body
   set_fact:
-    body: "{{ output_scaleset.ansible_facts.azure_vmss[0] }}"
+    body: "{{ output_scaleset.vmss[0] }}"
 
 - name: Try to update VMSS using output as input
   azure_rm_virtualmachine_scaleset: