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

Článek
06/14/2024

Přisuzování využití zákazníka přidruží využití prostředků Azure v zákaznických předplatných vytvořených při nasazování IP adresy s vámi jako partnera. 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. U nabídek Aplikace Azure lication na komerčním marketplace vám tato funkce sledování pomůže v souladu s prodejními týmy Microsoftu a získat kredit pro partnerské programy Microsoftu. Přiřazení využití zákazníků se nevztahuje na nabídky virtuálních počítačů Azure na komerčním marketplace. 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í využití zákazníka 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.

Další případy použití najdete dále v tomto článku o přiřazení využití zákazníků mimo komerční marketplace.

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íka je určené pro nová nasazení a nepodporuje sledování prostředků, které už 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é generování sestav o 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 ID sledování v typu prostředku Microsoft.Resources/deployment s proměnnou, nahraďte tuto proměnnou ID sledování viditelným 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 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ásledujících pokynů přidat ID sledování, abyste ho předali 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 lication.

Poznámka:

U stávajících aplikací Azure začala jednorázová migrace v březnu 2021 aktualizovat 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 už nemusíte do hlavního souboru šablony přidávat typ prostředku Microsoft.Resources/deployments .

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 úložišti Rychlého startu, privátních úložištích GitHubu nebo pocházejí z 1:1 zákaznických rezervací, které vytvářejí odolnou IP adresu (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 řetězců agenta Azure a/nebo uživatelského agenta.

Vytvoření identifikátorů GUID

Na rozdíl od ID sledování, která Partnerské centrum vytváří vaším jménem pro aplikace Azure na komerčním marketplace, vyžadují jiné použití přiřazení využití zákazníků k vytvoření identifikátoru 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 rozdělit sestavy, můžete pro více distribučních kanálů produktu použít jeden identifikátor GUID. Generování sestav probíhá podle ID partnera a identifikátoru GUID.

Registrace identifikátorů GUID

Identifikátory GUID musí být zaregistrované v Partnerském centru, aby se k vám mohly přidružit jako partner:

Přihlaste se k Partnerskému centru.
Zaregistrujte se jako vydavatel komerčního marketplace.
V pravém horním rohu vyberte Nastavení (ikona ozubeného kola) a pak nastavení účtu.
Vyberte Identifikátory>profilu>organizace – Přidat identifikátory GUID sledování.
Do pole GUID zadejte identifikátor GUID sledování. 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.
Zvolte 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 mainTemplate.json nebo azuredeploy.json souboru, ne v žádné vnořené nebo propojené šablony.
Jako název prostředku zadejte hodnotu GUID za pid- předponu. Pokud je například identifikátor GUID eb7927c8-dd66-43e1-b0cf-c346a422063, bude název prostředku 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ěřte úspěch identifikátoru GUID v nasazení šablony.

Tip

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

Ověření sledovaných 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 do 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 identifikátor GUID (níže označovaný jako deploymentName) a název resourceGroupName nasazení.

Můžete získat původní skript Verify-DeploymentGuid 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í na adrese https://www.microsoft.com/trustcenter.

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

Při nasazování <softwaru PARTNER> 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í na adrese 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. podpora Azure více sad SDK, aby bylo možné tato volání povolit. K nasazení prostředků můžete použít některou ze sad SDK nebo přímo volat rozhraní REST API.

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 obsahují neobchodní přístup k marketplace pomocí identifikátoru GUID a pokrývají celou řadu oblíbených sad Azure SDK.

Příklad: Python SDK

Pro Python použijte atribut konfigurace . 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 objekt pro vytváření klientů, abyste zajistili, že každý klient sleduje. Další informace najdete v této ukázce klientské továrny 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. Vydání sady SDK si můžete stáhnout z GitHubu spolu se souborem readme, který obsahuje užitečné informace.

Doporučujeme, aby partneři dál 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:

Při práci s Azure doporučujeme používat modul Azure Az PowerShellu. Začněte tím, že si projdete téma Instalace Azure PowerShellu. Informace o tom, jak migrovat na modul 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 obor 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ší).

Poskytovatel 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

Seznamte se s možnostmi podpory na komerčním marketplace na webu Support for the commercial marketplace program in Partner Center.

Jak odeslat žádost o technickou konzultaci

Navštivte partnerské technické služby.
Výběrem cloudové infrastruktury a správy zobrazíte technickou cestu.
Vyberte Deployment Services>Submit a request.
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 můžou být předem vyplněné nebo máte možnosti rozevíracího seznamu.
Zadejte název a podrobný popis problému.
Vyberte položku Odeslat.

Podrobné pokyny se snímky obrazovky najdete na webu Using Technical Presales and Deployment Services (Používání technických presales a služeb nasazení).

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

Často kladené dotazy

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 Partnerském centru. 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 sestavy přisuzování využití zákazníků?

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í rozdělené podle ID sledování 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ření identifikátorů GUID

Registrace identifikátorů GUID

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

Ověření sledovaných 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

Často kladené dotazy

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 sestavy přisuzování využití zákazníků?

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ření identifikátorů GUID

Registrace identifikátorů GUID

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

Ověření sledovaných 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

Často kladené dotazy

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 využití zákazníků s partnery?

Dostávají zákazníci sestavy přisuzování využití zákazníků?

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