From 6208294054268a1bcfaa64c419d3c39286705a09 Mon Sep 17 00:00:00 2001
From: Fred-sun <37327967+Fred-sun@users.noreply.github.com>
Date: Wed, 31 Jul 2019 03:38:00 +0800
Subject: [PATCH] Update the document according to the yuwzho-datadisk branch
 (#59491)

---
 .../cloud/azure/azure_rm_virtualmachine.py    | 30 ++++++++++++++-----
 1 file changed, 23 insertions(+), 7 deletions(-)

diff --git a/lib/ansible/modules/cloud/azure/azure_rm_virtualmachine.py b/lib/ansible/modules/cloud/azure/azure_rm_virtualmachine.py
index b1daa080f0e..3edd3fbe9a1 100644
--- a/lib/ansible/modules/cloud/azure/azure_rm_virtualmachine.py
+++ b/lib/ansible/modules/cloud/azure/azure_rm_virtualmachine.py
@@ -145,6 +145,8 @@ options:
     managed_disk_type:
         description:
             - Managed OS disk type.
+            - Create OS disk with managed disk if defined.
+            - If not defined, the OS disk will be created with virtual hard disk (VHD).
         choices:
             - Standard_LRS
             - StandardSSD_LRS
@@ -176,21 +178,27 @@ options:
         default: Linux
     data_disks:
         description:
-            - List of data disks.
+            - Describes list of data disks.
+            - Use M(azure_rm_mangeddisk) to manage the specific disk.
         version_added: "2.4"
         suboptions:
             lun:
                 description:
                     - The logical unit number for data disk.
-                default: 0
+                    - This value is used to identify data disks within the VM and therefore must be unique for each data disk attached to a VM.
+                required: true
                 version_added: "2.4"
             disk_size_gb:
                 description:
                     - The initial disk size in GB for blank data disks.
+                    - This value cannot be larger than C(1023) GB.
+                    - Size can be changed only when the virtual machine is deallocated.
+                    - Not sure when I(managed_disk_id) defined.
                 version_added: "2.4"
             managed_disk_type:
                 description:
                     - Managed data disk type.
+                    - Only used when OS disk created with managed disk.
                 choices:
                     - Standard_LRS
                     - StandardSSD_LRS
@@ -199,19 +207,28 @@ options:
             storage_account_name:
                 description:
                     - Name of an existing storage account that supports creation of VHD blobs.
-                    - If not specified for a new data disk, a new storage account named <vm name>01 will be created using storage type C(Standard_LRS).
+                    - If not specified for a new VM, a new storage account started with I(name) will be created using storage type C(Standard_LRS).
+                    - Only used when OS disk created with virtual hard disk (VHD).
+                    - Used when I(managed_disk_type) not defined.
+                    - Cannot be updated unless I(lun) updated.
                 version_added: "2.4"
             storage_container_name:
                 description:
                     - Name of the container to use within the storage account to store VHD blobs.
-                    - If not specified, a default container will created.
+                    - If no name is specified a default container named 'vhds' will created.
+                    - Only used when OS disk created with virtual hard disk (VHD).
+                    - Used when I(managed_disk_type) not defined.
+                    - Cannot be updated unless I(lun) updated.
                 default: vhds
                 version_added: "2.4"
             storage_blob_name:
                 description:
                     - Name of the storage blob used to hold the OS disk image of the VM.
                     - Must end with '.vhd'.
-                    - If not specified, defaults to the VM name + '.vhd'.
+                    - Default to the I(name) + timestamp + I(lun) + '.vhd'.
+                    - Only used when OS disk created with virtual hard disk (VHD).
+                    - Used when I(managed_disk_type) not defined.
+                    - Cannot be updated unless I(lun) updated.
                 version_added: "2.4"
             caching:
                 description:
@@ -445,8 +462,7 @@ EXAMPLES = '''
       version: latest
     data_disks:
       - lun: 0
-        disk_size_gb: 64
-        managed_disk_type: Standard_LRS
+        managed_disk_id: "/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myDisk"
       - lun: 1
         disk_size_gb: 128
         managed_disk_type: Premium_LRS