ModifyImageSharePermission - Elastic Compute Service - Alibaba Cloud ドキュメントセンター

イメージ共有の権限を管理します。作成したカスタムイメージを他の Alibaba Cloud アカウントと共有したり、コミュニティイメージとして公開したりできます。

操作説明

この操作を呼び出す前に、「カスタムイメージの共有」をご参照ください。

以下の共有ルールにご注意ください。

共有制限：作成したカスタムイメージのみ共有できます。各イメージは最大 50 の Alibaba Cloud アカウントと共有できます。一度に最大 10 の Alibaba Cloud アカウントとイメージを共有できます。
インスタンスへの影響：共有されたカスタムイメージから ECS インスタンス (RunInstances) を作成した後、イメージの所有者がそのカスタムイメージの共有を解除するか、削除 (DeleteImage) した場合、そのインスタンスのシステムディスクを再初期化 (ReInitDisk) することはできなくなります。

重要暗号化されたイメージの共有ルールが更新されました。カスタマーマスターキー (CMK) で暗号化されたイメージのみ共有できます。サービスキーで暗号化されたイメージは共有できなくなりました。サービスキーで暗号化されたイメージを共有しようとすると、エラーが返されます。サービスキーで暗号化されたイメージを共有するには、イメージをコピー (CopyImage) し、CMK で再暗号化してください。

コミュニティイメージを公開または非公開にする際の注意点は次のとおりです。

責任と契約：コミュニティイメージの所有者は、その品質と更新に責任を負います。Alibaba Cloud は共有のためのプラットフォームのみを提供します。イメージを公開する前に、コミュニティイメージ契約を理解し、署名する必要があります。詳細については、「コミュニティイメージの公開」をご参照ください。
暗号化の制限：暗号化されたイメージはコミュニティイメージとして公開できません。
パブリックアクセス：コミュニティイメージは公開されています。イメージが存在するリージョン内のすべての Alibaba Cloud アカウントが使用できます。
機能制限：コミュニティイメージは共有、エクスポート、コピーができません。
非公開化の影響：コミュニティイメージが非公開になると、パブリックアクセスはできなくなります。ただし、この操作は、以前にそのイメージから作成されたインスタンスには影響しません。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ecs:ModifyImageSharePermission

update

*Image

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
RegionId	string	必須	カスタムイメージが配置されているリージョン ID。Alibaba Cloud リージョンの最新リストを表示するには、DescribeRegions を呼び出してください。	cn-hangzhou
ImageId	string	必須	共有するカスタムイメージの ID。重要サービスキーで暗号化されたイメージは共有できなくなりました。カスタマーマスターキー (CMK) で暗号化されたイメージのみ共有できます。サービスキーで暗号化されたイメージを共有しようとすると、エラーが返されます。	m-bp18ygjuqnwhechc****
LaunchPermission	string	任意	説明このパラメーターは招待制プレビューであり、利用できません。	hide
AddAccount	array	任意	イメージを共有する Alibaba Cloud アカウントの ID。最大 10 個のアカウント ID を指定できます。10 個を超える ID を指定した場合、システムは最初の 10 個のみを処理し、残りは無視します。	1234567890
	string	任意	Alibaba Cloud アカウントの ID。	1234567890
RemoveAccount	array	任意	イメージの共有を解除する Alibaba Cloud アカウントの ID。最大 10 個のアカウント ID を指定できます。10 個を超える ID を指定した場合、システムは最初の 10 個のみを処理し、残りは無視します。	1234567890
	string	任意	Alibaba Cloud アカウントの ID。	1234567890
IsPublic	boolean	任意	イメージをコミュニティイメージとして公開するか、コミュニティイメージを非公開にするかを指定します。有効値： true: イメージをコミュニティイメージとして公開します。 false: コミュニティイメージを非公開にし、プライベートイメージに戻します。イメージがすでにプライベートである場合、この操作は効果がありません。デフォルト値：false。	false
DryRun	boolean	任意

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

例

成功レスポンス

JSONJSON

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

エラーレスポンス

JSONJSON

{
    "RequestId": "C8B26B44-0189-443E-9816-D951F59623A9"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
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.
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.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The CMK(Customer Master Key) lacks authorization to add tags to the ECS service.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK (Customer Master Key) must be in an active state.
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.
404	InvalidImageId.NotFound	The specified ImageId does not exist.
404	InvalidAccount.NotFound	The specified account %s in parameter "AddAccount.n" or "RemoveAccount.n" does not exist.
404	InvalidAccount.Forbbiden	The specified Account does not yourself.
404	InvalidKMSKeyId.NotFound	The KMS key used by the disk does not exist.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。