Bagikan melalui


Penagihan terukur untuk Azure Containers menggunakan layanan pengukuran marketplace komersial

Dengan layanan pengukuran marketplace komersial, Anda dapat membuat penawaran Azure Container yang dikenakan biaya sesuai dengan unit nonstandar. Sebelum menerbitkan penawaran ke marketplace komersial, Anda menentukan dimensi penagihan seperti bandwidth, pecahan, logfiles, pemindaian, email yang diproses, dll. Pelanggan kemudian membayar sesuai dengan konsumsi dimensi ini, dengan aplikasi Anda memberi tahu Microsoft melalui API layanan pengukuran marketplace komersial dari peristiwa yang dapat ditagih saat terjadi.

Prasyarat untuk penagihan terukur

Agar penawaran Kontainer Azure menggunakan tagihan terukur, Anda harus terlebih dahulu meninjau opsi Lisensi yang diuraikan dalam Paket untuk penawaran Kontainer Azure dan memastikan bahwa Anda memiliki kebutuhan penagihan kustom yang tidak terpenuhi oleh salah satu dari enam model penagihan yang telah ditentukan sebelumnya.

Kemudian penawaran Azure Container dapat diintegrasikan dengan API layanan pengukuran marketplace komersial untuk memberi tahu Microsoft tentang peristiwa yang dapat ditagih.

Penting

Aplikasi Anda harus memanggil API layanan pengukuran marketplace komersial. Saat ini tidak ada opsi untuk mengizinkan layanan yang dihosting (di luar aplikasi) untuk memanggil API layanan pengukuran.

Catatan

Layanan pengukuran marketplace hanya tersedia untuk model penagihan kustom dan tidak berlaku untuk model penagihan per pengguna.

Bagaimana penagihan terukur sesuai dengan harga

Memahami hierarki penawaran penting untuk menentukan penawaran bersama dengan model harganya.

  • Setiap penawaran dikonfigurasi untuk menjual baik melalui Microsoft atau tidak. Setelah penawaran diterbitkan, opsi ini tidak dapat diubah.
  • Setiap penawaran, yang dikonfigurasi untuk dijual melalui Microsoft, dapat memiliki satu atau beberapa paket.
  • Setiap paket memiliki model harga yang terkait dengannya: Paket tagihan bulanan berbasis penggunaan atau Bawa lisensi Anda sendiri (BYOL). Untuk paket penagihan bulanan berbasis penggunaan, Anda dapat memilih gratis, salah satu dari enam opsi penagihan yang telah ditentukan sebelumnya, atau kustom.
  • Model harga dan opsi input harga tidak dapat diperbarui setelah diterbitkan.
  • Setiap paket harus memiliki paket harga lengkap.
  • Anda dapat memilih untuk memberi harga menggunakan dimensi kustom untuk menagih pelanggan Anda untuk membantu memenuhi kebutuhan penagihan Anda. Setiap dimensi mewakili unit yang dapat ditagih yang dikomunikasikan layanan Anda ke Microsoft menggunakan API layanan pengukuran marketplace komersial.

Penting

Anda harus melacak penggunaan dalam kode Anda dan hanya mengirim peristiwa penggunaan ke Microsoft untuk penggunaan yang Anda inginkan untuk ditagihkan kepada pelanggan.

Catatan

Penawaran akan ditagihkan kepada pelanggan dalam mata uang perjanjian pelanggan, menggunakan harga pasar lokal yang diterbitkan pada saat penawaran dibuat. Jumlah yang dibayar pelanggan, dan BAHWA ISV dibayar, tergantung pada nilai tukar mata uang asing pada saat pelanggan bertransaksi penawaran. Pelajari lebih lanjut tentang "Bagaimana kami mengonversi mata uang?".

Opsi harga kustom sampel

Sebagai contoh, Contoso adalah penerbit yang IP-nya berada dalam logika sharding mereka untuk aplikasi Kubernetes mereka. Contoso ingin menagih pelanggan mereka berdasarkan jumlah pecahan yang digunakan. Mereka juga mengeksplorasi opsi penagihan lain dengan harga yang nyaman dan kompetitif. Contoso terdaftar sebagai penerbit di Pusat Mitra untuk program marketplace komersial dan ingin menerbitkan penawaran Kontainer kepada pelanggan Azure. Ada empat paket yang terkait dengan Contoso, yang diuraikan di bawah ini:

  • Biaya per pecahan yang digunakan per jam, misalnya, $1.000/pecahan/jam

    Cuplikan layar yang menggambarkan biaya per pecahan yang digunakan per jam.

  • Pemodelan pembayaran satu kali atau penagihan berulang: Katakanlah Contoso ingin menagih pelanggan $ 449 / bln untuk penggunaan hingga 100 file log dari aplikasi mereka. Logika aplikasi Contoso melacak peristiwa penggunaan untuk bulan tersebut dan memicu biaya pada akhir bulan untuk penggunaan 100 file log.

    Cuplikan layar yang menggambarkan pemodelan pembayaran satu kali atau penagihan berulang.

  • Pemodelan tagihan berjenjang: Katakanlah Contoso ingin mengenakan biaya $ 449 / bln hingga 100 pecahan, dan kemudian harga berjenjang untuk kelebihan pemakaian apa pun. Logika aplikasi mereka akan melacak penggunaan untuk bulan tersebut, mengesegmentasikan penggunaan yang sesuai dan melaporkannya menggunakan API pengukuran di bawah ini pada akhir periode:

    Cuplikan layar yang menggambarkan pemodelan penagihan berjenjang.

  • Penagihan multidaya: Contoso juga dapat menggunakan pengukuran kustom untuk memenuhi kebutuhan mereka untuk penagihan tingkat lanjut menggunakan beberapa dimensi

    Cuplikan layar yang menggambarkan penagihan multidirmensional.

Berdasarkan paket yang dipilih, pelanggan Azure yang mendapatkan penawaran Kontainer Contoso dikenakan biaya berdasarkan penggunaannya. Contoso menghitung penggunaan tanpa mengirim peristiwa penggunaan apa pun ke Microsoft. Baik ketika pelanggan mengonsumsi jumlah yang memadai atau secara berkala, Contoso melaporkan penggunaan. Pelanggan tidak perlu mengubah paket atau melakukan sesuatu yang berbeda. Contoso mengukur penggunaan dan mulai memancarkan peristiwa penggunaan ke Microsoft untuk menagih penggunaan berlebih menggunakan API layanan pengukuran marketplace komersial. Microsoft pada gilirannya menagih pelanggan untuk penggunaan seperti yang ditentukan oleh penerbit dalam dimensi kustom. Penagihan dilakukan pada siklus penagihan bulanan berikutnya.

Dimensi penagihan

Setiap dimensi penagihan menentukan unit kustom tempat ISV dapat memancarkan peristiwa penggunaan. Dimensi penagihan juga digunakan untuk berkomunikasi dengan pelanggan tentang bagaimana mereka akan ditagih untuk menggunakan perangkat lunak. Mereka didefinisikan sebagai berikut:

  • ID: pengidentifikasi dimensi yang tidak dapat diubah direferensikan saat memancarkan peristiwa penggunaan.
  • Nama Tampilan: nama tampilan yang terkait dengan dimensi, misalnya "pesan teks dikirim".
  • Satuan Ukur: deskripsi unit penagihan, misalnya "per pesan teks" atau "per 100 email".
  • Harga per unit dalam USD: harga untuk satu unit dimensi. Dapat berupa 0.

Penting

Anda harus melacak penggunaan dalam kode aplikasi Anda dan mengirim peristiwa penggunaan ke Microsoft berdasarkan kebutuhan penagihan Anda.

Dimensi penagihan dibagikan di semua paket untuk penawaran. Beberapa atribut berlaku untuk dimensi di semua paket, dan atribut lainnya bersifat rencana khusus.

Atribut, yang mendefinisikan dimensi itu sendiri, dibagikan di semua paket untuk penawaran. Sebelum Anda menerbitkan penawaran, perubahan yang dilakukan pada atribut ini dari konteks paket apa pun memengaruhi definisi dimensi di semua paket. Setelah Anda menerbitkan penawaran, atribut ini tidak lagi dapat diedit. Atribut tersebut adalah:

  • ID
  • Nama Tampilan
  • Satuan Ukuran

Atribut dimensi lainnya khusus untuk setiap paket dan dapat memiliki nilai yang berbeda dari paket ke paket. Sebelum menerbitkan paket, Anda dapat mengedit nilai-nilai ini, dan hanya paket ini yang akan terpengaruh. Setelah Anda menerbitkan paket, atribut ini tidak akan lagi dapat diedit. Atribut tersebut adalah:

  • Harga per unit dalam USD

Dimensi juga memiliki konsep khusus yang disebut "diaktifkan":

  • Diaktifkan menunjukkan bahwa paket ini berpartisipasi dalam dimensi ini. Jika Anda membuat paket baru yang tidak mengirim peristiwa penggunaan berdasarkan dimensi ini, Anda mungkin ingin membiarkan opsi ini tidak dicentang. Selain itu, dimensi baru apa pun yang ditambahkan setelah rencana pertama kali diterbitkan akan muncul sebagai "tidak diaktifkan" pada paket yang sudah diterbitkan. Dimensi yang dinonaktifkan tidak akan muncul dalam daftar dimensi apa pun untuk paket yang dilihat oleh pelanggan.

Catatan

Skenario berikut secara eksplisit didukung:

  • Anda dapat menambahkan dimensi baru ke paket baru. Dimensi baru tidak akan diaktifkan untuk paket yang sudah diterbitkan.

Menetapkan harga dimensi per unit per pasar yang didukung

Seperti harga berbasis penggunaan lainnya, harga dimensi penagihan dapat ditetapkan per negara atau wilayah yang didukung. Anda perlu menggunakan fitur impor dan ekspor data harga di Pusat Mitra, sebagai berikut.

  1. Tentukan dimensi yang diinginkan dan tandai pasar mana yang didukung.
  2. Ekspor data ini ke dalam sebuah berkas.
  3. Tambahkan harga yang benar per negara/wilayah dan impor file di Pusat Mitra.

Antarmuka pengguna meteran berubah untuk mencerminkan bahwa harga dimensi hanya dapat dilihat dalam file.

Cuplikan layar yang menggambarkan antarmuka pengguna meteran.

Paket privat

Seperti paket penagihan berbasis penggunaan yang telah ditentukan sebelumnya, paket dengan dimensi kustom dapat ditetapkan sebagai paket privat, hanya dapat diakses oleh audiens yang ditentukan paket.

Kendala

Perilaku penguncian

Karena dimensi yang digunakan dengan layanan pengukuran marketplace komersial mewakili pemahaman tentang bagaimana pelanggan akan membayar layanan, semua detail untuk dimensi tidak lagi dapat diedit setelah Anda memublikasikannya. Penting bahwa Anda memiliki dimensi Anda sepenuhnya didefinisikan untuk rencana sebelum Anda mempublikasikan.

Setelah penawaran diterbitkan dengan dimensi, detail tingkat penawaran untuk dimensi tersebut tidak dapat lagi diubah:

  • ID
  • Nama Tampilan
  • Satuan Ukuran

Setelah paket diterbitkan, detail tingkat paket ini tidak dapat lagi diubah:

  • Apakah dimensi diaktifkan untuk paket atau tidak

Batas atas

Jumlah dimensi maksimum yang dapat dikonfigurasikan untuk satu penawaran adalah 30 dimensi unik.

Penagihan terukur Kontainer Azure

API penagihan terukur harus digunakan saat penerbit membuat dimensi pengukuran kustom agar penawaran dipublikasikan di Pusat Mitra. Integrasi dengan API penagihan terukur diperlukan untuk setiap penawaran yang dibeli yang memiliki satu atau beberapa paket dengan dimensi khusus untuk memancarkan peristiwa penggunaan.

Penting

Untuk informasi selengkapnya tentang membuat dimensi pengukuran kustom untuk Aplikasi Kubernetes, lihat Membuat Penawaran Kontainer Azure.

Memberlakukan catatan TLS 1.2

Versi TLS versi 1.2 akan diberlakukan segera setelah versi minimal untuk komunikasi HTTPS. Pastikan Anda menggunakan versi TLS ini di kode Anda. TLS versi 1.0 dan 1.1 tidak digunakan lagi dan upaya koneksi ditolak.

Peristiwa penggunaan tunggal penagihan terukur

API peristiwa penggunaan harus dipanggil oleh penerbit untuk memancarkan peristiwa penggunaan terhadap sumber daya aktif (berlangganan) untuk paket yang dibeli oleh pelanggan tertentu. Peristiwa penggunaan dipancarkan secara terpisah untuk setiap dimensi kustom dari paket yang ditentukan oleh penerbit saat menerbitkan penawaran.

Hanya satu peristiwa penggunaan yang dapat dipancarkan untuk setiap jam hari kalender per sumber daya dan dimensi. Jika lebih dari satu unit dikonsumsi dalam satu jam, maka akumulasi semua unit yang dikonsumsi dalam satu jam dan kemudian keluarkan dalam satu peristiwa. Peristiwa penggunaan hanya dapat dipancarkan selama 24 jam terakhir. Jika Anda memancarkan peristiwa penggunaan kapan saja antara pukul 08.00 dan 08.59.59 (dan diterima) dan mengirim peristiwa lain untuk hari yang sama antara pukul 08.00 dan 08.59.59, peristiwa tersebut ditolak sebagai duplikat.

POST: https://marketplaceapi.microsoft.com/api/usageEvent?api-version=<ApiVersion>

Parameter kueri:

Parameter Rekomendasi
ApiVersion Gunakan 2018-08-31.

Header permintaan:

Jenis-konten Menggunakan application/json
x-ms-requestid Nilai string unik untuk melacak permintaan dari klien, sebaiknya berupa GUID. Jika nilai ini tidak disediakan, nilai dibuat dan disediakan di header respons.
x-ms-correlationid Nilai string unik untuk operasi pada klien. Parameter ini menghubungkan semua peristiwa dari operasi klien dengan peristiwa di sisi server. Jika nilai ini tidak disediakan, nilai dibuat dan disediakan di header respons.
authorization Token akses unik yang mengidentifikasi penerbit melakukan panggilan API ini. Formatnya adalah "Bearer <access_token>" ketika nilai token diambil oleh penerbit, seperti yang dijelaskan dalam aplikasi Kubernetes dalam strategi Autentikasi.

Contoh isi permintaan:

{
  "resourceUri": "<ARM resource URI of the Kubernetes app instance>", // unique identifier of the resource against which usage is emitted. 
  "quantity": 5.0, // how many units were consumed for the date and hour specified in effectiveStartTime, must be greater than 0 or a double integer
  "dimension": "dim1", // custom dimension identifier
  "effectiveStartTime": "2018-12-01T08:30:14", // time in UTC when the usage event occurred, from now and until 24 hours back
  "planId": "plan1", // id of the plan purchased for the offer
}

Catatan

Untuk aplikasi Kubernetes, resourceUri adalah URI sumber daya ARM dari instans Aplikasi Kubernetes.

Respons

Kode: 200
OK. Emisi penggunaan diterima dan direkam di sisi Microsoft untuk pemrosesan dan penagihan lebih lanjut.

Contoh payload respons:

{
  "usageEventId": <guid>, // unique identifier associated with the usage event in Microsoft records
  "status": "Accepted" // this is the only value in case of single usage event
  "messageTime": "2020-01-12T13:19:35.3458658Z", // time in UTC this event was accepted
  "resourceUri": "<ARM resource URI of the Kubernetes app instance>", // unique identifier of the resource against which usage is emitted. For SaaS it's the subscriptionId.
  "quantity": 5.0, // amount of emitted units as recorded by Microsoft
  "dimension": "dim1", // custom dimension identifier
  "effectiveStartTime": "2018-12-01T08:30:14", // time in UTC when the usage event occurred, as sent by the ISV
  "planId": "plan1", // id of the plan purchased for the offer
}

Kode: 400
Permintaan buruk.

  • Data permintaan yang hilang atau tidak valid disediakan.
  • effectiveStartTime lebih dari 24 jam di masa lalu. Peristiwa telah kedaluwarsa.

Contoh payload respons:

{
  "message": "One or more errors have occurred.",
  "target": "usageEventRequest",
  "details": [
    {
      "message": "The resourceUri is required.",
      "target": "ResourceUri",
      "code": "BadArgument"
    }
  ],
  "code": "BadArgument"
}

Kode: 400
Permintaan buruk.

  • URI sumber daya sudah terdaftar sebelumnya, Perlu menunggu selama 24 jam sebelum mengirimkan penggunaan.

Contoh payload respons:

{
  "message": "One or more errors have occurred.",
  "target": "usageEventRequest",
  "details": [
    {
      "message": "Invalid usage state.",
      "target": "ResourceUri",
      "code": "BadArgument"
    }
  ],
  "code": "BadArgument"
}

Kode: 403

Terlarang. Token otorisasi tidak tersedia, tidak valid, atau kedaluwarsa.

Kode: 409
Konflik. Peristiwa penggunaan telah berhasil dilaporkan untuk ID sumber daya, tanggal dan jam penggunaan efektif yang ditentukan.

Contoh payload respons:

{
  "additionalInfo": {
    "acceptedMessage": {
      "usageEventId": "<guid>", //unique identifier associated with the usage event in Microsoft records
      "status": "Duplicate",
      "messageTime": "2020-01-12T13:19:35.3458658Z",
      "resourceUri": "<ARM resource URI of the Kubernetes app instance>", //unique identifier of the resource against which usage is emitted.
      "quantity": 1.0,
      "dimension": "dim1",
      "effectiveStartTime": "2020-01-12T11:03:28.14Z",
      "planId": "plan1"
    }
  },
  "message": "This usage event already exist.",
  "code": "Conflict"
}

Peristiwa penggunaan batch penagihan terukur

API peristiwa penggunaan batch memungkinkan Anda untuk memancarkan peristiwa penggunaan untuk lebih dari satu sumber daya yang dibeli sekaligus. Ini juga memungkinkan Anda untuk memancarkan beberapa peristiwa penggunaan untuk sumber daya yang sama selama mereka untuk jam kalender yang berbeda. Jumlah maksimal peristiwa dalam satu batch adalah 25.

POST: https://marketplaceapi.microsoft.com/api/batchUsageEvent?api-version=<ApiVersion>

Parameter kueri:

Parameter Rekomendasi
ApiVersion Gunakan 2018-08-31.

Header permintaan:

Jenis-konten Menggunakan application/json
x-ms-requestid Nilai string unik untuk melacak permintaan dari klien, sebaiknya berupa GUID. Jika nilai ini tidak disediakan, nilai dibuat, dan disediakan di header respons.
x-ms-correlationid Nilai string unik untuk operasi pada klien. Parameter ini menghubungkan semua peristiwa dari operasi klien dengan peristiwa di sisi server. Jika nilai ini tidak disediakan, dihasilkan, dan disediakan di header respons.
authorization Token akses unik yang mengidentifikasi penerbit melakukan panggilan API ini. Formatnya adalah Bearer <access_token> ketika nilai token diambil oleh penerbit, seperti yang dijelaskan dalam aplikasi Kubernetes dalam strategi Autentikasi.

Catatan

Dalam isi permintaan, pengidentifikasi sumber daya untuk aplikasi Kubernetes adalah resourceUri.

Contoh isi permintaan untuk aplikasi Kubernetes:

{
  "request": [ // list of usage events for the same or different resources of the publisher
    { // first event
      "resourceUri": "<ARM resource URI of the Kubernetes app instance>", // Unique identifier of the resource against which usage is emitted. 
      "quantity": 5.0, // how many units were consumed for the date and hour specified in effectiveStartTime, must be greater than 0 or a double integer
      "dimension": "dim1", //Custom dimension identifier
      "effectiveStartTime": "2018-12-01T08:30:14",//Time in UTC when the usage event occurred, from now and until 24 hours back
      "planId": "plan1", // id of the plan purchased for the offer
    },
    { // next event
      "resourceUri": "<ARM resource URI of the Kubernetes app instance>", 
      "quantity": 39.0, 
      "dimension": "email", 
      "effectiveStartTime": "2018-11-01T23:33:10
      "planId": "gold", // id of the plan purchased for the offer
    }
  ]
}

Respons

Kode: 200
OK. Emisi penggunaan diterima dan direkam di sisi Microsoft untuk pemrosesan dan penagihan lebih lanjut. Daftar respons dikembalikan dengan status untuk setiap peristiwa individual dalam batch. Anda harus melakukan iterasi melalui muatan respons untuk memahami respons untuk setiap peristiwa penggunaan individu yang dikirim sebagai bagian dari peristiwa batch.

Contoh payload respons:

{
  "count": 2, // number of records in the response
  "result": [
    { // first response
      "usageEventId": "<guid>", // unique identifier associated with the usage event in Microsoft records
      "status": "Accepted" // see list of possible statuses below,
      "messageTime": "2020-01-12T13:19:35.3458658Z", // Time in UTC this event was accepted by Microsoft,
      "resourceUri": "<ARM resource URI of the Kubernetes app instance>", // unique identifier of the resource against which usage is emitted.
      "quantity": 5.0, // amount of emitted units as recorded by Microsoft 
      "dimension": "dim1", // custom dimension identifier
      "effectiveStartTime": "2018-12-01T08:30:14",// time in UTC when the usage event occurred, as sent by the ISV
      "planId": "plan1", // id of the plan purchased for the offer
    },
    { // second response
      "status": "Duplicate",
      "messageTime": "0001-01-01T00:00:00",
      "error": {
        "additionalInfo": {
          "acceptedMessage": {
            "usageEventId": "<guid>",
            "status": "Duplicate",
            "messageTime": "2020-01-12T13:19:35.3458658Z",
            "resourceUri": "<ARM resource URI of the Kubernetes app instance>",
            "quantity": 1.0,
            "dimension": "email",
            "effectiveStartTime": "2020-01-12T11:03:28.14Z",
            "planId": "gold"
          }
        },
        "message": "This usage event already exist.",
        "code": "Conflict"
      },
      "resourceId": "<guid2>",
      "quantity": 1.0,
      "dimension": "email",
      "effectiveStartTime": "2020-01-12T11:03:28.14Z",
      "planId": "gold"
    }
  ]
}

Deskripsi kode status yang direferensikan dalam respons API BatchUsageEvent:

Kode status Deskripsi
Accepted Diterima.
Expired Penggunaan kedaluwarsa.
Duplicate Penggunaan duplikat disediakan.
Error Kode Kesalahan.
ResourceNotFound Sumber daya penggunaan yang disediakan tidak valid.
ResourceNotAuthorized Anda tidak berwenang untuk menyediakan penggunaan untuk sumber daya ini.
ResourceNotActive Sumber daya ditangguhkan atau tidak pernah diaktifkan.
InvalidDimension Dimensi di mana penggunaan diteruskan tidak valid untuk penawaran/paket ini.
InvalidQuantity Kuantitas yang dilewati lebih rendah atau sama dengan 0.
BadArgument Input hilang atau cacat.

Kode: 400
Permintaan buruk. Batch berisi lebih dari 25 peristiwa penggunaan.

Kode: 403
Terlarang. Token otorisasi tidak tersedia, tidak valid, atau kedaluwarsa.

Penagihan terukur mengambil peristiwa penggunaan

Anda dapat memanggil API peristiwa penggunaan untuk mendapatkan daftar peristiwa penggunaan. ISV dapat menggunakan API ini untuk melihat peristiwa penggunaan yang telah diposting selama durasi waktu tertentu yang dapat dikonfigurasi dan status peristiwa ini pada saat memanggil API.

DAPAT: https://marketplaceapi.microsoft.com/api/usageEvents

Parameter kueri:

Parameter Rekomendasi
ApiVersion Gunakan 2018-08-31.
usageStartDate DateTime dalam format ISO8601. Misalnya, 2020-12-03T15:00 atau 2020-12-03
UsageEndDate (opsional) DateTime dalam format ISO8601. Default = tanggal saat ini
offerId (opsional) Default = semua tersedia
planId (opsional) Default = semua tersedia
dimensi (opsional) Default = semua tersedia
azureSubscriptionId (opsional) Default = semua tersedia
reconStatus (opsional) Default = semua tersedia

Kemungkinan nilai reconStatus:

ReconStatus Deskripsi
Diajukan Belum diproses oleh PC Analytics
Diterima Dicocokkan dengan ANalitik PC
Ditolak Ditolak dalam alur. Hubungi dukungan Microsoft untuk menyelidiki penyebabnya.
Tidak cocok Jumlah MarketplaceAPI dan Analitik Pusat Mitra keduanya bukan nol, namun tidak cocok
TestHeaders Langganan tercantum dengan header pengujian, dan oleh karena itu tidak di PC Analytics
DryRun Dikirim dengan SessionMode=DryRun, dan oleh karena itu tidak di PC

Header permintaan:

Jenis konten Menggunakan aplikasi/json
x-ms-requestid Nilai string unik (sebaiknya GUID), untuk melacak permintaan dari klien. Jika nilai ini tidak disediakan, nilai dibuat dan disediakan di header respons.
x-ms-correlationid Nilai string unik untuk operasi pada klien. Parameter ini menghubungkan semua peristiwa dari operasi klien dengan peristiwa di sisi server. Jika nilai ini tidak disediakan, nilai dibuat dan disediakan di header respons.
authorization Token akses unik yang mengidentifikasi penerbit melakukan panggilan API ini. Formatnya adalah Bearer <access_token> ketika nilai token diambil oleh penerbit.
- Aplikasi Kubernetes dalam strategi Autentikasi

Respons

Contoh payload respons:

Diterima

[
  {
    "usageDate": "2020-11-30T00:00:00Z",
    "usageResourceId": "11111111-2222-3333-4444-555555555555",
    "dimension": "tokens",
    "planId": "silver",
    "planName": "Silver",
    "offerId": "mycooloffer",
    "offerName": "My Cool Offer",
    "offerType": "SaaS",
    "azureSubscriptionId": "12345678-9012-3456-7890-123456789012",
    "reconStatus": "Accepted",
    "submittedQuantity": 17.0,
    "processedQuantity": 17.0,
    "submittedCount": 17
  }
]

Dikirimkan

[
  {
    "usageDate": "2020-11-30T00:00:00Z",
    "usageResourceId": "11111111-2222-3333-4444-555555555555",
    "dimension": "tokens",
    "planId": "silver",
    "planName": "",
    "offerId": "mycooloffer",
    "offerName": "",
    "offerType": "SaaS",
    "azureSubscriptionId": "12345678-9012-3456-7890-123456789012",
    "reconStatus": "Submitted",
    "submittedQuantity": 17.0,
    "processedQuantity": 0.0,
    "submittedCount": 17
  }
]

Ketidakcocokan

[
  {
    "usageDate": "2020-11-30T00:00:00Z",
    "usageResourceId": "11111111-2222-3333-4444-555555555555",
    "dimension": "tokens",
    "planId": "silver",
    "planName": "Silver",
    "offerId": "mycooloffer",
    "offerName": "My Cool Offer",
    "offerType": "SaaS",
    "azureSubscriptionId": "12345678-9012-3456-7890-123456789012",
    "reconStatus": "Mismatch",
    "submittedQuantity": 17.0,
    "processedQuantity": 16.0,
    "submittedCount": 17
  }
]

Ditolak

[
  {
    "usageDate": "2020-11-30T00:00:00Z",
    "usageResourceId": "11111111-2222-3333-4444-555555555555",
    "dimension": "tokens",
    "planId": "silver",
    "planName": "",
    "offerId": "mycooloffer",
    "offerName": "",
    "offerType": "SaaS",
    "azureSubscriptionId": "12345678-9012-3456-7890-123456789012",
    "reconStatus": "Rejected",
    "submittedQuantity": 17.0,
    "processedQuantity": 0.0,
    "submittedCount": 17
  }
]

Kode status

Kode: 403 Terlarang. Token otorisasi tidak tersedia, tidak valid, atau kedaluwarsa.

Pengembangan dan pengujian praktik terbaik

Untuk menguji emisi meteran kustom, terapkan integrasi dengan API pengukuran, buat rencana untuk penawaran Kubernetes Apps yang diterbitkan dengan dimensi kustom yang ditentukan di dalamnya dengan harga nol per unit. Dan publikasikan penawaran ini sebagai pratinjau sehingga hanya pengguna terbatas yang dapat mengakses dan menguji integrasi.

Anda juga dapat menggunakan paket privat untuk penawaran langsung yang ada untuk membatasi akses ke paket ini selama pengujian ke audiens terbatas.

  • Untuk informasi selengkapnya tentang API layanan pengukuran, lihat FAQ API layanan pengukuran Marketplace.

Dapatkan dukungan

Jika anda memiliki salah satu masalah berikut, anda dapat membuka tiket dukungan.

  • Masalah teknis dengan API layanan pengukuran marketplace.
  • Masalah yang perlu di eskalasi karena kesalahan atau bug di sisi Anda (misalnya peristiwa penggunaan yang salah).
  • Setiap masalah lain yang terkait dengan penagihan terukur.

Untuk memahami opsi dukungan penayang dan membuka tiket dukungan dengan Microsoft, ikuti instruksi dalam Dukungan untuk program pasar komersial di Pusat Mitra.