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

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í:

1. Š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.
2. 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.
3. 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.

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.

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.

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ů:

1. Vytvořte jedno nebo více identifikátorů GUID, které se použijí jako ID sledování.
2. Zaregistrujte tyto identifikátory GUID v Partnerském centru.
3. 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:

1. Přihlaste se k Partnerskému centru.

2. Zaregistrujte se jako vydavatel komerčního marketplace.

3. V pravém horním rohu vyberte Nastavení (ikona ozubeného kola) a pak nastavení účtu.

4. Vyberte Identifikátory>profilu>organizace – Přidat identifikátory GUID sledování.

5. 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í.

6. 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.

7. 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:

1. Otevřete šablonu Resource Manageru.

2. 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.

3. 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

4. Zkontrolujte chyby v šabloně.

5. Znovu publikujte šablonu v příslušných úložištích.

6. Ověřte úspěch identifikátoru GUID v nasazení šablony.

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

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

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>");

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

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

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

1. Navštivte partnerské technické služby.
2. Výběrem cloudové infrastruktury a správy zobrazíte technickou cestu.
3. Vyberte Deployment Services>Submit a request.
4. Přihlaste se pomocí účtu MSA (microsoft AI Cloud Partner Program) nebo svého účtu Microsoft Entra ID (účet partnerského řídicího panelu).
5. 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.
6. Zadejte název a podrobný popis problému.
7. 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.

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

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.