Prenumerationsresurser
gäller för: Partnercenter | Partnercenter som drivs av 21Vianet | Partnercenter för Microsoft Cloud for US Government
Med en prenumeration kan en kund använda en tjänst under en viss tidsperiod. Alla fält gäller inte för alla prenumerationer. Många fält gäller endast vid vissa punkter i livscykeln, till exempel om en prenumeration pausas eller avbryts.
Abonnemang
Not
Resursen Prenumeration har en hastighetsgräns på 500 begäranden per minut per klientidentifierare.
Resursen Prenumeration representerar livscykeln för en prenumeration och innehåller egenskaper som definierar tillstånden under prenumerationens livscykel.
| Egenskap | Typ | Beskrivning |
|---|---|---|
| ID | sträng | Prenumerationsidentifieraren. |
| offerId | sträng | Erbjudandeidentifieraren. |
| rättighets-id | sträng | Behörighetsidentifieraren (ett ID för Azure-prenumeration). |
| erbjudandenamn | sträng | Erbjudandets namn. |
| vänligt namn | sträng | Det beskrivande namnet på prenumerationen som definierats av partnern för att klargöra tvetydighet. |
| kvantitet | nummer | Kvantiteten. Den här egenskapen är inställd på antalet licenser för licensbaserad fakturering. |
| enhetstyp | sträng | Enheter som definierar kvantitet för prenumerationen: "Licenser", "Användningsbaserad" eller "förmån". |
| föräldraabonnemangs-ID | sträng | Hämtar eller anger den överordnade prenumerationsidentifieraren. |
| skapaDatum | sträng | Hämtar eller anger skapandedatum i datum-tid-format. |
| giltigt startdatum | sträng i UTC-datumtidsformat | Hämtar eller anger det gällande startdatumet för den här prenumerationen i datum-tid-format. Den här egenskapen används för att bakåtdatera en migrerad prenumeration eller för att justera den mot en annan. |
| åtagandetslutdatum | sträng i UTC-datumtidsformat | Slutdatum för åtagandet i datum- och tidsformat för den här prenumerationen. För prenumerationer som inte kan återskapas automatiskt representerar den här egenskapen ett datum långt borta i framtiden. Nya slutdatum för handel är inkluderande, vilket innebär att slutet av termen är i slutet av hela dagen. Äldre slutdatum ingår inte. |
| åtagandeslutdatum och tid | sträng i UTC-datumtidsformat | Åtagandets slutdatum och tid för den här prenumerationen, i datum-tidsformat. För prenumerationer som inte kan återskapas automatiskt representerar den här egenskapen ett datum långt borta i framtiden. |
| status | sträng | Prenumerationsstatus: "ingen", "aktiv", "förväntad", "avstängd", "utgången", "inaktiverad" eller "raderad". |
| automatiskFörnyelseAktiverad | boolesk | Hämtar ett värde som anger om prenumerationen förnyas automatiskt. |
| faktureringstyp | sträng | Anger hur prenumerationen faktureras: "none", "usage", "license" eller "benefit". |
| billingCycle | sträng | Anger hur ofta partnern faktureras för den här ordern. Värden som stöds är de medlemsnamn som finns i BillingCycleType. |
| harKöpbaraTillägg | boolesk | Hämtar eller anger ett värde som anger om prenumerationen har köpbara tillägg. |
| isTrial | boolesk | Ett värde som anger om prenumerationen är en utvärderingsversion. |
| isMicrosoftProduct | boolesk | Ett värde som anger om prenumerationen är en Microsoft-produkt. |
| utgivarNamn | sträng | Utgivarens namn. |
| Åtgärder | matris med strängar | Hämtar eller anger de åtgärder som tillåts. Möjliga värden: "edit", "cancel" |
| partnerId | sträng | PartnerID för den registrerade återförsäljaren, som används i den indirekta partnermodellen. |
| avstängningsorsaker | matris med strängar | Skrivskyddad. Om prenumerationen avbröts anger du varför. |
| kontraktstyp | sträng | Skrivskyddad. Typ av kontrakt: "prenumeration", "productKey" eller "redemptionCode". |
| återbetalningsalternativ | matris med RefundOption resurser | Skrivskyddad. Den uppsättning återbetalningsalternativ som är tillgängliga för den här prenumerationen. |
| schemalagda instruktioner för nästa period | scheduledNextTermInstructions | Hämtar eller anger de schemalagda instruktionerna som utförs när nästa period startar. |
| nästa laddningsinstruktioner | nästaLaddningsInstruktioner | Hämtar information om nästa termins faktureringsinstruktioner för väntande ändringar i faktureringscykeln i slutet av den aktuella perioden. |
| Länkar | SubscriptionLinks | Hämtar eller anger prenumerationslänkarna. |
| orderId | sträng | ID:t för den beställning som gjordes för att påbörja prenumerationen. |
| tidsperiod | sträng | En ISO 8601-representation av termens varaktighet. Aktuella värden som stöds är P1M (1 månad), P1Y (1 år) och P3Y (3 år). |
| Attribut | ResourceAttributes | Metadataattributen som motsvarar prenumerationen. |
| förlängningstidsperiod | sträng | En ISO 8601-representation av termens varaktighet. De aktuella värdena som stöds är P1M- (1 månad) och P1Y- (1 år). |
| Produkttyp | Artikeltyp | Skrivskyddad. Den typ av produkt som prenumerationen gäller för. |
| förbrukningstyp | matris med överförbrukning resurser | Hämtar eller ställer in överförbrukning för en viss kund. |
| promotionId | sträng | Kampanjidentifieraren om den tillämpas på prenumerationen. Formatexempel: "39NFJQT1PJQB:0001:39NFJQT1Q5KN" |
| Avbokning Tillåten Fram Till Datum | DatumTid | Det sista datumet för annullering. |
| Fakturaperiodens slutdatum | DatumTid | Hämtar eller anger slutdatum för faktureringscykeln för den här prenumerationen i datum-tid-format. |
| FaktureringscykelSlutDatumTid | DatumTid | Hämtar slutdatum för faktureringscykeln för den här prenumerationen i datum-tid-format. |
| produktOrderId | sträng | Identifierare för ett specifikt produktköp (till exempel Reservationer eller Azure-sparplan). |
| lineItems | SubscriptionLineItem | Ett radobjekt innehåller inköpsinformation för en viss prenumeration. |
Prenumerationslänkar
Resursen SubscriptionLinks beskriver samlingen med länkar som är kopplade till en prenumerationsresurs.
| Egenskap | Typ | Beskrivning |
|---|---|---|
| erbjudande | Länk | Hämtar eller sätter erbjudandet. |
| huvudprenumeration | Link | Hämtar eller anger den överordnade prenumerationen. |
| produkt | Länk | Hämtar den produkt som är associerad med prenumerationen. |
| Sku | Link | Hämtar produkt-SKU:n som är associerad med prenumerationen. |
| tillgänglighet | Länk | Hämtar produkt-SKU-tillgängligheten som är associerad med prenumerationen. |
| aktiveringslänkar | Länk | Hämtar listan över aktiveringslänkar som är associerade med prenumerationen. |
| själv | Link | Själv-URI. |
| nästa | Link | Nästa sida med objekt. |
| föregående | Länk | Föregående sida med objekt. |
Abonnemangsförsörjningsstatus
Resursen SubscriptionProvisioningStatus innehåller information om etableringsstatus för en prenumeration.
| Egenskap | Typ | Beskrivning |
|---|---|---|
| skuId | sträng | En sträng som identifierar produktens SKU. |
| status | sträng | Anger etableringsstatus: "lyckades", "väntar" eller "misslyckades". |
| kvantitet | nummer | Tillhandahåller prenumerationsmängden efter tillhandahållandet. |
| slutdatum | sträng i UTC-datumtidsformat | Slutdatum för prenumerationen. |
| Attribut | ResourceAttributes | Metadata-attributen. |
instruktioner för nästa schemalagda termin
Den scheduledNextTermInstructions-resursen definierar de instruktioner som ska tillämpas i början på prenumerationens nästa termin. Visa endast om schemalagda ändringar har angetts eller för alla utvärderingsprenumerationer.
| Egenskap | Typ | Beskrivning |
|---|---|---|
| produkt | produkt | En GUID-formaterad sträng som identifierar produktens SKU. |
| kvantitet | nummer | Tillhandahåller prenumerationskvantiteten efter provisioneringen. |
| customTermEndDate | sträng i UTC-datumtidsformat | Det anpassade slutdatumet för prenumerationen när det är justerat till en annan prenumerations slutdatum |
Produkt
Den schemalagda ändringen för scheduledNextTermInstructions.product kommer att gälla resursen och attributen nästa termin.
| Egenskap | Typ | Beskrivning |
|---|---|---|
| produkt-id | Sträng | ID:t för en produkt. |
| skuId | Sträng | Tillhandahåller prenumerationskvantiteten efter tilldelning. |
| tillgänglighetsId | Sträng | ID:t för den här tillgängligheten. Det här ID:t är bara unikt inom ramen för dess överordnade produkt och SKU. Observera tillgänglighets-ID:t kan ändras över tid. Partner bör bara förlita sig på det här värdet inom en kort tid efter att de har hämtat det. |
| billingCycle | Sträng | Anger hur ofta partnern faktureras för den här ordern. Värden som stöds är de medlemsnamn som finns i BillingCycleType. |
| varaktighet | Sträng | En ISO 8601-representation av termens varaktighet. De aktuella värdena som stöds är P1M- (1 månad) och P1Y- (1 år). |
| promotionId | Sträng | Kampanjidentifieraren som ska tillämpas för nästa schemalagda period. Formatexempel: "39NFJQT1PJQB:0001:39NFJQT1Q5KN." |
nästaLaddinstruktioner
nextChargeInstructions resurs definierar de faktureringscykelinstruktioner som tillämpas i början av prenumerationens nästa period. Presentera endast när väntande ändringar i faktureringscykeln väntar.
| Egenskap | Typ | Beskrivning |
|---|---|---|
| produkt | produkt | En GUID-formaterad sträng som identifierar produktens SKU. |
| kvantitet | nummer | Anger prenumerationskvantiteten efter tilldelningen. |
Prenumerationsregistreringsstatus
Resursen SubscriptionRegistrationStatus beskriver samlingen med länkar som är kopplade till en prenumerationsresurs.
| Egenskap | Typ | Beskrivning |
|---|---|---|
| prenumerationsID | sträng | Prenumerationsidentifieraren. |
| status | sträng | Indikerar registreringsstatus: "registrerad", "registrerar" eller "inte registrerad". |
SupportContact
Resursen SupportContact representerar en supportkontakt för en kunds prenumeration.
| Egenskap | Typ | Beskrivning |
|---|---|---|
| supportTenantId | sträng | En GUID-formaterad sträng som anger supportkontaktens klient-ID. |
| supportMpnId | sträng | Kontaktens partneridentifierare. |
| Namn | sträng | Namnet på supportkontakten. |
| Länkar | Resurslänkar | Relaterade länkar för supportkontakt. |
| Attribut | ResourceAttributes | Metadataattributen. Innehåller "objectType": "SupportContact". |
Överskott
Den överförbrukning resursen representerar överförbrukningsprenumerationens överförbrukning kan tilldelas, oavsett om den har tilldelats och återförsäljaren har tilldelats.
| Egenskap | Typ | Beskrivning |
|---|---|---|
| azureEntitlementId | sträng | En GUID-formaterad sträng som anger förbrukningsprenumerationsidentifierare. |
| partnerId | sträng | Partneridentifieraren för den återförsäljare som är associerad med prenumerationen. |
| typ | sträng | Typen av överförbrukning kan vara "Telefonitjänster" |
| överskott | boolesk | Ett värde som anger om överförbrukning är aktiverat. |
| Länkar | Resurslänkar | De överförbrukningsrelaterade länkarna. |
| Egenskaper | Resursattribut | Metadataattributen. Innehåller "objectType": "Overage". |
RegistreraPrenumeration
Resursen RegisterSubscription returnerar en länk som kan användas för att fråga efter registreringsstatus för en prenumeration. Registreringsstatusen returneras i svarstexten i en begäran om att registrera en Azure-prenumeration.
| Egenskap | Typ | Beskrivning |
|---|---|---|
| httpResponseMessage | objekt | Returnerar HTTP-statuskod 202 "Godkänd", med en platsrubrik som innehåller en länk för att fråga registreringsstatusen. Till exempel "/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus" |
Återbetalningsalternativ
Resursen RefundOption representerar ett möjligt återbetalningsalternativ för prenumerationen.
| Egenskap | Typ | Beskrivning |
|---|---|---|
| typ | sträng | Typ av återbetalning. De värden som stöds är "Partiella" och "fullständiga" |
| upphör efter | sträng i UTC-datumtidsformat | Tidsstämpeln när det här alternativet upphör att gälla. Om värdet är null har återbetalningsåtgärden inte upphör att gälla. |
AzureEntitlement
Resursen AzureEntitlement representerar Azure-berättigandena för prenumerationen.
| Egenskap | Typ | Beskrivning |
|---|---|---|
| ID | sträng | Rättighets-ID |
| vänligt namn | sträng | Det vänliga namnet på berättigandet. |
| status | sträng | Status för berättigande. |
| abonnemangs-ID | sträng | Prenumerations-ID:et som rättigheten tillhör. |
SubscriptionLineItem
Ett radobjekt innehåller inköpsinformation för en viss prenumeration.
| egenskap | Typ | Beskrivning |
|---|---|---|
| ID | sträng | Identifieraren för prenumerationsradsobjektet. |
| vänligtNamn | sträng | Det beskrivande namnet på prenumerationsradobjektet som definierats av partnern för att underlätta avgränsning. |
| omfattning | Omfattning | Omfång anger var förmånerna gäller. |
| automatiskFörnyelseAktiverad | Boolesk | Hämtar ett värde som anger om prenumerationen förnyas automatiskt. |
| status | sträng | Prenumerationsstatus: "ingen", "aktiv", "väntande", "avstängd", "utgånget", "inaktiverad" eller "raderad". |
| köpauttagande | inköpsåtagande | Det fasta beloppet avsatt för beräkningstjänster. |
Omfattning
Omfång anger var förmånerna gäller.
| egenskap | typ | Beskrivning |
|---|---|---|
| typ | sträng | Omfångstypen för ett köp: "Single", "Shared", "Resource group" eller "Management group". |
| prenumerations-ID | sträng | ID:t för den Azure-planen som skulle användas för ett köp. Krävs för delad tillämpning. |
| rättighets-ID | sträng | ID:t för den Azure-prenumeration som skulle användas för ett köp. Krävs för enstaka omfång. |
| förvaltningsgruppId | sträng | ID:t för hanteringsgruppen som skulle användas för ett köp. Det här omfånget kan bara väljas via Azure-portalen i dag, men uppdateringarna återspeglas i PC. |
| resursgruppId | sträng | ID:t för den resursgrupp som ska användas för ett köp. Det här omfånget kan bara väljas via Azure-portalen i dag, men uppdateringarna återspeglas i PC. |
Inköpsåtagande
Det fasta beloppet som har avsatts för beräkningstjänster.
| egenskap | typ | Beskrivning |
|---|---|---|
| belopp | sträng | Åtagandet för fast belopp. |
| korn | sträng | Perioden för åtagandet. |
| valuta | sträng | Valutan för åtagandet. |