Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.
# Harga pengukuran khusus untuk produk AMI dengan AWS Marketplace Metering Service
Dengan AWS Marketplace Metering Service, Anda dapat memodifikasi perangkat lunak Anda untuk mengirim catatan pengukuran ke titik akhir untuk menangkap penggunaan. Anda dapat memilih kategori penggunaan dan menentukan hingga 24 dimensi untuk satu kategori tersebut. Dimensi ini diukur sekali per jam, dikumpulkan, dan dibebankan terhadap rencana harga yang Anda tentukan. Sebagai penjual, Anda harus menentukan dimensi mana yang ingin Anda gunakan. Setelah AMI diterbitkan, Anda tidak akan dapat mengubahnya. Bagian berikut memberikan informasi tentang AWS Marketplace Metering Service.
**Topics**
+ [Menggabungkan konsep layanan pengukuran](#metering-service-concepts)
+ [Harga perangkat lunak Anda](#pricing-your-software)
+ [Menambahkan produk Anda ke AWS Marketplace](#listing-your-product-on-aws-marketplace)
+ [Memodifikasi perangkat lunak Anda untuk menggunakan Layanan Pengukuran](#modifying-your-software-to-use-the-metering-service)
+ [Penandaan terukur vendor (Opsional)](#ami-vendor-metered-tagging)
+ [Mengkonfigurasi pengukuran kustom](#configure-custom-metering)
+ [Mengkonfigurasi pengukuran khusus untuk produk AMI dengan AWS Marketplace Metering Service](custom-metering-with-mp-metering-service.md)
## Menggabungkan konsep layanan pengukuran
Sebelum Anda menggunakan AWS Marketplace Metering Service, perhatikan konsep layanan penting berikut ini:
+ **Kategori Penggunaan** — Setiap produk perangkat lunak yang diberi harga melalui penggunaan Layanan Pengukuran dikategorikan menurut satu kategori penggunaan, yang menentukan cara yang tepat untuk membebankan biaya kepada pelanggan. Kategori penggunaan termasuk tetapi tidak terbatas pada:
+ **Pengguna** — Satu set izin yang ditentukan yang terkait dengan pengenal tunggal. Kategori ini sesuai untuk perangkat lunak di mana pengguna pelanggan terhubung ke perangkat lunak secara langsung (misalnya, untuk manajemen hubungan pelanggan atau pelaporan intelijen bisnis).
+ **Host** — Setiap server, node, instance, endpoint, atau bagian lain dari sistem komputasi. Kategori ini sesuai untuk perangkat lunak yang memonitor atau memindai banyak instans milik pelanggan (misalnya, pemantauan kinerja atau keamanan).
+ **Data** — Penyimpanan atau informasi, diukur dalam MB, GB, atau TB. Kategori ini sesuai untuk perangkat lunak yang mengelola data tersimpan atau memproses data dalam batch.
+ **Bandwidth** — Diukur dalam Mbps atau Gbps. Kategori ini sesuai untuk perangkat lunak yang memungkinkan pelanggan untuk menentukan jumlah bandwidth untuk penyediaan.
+ **Unit** — Satuan pengukuran; lihat contoh yang dijelaskan selanjutnya.
+ **Unit Penggunaan — Unit** penggunaan khusus produk perangkat lunak sesuai dengan kategori penggunaan yang dipilih. Unit penggunaan ini menjelaskan unit yang akan dikenakan biaya perangkat lunak Anda. Contohnya termasuk:
+ **NodesHrs**(sesuai dengan kategori Host)
+ **UserHrs**(sesuai dengan kategori Pengguna)
+ **GBStored**(sesuai dengan kategori Data)
+ **Konsumsi** — Produk perangkat lunak yang diberi harga melalui penggunaan Layanan Pengukuran membebankan biaya untuk konsumsi dalam salah satu dari tiga cara:
+ Diberikan - Perangkat lunak ini memungkinkan pelanggan untuk mengkonfigurasi jumlah sumber daya tertentu untuk digunakan (misalnya, jumlah pengguna atau jumlah bandwidth tetap). Setiap jam, pelanggan membayar untuk apa yang telah mereka tetapkan.
+ Bersamaan - Perangkat lunak ini memungkinkan sejumlah host yang berbeda atau pengguna untuk terhubung ke perangkat lunak. Setiap jam, pelanggan membayar berdasarkan jumlah host atau pengguna yang mengakses perangkat lunak.
+ Akumulasi — Perangkat lunak ini memungkinkan pelanggan untuk menggunakan sejumlah data, baik diproses atau disimpan. Setiap jam, pelanggan membayar jumlah agregat.
+ **Harga** — Produk perangkat lunak yang diberi harga melalui penggunaan Layanan Pengukuran harus menentukan harga tunggal atau menentukan hingga 24 dimensi, masing-masing dengan harganya sendiri. Rincian tentang opsi harga meliputi:
+ Dimensi tunggal - Ini adalah pilihan harga yang paling mudah. Pelanggan membayar satu harga per unit sumber daya per jam, terlepas dari ukuran atau volume (misalnya, \$10,014 per pengguna per jam, atau \$10,070 per host per jam).
+ Multiple dimensions - Opsi harga ini sesuai saat kategori penggunaan yang dipilih bervariasi sepanjang beberapa sumbu. Misalnya, untuk pemantauan host, harga yang berbeda dapat diatur tergantung pada ukuran host. Atau, untuk harga berbasis pengguna, harga yang berbeda dapat ditetapkan berdasarkan tipe pengguna (misalnya, admin, power user, dan read-only user).
+ **Pengukuran**— Semua penggunaan dicatat sebagai acara pengukuran, setiap jam sekali. Perangkat lunak Anda harus dikonfigurasi untuk mengirim dimensi dan jumlah penggunaan yang sesuai ke AWS Marketplace Layanan Pengukuran.
+ Alokasi - Opsional, Anda dapat mendistribusikan penggunaan ke alokasi oleh properti yang Anda melacak. Alokasi ini direpresentasikan sebagai tag kepada pembeli. Tag memungkinkan pembeli untuk melihat biaya mereka dibagi menjadi penggunaan dengan tag. Sebagai contoh, jika Anda mengisi oleh pengguna, dan pengguna memiliki properti “Departemen”, Anda dapat membuat alokasi penggunaan dengan tag yang memiliki kunci “Departemen”, dan satu alokasi per nilai. Pendekatan ini tidak mengubah harga, dimensi, atau total penggunaan yang Anda laporkan. Namun, ini memungkinkan pelanggan Anda untuk melihat biaya mereka berdasarkan kategori yang sesuai dengan produk Anda.
## Harga perangkat lunak Anda
Saat menetapkan harga perangkat lunak Anda dengan AWS Marketplace Layanan Pengukuran, Anda harus terlebih dahulu memutuskan kategori penggunaan dan bagaimana hal itu akan dikonsumsi. Tia mendukung enam skenario harga yang berbeda. Anda harus memilih hanya salah satu dari ini untuk produk Anda:
+ Pengguna yang ditetapkan (per jam)
+ Pengguna bersamaan (per jam)
+ Host yang ditetapkan (per jam)
+ Host serentak (per jam)
+ Bandwidth yang ditetapkan (per jam)
+ Akumulasi data (per jam)
Selanjutnya, Anda harus memutuskan bagaimana harga kategori penggunaan yang dipilih:
+ Harga tunggal
+ Beberapa dimensi (hingga 24)
[Menambahkan produk Anda ke AWS Marketplace](#listing-your-product-on-aws-marketplace)menjelaskan cara memberikan deskripsi dimensi dan harga yang sesuai dengan pelanggan.
### Contoh: Bandwidth yang ditetapkan dengan harga nonlinear
Bayangkan Anda menawarkan perangkat lunak perangkat jaringan. Anda memilih untuk tagihan dengan bandwidth yang ditetapkan. Untuk kategori penggunaan Anda, pilih **Bandwidth**. Selain pengisian dengan bandwidth, Anda ingin mengisi harga yang berbeda karena pembeli meningkatkan skala. Anda dapat menentukan beberapa dimensi dalam kategori bandwidth. Anda dapat menentukan harga yang berbeda untuk 25 Mbps, 100 Mbps, dan 1 Gbps.
### Contoh: host bersamaan dengan beberapa dimensi
Bayangkan Anda menawarkan perangkat lunak yang memonitor contoh Amazon EC2 lainnya. Anda memilih untuk tagihan dengan jumlah host yang sedang dipantau. Untuk kategori penggunaan Anda, pilih **Host**. Selain pengisian oleh host, Anda ingin mengisi untuk nilai tambahan untuk memantau host yang lebih besar. Anda dapat menggunakan beberapa dimensi dalam kategori host. Anda dapat menentukan harga yang berbeda untuk mikro, kecil, menengah, besar, x-besar, 2XL, 4XL, dan 8XL contoh. Perangkat lunak Anda bertanggung jawab untuk memetakan setiap host tertentu ke salah satu dimensi yang Anda tentukan. Perangkat lunak Anda bertanggung jawab untuk mengirimkan rekaman pengukuran terpisah untuk setiap dimensi kategori penggunaan Anda jika berlaku.
## Menambahkan produk Anda ke AWS Marketplace
Untuk memanfaatkan Layanan Pengukuran, Anda harus membuat produk baru AWS Marketplace untuk dicantumkan. Jika produk Anda sudah ada di AWS Marketplace, Anda harus memutuskan apakah produk AWS Marketplace Metering Service baru akan tersedia selain produk Anda saat ini, atau apakah produk tersebut akan menggantikan produk Anda saat ini sebagai satu-satunya versi yang tersedia untuk pengguna baru. Jika Anda memilih pengganti, produk yang ada akan dihapus dari AWS Marketplace sehingga tidak lagi tersedia untuk pembeli baru. Pelanggan yang sudah ada akan terus memiliki akses ke produk lama mereka dan contoh, tetapi mereka dapat bermigrasi ke produk baru pada kenyamanan mereka. Produk baru harus menggunakan meteran untuk AWS Marketplace Layanan Pengukuran, seperti yang dijelaskan dalam[Memodifikasi perangkat lunak Anda untuk menggunakan Layanan Pengukuran](#modifying-your-software-to-use-the-metering-service).
Setelah Anda memiliki AMI Anda, ikuti proses standar untuk berbagi dan memindai AMI Anda menggunakan alat swalayan. Selain menggunakan templat yang tersedia di portal manajemen, isi formulir beban produk dan unggah untuk memulai proses konsumsi.
Gunakan definisi berikut untuk melengkapi bidang Formulir Pemuatan Produk untuk AWS Marketplace Metering Service. Pada Formulir Beban Produk, bidang ini diberi label sebagai **Harga Konsumsi Fleksibel (FCP)** untuk membedakannya dari produk dengan harga per jam dan bulanan.
+ **Judul** — Jika Anda sudah memiliki produk AWS Marketplace dan Anda menambahkan produk yang sama dengan AWS Marketplace Metering Service, sertakan kategori dan dimensi FCP dalam tanda kurung untuk membedakannya (misalnya, “JUDUL PRODUK (Data)”).
+ **Model Harga** **—Dari daftar dropdown, pilih Usage.**
+ **Kategori FCP** — Kategori di mana pelanggan dikenakan biaya untuk produk berbayar dengan komponen harga **Penggunaan**. Dari daftar pilihan menurun, pilih**Pengguna**,**host**,**Data**, atau**Bandwidth**.
+ **Unit FCP** — Unit pengukuran di mana pelanggan dikenakan biaya untuk produk berbayar dengan komponen harga **Penggunaan**. Pilihan akan muncul dalam daftar dropdown berdasarkan kategori FCP yang Anda pilih. Tabel berikut menjelaskan unit yang valid untuk setiap kategori.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/id_id/marketplace/latest/userguide/custom-metering-pricing-ami-products.html)
+ **Nama Dimensi FCP** - Nama yang digunakan saat mengirim catatan pengukuran dengan memanggil operasi. `MeterUsage` Itu terlihat dalam laporan penagihan. Namun, karena tidak menghadap ke luar, namanya tidak perlu ramah pengguna. Nama tidak boleh lebih dari 15 karakter dan hanya dapat menyertakan karakter alfanumerik dan garis bawah. Setelah Anda menetapkan nama dan membuat produk publik, Anda tidak dapat mengubahnya. Mengubah nama membutuhkan AMI baru.
+ **Deskripsi Dimensi FCP** — Pernyataan yang menghadap pelanggan yang menjelaskan dimensi produk. Deskripsi (bisa tidak lebih dari 70 karakter dan harus user-friendly. Contoh deskripsi meliputi: Administrator per jam dan bandwidth Per Mbps disediakan. Setelah produk diterbitkan, Anda tidak dapat mengubah deskripsi ini.
+ **Tingkat FCP** — Biaya perangkat lunak per unit untuk produk ini. Bidang ini mendukung delapan tempat desimal.
**Catatan:**
Anda tidak perlu mengisi kolom harga per jam dan tahunan.
Uji coba gratis dan harga tahunan tidak kompatibel.
Produk yang menggunakan AMI, serta fitur Cluster, dan AWS Resources, tidak dapat menggunakan AWS Marketplace Metering Service.
Harga, jenis instans, atau Wilayah AWS perubahan akan mengikuti proses yang sama seperti AWS Marketplace produk lainnya.
Produk dengan AWS Marketplace Metering Service tidak dapat dikonversi ke model harga lain seperti per jam, bulanan, atau Bring Your Own License (BYOL).
AWS Marketplace merekomendasikan untuk menambahkan informasi kebijakan IAM dalam instruksi atau dokumen penggunaan Anda.
Anda dapat menyertakan hingga 24 dimensi FCP secara total. Setelah dibuat dan dipublikasikan, Anda tidak dapat mengubah dimensi yang ada, tetapi Anda dapat menambahkan dimensi baru (hingga batas 24).
Jika Anda memiliki pertanyaan, hubungi[AWS Marketplace Operasi Penjual](https://aws.amazon.com/marketplace/management/contact-us/)Tim.
## Memodifikasi perangkat lunak Anda untuk menggunakan Layanan Pengukuran
Anda perlu memodifikasi perangkat lunak Anda untuk merekam penggunaan pelanggan, mengirim laporan penggunaan per jam ke Layanan Pengukuran, dan menangani mode kegagalan baru. Perangkat lunak ini beroperasi secara independen dari harga, tetapi perangkat lunak perlu mengetahui tentang kategori penggunaan, bagaimana penggunaannya, dan dimensi apa pun.
### Mengukur konsumsi
Perangkat lunak Anda harus menentukan berapa banyak kategori penggunaan yang dipilih dan dimensi mana yang telah dikonsumsi pelanggan. Nilai ini akan dikirim, sekali setiap jam, ke Layanan Pengukuran. Dalam semua kasus, diasumsikan bahwa perangkat lunak Anda memiliki kemampuan untuk mengukur, mencatat, dan membaca konsumsi sumber daya untuk tujuan mengirimkannya setiap jam ke Layanan Pengukuran.
Untuk konsumsi yang ditetapkan, ini biasanya akan dibaca dari konfigurasi perangkat lunak sebagai nilai sampel, tetapi mungkin juga nilai dikonfigurasi maksimum, direkam setiap jam. Untuk konsumsi bersamaan, ini mungkin berupa sampel periodik atau nilai maksimum yang tercatat setiap jam. Untuk akumulasi konsumsi, ini akan menjadi nilai yang terakumulasi setiap jamnya.
Untuk penetapan harga pada beberapa dimensi, beberapa nilai harus diukur dan dikirim ke Layanan Pengukuran, satu per dimensi. Hal ini memerlukan perangkat lunak Anda untuk diprogram atau dikonfigurasi dengan rangkaian dimensi yang diketahui saat Anda memberikan AMI. Kumpulan dimensi tidak dapat berubah setelah produk dibuat.
Untuk setiap skenario harga, tabel berikut menjelaskan cara yang disarankan untuk mengukur konsumsi setiap jam.
| **Skenario** | **Bagaimana mengukur** |
| --- | --- |
| Pengguna yang disediakan | Jumlah pengguna yang ditetapkan saat ini (sampel). -atau- Jumlah maksimum pengguna yang ditetapkan (terlihat jam itu). |
| Pengguna yang bersamaan | Jumlah pengguna serentak saat ini (sampel). -atau- Jumlah maksimum pengguna bersamaan (terlihat jam itu). -atau- Jumlah total pengguna yang berbeda (terlihat jam itu). |
| Host yang disediakan | Jumlah host yang ditetapkan saat ini (sampel). -atau- Jumlah maksimum host yang ditetapkan (terlihat jam itu). |
| Host yang bersamaan | Jumlah host bersamaan saat ini (sampel). -atau- Jumlah maksimum host bersamaan (terlihat jam itu). -atau- Jumlah total host yang berbeda (terlihat jam itu). |
| Bandwidth yang disediakan | Pengaturan bandwidth yang ditetapkan saat ini (sampel). -atau- Maksimum yang ditetapkan bandwidth (terlihat jam itu). |
| Mengumpulkan data | GB saat ini data yang disimpan (sampel). -atau- GB maksimum data yang disimpan (dilihat jam itu). -atau- Total GB data yang ditambahkan atau diproses jam tersebut. -atau- Jumlah GB data diproses jam itu. |
## Penandaan terukur vendor (Opsional)
Penandaan yang diukur vendor membantu Vendor Perangkat Lunak Independen (ISVs) memberi pembeli wawasan yang lebih terperinci tentang penggunaan perangkat lunak mereka dan dapat membantu mereka melakukan alokasi biaya.
Untuk menandai penggunaan perangkat lunak pembeli, Anda perlu menentukan bagaimana biaya dialokasikan. Pertama tanyakan kepada pembeli Anda apa yang ingin mereka lihat dalam alokasi biaya mereka. Kemudian Anda dapat membagi penggunaan di seluruh properti yang Anda lacak untuk akun pembeli. Contoh properti termasuk`Account ID`,, `Business Unit``Cost Centers`, dan metadata relevan lainnya untuk produk Anda. Properti ini diekspos ke pembeli sebagai tag. Dengan menggunakan tag, pembeli dapat melihat biayanya dibagi menjadi penggunaan berdasarkan nilai tag di Konsol AWS Penagihan ([https://console.aws.amazon.com/costmanagement/](https://console.aws.amazon.com/costmanagement/)). Penandaan yang diukur vendor tidak mengubah harga, dimensi, atau total penggunaan yang Anda laporkan. Hal ini memungkinkan pelanggan Anda untuk melihat biaya mereka berdasarkan kategori yang sesuai dengan produk Anda.
Dalam kasus penggunaan umum, pembeli berlangganan produk Anda dengan satu Akun AWS. Pembeli juga memiliki banyak pengguna yang terkait dengan langganan produk yang sama. Anda dapat membuat alokasi penggunaan dengan tag yang memiliki kunci`Account ID`, dan kemudian mengalokasikan penggunaan untuk setiap pengguna. Dalam hal ini, pembeli dapat mengaktifkan `Account ID` tag di konsol Billing and Cost Management mereka dan menganalisis penggunaan pengguna individu.
### Pengalaman penjual
Penjual dapat menggabungkan catatan pengukuran untuk sumber daya dengan kumpulan tag yang sama alih-alih menggabungkan penggunaan untuk semua sumber daya. Misalnya, penjual dapat membuat catatan pengukuran yang mencakup ember yang berbeda dari. `UsageAllocations` Setiap bucket mewakili `UsageQuantity` satu set tag, seperti `AccountId` dan`BusinessUnit`.
Dalam diagram berikut, **Resource 1** memiliki satu set `AccountId` dan `BusinessUnit` tag yang unik, dan muncul di **Rekaman Pengukuran** sebagai entri tunggal.
**Resource 2** dan **Resource 3** keduanya memiliki `AccountId` tag yang sama`2222`,, dan `BusinessUnit` tag yang sama,`Operations`. Akibatnya, mereka digabungkan menjadi satu `UsageAllocations` entri dalam **Rekaman Pengukuran**.
![\[Diagram yang menunjukkan bagaimana tag metering vendor menggabungkan data penggunaan. Tiga sumber daya (Sumber Daya 1, 2, dan 3) dengan berbeda AccountIds dan BusinessUnits dikonsolidasikan ke dalam Rekaman Pengukuran tunggal dengan UsageAllocations dikelompokkan oleh AccountId dan BusinessUnit sebelum dikirim ke AWS Marketplace Metering Service.\]](http://docs.aws.amazon.com/id_id/marketplace/latest/userguide/images/seller-vendor-meter-tag.png)
Penjual juga dapat menggabungkan sumber daya tanpa tag menjadi satu `UsageAllocation` dengan jumlah penggunaan yang dialokasikan dan mengirimkannya sebagai salah satu entri di. `UsageAllocations`
Batasan meliputi:
+ Jumlah tag — 5
+ Ukuran `UsageAllocations` (kardinalitas) — 2.500
Validasi meliputi:
+ Karakter diperbolehkan untuk kunci tag dan nilai — a-zA-Z 0-9\$1 -= . \$1:\$1 /@
+ Tag maksimum di seluruh `UsageAllocation` daftar - 5
+ Dua tidak `UsageAllocations` dapat memiliki tag yang sama (yaitu, kombinasi yang sama dari kunci tag dan nilai). Jika itu masalahnya, mereka harus menggunakan hal yang sama`UsageAllocation`.
+ Jumlah `AllocatedUsageQuantity` `UsageAllocation` harus sama dengan`UsageQuantity`, yang merupakan penggunaan agregat.
### Pengalaman pembeli
Tabel berikut menunjukkan contoh pengalaman pembeli setelah pembeli mengaktifkan tag `AccountId` dan `BusinessUnit` vendor.
Dalam contoh ini, pembeli dapat melihat penggunaan yang dialokasikan dalam **Laporan Penggunaan Biaya** mereka. Tag yang diukur vendor menggunakan awalan. `“aws:marketplace:isv”` Pembeli dapat mengaktifkannya di Billing and Cost Management, **di bawah Tag Alokasi Biaya AWS, tag alokasi** **biaya yang dihasilkan**.
Baris pertama dan terakhir dari **Laporan Penggunaan Biaya** relevan dengan apa yang dikirim Penjual ke Layanan Pengukuran (seperti yang ditunjukkan dalam [Pengalaman penjual](container-metering-meterusage.md#container-vendor-metered-tag-seller) contoh).
**Laporan Penggunaan Biaya (Sederhana)**
| ProductCode | Pembeli | UsageDimension | UsageQuantity | `aws:marketplace:isv:AccountId ` | `aws:marketplace:isv:BusinessUnit` |
| --- | --- | --- | --- | --- | --- |
| xyz | 111122223333 | Jaringan: per (GB) diperiksa | 70 | 2222 | Operasi |
| xyz | 111122223333 | Jaringan: per (GB) diperiksa | 30 | 3333 | Keuangan |
| xyz | 111122223333 | Jaringan: per (GB) diperiksa | 20 | 4444 | IA |
| xyz | 111122223333 | Jaringan: per (GB) diperiksa | 20 | 5555 | Pemasaran |
| xyz | 111122223333 | Jaringan: per (GB) diperiksa | 30 | 1111 | Pemasaran |
Untuk contoh kode, lihat [`MeterUsage`dengan penandaan alokasi penggunaan (Opsional)](custom-metering-with-mp-metering-service.md#ami-meterusage-code-example)
## Mengkonfigurasi pengukuran kustom
Untuk informasi selengkapnya tentang bekerja dengan AWS Marketplace Metering Service, lihat[Mengkonfigurasi pengukuran khusus untuk produk AMI dengan AWS Marketplace Metering Service](custom-metering-with-mp-metering-service.md).
# Mengkonfigurasi pengukuran khusus untuk produk AMI dengan AWS Marketplace Metering Service
**catatan**
Untuk produk berbasis AMI dengan harga pengukuran khusus, perangkat lunak Anda harus memanggil [MeterUsage API](https://docs.aws.amazon.com/marketplace/latest/APIReference/API_marketplace-metering_MeterUsage.html) menggunakan AWS kredensi sementara peran IAM untuk Amazon Elastic Compute Cloud yang dilampirkan ke instans Amazon EC2. Menggunakan kunci akses jangka panjang tidak didukung.
AWS Marketplace Metering Service adalah fitur penetapan harga dan pengukuran yang dapat Anda gunakan untuk menagih langsung perangkat lunak berdasarkan kategori penggunaan. Ada lima kategori penggunaan: pengguna, data, bandwidth, host, atau unit. Anda dapat menggunakan Layanan Pengukuran dengan produk berbasis Amazon Machine Image (AMI), berbasis kontainer, dan perangkat lunak sebagai layanan (SaaS). Bagian berikut memberikan informasi selengkapnya tentang cara mengonfigurasi pengukuran khusus dengan AWS Marketplace Metering Service.
AWS Marketplace Layanan Pengukuran memungkinkan beberapa skenario baru. Misalnya, jika monitor perangkat lunak Anda host, Anda dapat mengisi daya untuk setiap host dipantau. Anda dapat memiliki harga yang berbeda berdasarkan ukuran host, dan biaya untuk jumlah host bersamaan dipantau setiap jam. Demikian pula, jika perangkat lunak Anda memungkinkan banyak pengguna di seluruh organisasi untuk masuk, Anda dapat mengisi daya dengan jumlah pengguna. Setiap jam, pelanggan dikenakan biaya untuk jumlah total pengguna yang ditetapkan.
Untuk informasi selengkapnya, lihat[https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/Welcome.html](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/Welcome.html).
*Untuk informasi selengkapnya tentang mengintegrasikan AWS Marketplace Metering Service API untuk produk berbasis AMI dengan harga pengukuran khusus, lihat Daftar [produk AMI dengan harga laboratorium unit kustom bengkel penjual](https://catalog.workshops.aws/mpseller/en-US/ami/list-ami-custom-units).AWS Marketplace *
**Topics**
+ [Persyaratan](#metering-service-requirements)
+ [Hubungi AWS Marketplace Layanan Pengukuran](#call-aws-marketplace-metering-service)
+ [Penanganan kegagalan](#important-information-about-failure-handling)
+ [Batasan](#limitations)
+ [Contoh kode](#ami-metering-code-example)
## Persyaratan
Semua perangkat lunak berbasis AMI yang menggunakan Layanan Metering harus memenuhi persyaratan berikut:
+ Perangkat lunak Anda harus diluncurkan dari AWS Marketplace melalui Amazon Machine Image (AMI).
+ Jika Anda memiliki produk yang sudah ada AWS Marketplace, Anda harus mengirimkan AMI baru dan membuat produk baru untuk mengaktifkan fitur ini.
+ Semua perangkat lunak harus disediakan dengan peran AWS Identity and Access Management (IAM). Pelanggan akhir harus menambahkan IAM role ke instans Amazon Elastic Compute Cloud (Amazon EC2) pengguna menetapkan dengan perangkat lunak. Penggunaan peran IAM bersifat opsional saat Anda menggunakan perangkat lunak. AWS Marketplace Ini diperlukan saat Anda menerapkan perangkat lunak AWS Marketplace Metering Service.
+ Perangkat lunak Anda harus dapat menentukan konsumsi dalam beberapa cara.
## Hubungi AWS Marketplace Layanan Pengukuran
Perangkat lunak Anda harus menghubungi Layanan Pengukuran per jam dan mencatat nilai konsumsi untuk jam tersebut.
Ketika perangkat lunak Anda dimulai, itu harus merekam minute-of-the-hour di mana ia dimulai. Ini disebut sebagai menit *awal*. Setiap jam pada menit awal, perangkat lunak Anda harus menentukan nilai konsumsi untuk jam itu dan menghubungi Layanan Pengukuran. Untuk informasi tentang cara mendapatkan nilai ini, lihat [Memodifikasi perangkat lunak Anda untuk menggunakan Layanan Pengukuran.](https://docs.aws.amazon.com/marketplace/latest/userguide/custom-metering-pricing-ami-products.html#modifying-your-software-to-use-the-metering-service)
Untuk bangun setiap jam di menit awal, perangkat lunak Anda harus menggunakan salah satu pendekatan berikut:
+ Sebuah thread dalam perangkat lunak Anda.
+ Proses daemon yang dimulai dengan instans atau perangkat lunak.
+ Pekerjaan cron yang dikonfigurasi selama aplikasi startup.
**catatan**
Perangkat lunak Anda harus memanggil AWS Marketplace Layanan Pengukuran menggunakan IAM role dikonfigurasi pada contoh pelanggan dan menentukan dimensi konsumsi dan jumlah.
Perangkat lunak Anda dapat menggunakan AWS SDK untuk memanggil AWS Marketplace Metering Service, mirip dengan contoh implementasi berikut:
1. Gunakan profil contoh untuk membuat klien layanan. Ini memerlukan peran yang dikonfigurasi untuk instans EC2. Kredensial peran disegarkan oleh SDK secara otomatis.
1. Setiap jam, baca konfigurasi perangkat lunak Anda dan negara untuk menentukan nilai konsumsi untuk jam tersebut. Ini mungkin termasuk mengumpulkan a value-per-dimension.
1. Panggil`meterUsage`metode pada klien SDK dengan parameter berikut (panggilan tambahan untuk setiap dimensi yang memiliki penggunaan):
+ `timestamp`— Stempel waktu jam yang direkam (dalam UTC).
+ `productCode`— Kode produk yang ditetapkan untuk perangkat lunak.
+ `dimension`— Dimensi (atau dimensi) yang ditetapkan untuk perangkat lunak.
+ `quantity`— Nilai konsumsi untuk satu jam.
+ `allocations`— (Opsional) Anda dapat memberikan alokasi untuk penggunaan di seluruh properti yang Anda lacak. Alokasi ini harus menambahkan hingga total konsumsi dalam catatan. Bagi pembeli, ini ditampilkan sebagai tag alokasi biaya potensial di alat penagihan mereka (seperti AWS Manajemen Penagihan dan Biaya konsol). Pembeli harus mengaktifkan tag di akun mereka untuk melacak biaya mereka menggunakan tag ini.
Selain itu, perangkat lunak Anda harus menghubungi endpoint AWS Marketplace Layanan Pengukuran di wilayah. Produk Anda harus memiliki pengaturan titik akhir Regional yang benar, sehingga `us-east-1` mengirimkan catatan ke `us-east-1` titik akhir, dan `us-west-2` mengirimkan catatan ke titik akhir. `us-west-2` Melakukan panggilan di wilayah memberi pembeli pengalaman yang lebih stabil dan mencegah situasi di mana ketersediaan Wilayah yang tidak terkait dapat memengaruhi perangkat lunak yang berjalan di Wilayah lain.
Saat Anda mengirim catatan pengukuran ke layanan, Anda harus terhubung ke AWS Marketplace Layanan Pengukuran di Wilayah Anda. Gunakan metode `getCurrentRegion()` helper untuk menentukan Region di mana instans EC2 berjalan, dan kemudian meneruskan informasi Region ini ke konstruktor. `MeteringServiceClient` Jika Anda tidak menentukan Wilayah AWS dalam konstruktor SDK, `us-east-1` Region default akan digunakan. Jika aplikasi Anda mencoba untuk membuat Cross-region panggilan ke layanan, panggilan ditolak. Untuk informasi selengkapnya, lihat [Menentukan Wilayah Saat Ini Aplikasi](https://java.awsblog.com/post/Tx3GBOIEN1JJMQ5/Determining-an-Application-s-Current-Region) dan [getCurrentRegion()](https://docs.aws.amazon.com/AWSJavaSDK/latest/javadoc/com/amazonaws/regions/Regions.html#getCurrentRegion()).
## Penanganan kegagalan
Produk Anda harus mengirimkan catatan pengukuran ke layanan, titik akhir internet publik, sehingga penggunaan dapat diambil dan ditagih. Karena mungkin bagi pelanggan untuk memodifikasi pengaturan jaringan dengan cara yang mencegah catatan pengukuran Anda dikirim, produk Anda harus memperhitungkannya dengan memilih mode kegagalan.
**catatan**
Beberapa kegagalan pengukuran mungkin merupakan masalah sementara dalam menghubungkan ke. AWS Marketplace Metering Service AWS Marketplace sangat merekomendasikan untuk menerapkan percobaan ulang hingga 30 menit, dengan mundur eksponensial, untuk menghindari pemadaman jangka pendek atau masalah jaringan.
Biasanya, perangkat lunak dapat gagal terbuka (memberikan pesan peringatan tetapi mempertahankan fungsionalitas penuh) atau gagal ditutup (menonaktifkan semua fungsi dalam aplikasi sampai sambungan telah dibuat kembali). Anda dapat memilih untuk gagal membuka, menutup, atau sesuatu yang spesifik untuk aplikasi Anda. Kami sangat menyarankan agar Anda menahan diri dari gagal ditutup setelah kurang dari dua jam pengukuran kegagalan.
Sebagai contoh gagal sebagian terbuka, Anda dapat terus mengizinkan akses ke perangkat lunak tetapi tidak memungkinkan pembeli untuk memodifikasi pengaturan perangkat lunak. Atau, pembeli masih dapat mengakses perangkat lunak tetapi tidak akan dapat membuat pengguna tambahan. Perangkat lunak Anda bertanggung jawab untuk menentukan dan menegakkan mode kegagalan ini. Mode kegagalan perangkat lunak Anda harus disertakan saat AMI Anda dikirimkan, dan tidak dapat diubah nanti.
## Batasan
Ingatlah keterbatasan ini saat merancang dan mengirimkan perangkat lunak berkemampuan Layanan Pengukuran-enabled Anda:
+ **Persyaratan peran dan gateway internet IAM untuk pelanggan Anda**— Pelanggan Anda harus memiliki gateway internet dan harus meluncurkan perangkat lunak Anda dengan IAM role dengan izin tertentu. Untuk informasi selengkapnya, lihat [AWS Marketplace izin API pengukuran dan hak](iam-user-policy-for-aws-marketplace-actions.md). Perangkat lunak Anda tidak dapat terhubung ke Layanan Pengukuran jika kedua kondisi ini tidak terpenuhi.
+ **Ketidakmampuan untuk menambahkan kategori penggunaan baru atau mengubah ke produk Layanan Pengukuran yang ada** — Ketika pelanggan berlangganan produk perangkat lunak Anda, mereka menyetujui syarat dan ketentuan. MengubahKategori penggunaandalam produk dengan Layanan Pengukuran memerlukan produk baru dan langganan baru.
+ **Ketidakmampuan untuk mengubah dimensi ke produk Layanan Pengukuran yang ada** — Ketika pelanggan berlangganan produk perangkat lunak Anda, mereka menyetujui syarat dan ketentuan. Mengubah dimensi dalam produk dengan Layanan Pengukuran memerlukan produk baru dan langganan baru. Anda*dapat*menambahkan dimensi baru untuk produk yang ada, hingga batas 24.
+ **Kurangnya uji coba gratis dan langganan tahunan** — Produk Metering Service tidak mendukung uji coba gratis dan langganan tahunan saat diluncurkan.
+ **Pertimbangan penggunaan multi-instans atau berbasis cluster**— Beberapa perangkat lunak digunakan sebagai bagian dari deployment multi-instance. Saat Anda merancang perangkat lunak Anda, pertimbangkan bagaimana dan di mana konsumsi diukur dan di mana catatan pengukuran dipancarkan.
## Contoh kode
Contoh kode berikut disediakan untuk membantu Anda mengintegrasikan produk AMI Anda dengan yang AWS Marketplace APIs diperlukan untuk menerbitkan dan memelihara produk Anda.
### `MeterUsage`dengan penandaan alokasi penggunaan (Opsional)
Contoh kode berikut relevan untuk produk AMI dengan model harga konsumsi. Contoh Python mengirimkan catatan pengukuran dengan tag alokasi penggunaan yang sesuai untuk membebankan biaya AWS Marketplace kepada pelanggan Anda. pay-as-you-go
```
# NOTE: Your application will need to aggregate usage for the
# customer for the hour and set the quantity as seen below.
# AWS Marketplace can only accept records for up to an hour in the past.
#
# productCode is supplied after the AWS Marketplace Ops team has
# published the product to limited
# Import AWS Python SDK
import boto3
import time
usageRecord = [
{
"AllocatedUsageQuantity": 2,
"Tags":
[
{ "Key": "BusinessUnit", "Value": "IT" },
{ "Key": "AccountId", "Value": "123456789" },
]
},
{
"AllocatedUsageQuantity": 1,
"Tags":
[
{ "Key": "BusinessUnit", "Value": "Finance" },
{ "Key": "AccountId", "Value": "987654321" },
]
}
]
marketplaceClient = boto3.client("meteringmarketplace")
response = marketplaceClient.meter_usage(
ProductCode="testProduct",
Timestamp=int(time.time()),
UsageDimension="Dimension1",
UsageQuantity=3,
DryRun=False,
UsageAllocations=usageRecord
)
```
Untuk informasi selengkapnya`MeterUsage`, lihat [MeterUsage](https://docs.aws.amazon.com/marketplacemetering/latest/APIReference/API_MeterUsage.html)di *Referensi AWS Marketplace API Layanan Pengukuran*.
### Contoh tanggapan
```
{ "MeteringRecordId": "string" }
```