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

Mengkonfigurasi pengukuran khusus untuk AMI produk dengan AWS Marketplace Metering Service

AWSMarketplace Metering Service adalah fitur penetapan harga dan pengukuran yang dapat Anda gunakan untuk langsung mengenakan biaya untuk perangkat lunak Anda 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 kustom dengan AWS Marketplace Metering Service.

AWSMarketplace Metering Service 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 APIReferensi AWS Marketplace Layanan Pengukuran.

Persyaratan

Semua perangkat lunak AMI berbasis yang menggunakan Layanan Pengukuran harus memenuhi persyaratan berikut:

Hubungi Layanan Pengukuran AWS Marketplace

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.

Untuk bangun setiap jam di menit awal, perangkat lunak Anda harus menggunakan salah satu pendekatan berikut:

Selain itu, perangkat lunak Anda harus memanggil titik akhir Layanan Pengukuran AWS Marketplace In-region. 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.

Ketika Anda mengirim catatan pengukuran ke layanan, Anda harus terhubung ke Layanan Pengukuran AWS Marketplace di Wilayah Anda. Gunakan metode getCurrentRegion() helper untuk menentukan Region di mana EC2 instance berjalan, dan kemudian meneruskan informasi Region ini ke MeteringServiceClient konstruktor. Jika Anda tidak menentukan Wilayah AWS dalam SDK konstruktor, us-east-1 Wilayah default digunakan. Jika aplikasi Anda mencoba untuk membuat Cross-region panggilan ke layanan, panggilan ditolak. Untuk informasi selengkapnya, lihat Menentukan Wilayah Saat Ini Aplikasi dan 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.

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 ketika Anda AMI dikirimkan, dan itu tidak dapat diubah nanti.

Batasan

Ingatlah keterbatasan ini saat merancang dan mengirimkan perangkat lunak berkemampuan Layanan Pengukuran-enabled Anda:

Contoh kode

Contoh kode berikut disediakan untuk membantu Anda mengintegrasikan AMI produk Anda dengan yang AWS Marketplace APIs diperlukan untuk menerbitkan dan memelihara produk Anda.

MeterUsagedengan penandaan alokasi penggunaan (Opsional)

Contoh kode berikut relevan untuk AMI produk 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 selengkapnyaMeterUsage, lihat MeterUsagedi APIReferensi AWS Marketplace Layanan Pengukuran.

Contoh tanggapan

{ "MeteringRecordId": "string" }