ANSIBLE.GCE_PD(3)               ANSIBLE MODULES              ANSIBLE.GCE_PD(3)



NAME
       gce_pd - utilize GCE persistent disk resources

DESCRIPTION
       This module can create and destroy unformatted GCE persistent disks
       https://developers.google.com/compute/docs/disks#persistentdisks. It
       also supports attaching and detaching disks from running instances but
       does not support creating boot disks from images or snapshots.  The
       'gce' module supports creating instances with boot disks. Full
       install/configuration instructions for the gce* modules can be found in
       the comments of ansible/test/gce_tests.py.

OPTIONS
       detach_only
              do not destroy the disk, merely detach it from an instance
              Choices: yes,no. (default: no)

       instance_name
              instance name if you wish to attach or detach the disk

       mode   GCE mount mode of disk, READ_ONLY (default) or READ_WRITE
              Choices: READ_WRITE,READ_ONLY. (default: READ_ONLY)

       name   name of the disk(required)

       size_gb
              whole integer size of disk (in GB) to create, default is 10 GB
              (default: 10)

       state  desired state of the persistent disk Choices:
              active,present,absent,deleted. (default: present)

       zone   zone in which to create the disk (default: us-central1-b).

EXAMPLES
       # Simple attachment action to an existing instance
       - local_action:
           module: gce_pd
           instance_name: notlocalhost
           size_gb: 5
           name: pd



AUTHOR
       Eric Johnson <erjohnso@google.com>

SEE ALSO
       ansible(1), http://ansible.github.com/modules.html#gce-pd



1.4.5                             2014-02-12                 ANSIBLE.GCE_PD(3)
