Dela via

Skapa Azure-prenumerationer via programmering med äldre API:er

  • Artikel

Den här artikeln hjälper dig att programmatiskt skapa Azure-prenumerationer med vårt äldre förhandsversions-API. I den här artikeln får du lära dig hur du skapar prenumerationer programmatiskt med hjälp av Azure Resource Manager.

Vi har nya artiklar för den senaste API-versionen som kan användas med olika typer av Azure-prenumerationsavtal:

Du kan dock fortfarande använda informationen i den här artikeln om du inte vill använda den senaste API-versionen.

Azure-kunder med ett faktureringskonto för följande avtalstyper kan skapa prenumerationer via programmering:

  • Enterprise-avtal
  • Microsoft-kundavtal (MCA)
  • Microsoft-partneravtal (MPA)

När du skapar en Azure-prenumeration via programmering regleras den av det avtal som du ingick när du köpte Azure-tjänsterna från Microsoft eller en auktoriserad återförsäljare. Mer information finns i Juridisk information för Microsoft Azure.

Kommentar

Vi rekommenderar att du använder Azure Az PowerShell-modulen för att interagera med Azure. Se Installera Azure PowerShell för att komma igång. Information om hur du migrerar till Az PowerShell-modulen finns i artikeln om att migrera Azure PowerShell från AzureRM till Az.

Du kan inte skapa supportplaner programmatiskt. Du kan köpa ett nytt supportprogram eller uppgradera ett supportprogram i Azure-portalen. Gå till Hjälp + support och välj sedan Välj rätt supportprogram överst på sidan.

Hantera prenumerationer för ett EA-faktureringskonto

Använd informationen i följande avsnitt för att skapa EA-prenumerationer.

Förutsättningar

Du måste ha rollen Ägare på ett registreringskonto eller vara en Enterprise-administratör för att kunna skapa prenumerationer. Det finns två sätt att få denna roll:

Hitta konton som du har åtkomst till

När du har lagt till ett registreringskonto som är associerat med en kontoägare använder Azure konto-till-registrering-relationen för att ta reda på var prenumerationsavgifterna ska debiteras. Alla prenumerationer som skapats under kontot debiteras till den EA-registrering som kontot ingår i. För att kunna skapa prenumerationer måste du ange värden om registreringskontot och användarens huvudnamn så att du är ägare för prenumerationen.

För att kunna köra följande kommandon måste du vara inloggad i kontoägarens hemkatalog, som är den katalog som prenumerationer skapas i som standard.

Begär en lista över alla registreringskonton som du har åtkomst till:

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

API-svaret visar alla registreringskonton som du har åtkomst till:

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

Använd egenskapen principalName för att identifiera det konto som du vill ska debiteras för prenumerationerna. Kopiera name för det kontot. Skapa till exempel prenumerationer under SignUpEngineering@contoso.com-registreringskontot och kopiera aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e. Identifieraren är objekt-ID:t för registreringskontot. Klistra in värdet någonstans så att du kan använda det som enrollmentAccountObjectId i nästa steg.

Skapa prenumerationer under ett specifikt registreringskonto

I följande exempel skapas en prenumeration med namnet Dev Team Subscription i det registreringskonto som valdes i föregående steg. Prenumerationserbjudandet är MS-AZR-0017P (vanligt Microsoft Enterprise-avtal). Du kan även lägga till två användare som Azure RBAC-ägare för prenumerationen.

Kör följande förfrågan och ersätt <enrollmentAccountObjectId> med värdet för name som du kopierade i första steget (aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb). Information om hur du definierar ägare finns i Hämtar användarobjekt-ID:n.

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>"
    }
  ]
}
Elementnamn Obligatoriskt Type Beskrivning
displayName Nej String Prenumerationens visningsnamn. Ange namnet på erbjudandet, till exempel ”Microsoft Azure Enterprise”, om det inte redan har angetts.
offerType Ja String Prenumerationens erbjudande. De två alternativen för EA är MS-AZR-0017P (produktionsanvändning) och MS-AZR-0148P (dev/test, måste aktiveras i Azure Portal).
owners Nej String Objekt-ID för alla användare som ska läggas till som Azure RBAC-ägare i prenumerationen när den skapas.

I sidhuvudet Location i svaret du får finns en URL som du kan använda för att fråga efter status för skapandet av prenumerationen. När prenumerationen har skapats returnerar ett GET-anrop till Location-url:en ett subscriptionLink-objekt, som innehåller prenumerations-ID:t. Mer information finns i dokumentationen om prenumerations-API:er

Begränsningar för API:et för att skapa Azure Enterprise-prenumerationer

  • Det går bara att skapa Azure Enterprise-prenumerationer med API:et.
  • Det finns en gräns på 5 000 prenumerationer per registreringskonto. Därefter kan du bara skapa fler prenumerationer för kontot i Azure-portalen. Skapa ett till registreringskonto om du vill skapa fler prenumerationer via API:et. Avbrutna, borttagna och överförda prenumerationer tas med i beräkningen för gränsen på 5000.
  • Användare som inte är kontoägare, men som har lagts till i ett registreringskonto med Azure RBAC, kan inte skapa prenumerationer på Azure-portalen.
  • Du kan inte välja den klientorganisation som prenumerationen ska skapas i. Prenumerationen skapas alltid i kontoägarens hemklientorganisation. Information om hur du flyttar prenumerationen till en annan klientorganisation finns i avsnittet om att ändra klientorganisation för prenumerationer.

Skapa prenumerationer för ett MCA-konto

Använd informationen i följande avsnitt om du vill skapa prenumerationer för ett MCA-konto.

Förutsättningar

För att kunna skapa prenumerationer måste du ha rollen ägare, deltagare eller skapare av Azure-prenumerationen i ett fakturaavsnitt eller rollen ägare eller deltagare i en faktureringsprofil eller ett faktureringskonto. Mer information finns i Roller och uppgifter för prenumerationsfakturering.

I följande exempel används REST-API:er. PowerShell och Azure CLI stöds inte för närvarande.

Sök efter faktureringskonton som du har åtkomst till

Visa en lista över alla faktureringskonton genom att göra följande begäran.

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

API-svaret visar alla faktureringskonton som du har åtkomst till.

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

Använd egenskapen displayName för att identifiera det faktureringskonto som du vill skapa prenumerationer för. Se till att agreementType för kontot är MicrosoftCustomerAgreement. Kopiera name för kontot. Om du till exempel vill skapa en prenumeration för faktureringskontot Contoso kopierar du bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx. Klistra in värdet någonstans så att du kan använda det i nästa steg.

Hitta fakturaavsnitt för att skapa prenumerationer

Avgifterna för din prenumeration visas i ett avsnitt på fakturan för en faktureringsprofil. Använd följande API för att hämta listan över fakturaavsnitt och faktureringsprofiler som du har behörighet att skapa Azure-prenumerationer på.

Kör följande förfrågan och ersätt <billingAccountName> med värdet för name som du kopierade i första steget (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

API-svaret visar alla fakturaavsnitt och de faktureringsprofiler som du har behörighet att skapa prenumerationer på:

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

Använd egenskapen invoiceSectionDisplayName för att identifiera det fakturaavsnitt som du vill skapa prenumerationer för. Kopiera invoiceSectionId, billingProfileId och ett skuId för fakturaavsnittet. Om du till exempel vill skapa en prenumeration av typen Microsoft Azure plan för Development-fakturaavsnittet kopierar du /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 och 0001. Klistra in värdena någonstans så att du kan använda dem i nästa steg.

Skapa en prenumeration för ett fakturaavsnitt

I följande exempel skapas en prenumeration med namnet Dev Team subscription av typen Microsoft Azure Plan för fakturaavsnittet Development. Prenumerationen debiteras till faktureringsprofilen för Contoso Finance och visas i avsnittet Development (Utveckling) på fakturan.

Skicka följande begäran och ersätt <invoiceSectionId> med invoiceSectionId som kopierats från det andra steget (/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). Använd billingProfileId och skuId som kopierades från det andra steget i parametrarna för begäran i API:et. Information om hur du definierar ägare finns i Hämtar användarobjekt-ID:n.

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",",
}'
Elementnamn Obligatoriskt Type Beskrivning
displayName Ja String Prenumerationens visningsnamn.
billingProfileId Ja String ID:t för den faktureringsprofil som debiteras för prenumerationsavgifterna.
skuId Ja String Det SKU-ID som bestämmer typen av Azure-plan.
owners Nej String Objekt-ID:t för en användare eller ett tjänsthuvudnamn som ska läggas till som Azure RBAC-ägare för prenumerationen när den skapas.
costCenter Nej String Kostnadsstället som är associerat med prenumerationen. Det visas i CSV-användningsfilen.
managementGroupId Nej String ID:t för den hanteringsgrupp som prenumerationen ska läggas till i. Information om hur du hämtar listan med hanteringsgrupper finns i Hanteringsgrupper – Lista – API. Använd ID:t för en hanteringsgrupp från API:et.

I svaret får du tillbaka ett subscriptionCreationResult-objekt för övervakning. När prenumerationen har skapats returnerar subscriptionCreationResult-objektet ett subscriptionLink-objekt, som innehåller prenumerations-ID:t.

Skapa prenumerationer för ett MPA-faktureringskonto

Använd informationen i följande avsnitt om du vill skapa prenumerationer för ett MPA-faktureringskonto.

Förutsättningar

Du måste ha en administratörsagentroll i organisationens Molnlösningsleverantör-konto för att kunna skapa en prenumeration för ditt faktureringskonto. Mer information finns i Partnercenter – Tilldela användarroller och behörigheter.

I följande exempel används REST-API:er. PowerShell och Azure CLI stöds inte för närvarande.

Sök efter faktureringskonton som du har åtkomst till

Skicka begäran nedan om du vill se en lista över alla faktureringskonton som du har åtkomst till.

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

API-svaret visar en lista över faktureringskontona.

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

Använd egenskapen displayName för att identifiera det faktureringskonto som du vill skapa prenumerationer för. Se till att agreementType för kontot är MicrosoftPartnerAgreement. Kopiera name för kontot. Om du till exempel vill skapa en prenumeration för faktureringskontot Contoso kopierar du cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx. Klistra in värdet någonstans så att du kan använda det i nästa steg.

Hitta kunder som har Azure-planer

Gör följande begäran och ersätt <billingAccountName> med name som kopierades från det första steget (bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx) för att visa en lista över alla kunder i faktureringskontot som du kan skapa Azure-prenumerationer för.

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

API-svaret visar en lista över kunder i faktureringskontot med Azure-planer. Du kan skapa prenumerationer för kunderna.

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

Använd egenskapen displayName för att identifiera kunden som du vill skapa prenumerationer för. Kopiera id för kunden. Om du till exempel vill skapa en prenumeration för Fabrikam toys kopierar du /providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b. Klistra in värdet någonstans så att du kan använda det i kommande steg.

Valfritt för indirekta leverantörer: Hämta återförsäljare för en kund

Om du är en indirekt leverantör i modellen med två nivåer för CSP kan välja en återförsäljare när de skapar prenumerationer för kunder.

Skicka följande begäran och ersätt <customerId> med id som kopierades från det andra steget (/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b) för att visa en lista över alla återförsäljare som är tillgängliga för en kund.

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

API-svaret visar återförsäljarna för kunden:

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

Använd egenskapen description för att identifiera den återförsäljare som ska associeras med prenumerationen. Kopiera resellerId för återförsäljaren. Om du till exempel vill associera Wingtip kopierar du 3xxxxx. Klistra in värdet någonstans så att du kan använda det i nästa steg.

Skapa en prenumeration för en kund

I följande exempel skapas en prenumeration med namnet Dev Team subscription (Prenumeration för utvecklingsteam) för Fabrikam toys, och återförsäljaren Wingtip associeras med prenumerationen.

Skicka följande begäran och ersätt <customerId> med id som kopierats från det andra steget (/providers/Microsoft.Billing/billingAccounts/cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b). Skicka det valfria resellerId som kopierades från det andra steget i parametrarna för begäran till API:et.

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

'{"displayName": "Dev Team subscription",
  "skuId": "0001",
  "resellerId": "<resellerId>",
}'
Elementnamn Obligatoriskt Type Beskrivning
displayName Ja String Prenumerationens visningsnamn.
skuId Ja String SKU-ID för Azure-planen. Använd 0001 för prenumerationer av typen Microsoft Azure plan
resellerId Nej String ID:t för den återförsäljare som ska associeras med prenumerationen.

I svaret får du tillbaka ett subscriptionCreationResult-objekt för övervakning. När du har skapat en prenumeration returnerar objektet subscriptionCreationResult ett subscriptionLink-objekt. Objektet innehåller prenumerations-ID:t.

Nästa steg

  • Ett exempel på hur du skapar en EA-prenumeration (Enterprise-avtal) med .NET finns i exempelkod på GitHub.