調(diào)用ModifyImageSharePermission管理鏡像共享權(quán)限。您可以將自己的自定義鏡像共享給其他阿里云賬號,也可以發(fā)布為社區(qū)鏡像供他人使用。
接口說明
調(diào)用該接口時,您需要注意:
- 您只能共享自己的自定義鏡像給其他阿里云用戶。
- 每份自定義鏡像一次最多共享給 10 個阿里云賬號。所以,參數(shù) AddAccount.n 或者參數(shù) RemoveAccount.n 單次最多可以傳入 10 個阿里云賬號,若一次提交超過 10 個阿里云賬號,系統(tǒng)將只處理前 10 個,忽略多余的賬號。
- 每份自定義鏡像最多可以共享給 50 個阿里云賬號。
- 使用共享鏡像創(chuàng)建 ECS 實例( RunInstances )后,一旦自定義鏡像擁有者解除了鏡像共享關(guān)系,或者刪除了自定義鏡像( DeleteImage ),該實例將無法初始化系統(tǒng)盤( ReInitDisk )。
發(fā)布或下架社區(qū)鏡像,您需要注意:
- 社區(qū)鏡像的所有者需要為對應(yīng)的社區(qū)鏡像的質(zhì)量與迭代負(fù)責(zé),阿里云僅提供平臺支撐。請確保您已知曉社區(qū)鏡像協(xié)議內(nèi)容,并已簽訂協(xié)議,否則不允許發(fā)布社區(qū)鏡像。更多信息,請參見發(fā)布社區(qū)鏡像。
- 加密鏡像不允許發(fā)布為社區(qū)鏡像。
- 社區(qū)鏡像完全公開,在鏡像所屬地域下,所有阿里云賬號均可使用。
- 社區(qū)鏡像不支持共享、導(dǎo)出與復(fù)制。
- 已發(fā)布的社區(qū)鏡像一旦下架,將不再對其他所有的阿里云賬號公開。如果該自定義鏡像已共享至其它阿里云賬號,共享關(guān)系會繼續(xù)保持。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
*Image acs:ecs:{#regionId}:{#accountId}:image/{#imageId} |
| 無 |
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
RegionId | string | 是 | 自定義鏡像所屬的地域 ID。您可以調(diào)用 DescribeRegions 查看最新的阿里云地域列表。 | cn-hangzhou |
ImageId | string | 是 | 被共享的自定義鏡像 ID。 | m-bp18ygjuqnwhechc**** |
LaunchPermission | string | 否 | 說明
該參數(shù)正在邀測中,暫不支持使用。
| hide |
AddAccount | array | 否 | 授權(quán)共享鏡像的阿里云賬號 ID。N 的取值范圍:1~10,若一次提交超過 10 個阿里云賬號,系統(tǒng)將只處理前 10 個,忽略多余的賬號。 | |
string | 否 | 授權(quán)共享鏡像的阿里云賬號 ID。N 的取值范圍:1~10,若一次提交超過 10 個阿里云賬號,系統(tǒng)將只處理前 10 個,忽略多余的賬號。 | 1234567890 | |
RemoveAccount | array | 否 | 刪除鏡像共享的阿里云賬號 ID。N 的取值范圍:1~10,若一次提交超過 10 個阿里云賬號,系統(tǒng)將只處理前 10 個,忽略多余的賬號。 | |
string | 否 | 刪除鏡像共享的阿里云賬號 ID。n 的取值范圍:1~10,若一次提交超過 10 個阿里云賬號,系統(tǒng)將只處理前 10 個,忽略多余的賬號。 | 1234567890 | |
IsPublic | boolean | 否 | 是否發(fā)布或下架社區(qū)鏡像。取值范圍:
默認(rèn)值:false。 | false |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
- | |||
指定的組不存在。 | |||
- | |||
- | |||
- | |||
您在共享加密鏡像前需要添加 AliyunECSShareEncryptImageDefaultRole RAM 角色。 | |||
指定的鏡像描述包含敏感詞匯。 | |||
指定的鏡像名稱包含敏感詞匯。 | |||
- | |||
- | |||
您指定的鏡像不是公共權(quán)限,不能修改為私有權(quán)限。 | |||
- | |||
已經(jīng)超過自定義鏡像共享配額限制。 | |||
已經(jīng)超過單個鏡像共享給用戶數(shù)量的配額限制。 | |||
鏡像無法跨運營商共享。 | |||
指定的鏡像含有加密快照,不支持共享這種鏡像。 | |||
不能共享已經(jīng)被棄用的鏡像。 | |||
當(dāng)前賬戶沒有簽署社區(qū)鏡像協(xié)議。 | |||
指定的參數(shù)IsPublic與其他參數(shù)沖突。 | |||
指定的鏡像在該用戶賬號下不存在,請您檢查鏡像 ID 是否正確。 | |||
- | |||
不能把鏡像共享給自己。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
查看變更詳情 | ||
查看變更詳情 | ||
查看變更詳情 | ||
查看變更詳情 |