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

Pengukuran khusus untuk produk kontainer dengan AWS Marketplace Metering Service

AWS Marketplace produk kontainer dapat memiliki pengukuran khusus hingga 24 dimensi harga yang berbeda per produk. Setiap dimensi dapat memiliki harga kontrak jangka panjang yang terkait dengannya. Untuk mengaktifkan pengukuran khusus, integrasikan produk kontainer Anda dengan AWS Marketplace Metering Service. Anda dapat menentukan unit harga Anda sendiri dan pengukuran khusus untuk penggunaan tersebut AWS untuk penagihan menggunakan operasi. MeterUsageAPI

Dimensi harga didefinisikan dalam dua lokasi, sekali dalam bentuk beban produk dan sekali melaluiMeterUsageOperasi. Metode dua faktor ini memastikan bahwa penawaran berikutnya bekerja sebagaimana dimaksud sebelum dibuat tersedia untuk umum.

Untuk mengatur pengukuran khusus, Anda harus memilih kategori penggunaan, tipe unit, dan dimensi harga:

Opsional, Anda dapat mendistribusikan penggunaan ke alokasi oleh properti yang Anda melacak. Alokasi direpresentasikan sebagai tag kepada pembeli. Tag ini memungkinkan pembeli untuk melihat biaya mereka dibagi menjadi penggunaan berdasarkan nilai 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. Ini tidak mengubah harga, dimensi, atau total penggunaan yang Anda laporkan, tetapi memungkinkan pelanggan Anda untuk melihat biaya mereka berdasarkan kategori yang sesuai dengan produk Anda.

Kami menyarankan Anda mengirim catatan pengukuran setiap jam. Namun, Anda dapat menggabungkan penggunaan selama periode harian atau bulanan juga. Jika Anda mengalami pemadaman, Anda dapat menggabungkan penggunaan perangkat lunak pembeli dan mengirimkannya dalam pengukuran jam berikutnya. Anda tidak dapat mengirim lebih dari satu catatan per jam.

Prasyarat pengukuran

Sebelum menerbitkan produk, Anda harus melakukan hal berikut:

Formulir beban produk untuk pengukuran kustom

Saat mengisi formulir beban produk untuk pengukuran khusus, setiap produk dapat memiliki hingga 24 dimensi. Dimensi didefinisikan dalam bidang berikut:

Menguji MeterUsage integrasi dan mode pratinjau

Gunakan MeterUsage 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 MeterUsage dalam mode pratinjau, panggil MeterUsage dari gambar kontainer dengan menjalankan produk Anda di Amazon Elastic Container Service (AmazonECS) atau Amazon Elastic Kubernetes Service (EKSAmazon) Akun AWS dengan yang Anda gunakan untuk membuat daftar produk. AWS Marketplace Integrasi pengukuran Anda harus secara dinamis mengatur Wilayah AWS, bukan hard coding 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) sehingga tim AWS Marketplace operasi dapat memverifikasi pekerjaan Anda dengan log di Wilayah tersebut.

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 MeterUsage

Jika citra kontainer Anda terintegrasi denganMeterUsageoperasi dan menerima pengecualian selainThrottlingExceptionpada startup kontainer, Anda harus mengakhiri kontainer untuk mencegah penggunaan yang tidak sah.

Pengecualian selainThrottlingExceptiondilemparkan hanya pada panggilan awal untukMeterUsage. 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.

Lihat MeterUsagedi AWS Marketplace Metering Service APIReferensi untuk deskripsi rinci tentang kesalahan umum untukMeterUsage. Setiap bahasa AWS SDK pemrograman memiliki seperangkat pedoman penanganan kesalahan yang dapat Anda rujuk untuk informasi tambahan.

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.

Ada banyak cara untuk menandai penggunaan perangkat lunak pembeli. Salah satu caranya adalah dengan terlebih dahulu bertanya 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 termasukAccountId,, Business UnitCost 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/billing/). 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 kunciAccountId, dan kemudian mengalokasikan penggunaan untuk setiap pengguna. Dalam hal ini, pembeli dapat mengaktifkan AccountId 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 danBusinessUnit.

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 sama2222,, dan BusinessUnit tag yang sama,Operations. Akibatnya, mereka digabungkan menjadi satu UsageAllocations entri dalam Rekaman Pengukuran.

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:

Validasi meliputi:

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 contoh).

Untuk contoh kode, lihat MeterUsagecontoh kode dengan penandaan alokasi penggunaan (Opsional).

Contoh kode

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

MeterUsagecontoh kode dengan penandaan alokasi penggunaan (Opsional)

Contoh kode berikut relevan untuk produk kontainer 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 AWS Marketplace Metering Service APIReferensi.

Contoh tanggapan

{ "MeteringRecordId": "string" }