placement_group.md

placement_group

Manage a Linode Placement Group.

NOTE: Placement Groups may not currently be available to all users.

• 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: Create a placement group
  linode.cloud.placement_group:
    label: my-pg
    region: us-east
    affinity_type: anti_affinity:local
    is_strict: True
    state: present

- name: Update a Linode placement group label
  linode.cloud.placement_group:
    # id is required to update the label
    id: 123
    label: my-pg-updated
    state: present

- name: Delete a placement group by label
  linode.cloud.placement_group:
    label: my-pg
    state: absent

- name: Delete a placement group by id
  linode.cloud.placement_group:
    id: 123
    state: absent    

Parameters

Field	Type	Required	Description
id	int	Optional	The unique ID of the placement group.
label	str	Optional	The label of the Placement Group. This field can only contain ASCII letters, digits and dashes.
region	str	Optional	The region that the placement group is in.
affinity_type	str	Optional	The affinity policy for Linodes in a placement group.
is_strict	bool	Optional	Whether Linodes must be able to become compliant during assignment. (Default: False)

Return Values

• placement_group - The Placement Group in JSON serialized form.

  • Sample Response:

    {
      "id": 123,
      "label": "my-pg",
      "region": "eu-west",
      "affinity_type": "anti_affinity:local",
      "is_strict": true,
      "is_compliant": true,
      "members": [
        {
          "linode_id": 123,
          "is_compliant": true
        }
      ]
    }

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