ip_share.md

ip_share

Manage the Linode shared IPs.

WARNING! This module makes use of beta endpoints and requires the C(api_version) field be explicitly set to C(v4beta).

• Minimum Required Fields
• Examples
• Parameters
• Return Values

Minimum Required Fields

Field	Type	Required	Description
api_token	str	Required	The Linode account personal access token. It is necessary to run the module. It can be exposed by the environment variable LINODE_API_TOKEN instead. See details in Usage.

Examples

- name: Configure the Linode shared IPs.
  linode.cloud.ip_share:
    api_version: v4beta
    linode_id: 12345
    ips: ["192.0.2.1", "2001:db8:3c4d:15::"]

Parameters

Field	Type	Required	Description
ips	list	Required	A list of secondary Linode IPs to share with the primary Linode.
linode_id	int	Required	The ID of the primary Linode that the addresses will be shared with.
state	str	Required	The desired state of the target. (Choices: present, absent)

Return Values

• ip_share_stats - The Linode IP share info in JSON serialized form

  • Sample Response:

    [
      {
        "linode_id": 12345,
        "ips": ["192.0.2.1", "2001:db8:3c4d:15::"]
      }
    ]

  • See the Linode API response documentation for a list of returned fields