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