Toeschrijving van Azure-klantgebruik

Artikel
06/14/2024

Toeschrijving van klantgebruik koppelt het gebruik van Azure-resources in klantabonnementen die zijn gemaakt tijdens het implementeren van uw IP-adres bij u als partner. Het vormen van deze koppelingen in interne Microsoft-systemen zorgt voor een grotere interne zichtbaarheid van de Azure-footprint waarop uw software wordt uitgevoerd. Voor Azure-toepassing aanbiedingen in de commerciële marketplace helpt deze traceringsfunctie u in overeenstemming te zijn met Microsoft-verkoopteams en tegoed te krijgen voor Microsoft-partnerprogramma's. Toewijzing van klantgebruik is niet van toepassing op aanbiedingen van virtuele Azure-machines in de commerciële marketplace. Er is niets wat een marketplace-uitgever hoeft te doen voor aanbiedingen van virtuele machines om ervoor te zorgen dat hun Azure-verbruik wordt bijgehouden in abonnementen van eindgebruikers.

Toeschrijving van klantgebruik ondersteunt drie implementatieopties:

Azure Resource Manager-sjablonen (de algemene basis van Azure-apps, ook wel aangeduid in de commerciële marketplace als oplossingssjablonen of beheerde apps): partners maken Resource Manager-sjablonen om de infrastructuur en configuratie van hun Azure-oplossingen te definiëren. Met een Resource Manager-sjabloon kunnen uw klanten de resources van uw oplossing in een consistente en herhaalbare status implementeren.
Azure Resource Manager-API's: partners kunnen de Resource Manager-API's aanroepen om een Resource Manager-sjabloon te implementeren of rechtstreeks Azure-services in te richten.
Terraform: partners kunnen Terraform gebruiken om een Resource Manager-sjabloon te implementeren of rechtstreeks Azure-services te implementeren.

Zie secundaire gebruiksvoorbeelden verderop in dit artikel voor het toewijzen van klantgebruik buiten de commerciële marketplace.

Belangrijk

Toeschrijving van klantgebruik is niet bedoeld om het werk van systeemintegrators, beheerde serviceproviders of hulpprogramma's bij te houden die voornamelijk zijn ontworpen voor het implementeren en beheren van Azure-resources.
Toeschrijving van klantgebruik is bedoeld voor nieuwe implementaties en biedt geen ondersteuning voor het bijhouden van resources die al zijn geïmplementeerd.
- Niet alle Azure-services zijn compatibel met het gebruik van klanten. Azure Kubernetes Services (AKS), VM-schaalsets en Azure Batch hebben bekende problemen die een onderrapportage van het gebruik veroorzaken.
- Azure-verbruiksgegevens voor het gebruik van klanten worden niet extern gedeeld met partners.

Azure-apps voor commerciële marketplace

Het bijhouden van Azure-gebruik van Azure-apps die zijn gepubliceerd naar de commerciële marketplace, is grotendeels automatisch. Wanneer u een Resource Manager-sjabloon uploadt als onderdeel van de technische configuratie van het Azure-app-plan van uw Marketplace, voegt Partner Center een tracerings-id toe die kan worden gelezen door Azure Resource Manager.

Notitie

Om ervoor te zorgen dat het gebruik van uw toepassing nauwkeurig wordt toegeschreven in onze systemen:

Als u de tracerings-id definieert in het resourcetype Microsoft.Resources/implementatie door een variabele, vervangt u de variabele door de tracerings-id die zichtbaar is in partnercentrum op de pagina Technische configuratie van het plan (zie Hieronder een GUID toevoegen aan een Resource Manager-sjabloon).
Als uw Resource Manager-sjabloon resources van het type Microsoft.Resources/implementaties gebruikt voor andere doeleinden dan het toewijzen van klantgebruik, kan Microsoft namens u geen tracerings-id voor klantgebruiksvermeldingen toevoegen. Voeg een nieuwe resource van het type Microsoft.Resources/implementaties toe en voeg de tracerings-id toe die zichtbaar is in partnercentrum op de pagina Technische configuratie van het plan (zie Een GUID toevoegen aan een Resource Manager-sjabloon hieronder).

Als u Azure Resource Manager-API's gebruikt, moet u uw tracerings-id toevoegen aan de onderstaande instructies om deze door te geven aan Azure Resource Manager wanneer uw code resources implementeert. Deze id is zichtbaar in partnercentrum op de pagina Technische configuratie van uw Azure-toepassing-plan.

Notitie

Voor bestaande Azure-apps is in maart 2021 een eenmalige migratie gestart om de tracerings-id's bij te werken in de technische configuratie van elk plan. Het gebruik van eerdere implementaties van deze aanbiedingen blijft bijgehouden in Microsoft-systemen.

Wanneer u uw aanbiedingen bijwerkt, hoeft u het resourcetype Microsoft.Resources/deployments niet meer toe te voegen in uw hoofdsjabloonbestand.

Andere gebruiksvoorbeelden

U kunt gebruiksvermelding van klanten gebruiken om het Gebruik van Azure-oplossingen bij te houden die niet beschikbaar zijn in de commerciële marketplace. Deze oplossingen bevinden zich meestal in de quickstart-opslagplaats, privé-GitHub-opslagplaatsen of zijn afkomstig van 1:1 klantafspraken die duurzame IP-adressen maken (zoals een implementeerbare en schaalbare app).

Er zijn verschillende handmatige stappen vereist:

Maak een of meer GUID's die u als tracerings-id's wilt gebruiken.
Registreer deze GUID's in partnercentrum.
Voeg uw geregistreerde GUID's toe aan uw Azure-app en/of gebruikersagenttekenreeksen.

GUID's maken

In tegenstelling tot de tracerings-id's die partnercentrum namens u maakt voor Azure-apps in de commerciële marketplace, moet u voor andere gebruiksvermeldingen van klanten een GUID maken om te gebruiken als uw tracerings-id. Een GUID is een unieke referentie-id met 32 hexadecimale cijfers. Als u GUID's wilt maken voor het bijhouden, moet u bijvoorbeeld een GUID-generator gebruiken via PowerShell:

[guid]::NewGuid()

U moet een unieke GUID maken voor elk product- en distributiekanaal. U kunt één GUID gebruiken voor de meerdere distributiekanalen van een product als u geen rapportage wilt splitsen. Rapportage vindt plaats door PartnerID en GUID.

GUID's registreren

GUID's moeten vervolgens worden geregistreerd in partnercentrum, zodat ze als partner aan u kunnen worden gekoppeld:

Meld u aan bij Partnercentrum.
Meld u aan als uitgever van commerciële marketplace.
Selecteer Instellingen (tandwielpictogram) in de rechterbovenhoek en vervolgens Accountinstellingen.
Selecteer Organisatieprofiel-id's>>Add Tracking GUID.
Voer in het GUID-vak uw tracerings-GUID in. Voer alleen de GUID zonder het pid- voorvoegsel in. Voer in het vak Beschrijving de naam of beschrijving van uw oplossing in.
Als u meer dan één GUID wilt registreren, selecteert u Tracerings-GUID opnieuw toevoegen. Er worden extra vakken weergegeven op de pagina.
Selecteer Opslaan.

Een GUID toevoegen aan een Resource Manager-sjabloon

Als u uw geregistreerde GUID wilt toevoegen aan een Resource Manager-sjabloon, moet u één wijziging aanbrengen in het hoofdsjabloonbestand:

Open de Resource Manager-sjabloon.
Voeg een nieuwe resource toe van het type Microsoft.Resources/implementaties in het hoofdsjabloonbestand. De resource moet alleen in het mainTemplate.json of azuredeploy.json bestand staan, niet in geneste of gekoppelde sjablonen.
Voer de GUID-waarde achter het pid- voorvoegsel in als de naam van de resource. Als de GUID bijvoorbeeld eb7927c8-dd66-43e1-b0cf-c346a422063 is, is de resourcenaam pid-eb7927c8-dd66-43e1-b0cf-c346a422063. Voorbeeld:

{ // add this resource to the resources section in the mainTemplate.json
    "apiVersion": "2020-06-01",
    "name": "pid-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", // use your generated GUID here
    "type": "Microsoft.Resources/deployments",
    "properties": {
        "mode": "Incremental",
        "template": {
            "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
            "contentVersion": "1.0.0.0",
            "resources": []
        }
    }
} // remove all comments from the file when complete

Controleer de sjabloon op fouten.
Publiceer de sjabloon opnieuw in de juiste opslagplaatsen.
Controleer of de GUID is geslaagd in de sjabloonimplementatie.

Tip

Zie voor meer informatie over het maken en publiceren van Resource Manager-sjablonen: uw eerste Resource Manager-sjabloon maken en implementeren.

Implementaties controleren die zijn bijgehouden met een GUID

Nadat u de sjabloon hebt gewijzigd en een testimplementatie hebt uitgevoerd, gebruikt u het volgende PowerShell-script om de resources op te halen die u hebt geïmplementeerd en gelabeld.

U kunt het script gebruiken om te controleren of de GUID is toegevoegd aan uw Resource Manager-sjabloon. Het script is niet van toepassing op Resource Manager API- of Terraform-implementaties.

Meld u aan bij Azure. Selecteer het abonnement met de implementatie die u wilt verifiëren voordat u het script uitvoert. Voer het script uit in de abonnementscontext van de implementatie.

De GUID (hieronder 'deploymentName' genoemd) en de naam resourceGroupName van de implementatie zijn vereiste parameters.

U kunt het oorspronkelijke Verify-DeploymentGuid-script ophalen op GitHub.

Param(
    [string][Parameter(Mandatory=$true)]$deploymentName, # the full name of the deployment, e.g. pid-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX
    [string][Parameter(Mandatory=$true)]$resourceGroupName
)

# Get the correlationId of the named deployment
$correlationId = (Get-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName -Name "$deploymentName").correlationId

# Find all deployments with that correlationId
$deployments = Get-AzResourceGroupDeployment -ResourceGroupName $resourceGroupName | Where-Object{$_.correlationId -eq $correlationId}

# Find all deploymentOperations in all deployments with that correlationId as PowerShell doesn't surface outputResources on the deployment or correlationId on the deploymentOperation

foreach ($deployment in $deployments){
    # Get deploymentOperations by deploymentName
    # then the resourceIds for each resource
    ($deployment | Get-AzResourceGroupDeploymentOperation | Where-Object{$_.targetResource -notlike "*Microsoft.Resources/deployments*"}).TargetResource
}

Uw klanten op de hoogte stellen

Partners moeten hun klanten informeren over implementaties die gebruikmaken van het gebruik van klantgebruik. De volgende voorbeelden zijn inhoud die u kunt gebruiken om uw klanten op de hoogte te stellen van deze implementaties. Vervang partner> in de voorbeelden door <de naam van uw bedrijf. Partners moeten ervoor zorgen dat de melding overeenkomt met hun gegevensprivacy- en verzamelingsbeleid, inclusief opties voor klanten die moeten worden uitgesloten van het bijhouden.

Melding voor Resource Manager-sjabloonimplementaties

Wanneer u deze sjabloon implementeert, kan Microsoft de installatie van <PARTNER-software> identificeren met de geïmplementeerde Azure-resources. Microsoft kan deze resources correleren die worden gebruikt ter ondersteuning van de software. Microsoft verzamelt deze informatie om de beste ervaringen met hun producten te bieden en om hun bedrijf te bedienen. De gegevens worden verzameld en beheerd door het privacybeleid van Microsoft, dat zich bevindt op https://www.microsoft.com/trustcenter.

Melding voor SDK- of API-implementaties

Wanneer u PARTNER-software> implementeert<, kan Microsoft de installatie van <PARTNER-software> identificeren met de geïmplementeerde Azure-resources. Microsoft kan deze resources correleren die worden gebruikt ter ondersteuning van de software. Microsoft verzamelt deze informatie om de beste ervaringen met hun producten te bieden en om hun bedrijf te bedienen. De gegevens worden verzameld en beheerd door het privacybeleid van Microsoft, dat zich bevindt op https://www.microsoft.com/trustcenter.

Resource Manager-API's gebruiken

In sommige gevallen kunt u rechtstreeks aanroepen uitvoeren op basis van de Rest API's van Resource Manager om Azure-services te implementeren. ondersteuning voor Azure meerdere SDK's om deze aanroepen in te schakelen. U kunt een van de SDK's gebruiken of de REST API's rechtstreeks aanroepen om resources te implementeren.

Als u het gebruik van klanten wilt inschakelen, moet u uw tracerings-id opnemen in de header van de gebruikersagent in de aanvraag wanneer u uw API-aanroepen ontwerpt. Maak de tekenreeks op met het pid- voorvoegsel. Voorbeelden:

//Commercial Marketplace Azure app
pid-contoso-myoffer-partnercenter //copy the tracking ID exactly as it appears in Partner Center

//Other use cases
pid-b6addd8f-5ff4-4fc0-a2b5-0ec7861106c4 //enter your GUID after "pid-"

Belangrijk

Als u Resource Manager-API's gebruikt met een Azure-app in de commerciële marketplace, gebruikt u de tracerings-id die is opgegeven in partnercentrum. Gebruik GEEN GUID.

Verschillende SDK's werken anders met de Resource Manager-API's en vereisen enkele verschillen in uw code. In de onderstaande voorbeelden wordt de niet-commerciële marketplace-benadering gebruikt met behulp van een GUID en worden verschillende populaire Azure-SDK's behandeld.

Voorbeeld: Python SDK

Gebruik voor Python het configuratiekenmerk . U kunt het kenmerk alleen toevoegen aan een UserAgent. Voorbeeld:

client = azure.mgmt.servicebus.ServiceBusManagementClient(**parameters)
client.config.add_user_agent("pid-b6addd8f-5ff4-4fc0-a2b5-0ec7861106c4")

Belangrijk

Voeg het kenmerk voor elke client toe. Er is geen globale statische configuratie. U kunt een clientfactory taggen om ervoor te zorgen dat elke client wordt bijgehouden. Zie dit voorbeeld van de clientfactory op GitHub voor meer informatie.

Voorbeeld: .NET SDK

Voor .NET moet u de gebruikersagent instellen. Gebruik de bibliotheek Microsoft.Azure.Management.Fluent om de gebruikersagent in te stellen met de volgende code (voorbeeld in C#):

var azure = Microsoft.Azure.Management.Fluent.Azure
    .Configure()
    // Add your pid in the user agent header
    .WithUserAgent("pid-XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX", String.Empty) 
    .Authenticate(/* Credentials created via Microsoft.Azure.Management.ResourceManager.Fluent.SdkContext.AzureCredentialsFactory */)
    .WithSubscription("<subscription ID>");

Belangrijk

Vanaf juni 2023 wordt de nieuwste Versie van Partner Center .NET SDK 3.4.0 gearchiveerd. U kunt de SDK-release downloaden van GitHub, samen met een leesmij-bestand dat nuttige informatie bevat.

Partners worden aangemoedigd om de REST API's van partnercentrum te blijven gebruiken.

Voorbeeld: Azure PowerShell

Als u resources implementeert via Azure PowerShell, voegt u uw GUID toe met behulp van deze methode:

[Microsoft.Azure.Common.Authentication.AzureSession]::ClientFactory.AddUserAgent("pid-eb7927c8-dd66-43e1-b0cf-c346a422063")

Notitie

Het wordt aanbevolen de Azure Az PowerShell-module te gebruiken om te communiceren met Azure. Zie Azure PowerShell installeren om aan de slag te gaan. Raadpleeg Azure PowerShell migreren van AzureRM naar Az om te leren hoe u naar de Azure PowerShell-module migreert.

Voorbeeld: Azure CLI

Wanneer u de Azure CLI gebruikt om uw GUID toe te voegen, stelt u de AZURE_HTTP_USER_AGENT omgevingsvariabele in binnen het bereik van een script. U kunt de variabele ook globaal instellen voor shell-bereik:

export AZURE_HTTP_USER_AGENT='pid-eb7927c8-dd66-43e1-b0cf-c346a422063'

Zie Azure SDK voor Go voor meer informatie.

Terraform gebruiken

Ondersteuning voor Terraform is beschikbaar via de versie 1.21.0 van de Azure-provider: https://github.com/terraform-providers/terraform-provider-azurerm/blob/master/CHANGELOG.md#1210-january-11-2019. Dit geldt voor alle partners die hun oplossing implementeren via Terraform en alle resources die zijn geïmplementeerd en naar gebruik worden gebracht door de Azure-provider (versie 1.21.0 of hoger).

Azure-provider voor Terraform heeft een nieuw optioneel veld toegevoegd met de naam partner_id voor het opgeven van de tracerings-GUID die voor uw oplossing wordt gebruikt. De waarde van dit veld kan ook worden opgehaald uit de omgevingsvariabele ARM_PARTNER_ID .

provider "azurerm" {
          subscription_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
          client_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
          ……
          # new stuff for ISV attribution
          partner_id = "xxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"}

Belangrijk

Als u Terraform gebruikt met een Azure-app in de commerciële marketplace, gebruikt u de volledige tracerings-id die is opgegeven in partnercentrum. Gebruik GEEN GUID.

Ondersteuning krijgen

Meer informatie over de ondersteuningsopties in de commerciële marketplace op Ondersteuning voor het commerciële marketplace-programma in Partnercentrum.

Een verzoek om technische raadpleging indienen

Ga naar Partner Technical Services.
Selecteer Cloudinfrastructuur en -beheer om het technische traject weer te geven.
Selecteer Deployment Services>Dien een aanvraag in.
Meld u aan met uw MSA -account (Microsoft AI Cloud Partner Program) of uw Microsoft Entra-id (partnerdashboardaccount).
Vul de contactgegevens in of bekijk de contactgegevens in het formulier dat wordt geopend. De raadplegingsgegevens zijn mogelijk vooraf ingevuld of u hebt mogelijk vervolgkeuzelijsten.
Voer een titel en een gedetailleerde beschrijving van het probleem in.
Selecteer Indienen.

Bekijk stapsgewijze instructies met schermopnamen bij Using Technical Presales and Deployment Services.

U wordt gecontacteerd door een technische consultant van Microsoft Partner om een oproep in te stellen om uw behoeften te bepalen.

Veelgestelde vragen

Kan een tracerings-id worden gewijzigd nadat een tracerings-id is toegevoegd?

Tracerings-id's voor Azure-apps in de commerciële marketplace worden automatisch beheerd door partnercentrum. Een klant kan echter een sjabloon downloaden en de tracerings-id wijzigen of verwijderen. Partners moeten proactief de rol van de tracerings-id aan hun klanten beschrijven om verwijdering of bewerkingen te voorkomen. Het wijzigen van de tracerings-id is alleen van invloed op nieuwe implementaties en resources, niet op bestaande implementaties.

Kan ik sjablonen bijhouden die zijn geïmplementeerd vanuit een niet-Microsoft-opslagplaats, zoals GitHub?

Ja, zolang de tracerings-id aanwezig is wanneer de sjabloon wordt geïmplementeerd, wordt het gebruik bijgehouden. Als u de koppeling tussen u als uitgever en uw sjabloon wilt onderhouden die is geïmplementeerd vanuit een niet-Microsoft-opslagplaats, downloadt u eerst een kopie van uw gepubliceerde sjabloon (die de tracerings-id bevat) van de vermelding in de commerciële marketplace van uw aanbieding in Azure Portal. Publiceer die versie naar GitHub of een andere niet-Microsoft-opslagplaats.

Als uw sjabloon niet wordt vermeld in de commerciële marketplace en een geregistreerde GUID bevat, controleert u of de GUID aanwezig is in de versie die u publiceert naar GitHub of een andere niet-Microsoft-opslagplaats.

Nee Microsoft deelt geen azure-verbruiksgegevens die extern worden bijgehouden via klantgebruiksvermelding met partners.

Ontvangen klanten rapportage over klantgebruiksvermeldingen?

Nee Klanten kunnen hun gebruik van alle resources of resourcegroepen in Azure Portal bijhouden. Klanten zien het gebruik niet uitgesplitsd door tracerings-id van klantgebruiksvermeldingen.

Is toeschrijving van klantgebruik vergelijkbaar met de digitale partner van record (DPOR) of partnerbeheerderkoppeling (PAL)?

Toeschrijving van klantgebruik is een mechanisme om Azure-gebruik te koppelen aan het herhaalbare, implementeerbare IP-adres van een partner, dat de koppeling vormt tijdens de implementatie. DPOR en PAL zijn bedoeld om een adviespartner (Systeemintegrator) of beheerpartner (Managed Service Provider) te koppelen aan de relevante Azure-footprint van een klant terwijl de partner betrokken is bij de klant.

Delen via

Toeschrijving van Azure-klantgebruik

Azure-apps voor commerciële marketplace

Andere gebruiksvoorbeelden

GUID's maken

GUID's registreren

Een GUID toevoegen aan een Resource Manager-sjabloon

Implementaties controleren die zijn bijgehouden met een GUID

Uw klanten op de hoogte stellen

Melding voor Resource Manager-sjabloonimplementaties

Melding voor SDK- of API-implementaties

Resource Manager-API's gebruiken

Voorbeeld: Python SDK

Voorbeeld: .NET SDK

Voorbeeld: Azure PowerShell

Voorbeeld: Azure CLI

Terraform gebruiken

Ondersteuning krijgen

Een verzoek om technische raadpleging indienen

Veelgestelde vragen

Kan een tracerings-id worden gewijzigd nadat een tracerings-id is toegevoegd?

Kan ik sjablonen bijhouden die zijn geïmplementeerd vanuit een niet-Microsoft-opslagplaats, zoals GitHub?

Ontvangen klanten rapportage over klantgebruiksvermeldingen?

Is toeschrijving van klantgebruik vergelijkbaar met de digitale partner van record (DPOR) of partnerbeheerderkoppeling (PAL)?

Feedback

Aanvullende resources

Delen via

Toeschrijving van Azure-klantgebruik

Azure-apps voor commerciële marketplace

Andere gebruiksvoorbeelden

GUID's maken

GUID's registreren

Een GUID toevoegen aan een Resource Manager-sjabloon

Implementaties controleren die zijn bijgehouden met een GUID

Uw klanten op de hoogte stellen

Melding voor Resource Manager-sjabloonimplementaties

Melding voor SDK- of API-implementaties

Resource Manager-API's gebruiken

Voorbeeld: Python SDK

Voorbeeld: .NET SDK

Voorbeeld: Azure PowerShell

Voorbeeld: Azure CLI

Terraform gebruiken

Ondersteuning krijgen

Een verzoek om technische raadpleging indienen

Veelgestelde vragen

Kan een tracerings-id worden gewijzigd nadat een tracerings-id is toegevoegd?

Kan ik sjablonen bijhouden die zijn geïmplementeerd vanuit een niet-Microsoft-opslagplaats, zoals GitHub?

Deelt Microsoft gegevens over klantgebruiksvermelding met partners?

Ontvangen klanten rapportage over klantgebruiksvermeldingen?

Is toeschrijving van klantgebruik vergelijkbaar met de digitale partner van record (DPOR) of partnerbeheerderkoppeling (PAL)?

Feedback

Aanvullende resources