Docs4dev
Docs
ansible / latest / collections / community / general / profitbricks_nic_module.html

community.general.profitbricks_nic – Create or Remove a NIC.

Note

This plugin is part of the community.general collection (version 3.8.1).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install community.general.

To use it in a playbook, specify: community.general.profitbricks_nic.

Synopsis

  • This module allows you to create or restore a volume snapshot. This module has a dependency on profitbricks >= 1.0.0

Requirements

The below requirements are needed on the host that executes this module.

  • profitbricks

Parameters

Parameter Choices/Defaults Comments
datacenter
string / required
The datacenter in which to operate.
lan
string
The LAN to place the NIC on. You can pass a LAN that doesn't exist and it will be created. Required on create.
name
string
The name or ID of the NIC. This is only required on deletes, but not on create.
If not specified, it defaults to a value based on UUID4.
server
string / required
The server name or ID.
state
string
Default:
"present"
Indicate desired state of the resource
The available choices are: present, absent.
subscription_password
string / required
THe ProfitBricks password. Overrides the PB_PASSWORD environment variable.
subscription_user
string / required
The ProfitBricks username. Overrides the PB_SUBSCRIPTION_ID environment variable.
wait
boolean
    Choices:
  • no
  • yes ←
wait for the operation to complete before returning
wait_timeout
integer
Default:
600
how long before wait gives up, in seconds

Examples

- name: Create a NIC
  community.general.profitbricks_nic:
    datacenter: Tardis One
    server: node002
    lan: 2
    wait_timeout: 500
    state: present

- name: Remove a NIC
  community.general.profitbricks_nic:
    datacenter: Tardis One
    server: node002
    name: 7341c2454f
    wait_timeout: 500
    state: absent

Authors

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/profitbricks_nic_module.html