Facturering naar gebruik van Azure-containers met behulp van de commerciële marketplace-meterservice

Artikel
06/14/2024

Met de commerciële marketplace-meterservice kunt u Azure Container-aanbiedingen maken die in rekening worden gebracht op basis van niet-standaardeenheden. Voordat u de aanbieding publiceert naar de commerciële marketplace, definieert u de factureringsdimensies zoals bandbreedte, shards, logboekbestanden, scans, e-mailberichten verwerkt, enzovoort. Klanten betalen vervolgens op basis van hun verbruik van deze dimensies, waarbij uw toepassing Microsoft informeert via de api van de commerciële marketplace-meterservice van factureerbare gebeurtenissen wanneer deze zich voordoen.

Vereisten voor facturering naar gebruik

Voor een Azure Container-aanbieding voor het gebruik van facturering met een datalimiet moet u eerst de licentieopties bekijken die worden beschreven in Plan for Azure Container-aanbieding en ervoor zorgen dat u aangepaste factureringsbehoeften hebt waaraan niet wordt voldaan door een van de zes bestaande vooraf gedefinieerde factureringsmodellen.

Vervolgens kan de Azure Container-aanbieding worden geïntegreerd met de API's van de commerciële marketplace-meterservice om Microsoft te informeren over factureerbare gebeurtenissen.

Belangrijk

Uw toepassing moet de service-API's voor de commerciële marketplace-meterservice aanroepen. Er is momenteel geen optie om uw gehoste service (buiten de toepassing) toe te staan om de service-API voor meten aan te roepen.

Notitie

De Marketplace-meterservice is alleen beschikbaar voor het aangepaste factureringsmodel en is niet van toepassing op het factureringsmodel per gebruiker.

Hoe de facturering naar gebruik past bij prijzen

Inzicht in de aanbiedingshiërarchie is belangrijk als het gaat om het definiëren van de aanbieding samen met de prijsmodellen.

Elke aanbieding is geconfigureerd om te verkopen via Microsoft of niet. Zodra een aanbieding is gepubliceerd, kan deze optie niet meer worden gewijzigd.
Elke aanbieding, geconfigureerd voor verkoop via Microsoft, kan een of meer abonnementen hebben.
Aan elk abonnement is een prijsmodel gekoppeld: maandelijks gefactureerd abonnement op basis van gebruik of Byol (Bring Your Own License). Voor het maandelijkse abonnement op basis van gebruik kunt u gratis kiezen, een van de zes vooraf gedefinieerde factureringsopties of aangepaste opties.
Het prijsmodel en de invoeropties voor prijzen kunnen niet worden bijgewerkt zodra ze zijn gepubliceerd.
Elk abonnement moet een volledig prijsplan hebben.
U kunt ervoor kiezen om met aangepaste dimensies kosten in rekening te brengen voor uw klanten om te voldoen aan uw factureringsbehoeften. Elke dimensie vertegenwoordigt een factureerbare eenheid die uw service met Microsoft communiceert met behulp van de service-API voor de commerciële marketplace-meterservice.

Belangrijk

U moet het gebruik in uw code bijhouden en alleen gebruiksgebeurtenissen naar Microsoft verzenden voor het gebruik dat de klant wilt factureren.

Notitie

Aanbiedingen worden gefactureerd aan klanten in de valuta van de overeenkomst van de klant, met behulp van de lokale marktprijs die werd gepubliceerd op het moment dat de aanbieding werd gemaakt. Het bedrag dat klanten betalen en dat ISV's worden betaald, is afhankelijk van de wisselkoersen op het moment dat de klant de aanbieding overhandelt. Meer informatie over 'Hoe converteren we valuta?'.

Voorbeeld van aangepaste prijsopties

Contoso is bijvoorbeeld een uitgever waarvan het IP-adres zich in hun shardinglogica bevindt voor de Kubernetes-toepassing. Contoso wil klanten kosten in rekening brengen op basis van het aantal gebruikte shards. Ze verkennen ook andere handige en concurrerende factureringsopties. Contoso is geregistreerd als uitgever in partnercentrum voor het commerciële marketplace-programma en wil containeraanbiedingen publiceren naar Azure-klanten. Er zijn vier abonnementen gekoppeld aan Contoso, die hieronder worden beschreven:

Kosten per shard die per uur worden gebruikt, bijvoorbeeld $ 1.000/shard/uur
Eenmalige betaling of terugkerende facturering modelleren: Stel dat Contoso een klant $ 449/mo wil in rekening brengen voor het gebruik van maximaal 100 logboekbestanden van hun toepassing. De toepassingslogica van Contoso houdt gebruiksevenementen voor de maand bij en activeert kosten aan het einde van de maand voor het gebruik van 100 logboekbestanden.
Gelaagde facturering modelleren: Stel dat Contoso $ 449/mo wil in rekening brengen voor maximaal 100 shards en vervolgens gelaagde prijzen voor overschrijdingen. De toepassingslogica houdt het gebruik voor de maand bij, segmenteert het gebruik dienovereenkomstig en rapporteert deze met behulp van de onderstaande meter-API's aan het einde van de periode:
Multidimensionale facturering: Contoso kan ook aangepaste meting gebruiken om te voldoen aan hun behoeften voor geavanceerde facturering met behulp van meerdere dimensies

Op basis van het geselecteerde abonnement worden kosten in rekening gebracht voor een Azure-klant die de Contoso Container-aanbieding krijgt op basis van hun gebruik. Contoso telt het gebruik zonder gebruiksgebeurtenissen naar Microsoft te verzenden. Wanneer klanten voldoende hoeveelheid verbruiken of periodiek, rapporteert Contoso het gebruik. Klanten hoeven geen plannen te wijzigen of iets anders te doen. Contoso meet het gebruik en begint met het verzenden van gebruiksgebeurtenissen naar Microsoft voor het opladen van het overschrijdingsgebruik met behulp van de service-API voor de commerciële marketplace-meterservice. Microsoft brengt de klant op zijn beurt kosten in rekening voor het gebruik zoals opgegeven door de uitgever in de aangepaste dimensies. De facturering wordt uitgevoerd op de volgende maandelijkse factureringscyclus.

Factureringsdimensies

Elke factureringsdimensie definieert een aangepaste eenheid waarmee de ISV gebruiksevenementen kan verzenden. Factureringsdimensies worden ook gebruikt om de klant te laten communiceren over hoe ze worden gefactureerd voor het gebruik van de software. Ze worden als volgt gedefinieerd:

Id: de onveranderbare dimensie-id waarnaar wordt verwezen tijdens het verzenden van gebruiksgebeurtenissen.
Weergavenaam: de weergavenaam die is gekoppeld aan de dimensie, bijvoorbeeld 'sms-berichten verzonden'.
Maateenheid: de beschrijving van de factureringseenheid, bijvoorbeeld 'per sms-bericht' of 'per 100 e-mailberichten'.
Prijs per eenheid in USD: de prijs voor één eenheid van dimensie. Het kan 0 zijn.

Belangrijk

U moet het gebruik in uw toepassingscode bijhouden en gebruiksevenementen naar Microsoft verzenden op basis van uw factureringsbehoeften.

Factureringsdimensies worden gedeeld in alle abonnementen voor een aanbieding. Sommige kenmerken zijn van toepassing op de dimensie voor alle plannen en andere kenmerken zijn planspecifiek.

De kenmerken, die de dimensie zelf definiëren, worden gedeeld in alle abonnementen voor een aanbieding. Voordat u de aanbieding publiceert, is een wijziging in deze kenmerken van de context van een plan van invloed op de dimensiedefinitie voor alle plannen. Nadat u de aanbieding hebt gepubliceerd, kunnen deze kenmerken niet meer worden bewerkt. Deze kenmerken zijn:

Id
Weergavenaam
Maateenheid

De andere kenmerken van een dimensie zijn specifiek voor elk plan en kunnen verschillende waarden hebben van plan tot plan. Voordat u het plan publiceert, kunt u deze waarden bewerken en wordt alleen dit plan beïnvloed. Nadat u het plan hebt gepubliceerd, kunnen deze kenmerken niet meer worden bewerkt. Deze kenmerken zijn:

Prijs per eenheid in USD

Dimensies hebben ook een speciaal concept met de naam 'ingeschakeld':

Ingeschakeld geeft aan dat dit plan deelneemt aan deze dimensie. Als u een nieuw abonnement maakt dat geen gebruiksgebeurtenissen verzendt op basis van deze dimensie, kunt u deze optie uitgeschakeld laten. Bovendien worden nieuwe dimensies die zijn toegevoegd nadat een plan voor het eerst is gepubliceerd, weergegeven als 'niet ingeschakeld' in het reeds gepubliceerde plan. Een uitgeschakelde dimensie wordt niet weergegeven in een lijst met dimensies voor een abonnement dat door klanten wordt gezien.

Notitie

De volgende scenario's worden expliciet ondersteund:

U kunt een nieuwe dimensie toevoegen aan een nieuw plan. De nieuwe dimensie wordt niet ingeschakeld voor al gepubliceerde plannen.

Dimensieprijs per eenheid per ondersteunde markt instellen

Net als bij andere prijzen op basis van gebruik kunnen factureringsdimensieprijzen per ondersteund land of regio worden ingesteld. U moet de functie voor het importeren en exporteren van prijsgegevens als volgt gebruiken in partnercentrum.

Definieer de gewenste dimensies en markeer welke markten worden ondersteund.
Exporteer deze gegevens naar een bestand.
Voeg de juiste prijzen per land/regio toe en importeer het bestand in partnercentrum.

De gebruikersinterface van de meter verandert om aan te geven dat de prijzen van de dimensie alleen zichtbaar zijn in het bestand.

Privéplan

Net als de vooraf gedefinieerde factureringsplannen op basis van gebruik, kan een abonnement met aangepaste dimensies worden ingesteld als privéabonnement, dat alleen toegankelijk is voor de gedefinieerde doelgroep van het plan.

Beperkingen

Vergrendelingsgedrag

Omdat een dimensie die wordt gebruikt met de commerciële marketplace-meterservice een goed beeld geeft van hoe een klant voor de service betaalt, kunnen alle details voor een dimensie niet meer worden bewerkt nadat u deze hebt gepubliceerd. Het is belangrijk dat u uw dimensies volledig hebt gedefinieerd voor een plan voordat u publiceert.

Zodra een aanbieding met een dimensie is gepubliceerd, kunnen de details op aanbiedingsniveau voor die dimensie niet meer worden gewijzigd:

Id
Weergavenaam
Maateenheid

Zodra een plan is gepubliceerd, kan dit detail op planniveau niet meer worden gewijzigd:

Of de dimensie is ingeschakeld voor het plan of niet

Bovengrens

Het maximum aantal dimensies dat voor één aanbieding kan worden geconfigureerd, is 30 unieke dimensies.

Facturering naar gebruik van Azure Container

De API's voor facturering naar gebruik naar gebruik moeten worden gebruikt wanneer de uitgever aangepaste meterdimensies maakt voor een aanbieding die in partnercentrum moet worden gepubliceerd. Integratie met de facturerings-API's met datalimiet is vereist voor elke aangeschafte aanbieding met een of meer abonnementen met aangepaste dimensies om gebruiksgebeurtenissen te verzenden.

Belangrijk

Zie Een Azure Container-aanbieding maken voor meer informatie over het maken van aangepaste metingsdimensies voor Kubernetes Apps.

TLS 1.2-notitie afdwingen

TLS-versie 1.2 wordt afgedwongen als minimale versie voor HTTPS-communicatie. Zorg ervoor dat u deze TLS-versie in uw code gebruikt. TLS-versie 1.0 en 1.1 zijn afgeschaft en verbindingspogingen worden geweigerd.

Eenmalige factureringsgebeurtenis met één gebruik

De API voor gebruiksgebeurtenissen moet worden aangeroepen door de uitgever om gebruiksgebeurtenissen te verzenden op basis van een actieve resource (geabonneerd) voor het abonnement dat is gekocht door de specifieke klant. De gebruiks gebeurtenis wordt afzonderlijk verzonden voor elke aangepaste dimensie van het plan dat door de uitgever is gedefinieerd bij het publiceren van de aanbieding.

Er kan slechts één gebruiksgebeurtenis worden verzonden voor elk uur van een kalenderdag per resource en dimensie. Als er meer dan één eenheid in een uur wordt verbruikt, verzamelt u alle eenheden die in het uur worden verbruikt en verzendt u deze vervolgens in één gebeurtenis. Gebruiksevenementen kunnen de afgelopen 24 uur alleen worden verzonden. Als u een gebruiksevenement op elk gewenst moment verzendt tussen 8:00 en 8:59:59 (en geaccepteerd) en een andere gebeurtenis verzendt voor dezelfde dag tussen 8:00 en 8:59:59, wordt deze geweigerd als een duplicaat.

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

Queryparameters:

Parameter	Aanbeveling
`ApiVersion`	Gebruik 2018-08-31.

Aanvraagheaders:

Inhoudstype	`application/json` gebruiken
`x-ms-requestid`	Unieke tekenreekswaarde voor het bijhouden van de aanvraag van de client, bij voorkeur een GUID. Als deze waarde niet is opgegeven, wordt er een gegenereerd en opgegeven in de antwoordheaders.
`x-ms-correlationid`	Unieke tekenreekswaarde voor bewerking op de client. Deze parameter correleert alle gebeurtenissen van de clientbewerking met gebeurtenissen aan de serverzijde. Als deze waarde niet is opgegeven, wordt er een gegenereerd en opgegeven in de antwoordheaders.
`authorization`	Een uniek toegangstoken dat de ISV identificeert die deze API-aanroep maakt. De indeling is `"Bearer <access_token>"` wanneer de tokenwaarde wordt opgehaald door de uitgever, zoals uitgelegd in de Kubernetes-toepassing in verificatiestrategieën.

Voorbeeld van aanvraagtekst:

{
  "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
}

Notitie

Voor Kubernetes-apps is dit de resourceUri ARM-resource-URI van het Kubernetes App-exemplaar.

Antwoorden

Code: 200
OK. De gebruiksemissie is geaccepteerd en geregistreerd aan de zijde van Microsoft voor verdere verwerking en facturering.

Voorbeeld van nettolading van antwoord:

{
  "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
}

Code: 400
Ongeldig verzoek.

Ontbrekende of ongeldige aanvraaggegevens opgegeven.
effectiveStartTime is meer dan 24 uur in het verleden. De gebeurtenis is verlopen.

Voorbeeld van nettolading van antwoord:

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

Code: 400
Ongeldig verzoek.

Resource-URI is al eerder geregistreerd. Wacht 24 uur voordat u het gebruik indient.

Voorbeeld van nettolading van antwoord:

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

Code: 403

Verboden. Het autorisatietoken is niet opgegeven, is ongeldig of verlopen.

Code: 409
Conflict. Er is al een gebruiksgebeurtenis gerapporteerd voor de opgegeven resource-id, de ingangsdatum en het uur.

Voorbeeld van nettolading van antwoord:

{
  "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"
}

Gebeurtenis voor batchgebruik met een datalimiet

Met de gebeurtenis-API voor batchgebruik kunt u gebruiksgebeurtenissen verzenden voor meer dan één aangeschafte resource tegelijk. Hiermee kunt u ook verschillende gebruiksgebeurtenissen verzenden voor dezelfde resource, zolang ze voor verschillende kalenderuren zijn. Het maximale aantal gebeurtenissen in één batch is 25.

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

Queryparameters:

Parameter	Aanbeveling
`ApiVersion`	Gebruik 2018-08-31.

Aanvraagheaders:

Inhoudstype	`application/json` gebruiken
`x-ms-requestid`	Unieke tekenreekswaarde voor het bijhouden van de aanvraag van de client, bij voorkeur een GUID. Als deze waarde niet wordt opgegeven, wordt er een gegenereerd en opgegeven in de antwoordheaders.
`x-ms-correlationid`	Unieke tekenreekswaarde voor bewerking op de client. Deze parameter correleert alle gebeurtenissen van de clientbewerking met gebeurtenissen aan de serverzijde. Als deze waarde niet is opgegeven, wordt deze gegenereerd en opgegeven in de antwoordheaders.
`authorization`	Een uniek toegangstoken dat de ISV identificeert die deze API-aanroep maakt. De indeling is `Bearer <access_token>` wanneer de tokenwaarde wordt opgehaald door de uitgever, zoals uitgelegd in de Kubernetes-toepassing in verificatiestrategieën.

Notitie

In de aanvraagbody is resourceUride resource-id voor Kubernetes-apps.

Voorbeeld van aanvraagbody voor Kubernetes-apps:

{
  "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
    }
  ]
}

Antwoorden

Code: 200
OK. De emissie van batchgebruik is geaccepteerd en geregistreerd aan de zijde van Microsoft voor verdere verwerking en facturering. De antwoordlijst wordt geretourneerd met de status voor elke afzonderlijke gebeurtenis in de batch. U moet de nettolading van het antwoord herhalen om inzicht te krijgen in de antwoorden voor elke afzonderlijke gebruiksgebeurtenis die wordt verzonden als onderdeel van de batchgebeurtenis.

Voorbeeld van nettolading van antwoord:

{
  "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"
    }
  ]
}

Beschrijving van statuscode waarnaar wordt verwezen in BatchUsageEvent API-antwoord:

Statuscode	Beschrijving
`Accepted`	Geaccepteerd.
`Expired`	Verlopen gebruik.
`Duplicate`	Er is een dubbel gebruik opgegeven.
`Error`	Foutcode.
`ResourceNotFound`	De opgegeven gebruiksresource is ongeldig.
`ResourceNotAuthorized`	U bent niet gemachtigd om gebruik voor deze resource op te geven.
`ResourceNotActive`	De resource is onderbroken of is nooit geactiveerd.
`InvalidDimension`	De dimensie waarvoor het gebruik wordt doorgegeven, is ongeldig voor deze aanbieding/plan.
`InvalidQuantity`	De doorgegeven hoeveelheid is lager of gelijk aan 0.
`BadArgument`	De invoer ontbreekt of is onjuist.

Code: 400
Ongeldig verzoek. De batch bevat meer dan 25 gebruiksgebeurtenissen.

Code: 403
Verboden. Het autorisatietoken is niet opgegeven, is ongeldig of verlopen.

Gebruiksgebeurtenissen ophalen met een datalimiet

U kunt de API voor gebruiksevenementen aanroepen om de lijst met gebruiksevenementen op te halen. ISV's kunnen deze API gebruiken om de gebruiksgebeurtenissen te zien die gedurende een bepaalde configureerbare tijdsduur zijn gepost en welke status deze gebeurtenissen zijn op het moment dat de API wordt aangeroepen.

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

Queryparameters:

Parameter	Aanbeveling
ApiVersion	Gebruik 2018-08-31.
usageStartDate	DateTime in ISO8601-indeling. Bijvoorbeeld 2020-12-03T15:00 of 2020-12-03
UsageEndDate (optioneel)	DateTime in ISO8601-indeling. Standaard = huidige datum
offerId (optioneel)	Standaard = alle beschikbare
planId (optioneel)	Standaard = alle beschikbare
dimensie (optioneel)	Standaard = alle beschikbare
azureSubscriptionId (optioneel)	Standaard = alle beschikbare
reconStatus (optioneel)	Standaard = alle beschikbare

Mogelijke waarden van reconStatus:

ReconStatus	Beschrijving
Ingediend	Nog niet verwerkt door PC Analytics
Geaccepteerd	Overeenkomend met PC Analytics
Afgewezen	Geweigerd in de pijplijn. Neem contact op met Microsoft Ondersteuning om de oorzaak te onderzoeken.
Wanverhouding	MarketplaceAPI- en Partner Center Analytics-hoeveelheden zijn beide niet-nul, maar niet overeenkomend
Testheaders	Abonnement dat wordt vermeld met testheaders en daarom niet in PC Analytics
DryRun	Ingediend met SessionMode=DryRun, en dus niet op pc

Aanvraagheaders:

Inhoudstype	Toepassing/json gebruiken
x-ms-requestid	Unieke tekenreekswaarde (bij voorkeur een GUID) voor het bijhouden van de aanvraag van de client. Als deze waarde niet is opgegeven, wordt er een gegenereerd en opgegeven in de antwoordheaders.
x-ms-correlationid	Unieke tekenreekswaarde voor bewerking op de client. Deze parameter correleert alle gebeurtenissen van de clientbewerking met gebeurtenissen aan de serverzijde. Als deze waarde niet is opgegeven, wordt er een gegenereerd en opgegeven in de antwoordheaders.
autorisatie	Een uniek toegangstoken dat de ISV identificeert die deze API-aanroep maakt. De notatie is `Bearer <access_token>` wanneer de tokenwaarde wordt opgehaald door de uitgever. - Kubernetes-toepassing in verificatiestrategieën

Antwoorden

Voorbeelden van nettoladingen van antwoorden:

Geaccepteerd

[
  {
    "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
  }
]

Ingediend

[
  {
    "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
  }
]

Wanverhouding

[
  {
    "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
  }
]

Afgekeurd

[
  {
    "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
  }
]

Statuscodes

Code: 403 Verboden. Het autorisatietoken is niet opgegeven, is ongeldig of verlopen.

Best practices voor ontwikkelen en testen

Als u de emissie van de aangepaste meter wilt testen, implementeert u de integratie met de metering-API, maakt u een plan voor uw gepubliceerde Kubernetes Apps-aanbieding met aangepaste dimensies die erin zijn gedefinieerd met nulprijs per eenheid. En publiceer deze aanbieding als preview zodat alleen beperkte gebruikers de integratie kunnen openen en testen.

U kunt ook een privéabonnement gebruiken voor een bestaande live-aanbieding om de toegang tot dit plan tijdens het testen te beperken tot een beperkt publiek.

Zie de veelgestelde vragen over service-API's voor de meteringservice voor Marketplace voor meer informatie over service-API's voor metering.

Ondersteuning krijgen

Als u een van de volgende problemen ondervindt, kunt u een ondersteuningsticket openen.

Technische problemen met de service-API voor marketplace-metering.
Een probleem dat moet worden geëscaleerd vanwege een fout of fout aan uw zijde (bijvoorbeeld een verkeerde gebruiksgebeurtenis).
Eventuele andere problemen met betrekking tot facturering naar gebruik.

Als u meer wilt weten over ondersteuningsopties voor uitgevers en een ondersteuningsticket met Microsoft wilt openen, volgt u de instructies in Ondersteuning voor het commerciële marketplace-programma in Partnercentrum.

Delen via

Facturering naar gebruik van Azure-containers met behulp van de commerciële marketplace-meterservice

Vereisten voor facturering naar gebruik

Hoe de facturering naar gebruik past bij prijzen

Voorbeeld van aangepaste prijsopties

Factureringsdimensies

Dimensieprijs per eenheid per ondersteunde markt instellen

Privéplan

Beperkingen

Vergrendelingsgedrag

Bovengrens

Facturering naar gebruik van Azure Container

TLS 1.2-notitie afdwingen

Eenmalige factureringsgebeurtenis met één gebruik

Antwoorden

Gebeurtenis voor batchgebruik met een datalimiet

Antwoorden

Gebruiksgebeurtenissen ophalen met een datalimiet

Antwoorden

Best practices voor ontwikkelen en testen

Ondersteuning krijgen

Feedback

Aanvullende resources

Delen via

Facturering naar gebruik van Azure-containers met behulp van de commerciële marketplace-meterservice

Vereisten voor facturering naar gebruik

Hoe de facturering naar gebruik past bij prijzen

Voorbeeld van aangepaste prijsopties

Factureringsdimensies

Dimensieprijs per eenheid per ondersteunde markt instellen

Privéplan

Beperkingen

Vergrendelingsgedrag

Bovengrens

Facturering naar gebruik van Azure Container

TLS 1.2-notitie afdwingen

Eenmalige factureringsgebeurtenis met één gebruik

Antwoorden

Gebeurtenis voor batchgebruik met een datalimiet

Antwoorden

Gebruiksgebeurtenissen ophalen met een datalimiet

Antwoorden

Best practices voor ontwikkelen en testen

Gerelateerde inhoud

Ondersteuning krijgen

Feedback

Aanvullende resources