Mengkonfigurasi pengukuran per jam dengan Marketplace Metering Service AWS - AWS Marketplace
Prasyarat pengukuran per jamFormulir beban produk untuk pengukuran per jamMenguji integrasi dan mode pratinjau untuk RegisterUsagePenanganan kesalahan untuk RegisterUsage

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Mengkonfigurasi pengukuran per jam dengan Marketplace Metering Service AWS

Jika produk kontainer Anda menggunakan harga per jam per tugas atau per-pod alih-alih dimensi harga terukur khusus, Anda tidak perlu menentukan dimensi pengukuran khusus. Anda dapat menggunakan AWS Marketplace Metering Service untuk pengukuran per jam dengan produk kontainer di. AWS Marketplace Bagian berikut menunjukkan cara mengonfigurasi pengukuran per jam dengan AWS Marketplace Metering Service.

Perangkat lunak pengukur RegisterUsage API operasi digunakan per tugas Amazon Elastic Container Service (AmazonECS) atau per pod Amazon Elastic Kubernetes Service (EKSAmazon), per jam, dengan penggunaan prorata ke yang kedua. Penggunaan minimal 1 menit berlaku untuk tugas atau pod yang berumur pendek. Pengukuran berkelanjutan untuk penggunaan perangkat lunak secara otomatis ditangani oleh AWS Marketplace Metering Control Plane. Perangkat lunak Anda tidak diperlukan untuk melakukan tindakan khusus pengukuran apa pun kecuali menelepon RegisterUsage sekali untuk pengukuran penggunaan perangkat lunak untuk memulai.

RegisterUsageharus segera dipanggil pada saat meluncurkan wadah. Jika Anda tidak mendaftarkan kontainer dalam 6 jam pertama peluncuran kontainer, AWS Marketplace Metering Service tidak memberikan jaminan pengukuran apa pun untuk bulan-bulan sebelumnya. Namun, pengukuran akan berlanjut untuk bulan berjalan ke depan sampai wadah berakhir.

The AWS Marketplace Metering Control Plane terus menagih pelanggan untuk menjalankan ECS tugas Amazon dan EKS pod Amazon, terlepas dari status langganan pelanggan. Ini menghilangkan kebutuhan perangkat lunak Anda untuk melakukan pemeriksaan hak setelah peluncuran tugas atau pod awal yang berhasil.

Topik

Prasyarat pengukuran per jam

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.

  2. Gunakan peran AWS Identity and Access Management (IAM) untuk tugas atau pod yang menjalankan aplikasi Anda dengan IAM izin yang diperlukan untuk memanggilRegisterUsage. Kebijakan IAM terkelola AWSMarketplaceMeteringRegisterUsage memiliki izin ini.

  3. (Opsional) Jika Anda ingin melihat logging, kami sarankan Anda mengaktifkan AWS CloudTrail logging dalam tugas atau definisi pod.

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

Formulir beban produk untuk pengukuran per jam

Saat mengisi formulir beban produk untuk pengukuran per jam, isi kolom berikut untuk produk Anda, selain bidang lain yang diperlukan dan opsional yang menentukan produk Anda:

  • Harga Per Jam — Harga untuk produk Anda, per jam.

  • Dimensi Tingkat Jangka Panjang— Harga perangkat lunak total selama kontrak jangka panjang saat pembeli membayar di muka.

  • Durasi Jangka Panjang (Hari)— Durasi, dalam hari, untuk kontrak jangka panjang.

Menguji integrasi dan mode pratinjau untuk RegisterUsage

Gunakan RegisterUsage API operasi untuk menguji integrasi Anda sebelum mengirimkan gambar Anda AWS Marketplace untuk dipublikasikan.

Mode pratinjau beroperasi secara identik dengan mode produksi, kecuali mode pratinjau tidak memverifikasi hak untuk menggunakan produk Anda. Untuk memanggil RegisterUsage dalam mode pratinjau, panggil RegisterUsage dari gambar kontainer dengan menjalankan produk Anda di Amazon ECS atau AmazonEKS. Gunakan Akun AWS yang Anda gunakan untuk membuat daftar produk AWS Marketplace. Integrasi pengukuran Anda harus secara dinamis mengatur Wilayah AWS, bukan hardcoding itu. Namun, saat menguji, luncurkan setidaknya satu ECS tugas Amazon atau EKS pod Amazon yang berisi kontainer berbayar Anda di Wilayah AS Timur (Virginia Utara). Dengan melakukan ini, tim AWS Marketplace operasi dapat memverifikasi pekerjaan Anda dengan log di Wilayah tersebut.

catatan

Jika produk Anda mendukung Amazon ECS dan AmazonEKS, Anda hanya perlu meluncurkan di Amazon EKS agar kami dapat memvalidasi integrasi Anda.

Anda tidak dapat sepenuhnya menguji integrasi sampai produk Anda dipublikasikan dengan semua metadata dan informasi harga yang diperlukan. Jika diminta, tim operasi AWS Marketplace katalog dapat memverifikasi penerimaan catatan pengukuran Anda dalam mode pratinjau.

Penanganan kesalahan untuk RegisterUsage

Jika image container Anda terintegrasi dengan AWS Marketplace Metering Service dan menerima pengecualian selain ThrottlingException saat startup container, Anda harus menghentikan container untuk mencegah penggunaan yang tidak sah.

Pengecualian selain ThrottlingException dilemparkan hanya pada panggilan awal ke RegisterUsage API operasi. Panggilan berikutnya dari ECS tugas Amazon yang sama atau EKS pod Amazon tidak dibuang CustomerNotSubscribedException meskipun pelanggan berhenti berlangganan saat tugas atau pod masih berjalan. Pelanggan ini masih dikenakan biaya untuk menjalankan kontainer setelah mereka berhenti berlangganan, dan penggunaannya dilacak.

Tabel berikut menjelaskan kesalahan yang mungkin dilemparkan oleh RegisterUsage API operasi. Setiap bahasa AWS SDK pemrograman memiliki seperangkat pedoman penanganan kesalahan yang dapat Anda rujuk untuk informasi tambahan.

Kesalahan Deskripsi
InternalServiceErrorException RegisterUsagetidak tersedia.
CustomerNotEntitledException Pelanggan tidak memiliki langganan yang valid untuk produk tersebut.
InvalidProductCodeException ParameterProductCodenilai yang dilewatkan sebagai bagian dari permintaan tidak ada.
InvalidPublicKeyException ParameterPublicKeyVersionnilai yang dilewatkan sebagai bagian dari permintaan tidak ada.
PlatformNotSupportedException AWS Marketplace tidak mendukung penggunaan pengukuran dari platform yang mendasarinya. Hanya AmazonECS, AmazonEKS, dan AWS Fargate didukung.
ThrottlingException Panggilan keRegisterUsagediperlambat.
InvalidRegionException RegisterUsageharus dipanggil sama dengan Wilayah AWS ECS tugas Amazon atau EKS pod Amazon diluncurkan. Hal ini mencegah kontainer dari memilih Wilayah (misalnya,withRegion(“us-east-1”)) saat memanggilRegisterUsage.