edit-icon download-icon

ModifyImageSharePermission

最終更新日: Jun 26, 2018

説明

カスタムイメージを他の 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より大きい場合、このパラメータは無視されます。

レスポンスパラメータ

すべてのパラメータは共通の応答パラメータです。詳細は、コモンパラメーターを参照してください。

リクエストの例

  1. https://ecs.aliyuncs.com/?Action=ModifyImageSharePermission
  2. &RegionId=cn-hangzhou
  3. &ImageId=m-281234567
  4. &AddAccount.1=23412345234
  5. &<Common Request Parameters>

レスポンスの例

XML 形式

  1. <ModifyImageSharePermissionResponse>
  2. <RequestId>C8B26B44-0189-443E-9816-D951F59623A9</RequestId>
  3. </ModifyImageSharePermissionResponse>

JSON 形式

  1. {
  2. "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9"
  3. }

エラーコード

このインタフェースに固有のエラーコードは次のとおりです。詳細については、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 人の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 が存在しません。