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

イメージ共有権限を管理します。カスタムイメージを他の Alibaba Cloud アカウントと共有したり、コミュニティイメージとして公開して他のユーザーが利用できるようにすることができます。

操作説明

この操作を呼び出す前に、カスタムイメージの共有をお読みください。

この操作を呼び出す際は、以下の共有ルールにご注意ください。

共有制限: 共有できるのは、ご自身のアカウントで作成したカスタムイメージのみです。各イメージは最大 50 個の Alibaba Cloud アカウントと共有でき、1 回のリクエストあたり最大 10 個の Alibaba Cloud アカウントを指定できます。
インスタンスへの影響: 共有イメージから ECS インスタンスを作成 ( RunInstances ) した後、イメージのオーナーがイメージ共有関係を解除するか、カスタムイメージを削除 ( DeleteImage ) した場合、そのインスタンスはシステムディスクの初期化 ( ReInitDisk ) を実行できません。

重要 Elastic Compute Service (ECS) における暗号化イメージ共有のルール変更: カスタマーマスターキー (CMK) で暗号化されたイメージのみを共有できます。サービスキーで暗号化されたイメージは共有できなくなり、共有時にエラーが返されます。サービスキーで暗号化されたイメージをお持ちで、それらを共有する予定がある場合は、CopyImage を使用してイメージレプリケーションにより暗号鍵を CMK に変更してください。

コミュニティイメージを公開またはリストから削除する際は、以下にご注意ください。

責任と契約: コミュニティイメージはオーナーによって維持され、オーナーが品質と更新に責任を負います。Alibaba Cloud はプラットフォームサポートのみを提供します。公開前に、コミュニティイメージ契約をお読みになり、署名済みであることを確認してください。そうでない場合、公開は許可されません。詳細については、「コミュニティイメージの公開」をご参照ください。
暗号化制限: 暗号化されたイメージはコミュニティイメージとして公開できません。
可視性: コミュニティイメージは完全にパブリックです。イメージが存在するリージョン内のすべての 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。最新のリージョンリストをクエリするには、 DescribeRegions を呼び出せます。	cn-hangzhou
ImageId	string	必須	共有対象のカスタムイメージの ID。重要サービスキーで暗号化されたイメージは共有できなくなりました。カスタマーマスターキー (CMK) で暗号化されたイメージのみを共有できます。サービスキーで暗号化されたイメージを共有しようとすると、エラーが返されます。	m-bp18ygjuqnwhechc****
LaunchPermission	string	任意	説明このパラメーターは招待プレビュー中であり、ご利用いただけません。	hide
AddAccount	array	任意	共有イメージの権限付与先とする Alibaba Cloud アカウント ID。N の有効な値: 1～10。1 回のリクエストで 10 を超える Alibaba Cloud アカウントを指定した場合、システムは最初の 10 件のみを処理し、残りを無視します。	1234567890
	string	任意	共有イメージの権限付与先とする Alibaba Cloud アカウント ID。	1234567890
RemoveAccount	array	任意	イメージ共有を削除する Alibaba Cloud アカウント ID。N の有効な値: 1～10。1 回のリクエストで 10 を超える Alibaba Cloud アカウントを指定した場合、システムは最初の 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"
}

エラーコード

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.	暗号化するイメージを共有する前に、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.	指定されたカスタムイメージが非推奨ステータスであり、共有できません。まず ModifyImageAttribute を呼び出して、指定されたイメージのステータスを変更してください。
403	PublicImageAgreement.NotSigned	The current account has not signed "Community Image Terms of Service".	現在の Alibaba Cloud アカウントはコミュニティイメージ契約に署名していないため、指定されたイメージをコミュニティイメージとして公開できません。ModifyUserBusinessBehavior を呼び出してコミュニティイメージ契約に署名してください。
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.	ECS タグをカスタマーマスターキー (CMK) に追加する必要があります。
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK (Customer Master Key) must be in an active state.	暗号化されたディスクの設定項目で KMSKeyId を指定した場合、カスタマーマスターキー (CMK) は有効な状態である必要があります。Key Management Service (KMS) の DescribeKey 操作を呼び出して、指定された 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 キーを使用して、もう一度お試しください。
403	OperationDenied.KMSKeyUnauthorized	The operation is denied due to missing KMS key authorization. Please check the KMS key permissions and ensure the key is properly authorized for this operation.
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.	指定されたアカウントが存在しません。
404	InvalidAccount.Forbbiden	The specified Account does not yourself.
404	InvalidKMSKeyId.NotFound	The KMS key used by the disk does not exist.	ディスクで使用されている KMS キーが存在しません。

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

変更履歴

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