Přisuzování využití zákazníků Azure

Článek
03/09/2025

Přisuzování využití zákazníka spojuje využití prostředků Azure ve zákaznických předplatných vytvořených při nasazení vaší IP s vámi jako partnerem. Vytvoření těchto přidružení v interních systémech Microsoftu přináší větší interní přehled o využití azure, na kterém běží váš software. Pro nabídky aplikací Azure na komerčním marketplacevám tato funkce sledování pomůže sladit se s prodejními týmy Microsoftu a získat uznání pro partnerské programy Microsoftu. Přisuzování využití zákazníků se nevztahuje na nabídky virtuálních počítačů Azure na komerčním trhu. Vydavatel marketplace nemusí pro nabídky virtuálních počítačů dělat nic, aby se zajistilo, že jejich spotřeba Azure bude sledována v předplatných koncových zákazníků.

Přiřazení používání zákazníkem podporuje tři možnosti nasazení:

Šablony Azure Resource Manageru (společné základy aplikací Azure, označované také na komerčním marketplace jako "šablony řešení" nebo "spravované aplikace"): Partneři vytvářejí šablony Resource Manageru, které definují infrastrukturu a konfiguraci jejich řešení Azure. Šablona Resource Manageru umožňuje zákazníkům nasadit prostředky vašeho řešení v konzistentním a opakovatelném stavu.
Rozhraní API Azure Resource Manageru: Partneři můžou volat rozhraní API Resource Manageru pro nasazení šablony Resource Manageru nebo přímé zřizování služeb Azure.
Terraform: Partneři můžou pomocí Terraformu nasadit šablonu Resource Manageru nebo přímo nasadit služby Azure.

Viz sekundární případy použití dále v tomto článku pro přiřazení využití zákazníků mimo komerční trh.

Důležitý

Přisuzování využití zákazníků není určeno ke sledování práce integrátorů systémů, poskytovatelů spravovaných služeb nebo nástrojů určených primárně k nasazení a správě prostředků Azure.
Přiřazení využití zákazníkem je určeno pro nová nasazení a nepodporuje sledování prostředků, které již byly nasazeny.
- Ne všechny služby Azure jsou kompatibilní s přisouzením využití zákazníků. Azure Kubernetes Services (AKS), VM Scale Sets a Azure Batch mají známé problémy, které způsobují nedostatečné vykazování využití.
- Data o využití zákazníků v Azure se externě nesdílí s partnery.

Aplikace Azure na komerčním marketplace

Sledování využití Azure z aplikací Azure publikovaných na komerčním marketplace je z velké části automatické. Když nahrajete šablonu Resource Manageru jako součást technické konfigurace plánu aplikace Azure marketplace, Partnerské centrum přidá ID sledování čitelné pomocí Azure Resource Manageru.

Poznámka

Aby se zajistilo, že je využití vaší aplikace v našich systémech přesně přiřazené:

Pokud definujete sledovací ID v typu prostředku Microsoft.Resources/deployment a používáte proměnnou, nahraďte ji sledovacím ID, které je viditelné v Partner Center na stránce Technical Configuration (viz Přidání identifikátoru GUID do šablony Resource Manageru níže).
Pokud vaše šablona Resource Manageru používá prostředky typu Microsoft.Resources/deployments pro jiné účely než přisuzování využití zákazníka, Microsoft nebude za vás moct přidat ID sledování využití zákazníka. Přidejte nový prostředek typu Microsoft.Resources/deployments a přidejte ID sledování viditelné v Partnerském centru na stránce Technické konfigurace plánu (viz Přidání identifikátoru GUID do šablony Resource Manageru níže).

Pokud používáte rozhraní API Azure Resource Manageru, budete muset podle níže uvedených pokynů přidat své ID sledování a předat ho do Azure Resource Manageru při nasazování prostředků. Toto ID je viditelné v Partnerském centru na stránce Technické konfigurace plánu aplikace Azure.

Poznámka

U stávajících aplikací Azure byla v březnu 2021 spuštěna jednorázová migrace pro aktualizaci ID sledování v technické konfiguraci každého plánu. Využití z minulých nasazení těchto nabídek zůstane sledováno v systémech Microsoftu.

Při aktualizaci nabídek již není potřeba do hlavního souboru šablony přidávat Microsoft.Resources/deployments jako typ prostředku.

Jiné případy použití

Přisuzování využití zákazníků můžete použít ke sledování využití řešení Azure, která nejsou dostupná na komerčním marketplace. Tato řešení se obvykle nacházejí v repozitáři Quickstart, soukromých úložištích na GitHubu nebo pocházejí z 1:1 spoluprací se zákazníky, které vytvářejí odolné duševní vlastnictví (například nasaditelnou a škálovatelnou aplikaci).

Vyžaduje se několik ručních kroků:

Vytvořte jedno nebo více identifikátorů GUID, které se použijí jako ID sledování.
Zaregistrujte tyto identifikátory GUID v Partnerském centru.
Přidejte zaregistrované identifikátory GUID do vaší aplikace Azure a/nebo řetězců uživatelského agenta.

Vytvořte GUIDy

Na rozdíl od ID sledování, která Partnerské Centrum vytváří vaším jménem pro aplikace Azure na komerčním marketplace, jiná využití přiřazení využití zákazníků vyžadují, abyste vytvořili GUID, který se použije jako ID sledování. Identifikátor GUID je jedinečný identifikátor odkazu, který má 32 šestnáctkových číslic. Pokud chcete vytvořit identifikátory GUID pro sledování, měli byste použít generátor GUID, například přes PowerShell:

[guid]::NewGuid()

Pro každý produkt a distribuční kanál byste měli vytvořit jedinečný identifikátor GUID. Pokud nechcete mít rozdělené sestavy, můžete pro distribuční kanály produktu použít jediný identifikátor GUID. Vykazování probíhá podle ID partnera a identifikátoru GUID.

Registrace identifikátorů GUID

Identifikátory GUID musí být registrovány v Partner Center, aby se k vám mohly přidružit v roli partnera.

Přihlaste se k partnerskému centru .
Zaregistrujte se jako vydavatel komerčního tržiště .
V pravém horním rohu vyberte Nastavení (ikona ozubeného kola) a pak Nastavení účtu.
Vyberte profil organizace>identifikátory>Přidat identifikátor GUID sledování.
Do pole GUID zadejte váš sledovací identifikátor GUID. Zadejte pouze identifikátor GUID bez předpony pid-. Do pole Popis zadejte název nebo popis řešení.
Pokud chcete zaregistrovat více než jeden identifikátor GUID, znovu vyberte Přidat identifikátor GUID sledování. Na stránce se zobrazí další pole.
Vyberte Uložit.

Přidání identifikátoru GUID do šablony Resource Manageru

Pokud chcete přidat zaregistrovaný identifikátor GUID do šablony Resource Manageru, proveďte jednu změnu hlavního souboru šablony:

Otevřete šablonu Resource Manageru.
Do hlavního souboru šablony přidejte nový prostředek typu Microsoft.Resources/deployments. Prostředek musí být jenom v souboru mainTemplate.json nebo azuredeploy.json, nikoli vnořených nebo propojených šablonách.
Jako název prostředku zadejte hodnotu GUID za předponu pid-. Pokud je například identifikátor GUID eb7927c8-dd66-43e1-b0cf-c346a422063, název prostředku bude pid-eb7927c8-dd66-43e1-b0cf-c346a422063. Příklad:

{ // 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

Zkontrolujte chyby v šabloně.
Znovu publikujte šablonu v příslušných úložištích.
Ověřit úspěch identifikátoru GUID v nasazení šablony.

Spropitné

Další informace o vytváření a publikování šablon Resource Manageru najdete v tématu: vytvoření a nasazení první šablony Resource Manageru.

Ověřte sledovaná nasazení pomocí identifikátoru GUID

Po úpravě šablony a spuštění testovacího nasazení použijte následující skript PowerShellu k načtení prostředků, které jste nasadili a označili.

Skript můžete použít k ověření úspěšného přidání identifikátoru GUID do šablony Resource Manageru. Skript se nevztahuje na nasazení Api Resource Manageru ani Terraformu.

Přihlaste se k Azure. Před spuštěním skriptu vyberte předplatné s nasazením, které chcete ověřit. Spusťte skript v kontextu předplatného nasazení.

Požadované parametry jsou guid (níže označované jako deploymentName) a resourceGroupName název nasazení.

Původní skript Verify-DeploymentGuid můžete získat na GitHubu.

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
}

Upozorněte zákazníky

Partneři by měli informovat zákazníky o nasazeních, která používají přisuzování využití zákazníků. Následující příklady zahrnují obsah, který můžete použít k oznámení zákazníkům o těchto nasazeních. V příkladech nahraďte <PARTNER> názvem vaší společnosti. Partneři by měli zajistit, aby oznámení odpovídalo zásadám ochrany osobních údajů a shromažďování dat, včetně možností, které mají zákazníci vyloučit ze sledování.

Oznámení pro nasazení šablon Resource Manageru

Při nasazení této šablony může Microsoft identifikovat instalaci softwaru <PARTNER> s nasazenými prostředky Azure. Microsoft může tyto prostředky korelovat k podpoře softwaru. Společnost Microsoft tyto informace shromažďuje, aby poskytovala co nejlepší možnosti pro své produkty a provoz firmy. Data se shromažďují a řídí zásadami ochrany osobních údajů společnosti Microsoft, které se nacházejí v https://www.microsoft.com/trustcenter.

Oznámení pro nasazení sady SDK nebo rozhraní API

Při nasazování softwaru <PARTNER> dokáže Microsoft identifikovat instalaci softwaru <PARTNER> s nasazenými prostředky Azure. Microsoft může tyto prostředky korelovat k podpoře softwaru. Společnost Microsoft tyto informace shromažďuje, aby poskytovala co nejlepší možnosti pro své produkty a provoz firmy. Data se shromažďují a řídí zásadami ochrany osobních údajů společnosti Microsoft, které se nacházejí v https://www.microsoft.com/trustcenter.

Použití rozhraní API Resource Manageru

V některých případech můžete provádět volání přímo vůči rozhraním REST API Resource Manageru pro nasazení služeb Azure. Azure podporuje více sad SDK, aby bylo možné tato volání povolit. K nasazení prostředků můžete použít jednu z SDK nebo přímo volat API REST.

Pokud chcete povolit přisuzování využití zákazníků, při návrhu volání rozhraní API zahrňte id sledování do hlavičky uživatelského agenta v požadavku. Naformátujte řetězec s předponou pid-. Příklady:

//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-"

Důležitý

Pokud používáte rozhraní API Resource Manageru s aplikací Azure na komerčním marketplace, použijte ID sledování zadané v Partnerském centru. Nepoužívejte identifikátor GUID.

Různé sady SDK pracují s rozhraními API Resource Manageru odlišně a budou vyžadovat určité rozdíly v kódu. Následující příklady ukazují nekomerční přístup k trhu pomocí identifikátoru GUID a pokrývají různé oblíbené sady SDK pro Azure.

Příklad: Python SDK

Použijte atribut konfigurace pro Python. Atribut můžete přidat pouze do useragentu. Příklad:

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

Důležitý

Přidejte atribut pro každého klienta. Neexistuje žádná globální statická konfigurace. Můžete označit továrnu klientů, abyste zajistili sledování každého klienta. Další informace najdete v ukázce továrny klienta na GitHubu .

Příklad: .NET SDK

Pro .NET nezapomeňte nastavit uživatelského agenta. Pomocí knihovny Microsoft.Azure.Management.Fluent nastavte uživatelského agenta následujícím kódem (příklad v jazyce 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>");

Důležitý

Od června 2023 se teď archivuje nejnovější verze sady .NET SDK partnerského centra 3.4.0. Verzi sady SDK můžete stáhnout z GitHubuspolečně s souborem readme, který obsahuje užitečné informace.

Doporučujeme, aby partneři nadále používali rozhraní REST API Partnerského centra.

Příklad: Azure PowerShell

Pokud nasadíte prostředky přes Azure PowerShell, připojte identifikátor GUID pomocí této metody:

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

Poznámka

K interakci s Azure doporučujeme použít modul Azure Az PowerShell. Viz Instalace Azure PowerShell, abyste mohli začít. Informace o migraci do modulu Az PowerShell najdete v tématu Migrace Azure PowerShellu z AzureRM na Az.

Příklad: Azure CLI

Pokud k připojení identifikátoru GUID použijete Azure CLI, nastavte proměnnou prostředí AZURE_HTTP_USER_AGENT v rozsahu skriptu. Proměnnou můžete také nastavit globálně pro shell prostředí:

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

Další informace najdete v tématu Azure SDK for Go.

Použití Terraformu

Podpora Terraformu je dostupná prostřednictvím verze 1.21.0 poskytovatele Azure: https://github.com/terraform-providers/terraform-provider-azurerm/blob/master/CHANGELOG.md#1210-january-11-2019. To platí pro všechny partnery, kteří nasazují své řešení přes Terraform a všechny prostředky nasazené a měřené poskytovatelem Azure (verze 1.21.0 nebo novější).

Zprostředkovatel Azure pro Terraform přidal nové volitelné pole s názvem partner_id pro zadání identifikátoru GUID sledování používaného pro vaše řešení. Hodnotu tohoto pole lze také vytvořit z proměnné prostředí 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"}

Důležitý

Pokud používáte Terraform s aplikací Azure na komerčním marketplace, použijte celé ID sledování zadané v Partnerském centru. Nepoužívejte identifikátor GUID.

Získání podpory

Informace o možnostech podpory na komerčním marketplace najdete v tématu Podpora programu komerčního marketplace v Partnerském centru.

Jak odeslat žádost o technickou konzultaci

Navštivte technické služby pro partnery.
Pokud chcete zobrazit technickou cestu, vyberte cloudovou infrastrukturu a správu.
Vyberte Deployment Services>Odeslat žádost.
Přihlaste se pomocí účtu MSA (microsoft AI Cloud Partner Program) nebo svého účtu Microsoft Entra ID (účet partnerského řídicího panelu).
Vyplňte nebo zkontrolujte kontaktní informace ve formuláři, který se otevře. Podrobnosti o konzultaci mohou být předem vyplněny nebo můžete mít možnosti výběru z rozevíracího seznamu.
Zadejte název a podrobný popis problému.
Vyberte Odeslat.

Prohlédněte si podrobné pokyny se snímky obrazovky na Používání technických předprodejů a služeb nasazení.

Kontaktuje vás technický konzultant partnera Microsoftu, aby nastavil hovor, který bude odpovídat vašim potřebám.

FAQ

Po přidání ID sledování je možné ho změnit?

ID sledování aplikací Azure na komerčním Marketplace se spravují automaticky v Partner Center. Zákazník si ale může stáhnout šablonu a změnit nebo odebrat ID sledování. Partneři by měli proaktivně popsat roli ID sledování svým zákazníkům, aby zabránili odebrání nebo úpravám. Změna ID sledování má vliv jenom na nová nasazení a prostředky, nikoli existující.

Můžu sledovat šablony nasazené z jiného úložiště než Microsoftu, jako je GitHub?

Ano, pokud je ID sledování k dispozici při nasazení šablony, sleduje se využití. Pokud chcete zachovat přidružení mezi vámi jako vydavatelem a šablonou nasazenou z jiného úložiště než Microsoft, stáhněte si nejprve kopii publikované šablony (která bude obsahovat ID sledování) z výpisu komerčního marketplace vaší nabídky na webu Azure Portal. Publikujte ji do GitHubu nebo jiného úložiště jiného než Microsoftu.

Pokud vaše šablona není uvedená na komerčním marketplace a obsahuje zaregistrovaný identifikátor GUID, ujistěte se, že identifikátor GUID existuje ve verzi, kterou publikujete na GitHubu nebo jiném úložišti než Microsoft.

Ne. Microsoft nesdílí data o spotřebě Azure sledovaných prostřednictvím přisuzování využití zákazníků externě s partnery.

Dostávají zákazníci zprávy o využití zákazníky?

Ne. Zákazníci můžou sledovat využití všech prostředků nebo skupin prostředků na webu Azure Portal. Zákazníci nevidí využití rozčleněné podle sledovacího ID přiřazení využití zákazníka.

Je přiřazení využití zákazníků podobné digitálnímu partnerovi záznamu (DPOR) nebo odkazu na správce partnera (PAL)?

Přisuzování využití zákazníka je mechanismus přidružení využití Azure k opakovatelné a nasaditelné IP adrese partnera, která tvoří přidružení v době nasazení. DPOR a PAL jsou určeny k přidružení partnera pro poradenství (integrátor systémů) nebo správu (poskytovatel spravovaných služeb) k relevantnímu využití Azure zákazníka po dobu, kdy se partner zabývá zákazníkem.

Sdílet prostřednictvím

Přisuzování využití zákazníků Azure

Aplikace Azure na komerčním marketplace

Jiné případy použití

Vytvořte GUIDy

Registrace identifikátorů GUID

Přidání identifikátoru GUID do šablony Resource Manageru

Ověřte sledovaná nasazení pomocí identifikátoru GUID

Upozorněte zákazníky

Oznámení pro nasazení šablon Resource Manageru

Oznámení pro nasazení sady SDK nebo rozhraní API

Použití rozhraní API Resource Manageru

Příklad: Python SDK

Příklad: .NET SDK

Příklad: Azure PowerShell

Příklad: Azure CLI

Použití Terraformu

Získání podpory

Jak odeslat žádost o technickou konzultaci

FAQ

Po přidání ID sledování je možné ho změnit?

Můžu sledovat šablony nasazené z jiného úložiště než Microsoftu, jako je GitHub?

Dostávají zákazníci zprávy o využití zákazníky?

Je přiřazení využití zákazníků podobné digitálnímu partnerovi záznamu (DPOR) nebo odkazu na správce partnera (PAL)?

Váš názor

Další materiály

Sdílet prostřednictvím

Přisuzování využití zákazníků Azure

Aplikace Azure na komerčním marketplace

Jiné případy použití

Vytvořte GUIDy

Registrace identifikátorů GUID

Přidání identifikátoru GUID do šablony Resource Manageru

Ověřte sledovaná nasazení pomocí identifikátoru GUID

Upozorněte zákazníky

Oznámení pro nasazení šablon Resource Manageru

Oznámení pro nasazení sady SDK nebo rozhraní API

Použití rozhraní API Resource Manageru

Příklad: Python SDK

Příklad: .NET SDK

Příklad: Azure PowerShell

Příklad: Azure CLI

Použití Terraformu

Získání podpory

Jak odeslat žádost o technickou konzultaci

FAQ

Po přidání ID sledování je možné ho změnit?

Můžu sledovat šablony nasazené z jiného úložiště než Microsoftu, jako je GitHub?

Sdílí Microsoft data o přisuzování využití zákazníků s partnery?

Dostávají zákazníci zprávy o využití zákazníky?

Je přiřazení využití zákazníků podobné digitálnímu partnerovi záznamu (DPOR) nebo odkazu na správce partnera (PAL)?

Váš názor

Další materiály