Skapa Azure-prenumerationer via programmering med äldre API:er
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:
- Skapa EA-prenumerationer programmatiskt med det senaste API:et
- Skapa MCA-prenumerationer programmatiskt med det senaste API:et
- Skapa MPA-prenumerationer programmatiskt med det senaste API:et
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. Information om hur du kommer igång finns i Installera Azure PowerShell. 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 en ny supportplan eller uppgradera en i Azure-portalen. Gå till Hjälp + support och välj sedan Välj rätt supportplan ö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 för ett registreringskonto eller vara företagsadministratör för att kunna skapa en prenumeration. Det finns två sätt att få denna roll:
- Företagsadministratören för din registrering kan utse dig till kontoägare (inloggning krävs), vilket innebär att du blir ägare till registreringskontot.
- En befintlig ägare till registreringskontot kan ge dig åtkomst. Om du vill skapa en EA-prenumeration med hjälp av ett tjänsthuvudnamn måste du på liknande sätt bevilja tjänsthuvudnamnet behörighet att skapa prenumerationer.
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/747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"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 747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx. 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 (747ddfe5-xxxx-xxxx-xxxx-xxxxxxxxxxxx). 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-portalen). |
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/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"name": "5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"properties": {
"accountId": "5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"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 5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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 (5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_2019-05-31/billingProfiles/PBFV-XXXX-XXX-XXX/invoiceSections/GJGR-XXXX-XXX-XXX, /providers/Microsoft.Billing/billingAccounts/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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 rollen som global administratör eller administratör i din organisations molnlösningsleverantörskonto för att 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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"name": "99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx",
"properties": {
"accountId": "5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"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 99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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 (5e98e158-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"name": "2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
"properties": {
"billingProfileDisplayName": "Contoso USD",
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx. 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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx) 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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx: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/99a13315-xxxx-xxxx-xxxx-xxxxxxxxxxxx:xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx_xxxx-xx-xx/customers/2281f543-xxxx-xxxx-xxxx-xxxxxxxxxxxx). 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.
- Nu när du har skapat en prenumeration kan du bevilja den möjligheten till andra användare och tjänsthuvudnamn. Mer information finns i Bevilja behörighet att skapa Azure Enterprise-prenumerationer (förhandsversion).
- Mer information om hur du hanterar ett stort antal prenumerationer med hanteringsgrupper finns i Ordna resurser med hanteringsgrupper i Azure.
Feedback
Kommer snart: Under hela 2024 kommer vi att fasa ut GitHub-problem som feedbackmekanism för innehåll och ersätta det med ett nytt feedbacksystem. Mer information finns i: https://aka.ms/ContentUserFeedback.
Skicka och visa feedback för