Creates a group to share images with other users.

• Include existing images in the request or Add images to a share group later. Run the Get an image operation to see the existing images' id values. If needed, Create an image or Upload an image.

• You can set a label and description for the group and each image, visible to all group members.

• If omitted, the shared image keeps the original label and description. Note that when you Update the original image, it has no effect on shared image's details within any groups.

• Run the Add members to a share group to include other users in the group. Use the group's uuid from the response to Create a token for user authentication.

Permissions and scopes

To call this operation, you need the following:

• OAuth scopes. Your user needs these scopes assigned. Learn more.

  • Scopes: images:read_write

CLI

linode-cli image-sharegroups create --label "my_label" --description "my_description" \
  --images '[{"id": "private/15", "label": "Linux Debian", "description": "Official Debian Linux image for server deployment"}]'

Learn more