全部產品
Search
文件中心

Elastic Compute Service:ModifyImageSharePermission - 管理鏡像共用許可權

更新時間:Apr 04, 2026

管理鏡像共用許可權。您可以將自己的自訂鏡像共用給其他阿里雲帳號,也發行就緒為社區鏡像供他人使用。

介面說明

調用該介面前,請您仔細閱讀共用自訂鏡像

調用該介面時,請注意以下共用規則:

  • 共用限制:只能共用自己帳號下建立的自訂鏡像,每份鏡像最多可共用給 50 個阿里雲帳號,每份鏡像一次最多共用給 10 個阿里雲帳號。

  • 執行個體影響:使用共用鏡像建立 ECS 執行個體( RunInstances )後,一旦自訂鏡像擁有者解除了鏡像共用關係,或者刪除了自訂鏡像( DeleteImage ),該執行個體將無法初始化系統硬碟( ReInitDisk )。

重要 Elastic Compute Service 共用加密鏡像規則變更:僅支援共用使用使用者主要金鑰 CMK 加密的鏡像,不再支援共用使用服務祕密金鑰加密的鏡像,使用服務祕密金鑰加密的鏡像在共用時將會報錯。如果您保有服務祕密金鑰加密的鏡像且計劃共用給他人使用,請通過複製鏡像(CopyImage),將鏡像密鑰改為使用者主要金鑰 CMK。

發布或下架社區鏡像,您需要注意:

  • 責任與協議:社區鏡像由其所有者負責品質和迭代更新,阿里雲僅提供平台支援。發布前請確保您已瞭解並簽署社區鏡像協議,否則不允許發布,社區鏡像詳情見發布社區鏡像

  • 加密限制:加密鏡像不可發布為社區鏡像。

  • 公開性:社區鏡像完全公開,在鏡像所屬地區下,所有阿里雲帳號均可使用。

  • 功能限制:社區鏡像不支援共用、匯出或複製。

  • 下架影響:社區鏡像下架後,將不再對其他阿里雲帳號公開,但已共用的鏡像關係會繼續保持。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊,可以在RAM權限原則語句的Action元素中使用,用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下:

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

ecs:ModifyImageSharePermission

update

*Image

acs:ecs:{#regionId}:{#accountId}:image/{#imageId}

請求參數

名稱

類型

必填

描述

樣本值

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

是否發布或下架社區鏡像。取值範圍:

  • true:發布該鏡像為社區鏡像。

  • false:下架該鏡像為普通鏡像,若該鏡像本身是普通鏡像,則不做改變。

預設值: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 密鑰不存在.

訪問錯誤中心查看更多錯誤碼。

變更歷史

更多資訊,參考變更詳情