Add images to a share group

Beta Adds images to an existing group where you can share them with other members.

  • Run the List share groups operation to get the id you should use as the (sharegroupId) path parameter that identifies an existing share group.

  • 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 each image, visible to all group members. If omitted, the shared image keeps the original image's details. Note that when you Update the original image, it has no effect on a shared image's details within any groups.

📘

This operation is in Beta and available from the v4beta URL.

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 image-add 123 \
  --images '[{"id": "private/15", "label": "Linux Debian", "description": "Official Debian Linux image for server deployment"}]'

Learn more

Path Params
string
enum
required

Enum Call either the v4 URL, or v4beta for operations still in Beta.

Allowed:
integer
required

The share group's unique identifier assigned after creating it. Not to be confused with the group's uuid.

Body Params
images
array of objects
required
images*
Responses

Language
Credentials
LoadingLoading…
Response
Choose an example:
application/json