カスタムイメージを他の Alibaba Cloud ユーザーと共有します。あるいは、他の Alibaba Cloud ユーザーから共有認可を取り消すこともできます。他のユーザーは、共有イメージを使用して
ECS インスタンス (
CreateInstance
)を作成するか、システムディスク(
ReplaceSystemDisk
)を置き換えることができます。このインターフェイスを呼び出すときは、次の点を考慮してください。
-
カスタム画像は他の Alibaba Cloud ユーザーにしか共有できません。
-
一度に1つのイメージを最大 10 個の Alibaba Cloud アカウントに共有できます。またはカスタムイメージを共有する最大 10 のアカウントを一度に削除できます。パラメータ「AddAccount.n」または「RemoveAccount.n」に 10 以上のアカウント ID が指定されている場合、このパラメータは無効です。
-
1 つのイメージを最大 50 の Alibaba Cloud アカウントに共有することができます。ただし、それより多くのユーザーと共有したい場合は、チケットからできます。
-
共有イメージを使用してインスタンスを作成すると (
CreateInstance
)、イメージオーナーが共有認可を撤回するかカスタムイメージ (DeleteImage
)、指定したインスタンスを再初期化することはできません(ReInitDisk
)。
リクエストパラメータ
Action | String | はい | このインタフェースの名前。値:ModifyImageSharePermission。 |
RegionId | String | はい | カスタムイメージが属するリージョンの ID。 詳細は、DescribeRegions を参照してください。 |
ImageId | String | はい | カスタムイメージのID。 |
AddAccount.n | String | いいえ | 追加されるAlibaba CloudアカウントのIDは、イメージが共有されるアカウントです。 n の値の範囲: [1, 10] n が 10 より大きい場合、このパラメータは無視されます。
|
RemoveAccount.n | String | いいえ | 削除されるAlibaba CloudのIDは、イメージが共有されるアカウントです。 n の値の範囲: [1, 10]. n が10より大きい場合、このパラメータは無視されます。
|
レスポンスパラメータ
すべてのパラメータは共通の応答パラメータです。詳細は、コモンパラメーターを参照してください。
例
リクエストの例
https://ecs.aliyuncs.com/?Action=ModifyImageSharePermission
&RegionId=cn-hangzhou
&ImageId=m-281234567
&AddAccount.1=23412345234
&<Common Request Parameters>
レスポンスの例
XML
形式
<ModifyImageSharePermissionResponse>
<RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
</ModifyImageSharePermissionResponse>
JSON
形式
{
"RequestId": "C8B26B44-0189-443E-9816-D951F59623A9"
}
エラーコード
このインタフェースに固有のエラーコードは次のとおりです。詳細については、API のエラー・センターを参照してください。
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 人のAlibaba Cloudユーザーにのみカスタムイメージを共有できます。それより多くのユーザーと共有したい場合。チケットからできます。 |
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 が存在しません。 |