管理鏡像共用許可權。您可以將自己的自訂鏡像共用給其他阿里雲使用者，該使用者可以使用共用的自訂鏡像建立 ECS 執行個體（RunInstances）或者更換執行個體的系統盤（ReplaceSystemDisk）。

描述

調用該介面時，您需要注意：

  • 您只能共用自己的自訂鏡像給其他阿里雲使用者。

  • 每份自訂鏡像一次最多共用給 10 個阿里雲帳號。所以，參數 AddAccount.n 或者參數 RemoveAccount.n 單次最多可以傳入 10 個阿里雲帳號，超過 10 個帳號系統會忽略該參數。

  • 每份自訂鏡像最多可以共用給 50 個阿里雲帳號。您可以 提交工單 申請共用給更多的使用者。

  • 使用共用鏡像建立 ECS 執行個體（RunInstances）後，一旦自訂鏡像擁有者解除了鏡像共用關係，或者刪除了自訂鏡像（DeleteImage），該執行個體將無法初始化系統盤（ReInitDisk）。

請求參數

名稱 類型 是否必需 描述
Action String 是 系統規定參數。取值：ModifyImageSharePermission
RegionId String 是 自訂鏡像所屬的地域 ID。您可以調用 DescribeRegions 查看最新的阿里雲地域列表。
ImageId String 是 被共用的自訂鏡像 ID。
AddAccount.n String 否 授權共用鏡像的阿里雲帳號 ID。n 的取值範圍：[1, 10]

超過 10 系統會忽略該參數。
RemoveAccount.n String 否 刪除鏡像共用的阿里雲帳號 ID。n 的取值範圍：[1, 10]

超過 10 系統會忽略該參數。

返回參數

全是公共返回參數。參閱 公共參數

樣本

請求樣本 
https://ecs.aliyuncs.com/?Action=ModifyImageSharePermission
&RegionId=cn-hangzhou
&ImageId=m-281234567
&AddAccount.1=23412345234
&<公共請求參數>
返回樣本

XML 格式

<ModifyImageSharePermissionResponse>
    <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
</ModifyImageSharePermissionResponse>
JSON 格式 
{
    "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9"
}

錯誤碼

以下為本介面特有的錯誤碼。更多錯誤碼，請訪問 API 錯誤中心。

錯誤碼 錯誤資訊 HTTP 狀態碼 說明
IncorrectImageStatus The image is not available. 400 指定的自訂鏡像不可用。
InvalidRegionId.NotFound The specified region does not exist. 400 指定的 RegionId 不存在。
MissingParameter An input parameter RegionId that is mandatory for processing the request is not supplied. 400 您必須指定參數 RegionId。
MissingParameter An input parameter ImageId that is mandatory for processing the request is not supplied. 400 您必須指定參數 ImageId。
OperationDeined.EncryptedSnapshot The image contains encrypted snapshots, which do not support share. 403 該鏡像包含加密快照，不支援共用。
InvalidImageId.NotFound The specified ImageId does not exist. 403 指定的 ImageId 不存在。
QuotaExceed.ShareImageUser The shared image user quota exceeds. 403 您最多可以將該自訂鏡像共用給 50 個阿里雲帳號。
InvalidAccount.Forbbiden The specified account does not yourself. 404 您不能共用自訂鏡像給自己。
InvalidAccount.NotFound The specified parameter AddAccount.n or RemoveAccount.n does not exist. 404 參數 AddAccount.n或者 RemoveAccount.n 中有不存在的帳號 ID。