Model lisensi AWS License Manager prasyarat integrasi Mengintegrasikan produk kontainer dengan License Manager APIOperasi License Manager Perpanjangan dan peningkatan lisensi

Harga kontrak untuk produk Kontainer dengan AWS License Manager

Untuk produk berbasis kontainer dengan harga kontrak, gunakan 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 EC2 (Amazon), atau infrastruktur lokal, ikuti petunjuknya. Mengintegrasikan produk AWS Marketplace for Containers Anywhere dengan License Manager

Untuk informasi selengkapnya AWS License Manager, lihat Panduan AWS License Manager Pengguna dan AWS License Managerbagian Referensi AWS CLI Perintah.

Model lisensi

AWS Marketplace integrasi dengan AWS License Manager mendukung dua model lisensi:

Model lisensi yang dapat dikonfigurasi
Model lisensi berjenjang

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.

contoh 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
Lisensi mengambang

Lisensi penarikan

Lisensi diambil dari kumpulan jumlah lisensi yang diizinkan saat digunakan. Hak tersebut diperiksa secara permanen dan tidak dapat dikembalikan ke kumpulan lisensi.

contoh 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 CheckoutLicense API operasi untuk memeriksa unit lisensi (hak) yang digunakan.

contoh cadangan ke S3 untuk sejumlah unit/tahun

Anda memiliki produk penyimpanan yang memungkinkan pencadangan ke Amazon Simple Storage Service (Amazon S3) hingga 1.024 unit untuk data selama satu tahun. Aplikasi Anda dapat diluncurkan dengan menggunakan beberapa EC2 instans Amazon. Aplikasi Anda memiliki mekanisme untuk melacak dan mengumpulkan data. Perangkat lunak Anda memanggil CheckoutLicense API operasi dengan ID Produk pada setiap cadangan atau pada interval tetap untuk memperbarui jumlah yang dikonsumsi.

Dalam contoh ini, perangkat lunak Anda memanggil CheckoutLicense API operasi untuk memeriksa 10 unit data. Ketika total kapasitas mencapai batas cadangan yang telah dibeli pelanggan, API panggilan 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 CheckoutLicense API operasi saat sumber daya digunakan. Respons CheckoutLicense API operasi termasuk 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 hak kembali ke kolam, gunakan CheckInLicense API operasi 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 kolam dengan menggunakan ExtendLicenseConsumption API operasi selama sumber daya digunakan.


aws license-manager extend-license-consumption --license-consumption-token "f1603b3c1f574b7284..."

contoh 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 kolam karena 500 pengguna simultan adalah batas atas tetap.

Untuk hak mengambang, Anda dapat menggunakan CheckInLicense API operasi untuk mengembalikan unit lisensi ke kumpulan hak.

contoh 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 AWS Identity and Access Management (IAM) izin. Ketika pengguna log in, aplikasi Anda memanggil CheckoutLicense API operasi untuk mengurangi kuantitas sebesar 1. Ketika pengguna log out, aplikasi mengembalikan lisensi itu ke pool dengan memanggil CheckInLicense API operasi. Jika Anda tidak meneleponCheckInLicense, 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.

contoh 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 CheckoutLicense API operasi 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:

Buat produk kontainer baru di Portal Manajemen AWS Marketplace, dan catat kode produknya.

Untuk informasi selengkapnya, lihat Membuat produk kontainer.
Isi formulir pemuatan produk (PLF) dengan informasi harga yang diperlukan, dan kembalikan kepada kami untuk diproses.

Untuk informasi selengkapnya, lihat Membuat atau memperbarui detail harga untuk produk kontainer (warisan).

Gunakan IAM peran untuk tugas atau pod yang menjalankan aplikasi Anda dengan IAM izin yang diperlukan untuk memanggilCheckoutLicense,ExtendLicenseConsumption, dan CheckInLicense API operasi.

IAMIzin yang diperlukan dirinci dalam IAM kebijakan berikut.


{
   "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":"*"
      }
   ]
}

Lakukan panggilan uji ke RegisterUsage API operasi dengan catatan untuk semua dimensi harga yang Anda tentukan.

Mengintegrasikan produk kontainer dengan License Manager

Untuk mengintegrasikan produk berbasis kontainer Anda dengan License Manager

Setel IAM izin untuk memanggil License Manager. Untuk informasi selengkapnya, lihat AWS License Manager prasyarat integrasi.
Unduh AWS SDK.

catatan
Jangan mengkonfigurasi AWS kredensil dalam perangkat lunak Anda. AWS kredensi untuk pembeli diperoleh secara otomatis saat runtime saat container Anda berjalan dalam instans Amazon, ECS tugas AmazonEC2, atau pod Amazon. EKS
Tambahkan cek lisensi ke produk Anda.

Produk Anda dapat memanggil CheckoutLicense API operasi di mana pun pemeriksaan lisensi harus dilakukan. Untuk memeriksa lisensi, produk Anda harus tahu:
1. Penerbit lisensi tepercaya ()AWS Marketplace
2. Produk aplikasi SKU (ID Produk)
3. Hak untuk memeriksa aplikasi ini
APIPanggilan bervariasi berdasarkan jenis lisensi harga yang Anda siapkan.
Publikasikan daftar produk Anda di AWS Marketplace.

APIOperasi License Manager

Untuk mengelola lisensi yang disimpan di akun License Manager pelanggan, perangkat lunak Anda dapat menggunakan API operasi berikut:

GetLicense— Sebuah API yang perangkat lunak dapat query. 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 CheckoutLicense API operasi untuk memperbarui jumlah lisensi ketika pengguna telah menggunakan sejumlah lisensi. DenganCheckoutLicense, Anda dapat terus memeriksa jumlah lisensi yang digunakan oleh pelanggan. Ketika pelanggan menghabiskan semua lisensi, panggilan ini mengembalikan kesalahan. Untuk informasi tentang irama yang disarankan untuk dijalankanCheckoutLicense, lihatPerpanjangan dan peningkatan lisensi.
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 ExtendLicenseConsumption API operasi untuk memperpanjang lisensi selama 60 menit lagi.
CheckInLicense— Dalam kasus dimensi mengambang, ketika Anda ingin mengembalikan lisensi ke kumpulan hak, gunakan CheckInLicense API operasi.
ListReceivedLicensesAPI— 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 yang samaAPI. 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 CheckoutLicense API operasi dengan irama reguler saat produk sedang digunakan. Dengan menggunakan CheckoutLicense API operasi pada irama reguler, produk dapat mendeteksi perubahan hak seperti peningkatan dan kedaluwarsa.

Kami menyarankan Anda melakukan CheckoutLicense API panggilan setiap 15 menit.

Awas Javascript dinonaktifkan atau tidak tersedia di browser Anda.

Untuk menggunakan Dokumentasi AWS, Javascript harus diaktifkan. Lihat halaman Bantuan browser Anda untuk petunjuk.

Konvensi Dokumen

Integrasi Java

Mengintegrasikan produk AWS Marketplace for Containers Anywhere dengan License Manager