Call the ModifyImageSharePermission operation to manage permissions for image sharing.

Usage notes

For prerequisites and precautions for calling this operation, refer to Precautions.

Debugging

API Explorer

You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.

Go to debug

Request parameters

Only the request parameters specific to this operation and some common parameters are listed below. For more information, refer to Common parameters.

Action string required Sample value: ModifyImageSharePermission

The action that you want to perform. Value: ModifyImageSharePermission.

Version string required Sample value: 2020-04-01

The version of the API. Valid value: 2020-04-01.

AddAccounts.N string[] Optional Sample value: AddAccounts.1=210005****&AddAccounts.2=210007****

The accounts with which you want to share the image. Up to 50 accounts are supported.

Parameter - N: specifies the sequence number of the account.

Separate accounts with &.

ImageId string required Sample value: image-ebgy1og99tfct0gw****

The image ID. You can call the DescribeImages operation and configure the Visibility=private parameter to query and obtain the ID of the custom image.

RemoveAccounts.N string[] Optional Sample value: RemoveAccounts.1=210000****&RemoveAccounts.2=210000****

Removes the accounts with which the image is shared.

Parameter - N: specifies the sequence number of the account.

Separate accounts with &.

Response parameters

This operation has no specific response parameters. For more information, refer to Response structure.

Sample request

Sample response

Error codes

The table below lists the business-related error codes of the operation. For more information, refer to Common error codes.

Status code	Error code	Error message	Description
400	InvalidAccount.Malformed	The specified Account is malformed.	The specified account is invalid.
400	InvalidArgument	The specified argument is invalid.	The specified parameter is invalid.
400	InvalidImageSharePermissionForRemove.UnSupported	The specified image share permission cannot be used for remove.	The specified image sharing relationship cannot be deleted. Please remove it on the Resource Sharing platform.
400	InvalidImageStatus	The specified image is not in the correct status for the request.	The current status of the image does not support this operation.
400	LimitExceeded.MaximumShareImageAccount	You've reached the limit on the number of account that you can share.	The number of accounts with which the image is shared exceeds the limit.
400	MissingParameter.AddAccountsAndRemoveAccounts	The required parameter AddAccountsAndRemoveAccounts is not supplied.	Neither of the parameters AddAccounts nor RemoveAccounts is provided.
400	MissingParameter.ImageId	The required parameter ImageId is not supplied.	The image ID cannot be empty.
404	InvalidImage.NotFound	The specified image does not exist.	The specified image does not exist.
500	InternalError	An internal error has occurred.	An internal error occurred. Try again. If multiple attempts fail, submit a ticket.

Elastic Compute Service