ModifyImageSharePermission - Elastic Compute Service - Alibaba Cloud Documentation Center

Mengelola izin berbagi gambar. Anda dapat berbagi gambar kustom dengan akun Alibaba Cloud lain atau memublikasikannya sebagai gambar komunitas untuk digunakan pihak lain.

Deskripsi operasi

Sebelum memanggil operasi ini, baca Berbagi gambar kustom.

Saat memanggil operasi ini, perhatikan aturan berbagi berikut:

Batas berbagi: Anda hanya dapat berbagi gambar kustom yang dibuat di bawah akun Anda. Setiap gambar dapat dibagikan kepada hingga 50 akun Alibaba Cloud, dan hingga 10 akun Alibaba Cloud pengatur waktu.
Dampak pada Instans: Setelah Instance ECS dibuat dari gambar bersama dengan memanggil RunInstances, jika pemilik gambar membatalkan berbagi gambar atau menghapus gambar kustom (DeleteImage), Instans tidak dapat menginisialisasi ulang disk sistemnya (ReInitDisk).

Penting Perubahan aturan untuk berbagi gambar terenkripsi di Elastic Compute Service (ECS): Hanya gambar yang dienkripsi dengan customer master key (CMK) yang dapat dibagikan. Gambar yang dienkripsi dengan kunci layanan tidak dapat lagi dibagikan dan akan mengembalikan error saat berbagi. Jika Anda memiliki gambar yang dienkripsi dengan kunci layanan dan berencana untuk membagikannya, gunakan operasi copy image (CopyImage) untuk mengubah kunci enkripsi menjadi CMK.

Untuk memublikasikan atau membatalkan publikasi gambar komunitas, perhatikan hal berikut:

Tanggung jawab dan perjanjian: Pemilik gambar komunitas bertanggung jawab atas kualitas dan pembaruan berulang gambar mereka. Alibaba Cloud hanya menyediakan dukungan platform. Sebelum memublikasikan, pastikan Anda telah membaca dan menandatangani perjanjian gambar komunitas. Jika tidak, publikasi tidak diizinkan. Untuk informasi selengkapnya, lihat Memublikasikan gambar komunitas.
Batas enkripsi: Gambar terenkripsi tidak dapat dipublikasikan sebagai gambar komunitas.
Akses publik: Gambar komunitas sepenuhnya bersifat publik. Semua akun Alibaba Cloud di wilayah tempat gambar berada dapat menggunakan gambar tersebut.
Batas fitur: Gambar komunitas tidak mendukung berbagi, ekspor, atau penyalinan.
Dampak pembatalan publikasi: Setelah gambar komunitas dibatalkan publikasinya, gambar tersebut tidak lagi tersedia secara publik untuk akun Alibaba Cloud lain. Namun, hubungan berbagi yang ada tetap dipertahankan.

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

ecs:ModifyImageSharePermission

update

*Image.

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID wilayah gambar kustom. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.	cn-hangzhou
ImageId	string	Yes	ID gambar kustom yang akan dibagikan. Penting Gambar yang dienkripsi dengan kunci layanan tidak dapat lagi dibagikan. Hanya gambar yang dienkripsi dengan customer master key (CMK) yang dapat dibagikan. Error akan dikembalikan jika Anda mencoba membagikan gambar yang dienkripsi dengan kunci layanan.	m-bp18ygjuqnwhechc****
LaunchPermission	string	No	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk digunakan.	hide
AddAccount	array	No	ID akun Alibaba Cloud yang diizinkan menggunakan gambar bersama. Nilai valid N: 1 hingga 10. Jika lebih dari 10 akun Alibaba Cloud dikirimkan dalam satu permintaan, sistem hanya memproses 10 pertama dan mengabaikan sisanya.	1234567890
	string	No	ID akun Alibaba Cloud yang diizinkan menggunakan gambar bersama.	1234567890
RemoveAccount	array	No	ID akun Alibaba Cloud yang ingin Anda hapus berbagi gambarnya. Nilai valid N: 1 hingga 10. Jika lebih dari 10 akun Alibaba Cloud dikirimkan dalam satu permintaan, sistem hanya memproses 10 pertama dan mengabaikan sisanya.	1234567890
	string	No	ID akun Alibaba Cloud yang ingin Anda hapus berbagi gambarnya.	1234567890
IsPublic	boolean	No	Apakah akan memublikasikan atau membatalkan publikasi gambar sebagai gambar komunitas. Nilai valid: true: Memublikasikan gambar sebagai gambar komunitas. false: Membatalkan publikasi gambar dan mengubahnya menjadi gambar biasa. Jika gambar sudah merupakan gambar biasa, tidak ada perubahan yang dilakukan. Nilai default: false.	false
DryRun	boolean	No

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code	Error code	Error message	Description
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.	Kelompok tertentu tidak ada.
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.	Anda harus menambahkan peran RAM AliyunECSShareEncryptImageDefaultRole sebelum membagikan image terenkripsi.
403	ImageDescription.ContainsSensitiveWords	The specified image description contains sensitive words.	Deskripsi image yang ditentukan mengandung kata-kata sensitif.
403	ImageName.ContainsSensitiveWords	The specified image name contains sensitive words.	Nama image yang ditentukan mengandung kata-kata sensitif.
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.	Image yang ditentukan tidak memiliki izin publik dan tidak dapat diubah menjadi izin privat.
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.	Image tidak dapat dibagikan lintas Penyedia Layanan Internet yang berbeda.
403	OperationDeined.EncryptedSnapshot	The image contains encrypted snapshots, which do not support share.	Image berisi snapshot terenkripsi.
403	OperationDenied.InvalidImageStatus	The specified image cannot be shared when it is deprecated.	Gambar kustom tertentu berada dalam status tidak digunakan lagi dan tidak dapat dibagikan. Panggil ModifyImageAttribute untuk mengubah status image tertentu terlebih dahulu.
403	PublicImageAgreement.NotSigned	The current account has not signed "Community Image Terms of Service".	Akun Alibaba Cloud saat ini belum menandatangani perjanjian gambar komunitas dan karenanya tidak dapat menerbitkan image yang ditentukan sebagai gambar komunitas. Panggil ModifyUserBusinessBehavior untuk menandatangani perjanjian gambar komunitas.
403	InvalidParameter.IsPublic	The specified parameter IsPublic is conflicted with other parameters.	Parameter IsPublic yang ditentukan berkonflik dengan parameter lain.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The specified KMS key is not authorized for the ECS service. Please grant the ECS service permission to use the key in the KMS console and try again.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The specified KMS key must be in an enabled state. Please enable the key in the KMS console and try again.
403	InvalidOperation.ServiceKeyEncryptedImageUnsupported	The specified image is encrypted with a service key and cannot be shared. Please call the CopyImage operation to encrypt the image with your own KMS key and then share the new image.
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.	Image yang ditentukan tidak ada di akun ini. Verifikasi bahwa ID image benar.
404	InvalidAccount.NotFound	The specified account %s in parameter "AddAccount.n" or "RemoveAccount.n" does not exist.	Akun yang ditentukan tidak ada.
404	InvalidAccount.Forbbiden	The specified Account does not yourself.
404	InvalidKMSKeyId.NotFound	The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.