管理鏡像共用許可權。您可以將自己的自訂鏡像共用給其他阿里雲帳號,也發行就緒為社區鏡像供他人使用。
介面說明
調用該介面前,請您仔細閱讀共用自訂鏡像。
調用該介面時,請注意以下共用規則:
-
共用限制:只能共用自己帳號下建立的自訂鏡像,每份鏡像最多可共用給 50 個阿里雲帳號,每份鏡像一次最多共用給 10 個阿里雲帳號。
-
執行個體影響:使用共用鏡像建立 ECS 執行個體( RunInstances )後,一旦自訂鏡像擁有者解除了鏡像共用關係,或者刪除了自訂鏡像( DeleteImage ),該執行個體將無法初始化系統硬碟( ReInitDisk )。
發布或下架社區鏡像,您需要注意:
-
責任與協議:社區鏡像由其所有者負責品質和迭代更新,阿里雲僅提供平台支援。發布前請確保您已瞭解並簽署社區鏡像協議,否則不允許發布,社區鏡像詳情見發布社區鏡像。
-
加密限制:加密鏡像不可發布為社區鏡像。
-
公開性:社區鏡像完全公開,在鏡像所屬地區下,所有阿里雲帳號均可使用。
-
功能限制:社區鏡像不支援共用、匯出或複製。
-
下架影響:社區鏡像下架後,將不再對其他阿里雲帳號公開,但已共用的鏡像關係會繼續保持。
調試
您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。
調試
授權資訊
|
操作 |
存取層級 |
資源類型 |
條件關鍵字 |
關聯操作 |
|
ecs:ModifyImageSharePermission |
update |
*Image
|
無 | 無 |
請求參數
|
名稱 |
類型 |
必填 |
描述 |
樣本值 |
| RegionId |
string |
是 |
自訂鏡像所屬的地區 ID。您可以調用 DescribeRegions 查看最新的阿里雲地區列表。 |
cn-hangzhou |
| ImageId |
string |
是 |
被共用的自訂鏡像 ID。 重要 不再支援共用使用服務祕密金鑰加密的鏡像,僅支援共用使用使用者主要金鑰 CMK 加密的鏡像,使用服務祕密金鑰加密的鏡像在共用時將會報錯。 |
m-bp18ygjuqnwhechc**** |
| LaunchPermission |
string |
否 |
說明
該參數正在邀測中,暫不支援使用。 |
hide |
| AddAccount |
array |
否 |
授權共用鏡像的阿里雲帳號 ID。N 的取值範圍:1~10,若一次提交超過 10 個阿里雲帳號,系統將只處理前 10 個,忽略多餘的帳號。 |
1234567890 |
|
string |
否 |
授權共用鏡像的阿里雲帳號 ID。 |
1234567890 |
|
| RemoveAccount |
array |
否 |
刪除鏡像共用的阿里雲帳號 ID。N 的取值範圍:1~10,若一次提交超過 10 個阿里雲帳號,系統將只處理前 10 個,忽略多餘的帳號。 |
1234567890 |
|
string |
否 |
刪除鏡像共用的阿里雲帳號 ID。 |
1234567890 |
|
| IsPublic |
boolean |
否 |
是否發布或下架社區鏡像。取值範圍:
預設值:false。 |
false |
| DryRun |
boolean |
否 |
返回參數
|
名稱 |
類型 |
描述 |
樣本值 |
|
object |
|||
| RequestId |
string |
請求 ID。 |
473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
樣本
正常返回樣本
JSON格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
異常返回樣本
JSON格式
{
"RequestId": "C8B26B44-0189-443E-9816-D951F59623A9"
}
錯誤碼
|
HTTP status code |
錯誤碼 |
錯誤資訊 |
描述 |
|---|---|---|---|
| 400 | MissingParameter | The input parameter "RegionId" that is mandatory for processing this request is not supplied. | |
| 400 | InvalidGroup.Malformed | The specified Group is wrongly formed. | 指定的組不存在。 |
| 400 | UnnecessaryParameter.LaunchPermission | The specified parameter "LaunchPermission" is unnecessary if paramter "AddAccounts" or "RemoveAccounts" exist. | |
| 400 | InvalidParameter.LaunchPermission | The specified parameter "LaunchPermission" is invalid. | |
| 400 | ForbiddenParameter.LaunchPermission | The specified parameter "LaunchPermission" is forbidden for current account. | |
| 403 | AssumeRoleError | Requires a RAM role of AliyunECSShareEncryptImageDefaultRole before sharing encrypted image. | 您在共用加密鏡像前需要添加 AliyunECSShareEncryptImageDefaultRole RAM 角色。 |
| 403 | ImageDescription.ContainsSensitiveWords | The specified image description contains sensitive words. | 指定的鏡像描述包含禁用語。 |
| 403 | ImageName.ContainsSensitiveWords | The specified image name contains sensitive words. | 指定的鏡像名稱包含禁用語。 |
| 403 | Image.Public | The specified image is public image. | |
| 403 | CurrentRegion.NotSupportPublicImage | Public image is not supported for current region. | |
| 403 | Image.NotPublic | The specified image is not public image. | 您指定的鏡像不是公用許可權,不能修改為私人許可權。 |
| 403 | OperationDeined.FullImage | The encrypted image contains multiple snapshots, which do not support share. | |
| 403 | QuotaExceed.ShareImage | The shared Image Quota exceeds. | |
| 403 | QuotaExceed.ShareImageUser | The shared Image user Quota exceeds. | |
| 403 | InvalidImageId.BidMismatch | Cannot share the image with users %s of other sites. | 無法共用鏡像給其他網站的使用者。 |
| 403 | OperationDeined.EncryptedSnapshot | The image contains encrypted snapshots, which do not support share. | 指定的鏡像含有加密快照,不支援共用這種鏡像。 |
| 403 | OperationDenied.InvalidImageStatus | The specified image cannot be shared when it is deprecated. | 不能共用已經被棄用的鏡像。 |
| 403 | PublicImageAgreement.NotSigned | The current account has not signed "Community Image Terms of Service". | 當前賬戶沒有簽署社區鏡像協議。 |
| 403 | InvalidParameter.IsPublic | The specified parameter IsPublic is conflicted with other parameters. | 指定的參數IsPublic與其他參數衝突。 |
| 403 | InvalidParameter.KMSKeyId.CMKUnauthorized | The CMK(Customer Master Key) lacks authorization to add tags to the ECS service. | 使用者主要金鑰(CMK)未授權ECS服務添加標籤許可權。 |
| 403 | InvalidParameter.KMSKeyId.CMKNotEnabled | The CMK (Customer Master Key) must be in an active state. | 使用者主要金鑰(CMK)需要處於活動狀態。 |
| 403 | InvalidOperation.ServiceKeyEncryptedImageUnsupported | The specified service key encrypted image is not supported for this operation. Please switch to a CMK (Customer Master Key) encrypted image and retry. | 服務密鑰鏡像不支援該操作,請更換使用CMK密鑰後重試。 |
| 404 | InvalidImageId.NotFound | The specified ImageId does not exist. | 指定的鏡像在該使用者帳號下不存在,請您檢查鏡像 ID 是否正確。 |
| 404 | InvalidAccount.NotFound | The specified account %s in parameter "AddAccount.n" or "RemoveAccount.n" does not exist. | AddAccount或者RemoveAccount中的帳號不存在。 |
| 404 | InvalidAccount.Forbbiden | The specified Account does not yourself. | |
| 404 | InvalidKMSKeyId.NotFound | The KMS key used by the disk does not exist. | 磁碟使用的 KMS 密鑰不存在. |
訪問錯誤中心查看更多錯誤碼。
變更歷史
更多資訊,參考變更詳情。