community.general.memset_server_info module – Retrieve server information

Note

This module is part of the community.general collection (version 9.4.0).

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.memset_server_info.

Synopsis

  • Retrieve server information.

Parameters

Parameter

Comments

api_key

string / required

The API key obtained from the Memset control panel.

name

string / required

The server product name (that is, testyaa1).

Attributes

Attribute

Support

Description

check_mode

Support: full

added in community.general 3.3.0

This action does not modify state.

Can run in check_mode and return changed status prediction without modifying target.

diff_mode

Support: N/A

This action does not modify state.

Will return details on what has changed (or possibly needs changing in check_mode), when in diff mode.

Notes

Note

  • An API key generated via the Memset customer control panel is needed with the following minimum scope - server.info.

Examples

- name: Get details for testyaa1
  community.general.memset_server_info:
    name: testyaa1
    api_key: 5eb86c9896ab03919abcf03857163741
  delegate_to: localhost

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key

Description

memset_api

complex

Info from the Memset API

Returned: always

backups

boolean

Whether this server has a backup service.

Returned: always

Sample: true

control_panel

string

Whether the server has a control panel (i.e. cPanel).

Returned: always

Sample: "cpanel"

data_zone

string

The data zone the server is in.

Returned: always

Sample: "Memset Public Cloud"

expiry_date

string

Current expiry date of the server.

Returned: always

Sample: "2018-08-10"

firewall_rule_group

dictionary

Details about the firewall group this server is in.

Returned: always

Sample: {"default_outbound_policy": "RETURN", "name": "testyaa-fw1", "nickname": "testyaa cPanel rules", "notes": "", "public": false, "rules": {"51d7db54d39c3544ef7c48baa0b9944f": {"action": "ACCEPT", "comment": "", "dest_ip6s": "any", "dest_ips": "any", "dest_ports": "any", "direction": "Inbound", "ip_version": "any", "ordering": 2, "protocols": "icmp", "rule_group_name": "testyaa-fw1", "rule_id": "51d7db54d39c3544ef7c48baa0b9944f", "source_ip6s": "any", "source_ips": "any", "source_ports": "any"}}}

firewall_type

string

The type of firewall the server has (i.e. self-managed, managed).

Returned: always

Sample: "managed"

host_name

string

The server’s hostname.

Returned: always

Sample: "testyaa1.miniserver.com"

ignore_monitoring_off

boolean

When true, Memset won’t remind the customer that monitoring is disabled.

Returned: always

Sample: true

ips

list / elements=string

List of dictionaries of all IP addresses assigned to the server.

Returned: always

Sample: [{"address": "1.2.3.4", "bytes_in_today": 1000.0, "bytes_in_yesterday": 2000.0, "bytes_out_today": 1000.0, "bytes_out_yesterday": 2000.0}]

monitor

boolean

Whether the server has monitoring enabled.

Returned: always

Sample: true

monitoring_level

string

The server’s monitoring level (i.e. basic).

Returned: always

Sample: "basic"

name

string

Server name (same as the service name).

Returned: always

Sample: "testyaa1"

network_zones

list / elements=string

The network zone(s) the server is in.

Returned: always

Sample: ["reading"]

nickname

string

Customer-set nickname for the server.

Returned: always

Sample: "database server"

no_auto_reboot

boolean

Whether or not to reboot the server if monitoring detects it down.

Returned: always

Sample: true

no_nrpe

boolean

Whether Memset should use NRPE to monitor this server.

Returned: always

Sample: true

os

string

The server’s Operating System.

Returned: always

Sample: "debian_stretch_64"

penetration_patrol

string

Intrusion detection support level for this server.

Returned: always

Sample: "managed"

penetration_patrol_alert_level

integer

The alert level at which notifications are sent.

Returned: always

Sample: 10

primary_ip

string

Server’s primary IP.

Returned: always

Sample: "1.2.3.4"

renewal_price_amount

string

Renewal cost for the server.

Returned: always

Sample: "30.00"

renewal_price_currency

string

Currency for renewal payments.

Returned: always

Sample: "GBP"

renewal_price_vat

string

VAT rate for renewal payments

Returned: always

Sample: "20"

start_date

string

Server’s start date.

Returned: always

Sample: "2013-04-10"

status

string

Current status of the server (i.e. live, onhold).

Returned: always

Sample: "LIVE"

support_level

string

Support level included with the server.

Returned: always

Sample: "managed"

type

string

What this server is (i.e. dedicated)

Returned: always

Sample: "miniserver"

vlans

dictionary

Dictionary of tagged and untagged VLANs this server is in.

Returned: always

Sample: {"tagged": [], "untagged": ["testyaa-vlan1", "testyaa-vlan2"]}

vulnscan

string

Vulnerability scanning level.

Returned: always

Sample: "basic"

Authors

  • Simon Weald (@glitchcrab)