Share via

Programmatisch Azure-abonnementen maken met verouderde API's

  • Artikel

Dit artikel helpt u programmatisch Azure-abonnementen te maken met behulp van onze verouderde preview-API. In dit artikel leert u hoe u via programmatisch abonnementen kunt maken met behulp van Azure Resource Manager.

Er zijn nieuwe artikelen over de nieuwste API-versie voor gebruik met verschillende abonnementstypen voor een Azure-overeenkomst:

U kunt de informatie in dit artikel echter nog steeds gebruiken, als u niet de meest recente API-versie wilt gebruiken.

Azure-klanten met een facturerings account voor de volgende overeenkomsttypen kunnen programmatisch abonnementen maken:

  • Enterprise Agreement
  • Microsoft-klantovereenkomst (MCA)
  • Microsoft Partner-overeenkomst (MPA)

Wanneer u programmatisch een Azure-abonnement maakt, wordt het abonnement beheerd op basis van de overeenkomst waaronder u Azure-services van Microsoft of een geautoriseerde wederverkoper hebt verkregen. Zie de Juridische informatie van Microsoft Azure voor meer informatie.

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.

U kunt geen ondersteuningsplannen programmatisch maken. U kunt een nieuw ondersteuningsplan kopen of een upgrade uitvoeren in Azure Portal. Navigeer naar Help en ondersteuning en selecteer vervolgens boven aan de pagina Het juiste ondersteuningsplan kiezen.

Abonnementen maken voor een EA-factureringsrekening

Gebruik de informatie in de volgende secties om EA-abonnementen te maken.

Vereisten

U moet een accounteigenaar voor een inschrijvingsaccount of een Enterprise-beheerder zijn om abonnementen te kunnen maken. U kunt de rol op twee manieren verkrijgen:

Accounts zoeken waartoe u toegang hebt

Wanneer u bent toegevoegd aan een inschrijvingsaccount dat is gekoppeld aan een accounteigenaar, wordt de relatie account-naar-inschrijving gebruikt om te bepalen waaraan de abonnementskosten moeten worden gefactureerd. Alle abonnementen die onder het account zijn gemaakt, worden gefactureerd aan de EA-inschrijving waarin het account zich bevindt. Als u abonnementen wilt maken, moet u waarden over het inschrijvingsaccount en de gebruiker-principals doorgeven om eigenaar van het abonnement te kunnen zijn.

Als u de volgende opdrachten wilt uitvoeren, moet u zijn aangemeld bij de basismap van de accounteigenaar. Dit is de map waarin standaard abonnementen worden gemaakt.

Vraag een opsomming aan van alle inschrijvingsaccounts waartoe u toegang hebt:

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

De API-respons vermeldt alle inschrijvingsaccounts waartoe u toegang hebt:

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

Gebruik de eigenschap principalName om het account te identificeren waarvoor abonnementen moeten worden gefactureerd. Kopieer de name van dat account. Als u bijvoorbeeld abonnementen wilt maken onder het inschrijvingsaccount SignUpEngineering@contoso.com, kopieert u aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e. De id is de object-id van het inschrijvingsaccount. Plak de waarde ergens, zodat u deze in de volgende stap als enrollmentAccountObjectId kunt gebruiken.

Abonnementen maken onder een specifiek inschrijvingsaccount

In het volgende voorbeeld wordt in het inschrijvingsaccount dat u in de vorige stap hebt geselecteerd, een abonnement gemaakt met de naam Dev Team Subscription. De aanbieding voor het abonnement MS-AZR-0017P (regulier Microsoft Enterprise Agreement). Optioneel worden twee gebruikers toegevoegd als Azure RBAC-eigenaren voor het abonnement.

Voer de volgende aanvraag uit en vervang <enrollmentAccountObjectId> door de name die u hebt gekopieerd tijdens de eerste stap (aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb). Zie object-id's van gebruikers ophalen voor het opgeven van eigenaren.

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>"
    }
  ]
}
Naam van element Vereist Type Description
displayName Nee String De weergavenaam van het abonnement. Als deze niet is opgegeven, wordt deze ingesteld op de naam van de aanbieding, bijvoorbeeld Microsoft Azure Enterprise.
offerType Ja String De aanbieding voor het abonnement. De twee opties voor EA zijn MS-AZR-0017P (productiegebruik) en MS-AZR-0148P (dev/test), moeten worden ingeschakeld in Azure Portal.
owners Nee String De object-id van een gebruiker die moet worden toegevoegd als een Azure RBAC-eigenaar in het abonnement wanneer deze wordt gemaakt.

Als onderdeel van de header Location wordt in het antwoord een URL weergegeven waarmee u de status van de maakbewerking van een abonnement kunt achterhalen. Wanneer het abonnement is gemaakt, retourneert een GET-bewerking voor de URL van het type Location een subscriptionLink-object, dat de abonnement-id heeft. Raadpleeg Documentatie over abonnement-API voor meer informatie

Beperkingen van de API voor het maken van Azure Enter prise-abonnementen

  • Alleen Azure Enterprise-abonnementen kunnen met de API worden gemaakt.
  • Er is een limiet van 5000 abonnementen per inschrijvingsaccount. Daarna kunnen alleen nog meer abonnementen voor het account worden gemaakt in Azure Portal. Als u meer abonnementen via de API wilt maken, maakt u een nieuw inschrijvingsaccount. Het aantal geannuleerde, verwijderde en overgedragen abonnementen ten opzichte van de limiet van 5000.
  • Gebruikers die geen accounteigenaar zijn, maar die zijn toegevoegd aan een inschrijvingsaccount met Azure RBAC, kunnen geen abonnementen maken in de Azure-portal.
  • U kunt de tenant niet selecteren voor het abonnement waarin deze moet worden gemaakt. Het abonnement wordt altijd gemaakt in de starttenant van de accounteigenaar. Zie Abonnementstenant wijzigen om het abonnement naar een andere tenant te verplaatsen.

Abonnementen maken voor een MCA-account

Gebruik de informatie in de volgende secties om abonnementen te maken voor een MCA-account.

Vereisten

U moet de rol van eigenaar, bijdrager of Azure-abonnementsmaker op een factuursectie of die van eigenaar of bijdrager op een factureringsprofiel of factureringsrekening hebben om abonnementen te maken. Voor meer informatie, zie Rollen en taken voor abonnementsfacturering.

In de volgende voorbeelden worden REST API's gebruikt. PowerShell en Azure CLI worden momenteel niet ondersteund.

Factureringsrekeningen zoeken waartoe u toegang hebt

Doe de volgende aanvraag om alle factureringsrekeningen weer te geven.

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

De API-respons vermeldt alle factureringsrekeningen waartoe u toegang hebt.

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

Gebruik de eigenschap displayName om de factureringsrekening te identificeren waarvoor u abonnementen wilt maken. Zorg ervoor dat agreementType van het account gelijk is aan MicrosoftCustomerAgreement. Kopieer de name van het account. Kopieer bijvoorbeeld bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx om een abonnement te maken voor het factureringsaccount Contoso. Plak de waarde ergens, zodat u deze in de volgende stap kunt gebruiken.

Factuursecties zoeken om abonnementen te maken

De kosten voor uw abonnement worden weergegeven in een sectie van de factuur van het factureringsprofiel. Gebruik de volgende API om de lijst met factuursecties en factureringsprofielen op te halen waarvoor u gemachtigd bent om Azure-abonnementen te maken.

Voer de volgende aanvraag uit en vervang <billingAccountName> door de name die u hebt gekopieerd tijdens de eerste stap (bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx).

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

In de API-respons worden alle factuursecties en de bijbehorende factureringsprofielen vermeld waarvoor u toegang hebt om abonnementen te maken:

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

Gebruik de eigenschap invoiceSectionDisplayName om de factuursectie te identificeren waarvoor u abonnementen wilt maken. Kopieer invoiceSectionId, billingProfileId en een van de skuId voor de factuursectie. Als u bijvoorbeeld een abonnement wilt maken van het type Microsoft Azure plan voor factuursectie Development, kopieert u /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 en 0001. Bewaar de waarden ergens, zodat u deze kunt gebruiken in de volgende stap.

Een abonnement voor een factuursectie maken

In het volgende voorbeeld wordt een abonnement van het type Microsoft Azure Plan gemaakt met de naam Dev Team subscription voor de factuursectie Development. Het abonnement wordt gefactureerd voor het factureringsprofiel van Contoso finance en wordt weergegeven in de sectie Development van de factuur.

Voer de volgende aanvraag uit en vervang <invoiceSectionId> door de invoiceSectionId die u tijdens de tweede stap (/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) hebt gekopieerd. Geef de billingProfileId en skuId die in de tweede stap zijn gekopieerd, door in de aanvraagparameters van de API. Zie object-id's van gebruikers ophalen voor het opgeven van eigenaren.

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",",
}'
Naam van element Vereist Type Description
displayName Ja String De weergavenaam van het abonnement.
billingProfileId Ja String De id van het factureringsprofiel waarmee de kosten voor het abonnement worden gefactureerd.
skuId Ja String De SKU-id die het type het Azure-plan bepaalt.
owners Nee String De object-id van een gebruiker of service-principal die moet worden toegevoegd als Azure RBAC-eigenaar voor het abonnement wanneer het wordt gemaakt.
costCenter Nee String Kostenplaats die aan het abonnement is gekoppeld. Deze wordt weergegeven in het CSV-bestand voor het gebruik.
managementGroupId Nee String De id van de beheergroep waaraan het abonnement wordt toegevoegd. Zie Beheergroepen - Lijst-API voor een lijst met beheergroepen. Gebruik de id van een beheergroep van de API.

In de respons krijgt u een subscriptionCreationResult-object terug voor bewaking. Wanneer het abonnement is gemaakt, retourneert het subscriptionCreationResult-object een subscriptionLink-object, dat de abonnement-id bevat.

Abonnementen maken voor een MPA-factureringsrekening

Gebruik de informatie in de volgende secties om abonnementen te maken voor een MCA-factureringsaccount.

Vereisten

In het account van de Cloud Solution Provider van uw organisatie moet u de rol van globale beheerder of beheerderagent hebben om een abonnement voor uw factureringsrekening te maken. Zie Partner Center - Gebruikersrollen en -machtigingen toewijzen voor meer informatie.

In de volgende voorbeelden worden REST API's gebruikt. PowerShell en Azure CLI worden momenteel niet ondersteund.

De factureringsrekeningen zoeken waartoe u toegang hebt

Voer de onderstaande aanvraag uit om alle factureringsrekeningen weer te geven waartoe u toegang hebt.

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

In de API-respons worden de factureringsrekeningen vermeld.

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

Gebruik de eigenschap displayName om de factureringsrekening te identificeren waarvoor u abonnementen wilt maken. Zorg ervoor dat agreementType van het account gelijk is aan MicrosoftPartnerAgreement. Kopieer de name voor het account. Kopieer bijvoorbeeld cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx om een abonnement te maken voor het factureringsaccount Contoso. Plak de waarde ergens, zodat u deze in de volgende stap kunt gebruiken.

Klanten zoeken die Azure-plannen hebben

Voer de volgende aanvraag uit, waarbij u <billingAccountName> vervangt door de name die in de eerste stap (bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx) is gekopieerd, om alle klanten in de factureringsrekening te vermelden voor wie u Azure-abonnementen kunt maken.

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

In de API-respons worden de klanten in de factureringsrekening vermeld die een Azure-plan hebben. U kunt abonnementen voor de klanten maken.

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

Gebruik eigenschap displayName om de klant te identificeren waarvoor u abonnementen wilt maken. Kopieer de id voor de klant. Kopieer bijvoorbeeld /providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b om een abonnement te maken voor Fabrikam toys. Plak deze waarde ergens voor gebruik in latere stappen.

Optioneel voor indirecte providers: de resellers voor een klant ophalen

Als u een indirecte provider in het CSP-model met twee lagen bent, kunt u een reseller opgeven tijdens het maken van abonnementen voor klanten.

Voer de volgende aanvraag uit en vervang <customerId> door de id die is gekopieerd in de tweede stap (/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b) om alle resellers weer te geven die beschikbaar zijn voor een klant.

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

In de API-respons worden de resellers voor de klant vermeld:

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

Gebruik eigenschap description om de reseller te identificeren die aan het abonnement moet worden gekoppeld. Kopieer de resellerId voor de reseller. Kopieer bijvoorbeeld 3xxxxx om Wingtip te koppelen. Plak de waarde ergens, zodat u deze in de volgende stap kunt gebruiken.

Een abonnement voor een klant maken

In het volgende voorbeeld wordt een abonnement met de naam Dev Team subscription voor Fabrikam toys gemaakt en wordt reseller Wingtip aan het abonnement gekoppeld.

Voer de volgende aanvraag uit en vervang <customerId> door de id die u tijdens de tweede stap (/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b) hebt gekopieerd. Geef de optionele resellerId, die in de tweede stap is gekopieerd, door aan de aanvraagparameters van de 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>",
}'
Naam van element Vereist Type Description
displayName Ja String De weergavenaam van het abonnement.
skuId Ja String De SKU-id van het Azure-plan. Gebruik 0001 voor abonnementen van het type Microsoft Azure Plan
resellerId Nee String De id van de reseller die wordt gekoppeld aan het abonnement.

In de respons krijgt u een subscriptionCreationResult-object terug voor bewaking. Wanneer het abonnement is gemaakt, retourneert het subscriptionCreationResult-object een subscriptionLink-object. Dit bevat de abonnements-id.

Volgende stappen

  • Zie sample code on GitHub (voorbeeldcode op GitHub) voor een voorbeeld voor het maken van een Enterprise Agreement (EA)-abonnement met behulp van .NET.