Programmgesteuertes Erstellen von Azure-Abonnements mit Legacy-APIs

In diesem Artikel wird erläutert, wie Sie mithilfe unserer Legacy-Vorschau-API programmgesteuert Azure-Abonnements erstellen. Dieser Artikel enthält Informationen zum programmgesteuerten Erstellen von Abonnements mithilfe von Azure Resource Manager.

Es gibt neue Artikel für die aktuelle API-Version zur Verwendung mit verschiedenen Abonnementtypen für Azure-Vereinbarungen:

Wenn Sie nicht die neueste API-Version nutzen möchten, können Sie jedoch weiterhin die Informationen in diesem Artikel verwenden.

Azure-Kunden mit einem Abrechnungskonto für die folgenden Vereinbarungstypen können Abonnements programmgesteuert erstellen:

  • Unternehmensvereinbarung
  • Microsoft-Kundenvereinbarung (Microsoft-Kundenvereinbarung, MCA)
  • Microsoft-Partnervereinbarung (MPA)

Wenn Sie ein Azure-Abonnement programmgesteuert erstellen, unterliegt es der Vereinbarung, auf deren Grundlage Sie Azure-Dienste von Microsoft oder einem autorisierten Handelspartner erhalten haben. Weitere Informationen finden Sie unter Rechtliche Hinweise zu Microsoft Azure.

Hinweis

Es wird empfohlen, das Azure Az PowerShell-Modul für die Interaktion mit Azure zu verwenden. Zum Einstieg siehe Installieren von Azure PowerShell. Informationen zum Migrieren zum Az PowerShell-Modul finden Sie unter Migrieren von Azure PowerShell von AzureRM zum Az-Modul.

Supportpläne können nicht programmgesteuert erstellt werden. Sie können einen neuen Supportplan kaufen oder einen bestehenden Supportplan im Azure-Portal aktualisieren. Navigieren Sie zur Hilfe + Support, und wählen Sie dann oben auf der Seite Den richtigen Supportplan auswählen aus.

Abonnements für ein EA-Abrechnungskonto erstellen

Verwenden Sie die Informationen in den folgenden Abschnitten, um EA-Abonnements zu erstellen.

Voraussetzungen

Sie müssen über eine Besitzerrolle für ein Enrollment-Konto verfügen oder ein Enterprise-Administrator sein, um ein Abonnement zu erstellen. Es gibt zwei Möglichkeiten, wie Sie die Rolle erhalten:

Konten finden, auf die Sie Zugriff haben

Nachdem Sie einem Registrierungskonto hinzugefügt wurden, das einem Kontobesitzer zugeordnet ist, verwendet Azure die Beziehung zwischen dem Konto und der Registrierung, um zu bestimmen, wo die Abonnementgebühren in Rechnung gestellt werden sollen. Alle Abonnements, die unter dem Vertrag erstellt werden, werden dem EA-Enrollment in Rechnung gestellt, in dem sich der Vertrag befindet. Um Abonnements zu erstellen, müssen Sie Werte zum Enrollment-Konto und den Benutzerprinzipalen als Besitzer des Abonnements übergeben.

Um die folgenden Befehle ausführen zu können, müssen Sie im Home-Verzeichnis des Kontobesitzers angemeldet sein. Dies ist das Verzeichnis, in dem Abonnements standardmäßig erstellt werden.

Fordern Sie eine Liste aller Konten für die Registrierung an, auf die Sie Zugriff haben:

GET https://management.azure.com/providers/Microsoft.Billing/enrollmentAccounts?api-version=2018-03-01-preview

In der API-Antwort sind alle Enrollment-Konten aufgelistet, auf die Sie Zugriff haben:

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/enrollmentAccounts/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "name": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "type": "Microsoft.Billing/enrollmentAccounts",
      "properties": {
        "principalName": "SignUpEngineering@contoso.com"
      }
    },
    {
      "id": "/providers/Microsoft.Billing/enrollmentAccounts/4cd2fcf6-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "name": "4cd2fcf6-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "type": "Microsoft.Billing/enrollmentAccounts",
      "properties": {
        "principalName": "BillingPlatformTeam@contoso.com"
      }
    }
  ]
}

Verwenden Sie die principalName-Eigenschaft zum Identifizieren des Kontos, dem die Abonnements in Rechnung gestellt werden sollen. Kopieren Sie den name dieses Kontos. Wenn Sie beispielsweise Abonnements unter dem Anmeldungskonto SignUpEngineering@contoso.com erstellen möchten, kopieren Sie aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e. Der Bezeichner ist die Objekt-ID des Anmeldekontos. Fügen Sie den Wert irgendwo ein, damit Sie ihn im nächsten Schritt als enrollmentAccountObjectId verwenden können.

Erstellen von Abonnements unter einem bestimmten Enrollment-Konto

Im folgenden Beispiel wird ein Abonnement namens Dev Team Subscription im im vorherigen Schritt ausgewählten Registrierungskonto erstellt. Bei dem Abonnementangebot handelt es sich um MS-AZR-0017P (reguläres Microsoft Enterprise Agreement). Es werden optional auch zwei Benutzer als Azure RBAC-Besitzer für das Abonnement hinzugefügt.

Führen Sie die folgende Anfrage aus, und ersetzen Sie dabei <enrollmentAccountObjectId> durch den name-Wert, den Sie im ersten Schritt (aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb) kopiert haben. Informationen zum Festlegen von Besitzern finden Sie unter wie Sie Benutzerobjekt-IDs abrufen.

POST https://management.azure.com/providers/Microsoft.Billing/enrollmentAccounts/<enrollmentAccountObjectId>/providers/Microsoft.Subscription/createSubscription?api-version=2018-03-01-preview

{
  "displayName": "Dev Team Subscription",
  "offerType": "MS-AZR-0017P",
  "owners": [
    {
      "objectId": "<userObjectId>"
    },
    {
      "objectId": "<servicePrincipalObjectId>"
    }
  ]
}
Elementname Erforderlich Typ BESCHREIBUNG
displayName Nein Schnur Der Anzeigename des Abonnements. Wenn kein Name angegeben wird, wird er auf den Namen des Angebots festgelegt, z. B. „Microsoft Azure Enterprise“.
offerType Ja Schnur Das Angebot des Abonnements. Die beiden Optionen für EA sind MS-AZR-0017P- (Produktionsverwendung) und MS-AZR-0148P (Dev/Test, muss im Azure-Portal aktiviert sein).
owners Nein Schnur Die Objekt-ID eines Benutzers, den Sie als Azure RBAC-Besitzer für das Abonnement hinzufügen möchten, wenn es erstellt wird

In der Antwort wird als Teil des Headers Location eine URL zurückgegeben, über die Sie den Status des Erstellens des Abonnements abfragen können. Nach Abschluss der Abonnementerstellung wird durch einen GET auf Location ein Objekt vom Typ subscriptionLink zurückgegeben, das die Abonnement-ID enthält. Ausführlichere Informationen finden Sie in der Dokumentation zur Abonnement-API.

Einschränkungen der Azure Enterprise-Abonnementerstellungs-API

  • Nur Azure Enterprise-Abonnements können mithilfe der API erstellt werden.
  • Pro Registrierungskonto sind maximal 5000 Abonnements zulässig. Im Anschluss können weitere Abonnements für das Konto nur über das Azure-Portal erstellt werden. Wenn Sie über die API weitere Abonnements erstellen möchten, erstellen Sie ein weiteres Enrollment-Konto. Abgebrochene, gelöschte und übertragene Abonnements werden auf den Grenzwert von 5000 angerechnet.
  • Benutzer, die keine Kontobesitzer sind, aber per Azure RBAC einem Registrierungskonto hinzugefügt wurden, können über das Azure-Portal keine Abonnements erstellen.
  • Sie können den Mandanten nicht auswählen, in dem das Abonnement erstellt werden soll. Das Abonnement wird immer im Basismandanten des Kontobesitzers erstellt. Wenn Sie das Abonnement in einen anderen Mandanten verschieben möchten, finden Sie weitere Informationen unter Ändern des Abonnementmandanten.

Abonnements für ein MCA-Konto erstellen

Verwenden Sie die Informationen in den folgenden Abschnitten, um Subscriptions für ein MCA-Konto zu erstellen.

Voraussetzungen

Sie müssen über die Rolle „Besitzer“, „Mitwirkender“ oder „Azure-Abonnementersteller“ für einen Rechnungsabschnitt oder die Rolle „Besitzer“ oder „Mitwirkender“ für ein Abrechnungsprofil oder -konto verfügen, um Abonnements erstellen zu können. Weitere Informationen finden Sie unter Rollen und Aufgaben für die Abonnementabrechnung.

In den folgenden Beispielen werden REST-APIs verwendet. PowerShell und Azure CLI werden derzeit nicht unterstützt.

Suchen nach Abrechnungskonten, auf die Sie Zugriff haben

Senden Sie die folgende Anforderung, um alle Abrechnungskonten aufzulisten:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview

In der API-Antwort sind die Abrechnungskonten aufgeführt, auf die Sie Zugriff haben.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "name": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "accountStatus": "Active",
        "accountType": "Enterprise",
        "agreementType": "MicrosoftCustomerAgreement",
        "displayName": "Contoso",
        "hasReadAccess": true,
        "organizationId": "41b29574-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
      },
      "type": "Microsoft.Billing/billingAccounts"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "name": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "accountStatus": "Active",
        "accountType": "Enterprise",
        "agreementType": "MicrosoftCustomerAgreement",
        "displayName": "Fabrikam",
        "hasReadAccess": true,
        "organizationId": "41b29574-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
      },
      "type": "Microsoft.Billing/billingAccounts"
    }
  ]
}

Verwenden Sie die displayName-Eigenschaft, um das Abrechnungskonto zu identifizieren, für das Sie Abonnements erstellen möchten. Vergewissern Sie sich, dass als „agreementType“ des Kontos die Option MicrosoftCustomerAgreement festgelegt ist. Kopieren Sie das name des Kontos. Wenn Sie beispielsweise ein Abonnement für das Abrechnungskonto Contoso erstellen möchten, kopieren Sie bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx. Fügen Sie den Wert an einer Stelle ein, damit Sie ihn im nächsten Schritt verwenden können.

Rechnungspositionen finden, um Abonnements zu erstellen

Die Gebühren für Ihr Abonnement werden in einem Abschnitt der Rechnung eines Abrechnungsprofils angezeigt. Verwenden Sie die folgende API, um die Liste mit den Rechnungsabschnitten und Abrechnungsprofilen abzurufen, für die Sie über die Berechtigung zum Erstellen von Azure-Abonnements verfügen.

Führen Sie die folgende Anforderung aus, und ersetzen Sie dabei <billingAccountName> durch den name-Wert, den Sie im ersten Schritt (bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx) kopiert haben.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<billingAccountName>/listInvoiceSectionsWithCreateSubscriptionPermission?api-version=2019-10-01-preview

In der API-Antwort sind alle Rechnungsabschnitte und die zugehörigen Abrechnungsprofile aufgelistet, für die Sie über Zugriff zum Erstellen von Abonnements verfügen:

{
    "value": [{
        "billingProfileDisplayName": "Contoso finance",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx",
        "enabledAzurePlans": [{
            "productId": "DZH318Z0BPS6",
            "skuId": "0001",
            "skuDescription": "Microsoft Azure Plan"
        }, {
            "productId": "DZH318Z0BPS6",
            "skuId": "0002",
            "skuDescription": "Microsoft Azure Plan for DevTest"
        }],
        "invoiceSectionDisplayName": "Development",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx/invoiceSections/GJ77-xxxx-xxx-xxx"
    }, {
        "billingProfileDisplayName": "Contoso finance",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-xxxx-xxx-xxx",
        "enabledAzurePlans": [{
            "productId": "DZH318Z0BPS6",
            "skuId": "0001",
            "skuDescription": "Microsoft Azure Plan"
        }, {
            "productId": "DZH318Z0BPS6",
            "skuId": "0002",
            "skuDescription": "Microsoft Azure Plan for DevTest"
        }],
        "invoiceSectionDisplayName": "Testing",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX"
  }]
}

Verwenden Sie die invoiceSectionDisplayName-Eigenschaft, um den Rechnungsabschnitt zu identifizieren, für den Sie Abonnements erstellen möchten. Kopieren Sie die Elemente invoiceSectionId und billingProfileId sowie eines der skuId-Elemente für den Rechnungsbereich. Wenn Sie beispielsweise ein Abonnement des Typs Microsoft Azure plan für den Rechnungsabschnitt Development erstellen möchten, kopieren Sie /providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX, /providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-xxxx-xxx-xxx und 0001. Fügen Sie die Werte irgendwo ein, damit Sie sie im nächsten Schritt verwenden können.

Abonnement für einen Rechnungsbereich erstellen

Im folgenden Beispiel wird ein Abonnement mit dem Namen Dev Team subscription vom Typ Microsoft Azure Plan für den Rechnungsabschnitt Development erstellt. Die Kosten für das Abonnement werden dem Abrechnungsprofil von Contoso finance in Rechnung gestellt und im Abschnitt Development der Rechnung aufgeführt.

Führen Sie die folgende Anfrage aus, und ersetzen Sie dabei <invoiceSectionId> durch den invoiceSectionId-Wert, den Sie im zweiten Schritt kopiert haben (/providers/Microsoft.Billing/billingAccounts/bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX). Übergeben Sie die Elemente billingProfileId und skuId, die aus dem zweiten Schritt kopiert wurden, in den Anforderungsparametern der API. Informationen zum Festlegen von Besitzern finden Sie unter wie Sie Benutzerobjekt-IDs abrufen.

POST https://management.azure.com<invoiceSectionId>/providers/Microsoft.Subscription/createSubscription?api-version=2018-11-01-preview

'{"displayName": "Dev Team subscription",
  "billingProfileId": "<billingProfileId>",
  "skuId": "<skuId>",
  "owners": [
      {
        "objectId": "<userObjectId>"
      },
      {
        "objectId": "<servicePrincipalObjectId>"
      }
    ],
  "costCenter": "35683",
  "managementGroupId": "/providers/Microsoft.Management/managementGroups/xxxxxxx",",
}'
Elementname Erforderlich Typ BESCHREIBUNG
displayName Ja Schnur Der Anzeigename des Abonnements.
billingProfileId Ja Schnur Die ID des Abrechnungsprofils, dem die Gebühren für das Abonnement berechnet werden
skuId Ja Schnur Die SKU-ID, die den Typ des Azure-Plans bestimmt.
owners Nein Schnur Die Objekt-ID eines beliebigen Benutzers oder Dienstprinzipals, den Sie bei der Erstellung als Azure RBAC-Besitzer für das Abonnement hinzufügen möchten
costCenter Nein Schnur Die Kostenstelle, die dem Abonnement zugeordnet ist. Sie wird in der CSV-Datei zur Nutzungsauswertung angezeigt.
managementGroupId Nein Schnur Die ID der Verwaltungsgruppe, zu der das Abonnement hinzugefügt wird. Um die Liste der Management Groups abzurufen, siehe Management Groups - List API. Verwenden Sie die ID einer Verwaltungsgruppe über die API.

In der Antwort wird ein subscriptionCreationResult-Objekt für die Überwachung zurückgegeben. Nach Abschluss der Erstellung des Abonnements gibt das subscriptionCreationResult-Objekt ein subscriptionLink-Objekt zurück, das die Abonnement-ID enthält.

Erstellen von Abonnements für ein Abrechnungskonto vom Typ „MPA“

Verwenden Sie die Informationen in den folgenden Abschnitten, um Abonnements für ein MPA-Abrechnungskonto zu erstellen.

Voraussetzungen

Sie müssen im Cloud Solution Provider-Konto Ihrer Organisation über die Rolle „Admin-Agent“ verfügen, um ein Abonnement für Ihr Abrechnungskonto erstellen zu können. Weitere Informationen finden Sie unter Partner Center - Zuweisen von Rollen und Berechtigungen zu Benutzern.

In den folgenden Beispielen werden REST-APIs verwendet. PowerShell und Azure CLI werden derzeit nicht unterstützt.

Abrechnungskonten suchen, auf die Sie Zugriff haben

Verwenden Sie die unten angegebene Anforderung, um alle Abrechnungskonten aufzulisten, auf die Sie Zugriff haben.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview

In der API-Antwort sind die Abrechnungskonten aufgeführt.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "name": "cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "accountStatus": "Active",
        "accountType": "Enterprise",
        "agreementType": "MicrosoftPartnerAgreement",
        "displayName": "Contoso",
        "hasReadAccess": true,
        "organizationId": "1d100e69-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
      },
      "type": "Microsoft.Billing/billingAccounts"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "name": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
      "properties": {
        "accountId": "4f89e155-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "accountStatus": "Active",
        "accountType": "Enterprise",
        "agreementType": "MicrosoftCustomerAgreement",
        "displayName": "Fabrikam",
        "hasReadAccess": true,
        "organizationId": "1d100e69-xxxx-xxxx-xxxx-xxxxxxxxxxxxx_xxxx-xx-xx"
      },
      "type": "Microsoft.Billing/billingAccounts"
    }
  ]
}

Verwenden Sie die displayName-Eigenschaft, um das Abrechnungskonto zu identifizieren, für das Sie Abonnements erstellen möchten. Vergewissern Sie sich, dass als „agreementType“ des Kontos die Option MicrosoftPartnerAgreement festgelegt ist. Kopieren Sie name für das Konto. Wenn Sie beispielsweise ein Abonnement für das Abrechnungskonto Contoso erstellen möchten, kopieren Sie cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx. Fügen Sie den Wert irgendwo ein, damit Sie ihn im nächsten Schritt verwenden können.

Kunden mit Azure-Plänen suchen

Senden Sie die folgende Anforderung, indem Sie <billingAccountName> durch das name-Element aus dem ersten Schritt (bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx) ersetzen, um alle Kunden unter dem Abrechnungskonto aufzulisten, für die Sie Azure-Abonnements erstellen können.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/<billingAccountName>/customers?api-version=2019-10-01-preview

In der API-Antwort sind die Kunden des Abrechnungskontos aufgelistet, die über Azure-Pläne verfügen. Sie können Abonnements für die Kunden erstellen.

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b",
      "name": "dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b",
      "properties": {
        "billingProfileDisplayName": "Contoso USD",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/JUT6-xxxx-xxxx-xxxx",
        "displayName": "Fabrikam toys"
      },
      "type": "Microsoft.Billing/billingAccounts/customers"
    },
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/97c3fac4-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "name": "97c3fac4-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
      "properties": {
        "billingProfileDisplayName": "Fabrikam sports",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/billingProfiles/JUT6-xxxx-xxxx-xxxx",
        "displayName": "Fabrikam bakery"
      },
      "type": "Microsoft.Billing/billingAccounts/customers"
    }]
}

Verwenden Sie die displayName-Eigenschaft, um den Kunden zu identifizieren, für den Sie Abonnements erstellen möchten. Kopieren Sie die id für den Kunden. Wenn Sie beispielsweise ein Abonnement für Fabrikam toys erstellen möchten, kopieren Sie /providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b. Fügen Sie den Wert irgendwo ein, um ihn in späteren Schritten zu verwenden.

Optional für indirekte Anbieter: Abrufen der Wiederverkäufer für einen Kunden

Falls Sie im Rahmen des CSP-Zweistufenmodells als indirekter Anbieter fungieren, können Sie einen Wiederverkäufer angeben, während Sie Abonnements für Kunden erstellen.

Senden Sie die folgende Anfrage, indem Sie <customerId> durch die id aus dem zweiten Schritt (/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b) ersetzen, um alle Wiederverkäufer aufzulisten, die für einen Kunden verfügbar sind.

GET https://management.azure.com<customerId>?$expand=resellers&api-version=2019-10-01-preview

In der API-Antwort sind die Handelspartner für den Kunden aufgeführt:

{
  "value": [{
  "id": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2ed2c490-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "name": "2ed2c490-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "type": "Microsoft.Billing/billingAccounts/customers",
  "properties": {
    "displayName": "Fabrikam toys",
    "resellers": [
      {
        "resellerId": "3xxxxx",
        "description": "Wingtip"
      }
    ]
  }
},
{
  "id": "/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/4ed2c793-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "name": "4ed2c793-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "type": "Microsoft.Billing/billingAccounts/customers",
  "properties": {
    "displayName": "Fabrikam toys",
    "resellers": [
      {
        "resellerId": "5xxxxx",
        "description": "Tailspin"
      }
    ]
  }
}]
}

Verwenden Sie die description-Eigenschaft, um den Wiederverkäufer zu identifizieren, der dem Abonnement zugeordnet werden soll. Kopieren Sie die resellerId für den Handelspartner. Um beispielsweise Wingtip zuzuordnen, kopieren Sie 3xxxxx. Fügen Sie den Wert irgendwo ein, damit Sie ihn im nächsten Schritt verwenden können.

Abonnement für einen Kunden erstellen

Im folgenden Beispiel wird ein Abonnement mit dem Namen Dev Team subscription für Fabrikam toys erstellt, und anschließend wird dem Abonnement der Handelspartner Wingtip zugeordnet.

Führen Sie die folgende Anforderung aus, und ersetzen Sie dabei <customerId> durch den id-Wert, den Sie im zweiten Schritt kopiert haben (/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b). Übergeben Sie die optionale resellerId, die Sie aus dem zweiten Schritt kopiert haben, in den Anforderungsparametern der API.

POST https://management.azure.com<customerId>/providers/Microsoft.Subscription/createSubscription?api-version=2018-11-01-preview

'{"displayName": "Dev Team subscription",
  "skuId": "0001",
  "resellerId": "<resellerId>",
}'
Elementname Erforderlich Typ BESCHREIBUNG
displayName Ja Schnur Der Anzeigename des Abonnements.
skuId Ja Schnur Die SKU-ID des Azure-Plans. Verwenden Sie für Abonnements vom Typ „Microsoft Azure-Plan“ die ID 0001.
resellerId Nein Schnur Die ID des Handelspartners, der mit dem Abonnement verknüpft ist.

In der Antwort wird ein subscriptionCreationResult-Objekt für die Überwachung zurückgegeben. Nach Abschluss der Erstellung des Abonnements gibt das subscriptionCreationResult-Objekt ein subscriptionLink-Objekt zurück. Es hat die Abonnement-ID.

Nächste Schritte

  • Ein Beispiel zur Erstellung eines EA-Abonnements (Enterprise Agreement) mit .NET finden Sie unter Beispielcode auf GitHub.
  • Zuletzt aktualisiert um