cm_next_provider – Manage providers on Central Manager

New in version 1.0.0.

Synopsis

  • Manage providers on Central Manager.

Parameters

Parameter Choices/Defaults Configuration Comments
address
string
The address of the provider to which Central Manager can connect to.
The address may be a hostname or an IP address.
The parameter must be specified when creating a new provider.
cert_fingerprint
string
added in 1.1.0
The fingerprint of the certificate that the Central Manager uses when connecting with the specified provider.
force
boolean
    Choices:
  • no ←
  • yes
When true, forces update of the existing provider, this option is required when attempting to change existing provider's username and password.
When false, update is not performed when there is no change present.
name
string / required
Specifies the name of the provider on CM to create or manage.
password
string
The password that the Central Manager uses when connecting with the specified provider.
The parameter must be specified when username is defined.
port
integer
The port on which Central Manager can connect to provider.
The parameter is required when type is velos or rseries.
state
string
    Choices:
  • present ←
  • absent
When state is present, ensures the provider is created.
When state is absent, ensures the provider is removed.
type
string / required
    Choices:
  • rseries
  • velos
  • vsphere
Specifies the type of provider.
username
string
The username that the Central Manager uses when connecting with the specified provider.
The parameter must be specified when creating a new provider.

Examples

- name: Create a vsphere provider
  cm_next_provider:
    name: "ansible-vsphere"
    type: "vsphere"
    address: "dummy.host.net"
    username: "admin"
    password: "test"

- name: Create an F5OS provider
  cm_next_provider:
    name: "ansible-f5os"
    type: "rseries"
    address: "192.168.1.1"
    port: 8888
    username: "admin"
    password: "test"

- name: Update a username on provider
  cm_next_provider:
    name: "ansible-f5os"
    type: "rseries"
    username: "non-admin"
    password: "test"

- name: Update a password on a provider - force on
  cm_next_provider:
    name: "ansible-f5os"
    type: "rseries"
    password: "changed"
    force: "yes"

- name: Remove a vsphere provider
  cm_next_provider:
    name: "ansible-vsphere"
    type: "vsphere"
    state: "absent"

Return Values

The following are the fields unique to this module:

Key Returned Description
address
string
changed
The address of the provider to which Central Manager can connect to.

Sample:
192.168.1.1
name
string
changed
The name of the provider on CM.

Sample:
my_provider
port
integer
changed
The port on which Central Manager can connect to provider.

Sample:
8888
type
string
changed
The type of provider.

Sample:
rseries
username
string
changed
The username that the Central Manager uses when connecting with the specified provider.

Sample:
admin


Status

Authors

  • Ravinder Reddy (@RavinderReddyF5)
  • Wojciech Wypior (@wojtek0806)