image_share_group_token.md

image_share_group_token

Manage an Image Share Group Token.

• 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 an image share group token
  linode.cloud.image_share_group_token:
    label: "my-sharegroup-token"
    valid_for_sharegroup_uuid: "1533863e-16a4-47b5-b829-ac0f35c13278"
    state: present

- name: Delete an image share group token
  linode.cloud.image_share_group_token:
    label: "my-sharegroup-token"
    state: absent

Parameters

Field	Type	Required	Description
label	str	Required	This Image Share Group Token's unique label.
state	str	Required	The desired state of the target. (Choices: present, absent)
valid_for_sharegroup_uuid	str	Optional	The UUID of the Image Share Group that this token is valid for.

Return Values

• image_share_group_token - The Image Share Group Token in JSON serialized form.

  • Sample Response:

    {
      "created": "2025-08-04T10:09:09",
      "expiry": null,
      "label": "Backend Services - Engineering",
      "sharegroup_label": "DevOps Base Images",
      "sharegroup_uuid": "e1d0e58b-f89f-4237-84ab-b82077342359",
      "status": "active",
      "token_uuid": "13428362-5458-4dad-b14b-8d0d4d648f8c",
      "updated": null,
      "valid_for_sharegroup_uuid": "e1d0e58b-f89f-4237-84ab-b82077342359"
    }

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

• single_use_token - The single use token string to provide to a Image Share Group Producer to be added to the share group.

  • Sample Response:

    {
      "token": "abcdefghijklmnopqrstuvwxyz1234567890"
    }