Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris. # Harga kontrak untuk produk kontainer dengan AWS License Manager Untuk produk berbasis kontainer dengan harga kontrak, Anda dapat menggunakan AWS License Manager untuk mengaitkan lisensi dengan produk Anda. AWS License Manager adalah alat manajemen lisensi yang memungkinkan aplikasi Anda untuk melacak dan memperbarui lisensi (juga dikenal sebagai hak) yang telah dibeli oleh pelanggan. Bagian ini memberikan informasi tentang cara mengintegrasikan produk Anda AWS License Manager. Setelah integrasi selesai, Anda dapat mempublikasikan daftar produk Anda AWS Marketplace. Jika Anda mengintegrasikan License Manager dengan produk AWS Marketplace for Containers Anywhere untuk Amazon EKS Anywhere, Amazon ECS Anywhere, Amazon Elastic Compute Cloud (Amazon EC2), atau infrastruktur lokal, ikuti petunjuknya. [Mengintegrasikan AWS Marketplace untuk Kontainer Di Mana Saja dengan License Manager](container-anywhere-license-manager-integration.md) Untuk informasi selengkapnya AWS License Manager, lihat [Panduan AWS License Manager Pengguna](https://docs.aws.amazon.com/license-manager/latest/userguide/license-manager.html) dan [AWS License Manager](https://docs.aws.amazon.com/cli/latest/reference/license-manager/index.html)bagian *Referensi AWS CLI Perintah*. Untuk informasi selengkapnya tentang integrasi AWS License Manager dengan produk kontainer dengan harga kontrak, lihat lab [Integrasikan dengan pembayaran di muka](https://catalog.workshops.aws/mpseller/en-US/container/integrate-contract) bengkel *AWS Marketplace penjual*. **Topics** + [Harga kontrak untuk produk kontainer](#container-contracts) + [Model lisensi](#container-LM-license-models) + [AWS License Manager prasyarat integrasi](#container-LM-prereqs) + [Mengintegrasikan produk kontainer dengan License Manager](#container-integrate-with-LM) + [Operasi API License Manager](#container-LM-API-calls) + [Perpanjangan dan peningkatan lisensi](#container-LM-lic-renew-upgrade) + [Mengintegrasikan AWS Marketplace untuk Kontainer Di Mana Saja dengan License Manager](container-anywhere-license-manager-integration.md) ## Harga kontrak untuk produk kontainer Untuk produk berbasis kontainer dengan harga kontrak, AWS Marketplace menagih pelanggan Anda di muka atau dengan jadwal pembayaran yang Anda tentukan, berdasarkan kontrak antara Anda dan pelanggan Anda. Setelah itu, mereka berhak menggunakan sumber daya tersebut. Untuk menetapkan harga Anda, pilih satu atau lebih durasi kontrak yang Anda tawarkan kepada pelanggan. Anda dapat memasukkan harga yang berbeda untuk setiap durasi kontrak. Pilihan Anda adalah durasi 1 bulan, 12 bulan, 24 bulan, dan 36 bulan. Untuk penawaran pribadi, Anda dapat menentukan durasi khusus dalam beberapa bulan (hingga 144 bulan). Pilih kategori yang paling menggambarkan harga produk Anda. Kategori harga muncul untuk pelanggan di situs AWS Marketplace web. Anda dapat memilih dari **Bandwidth** (GB/s, MB/s), **Data** (GB, MB, TB), **Host**, **Requests**, **Tiers**, atau **Users**. Jika tidak ada kategori standar yang sesuai dengan kebutuhan Anda, Anda dapat memilih kategori **Unit** yang lebih umum. Penawaran ini memungkinkan hingga 24 dimensi untuk ditambahkan ke dalamnya. **Contoh: Aplikasi penyimpanan data** | | Harga 1 bulan | Harga 12 bulan | Harga 24 bulan | Harga P36 bulan | | --- | --- | --- | --- | --- | | Data tidak terenkripsi (GB) | $1,50/GB | $16,00/GB | $30.00/GB | $60.00/GB | | Data terenkripsi (GB) | $1,55/GB | $16,60/GB | $31.20/GB | $61.20/GB | **Contoh: Produk pemantauan log** | | Harga 1 bulan | Harga 12 bulan | Harga 24 bulan | Harga 36 bulan | | --- | --- | --- | --- | --- | | Dasar (10 host dipantau, 5 kontainer dipantau) | $100 | $1000 | $2000 | $4000 | | Standar (20 host dipantau, 10 kontainer dipantau) | $200 | $2000 | $4000 | $8000 | | Pro (40 host dipantau, 20 kontainer dipantau) | $400 | $4000 | $8000 | $16.000 | | Host tambahan dipantau per jam | $10 | $100 | $200 | $400 | | Kontainer tambahan dipantau per jam | $10 | $100 | $200 | $400 | **catatan** Harga bisa untuk jangka waktu berikut: 1 bulan, 12 bulan, 24 bulan, atau 36 bulan. Anda dapat memilih untuk menawarkan satu atau lebih opsi ini untuk produk Anda. Durasi harus sama di setiap dimensi. **Example** Misalnya, dalam kasus di mana Anda memiliki `ReadOnlyUsers` dan `AdminUsers` dimensi, jika Anda menawarkan harga tahunan untuk ReadOnlyUsers, Anda harus menawarkan harga tahunan juga. `AdminUsers` ### Perpanjangan otomatis Ketika pelanggan membeli produk Anda melalui AWS Marketplace menggunakan kontrak kontainer, mereka dapat setuju untuk memperbarui persyaratan kontrak secara otomatis. Pelanggan terus membayar hak setiap bulan atau selama 1, 2, atau 3 tahun. Pelanggan dapat mengubah pengaturan perpanjangan mereka kapan saja. Untuk informasi selengkapnya, lihat [Memodifikasi kontrak yang ada](https://docs.aws.amazon.com/marketplace/latest/buyerguide/buyer-container-contracts.html#modify-existing-contract) di *Panduan AWS Marketplace Pembeli*. ## Model lisensi AWS Marketplace integrasi dengan AWS License Manager mendukung dua model lisensi: + [Model lisensi yang dapat dikonfigurasi](#container-LM-config-lic-model) + [Model lisensi berjenjang](#container-LM-tiered-lic-model) ### Model lisensi yang dapat dikonfigurasi Model lisensi yang dapat dikonfigurasi (juga dikenal sebagai model lisensi yang dapat diukur) memberikan hak kepada pembeli untuk sejumlah sumber daya tertentu setelah pembeli memperoleh lisensi. Anda menetapkan dimensi harga dan harga per unit. Kemudian, pembeli dapat memilih jumlah sumber daya yang ingin mereka beli. **Example dimensi harga dan harga per unit** Anda dapat menetapkan dimensi harga (seperti cadangan data) dan harga per unit (seperti $30/unit). Pembeli dapat memilih untuk membeli 5, 10, atau 20 unit. Produk Anda melacak dan penggunaan meter untuk mengukur jumlah sumber daya yang dikonsumsi. Dengan model konfigurasi, hak dihitung dalam salah satu dari dua cara: + [Lisensi drawdown](#container-floating-lic) + [Lisensi mengambang](#container-floating-lic) #### Lisensi drawdown Lisensi diambil dari kumpulan jumlah lisensi yang diizinkan saat digunakan. Hak tersebut diperiksa secara permanen dan tidak dapat dikembalikan ke kumpulan lisensi. **Example Memproses data dalam jumlah terbatas** Seorang pengguna berhak untuk memproses 500 GB data. Ketika mereka terus memproses data, kuantitas diambil dari kumpulan 500 GB hingga semua lisensi 500 GB dikonsumsi. Untuk lisensi drawdown, Anda dapat menggunakan operasi `CheckoutLicense` API untuk memeriksa unit lisensi (hak) yang digunakan. **Example cadangan ke Amazon S3 untuk sejumlah unit/tahun** Anda memiliki produk penyimpanan yang memungkinkan pencadangan ke Amazon Simple Storage Service hingga 1.024 unit untuk data selama satu tahun. Aplikasi Anda dapat diluncurkan dengan menggunakan beberapa instans Amazon EC2. Aplikasi Anda memiliki mekanisme untuk melacak dan mengumpulkan data. Perangkat lunak Anda memanggil operasi `CheckoutLicense` API dengan ID Produk pada setiap cadangan atau pada interval tetap untuk memperbarui jumlah yang dikonsumsi. Dalam contoh ini, perangkat lunak Anda memanggil operasi `CheckoutLicense` API untuk memeriksa 10 unit data. Ketika total kapasitas mencapai batas cadangan yang telah dibeli pelanggan, panggilan API gagal. **Permintaan** ``` linux-machine ~]$ aws license-manager checkout-license\ --product-sku "2205b290-19e6-4c76-9eea-377d6bf7la47" \ --checkout-type "PERPETUAL" \ --key-fingerprint "aws:294406891311:AWS/Marketplace:issuer-fingerprint" \ --entitlements "Name=DataConsumption, Value=l0, Unit=Count" \ --client-token "AKIAIOSFODNN7EXAMPLE" ``` **Respons** ``` {"CheckoutType": "PERPETUAL", "EntitlementsAllowed": [{ "Name": "IntermediateTier", "Units": "None" }], "Expiration": "2021-04-22Tl9:02:36", "IssuedAt": "2021-04-22Tl8:02:36", "LicenseArn": "arn:aws:license-manager::294406891311:license:l-16bf01b...", "LicenseConsumptionToken": "AKIAIOSFODNN7EXAMPLE" } ``` #### Lisensi mengambang Lisensi dikembalikan ke kumpulan jumlah lisensi yang diizinkan setelah digunakan. Untuk lisensi mengambang, aplikasi memeriksa hak dari kumpulan hak menggunakan operasi `CheckoutLicense` API saat sumber daya digunakan. Respons operasi `CheckoutLicense` API mencakup token konsumsi lisensi yang merupakan pengenal unik untuk checkout. Token konsumsi lisensi dapat digunakan untuk melakukan tindakan tambahan pada hak yang diperiksa, seperti memeriksanya kembali ke lisensi atau memperpanjang checkout. Untuk memeriksa kembali hak ke kumpulan, gunakan operasi `CheckInLicense` API saat sumber daya tidak lagi digunakan. ``` aws license-manager check-in-license --license-consumption-token "f1603b3c1f574b7284db84..." ``` Jika terjadi kegagalan untuk memeriksa hak (jika aplikasi macet), hak akan memeriksa kembali ke kumpulan secara otomatis setelah 60 menit. Jika sumber daya digunakan lebih dari 60 menit, itu adalah praktik terbaik untuk menjaga hak diperiksa dari kumpulan dengan menggunakan operasi `ExtendLicenseConsumption` API selama sumber daya digunakan. ``` aws license-manager extend-license-consumption --license-consumption-token "f1603b3c1f574b7284..." ``` **Example jumlah pengguna dari batas atas tetap** Seorang pengguna berhak atas 500 pengguna simultan pada aplikasi. Saat pengguna masuk dan keluar, pengguna ditarik dan dikembalikan ke kumpulan 500 pengguna. Namun, aplikasi tidak dapat menarik lebih dari 500 pengguna dari pool karena 500 pengguna simultan adalah batas atas tetap. Untuk hak mengambang, Anda dapat menggunakan operasi `CheckInLicense` API untuk mengembalikan unit lisensi ke kumpulan hak. **Example jumlah pengguna bersamaan selama satu tahun** Harga produk Anda berdasarkan jumlah pengguna bersamaan. Pelanggan membeli lisensi untuk 10 pengguna selama satu tahun. Pelanggan meluncurkan perangkat lunak dengan memberikan izin AWS Identity and Access Management (IAM). Ketika pengguna log in, aplikasi Anda memanggil operasi `CheckoutLicense` API untuk mengurangi kuantitas sebesar 1. Saat pengguna log out, aplikasi mengembalikan lisensi tersebut ke pool dengan memanggil operasi `CheckInLicense` API. Jika Anda tidak menelepon`CheckInLicense`, unit lisensi akan secara otomatis diperiksa setelah 1 jam. **catatan** Dalam Permintaan berikut, `key-fingerprint` bukan nilai placeholder tetapi nilai sebenarnya dari sidik jari yang dengannya semua lisensi akan dipublikasikan. **Permintaan** ``` aws license-manager checkout-license\ --product-sku "2205b290-19e6-4c76-9eea-377d6bf7la47" \ --checkout-type "PROVISIONAL" \ --key-fingerprint "aws:294406891311:AWS/Marketplace:issuer-fingerprint" \ --entitlements "Name=ReadOnlyUSers, Value=l0, Unit=Count" \ --client-token "AKIAIOSFODNN7EXAMPLE" ``` **Respons** ``` { "CheckoutType": "PROVISIONAL", "EntitlementsAllowed": [ { "Name": "ReadOnlyUsers", "Count": 10, "Units": "Count", "Value": "Enabled" } }, "Expiration": "2021-04-22Tl9:02: 36", "IssuedAt": "2021-04-22Tl8:02:36", "LicenseArn": "arn:aws:license-manager::294406891311:license:l-16bf01b...", "LicenseConsumptionToken": "AKIAIOSFODNN7EXAMPLE" } ``` ### Model lisensi berjenjang Model lisensi berjenjang memberikan hak kepada pembeli ke tingkat tertentu, atau tingkat, fitur aplikasi setelah pembeli memperoleh lisensi. Anda membuat tingkatan untuk produk Anda, seperti Basic, Intermediate, dan Premium. Pembeli kemudian memilih salah satu tingkatan yang telah ditentukan. Aplikasi tidak perlu melacak atau mengukur penggunaan aplikasi. Dengan model lisensi berjenjang, hak tidak dihitung melainkan menandakan tingkat layanan yang diperoleh oleh pelanggan. Jika Anda ingin menawarkan fitur yang dibundel bersama-sama, tingkatan lebih disukai. **Example Tingkat Dasar, Menengah, dan Premium** Pelanggan dapat menandatangani kontrak untuk salah satu dari tiga kemungkinan tingkatan perangkat lunak: Dasar, Menengah, atau Premium. Masing-masing tingkatan ini memiliki harga sendiri. Perangkat lunak Anda dapat mengidentifikasi tingkat yang telah didaftarkan pelanggan dengan menjalankan operasi `CheckoutLicense` API dan menentukan semua tingkatan yang mungkin dalam permintaan. Tanggapan permintaan berisi hak yang sesuai dengan tingkat yang telah diperoleh pelanggan. Berdasarkan informasi ini, perangkat lunak dapat memberikan pengalaman pelanggan yang sesuai. #### Permintaan ``` linux-machine ~]$ aws license-manager checkout-license\ --product-sku "2205b290-19e6-4c76-9eea-377d6bf7la47" \ --checkout-type "PROVISIONAL" \ --key-fingerprint "aws:294406891311:AWS/Marketplace:issuer-fingerprint" \ --entitlements "Name=BasicTier, Unit=None" "Name=IntermediateTier, Unit=None" \ "Name=PremiumTier, Unit=None" ``` #### Respons ``` { "CheckoutType": "PROVISIONAL", "EntitlementsAllowed": [ { "Name": "IntermediateTier", "Units": "None" } }, "Expiration": "2021-04-22Tl9:02:36", "IssuedAt": "2021-04-22Tl8:02:36", "LicenseArn": "arn:aws:license-manager::294406891311:license:l-16bf01b...", "LicenseConsumptionToken": "AKIAIOSFODNN7EXAMPLE" } ``` ## AWS License Manager prasyarat integrasi Sebelum menerbitkan produk, Anda harus melakukan hal berikut: 1. Buat produk kontainer baru di Portal Manajemen AWS Marketplace, dan catat kode produknya. Untuk informasi selengkapnya, lihat [Ikhtisar: Buat produk kontainer](container-product-getting-started.md#create-container-product). 1. Gunakan peran IAM untuk tugas atau pod yang menjalankan aplikasi Anda dengan izin IAM yang diperlukan untuk memanggil operasi`CheckoutLicense`,`ExtendLicenseConsumption`, dan `CheckInLicense` API. Izin IAM yang diperlukan dirinci dalam kebijakan IAM berikut. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement":[ { "Sid":"VisualEditorO", "Effect":"Allow", "Action":[ "license-manager:CheckoutLicense", "license-manager:GetLicense", "license-manager:CheckInLicense", "license-manager:ExtendLicenseConsumption", "license-manager:ListReceivedLicenses" ], "Resource":"*" } ] } ``` ------ 1. Lakukan panggilan uji ke operasi `RegisterUsage` API dengan catatan untuk semua dimensi harga yang Anda tentukan. ## Mengintegrasikan produk kontainer dengan License Manager **Untuk mengintegrasikan produk berbasis kontainer Anda dengan License Manager** 1. Setel izin IAM untuk memanggil License Manager. Untuk informasi selengkapnya, lihat [AWS License Manager prasyarat integrasi](#container-LM-prereqs). 1. Unduh AWS SDK. **catatan** Jangan mengkonfigurasi AWS kredensional dalam perangkat lunak Anda. AWS kredensil untuk pembeli diperoleh secara otomatis saat runtime saat container Anda berjalan dalam instans Amazon EC2, tugas Amazon ECS, atau pod Amazon EKS. 1. Tambahkan cek lisensi ke produk Anda. Produk Anda dapat memanggil operasi `CheckoutLicense` API di mana pun pemeriksaan lisensi harus dilakukan. Untuk memeriksa lisensi, produk Anda harus tahu: 1. Penerbit lisensi tepercaya ()AWS Marketplace 1. SKU Produk aplikasi (ID Produk) 1. Hak untuk memeriksa aplikasi ini Panggilan API bervariasi berdasarkan jenis lisensi harga yang Anda siapkan. 1. Publikasikan daftar produk Anda di AWS Marketplace. ## Operasi API License Manager Untuk mengelola lisensi yang disimpan di akun License Manager pelanggan, perangkat lunak Anda dapat menggunakan operasi API berikut: + `GetLicense`— API yang dapat ditanyakan oleh perangkat lunak. Ini mengambil status lisensi yang dibeli (yaitu kedaluwarsa atau segera kedaluwarsa) dan mengirimkan pemberitahuan status kepada pelanggan. + `CheckoutLicense`— Menemukan lisensi yang telah dibeli pengguna. Anda juga dapat menggunakan operasi `CheckoutLicense` API untuk memperbarui kuantitas lisensi ketika pengguna telah menggunakan sejumlah lisensi. Dengan`CheckoutLicense`, Anda dapat terus memeriksa jumlah lisensi yang digunakan oleh pelanggan. Ketika pelanggan kehabisan semua lisensi, panggilan ini mengembalikan kesalahan. Untuk informasi tentang irama yang disarankan untuk dijalankan`CheckoutLicense`, lihat[Perpanjangan dan peningkatan lisensi](#container-LM-lic-renew-upgrade). + `ExtendLicenseConsumption`— Dalam hal dimensi mengambang, ketika perangkat lunak memeriksa lisensi, lisensi akan kembali ke kolam secara otomatis setelah 60 menit. Jika Anda ingin memperpanjang waktu lisensi tetap diperiksa, gunakan operasi `ExtendLicenseConsumption` API untuk memperpanjang lisensi selama 60 menit lagi. + `CheckInLicense`— Dalam kasus dimensi mengambang, ketika Anda ingin mengembalikan lisensi ke kumpulan hak, gunakan operasi `CheckInLicense` API. + `ListReceivedLicenses`API - Daftar lisensi yang dibeli oleh pembeli. ## Perpanjangan dan peningkatan lisensi Pelanggan dapat memperbarui atau meningkatkan lisensi mereka di. Portal Manajemen AWS Marketplace Setelah mereka melakukan pembelian tambahan AWS Marketplace , buat versi baru dari lisensi yang mencerminkan hak baru. Perangkat lunak Anda membaca hak baru dengan menggunakan operasi API yang sama. Anda tidak perlu melakukan sesuatu yang berbeda dalam hal integrasi License Manager untuk menangani pembaruan dan peningkatan. Karena perpanjangan lisensi, peningkatan, pembatalan, dan sebagainya, kami menyarankan agar produk Anda memanggil operasi `CheckoutLicense` API dengan irama reguler saat produk sedang digunakan. Dengan menggunakan operasi `CheckoutLicense` API pada irama reguler, produk dapat mendeteksi perubahan hak seperti upgrade dan kedaluwarsa. Kami menyarankan Anda melakukan panggilan `CheckoutLicense` API setiap 15 menit.