Dela via

Prenumerationsresurser

  • Artikel

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.

Prenumeration

Kommentar

Prenumerationsresursen har en hastighetsgräns på 500 begäranden per minut per klientorganisationsidentifierare.

Prenumerationsresursen representerar livscykeln för en prenumeration och innehåller egenskaper som definierar tillstånden under prenumerationens livscykel.

Property Type Beskrivning
ID sträng Prenumerationsidentifieraren.
offerId sträng Erbjudandeidentifieraren.
entitlementId sträng Berättigandeidentifieraren (ett Azure-prenumerations-ID).
offerName sträng Erbjudandets namn.
friendlyName sträng Det egna namnet på prenumerationen som definierats av partnern för att underlätta tvetydigheten.
kvantitet Nummer Kvantiteten. Den här egenskapen är inställd på antalet licenser för licensbaserad fakturering.
unitType sträng Enheter som definierar kvantitet för prenumerationen: "Licenser", "Användningsbaserad" eller "förmån".
parentSubscriptionId sträng Hämtar eller anger den överordnade prenumerationsidentifieraren.
creationDate sträng Hämtar eller anger skapandedatum i datum-tid-format.
effectiveStartDate 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.
commitmentEndDate sträng i UTC-datumtidsformat Slutdatum för åtagandet för den här prenumerationen i datum-tid-format. 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 är inte inkluderande.
commitmentEndDateTime 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: "none", "active", "pending", "suspended", "expired", "disabled" eller "deleted".
autoRenewEnabled boolean Hämtar ett värde som anger om prenumerationen förnyas automatiskt.
billingType 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 medlemsnamnen som finns i BillingCycleType.
hasPurchasableAddons boolean Hämtar eller anger ett värde som anger om prenumerationen har köpbara tillägg.
isTrial boolean Ett värde som anger om prenumerationen är en utvärderingsversion.
isMicrosoftProduct boolean Ett värde som anger om prenumerationen är en Microsoft-produkt.
publisherName sträng Utgivarens namn.
åtgärder strängmatris Hämtar eller anger de åtgärder som tillåts. Möjliga värden: "edit", "cancel"
partnerId sträng PartnerID för återförsäljaren av posten, som används i den indirekta partnermodellen.
suspensionReasons strängmatris Skrivskyddat. Om prenumerationen avbröts anger du varför.
contractType sträng Skrivskyddat. Typ av kontrakt: "prenumeration", "productKey" eller "redemptionCode".
refundOptions matris med RefundOption-resurser Skrivskyddad. Den uppsättning återbetalningsalternativ som är tillgängliga för den här prenumerationen.
scheduledNextTermInstructions scheduledNextTermInstructions Hämtar eller anger de schemalagda instruktionerna som körs när nästa termin startar.
nextChargeInstructions nextChargeInstructions 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.
termDuration 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.
renewalTermDuration 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).
ProductType ItemType Skrivskyddat. Den typ av produkt som prenumerationen gäller för.
consumptionType matris med överförbrukningsresurser 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"
CancellationAllowedUntilDate Datum/tid Det sista datumet för annullering.
BillingCycleEndDate Datum/tid Hämtar eller anger slutdatum för faktureringscykeln för den här prenumerationen i datum-tid-format.
BillingCycleEndDateTime Datum/tid Hämtar slutdatum för faktureringscykeln för den här prenumerationen i datum-tid-format.
productOrderId 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.

Resursen SubscriptionLinks beskriver samlingen med länkar som är kopplade till en prenumerationsresurs .

Property Type Beskrivning
offer Länk Hämtar eller ställer in erbjudandet.
parentSubscription Länk Hämtar eller anger den överordnade prenumerationen.
produkt Länk Hämtar den produkt som är associerad med prenumerationen.
sku Länk Hämtar produkt-SKU:n som är associerad med prenumerationen.
availability Länk Hämtar produkt-SKU-tillgängligheten som är associerad med prenumerationen.
activationLinks Länk Hämtar listan över aktiveringslänkar som är associerade med prenumerationen.
Själv Länk Själv-URI.
next Länk Nästa sida med objekt.
Tidigare Länk Föregående sida med objekt.

SubscriptionProvisioningStatus

Resursen SubscriptionProvisioningStatus innehåller information om etableringsstatus för en prenumeration.

Property Type 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 prenumerationskvantiteten efter etableringen.
endDate sträng i UTC-datumtidsformat Slutdatum för prenumerationen.
Attribut ResourceAttributes Metadataattributen.

scheduledNextTermInstructions

Resursen scheduledNextTermInstructions definierar de instruktioner som ska tillämpas i början av prenumerationens nästa period. Presentera endast om schemalagda ändringar har angetts eller för alla utvärderingsprenumerationer.

Property Type Beskrivning
produkt Produkt En GUID-formaterad sträng som identifierar produktens SKU.
kvantitet Nummer Tillhandahåller prenumerationskvantiteten efter etableringen.
customTermEndDate sträng i UTC-datumtidsformat Det anpassade slutdatumet för prenumerationen när det är justerat till en annan prenumerations slutdatum

Produkt

Resursen scheduledNextTermInstructions.product och attribut som en schemalagd ändring gäller vid nästa termin.

Property Type Beskrivning
productId String ID:t för en produkt.
skuId String Tillhandahåller prenumerationskvantiteten efter etableringen.
availabilityId String ID:t för den här tillgängligheten. Det här ID:t är endast unikt inom ramen för dess överordnade produkt och SKU. Observera att 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 String Anger hur ofta partnern faktureras för den här ordern. Värden som stöds är medlemsnamnen som finns i BillingCycleType.
termDuration String En ISO 8601-representation av termens varaktighet. De aktuella värdena som stöds är P1M (1 månad) och P1Y (1 år).
promotionId String Kampanjidentifieraren som ska tillämpas för nästa schemalagda period. Formatexempel: "39NFJQT1PJQB:0001:39NFJQT1Q5KN."

nextChargeInstructions

Resursen nextChargeInstructions 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.

Property Type Beskrivning
produkt Produkt En GUID-formaterad sträng som identifierar produktens SKU.
kvantitet Nummer Tillhandahåller prenumerationskvantiteten efter etableringen.

SubscriptionRegistrationStatus

Resursen SubscriptionRegistrationStatus beskriver samlingen med länkar som är kopplade till en prenumerationsresurs.

Property Type Beskrivning
subscriptionId sträng Prenumerationsidentifieraren.
status sträng Anger registreringsstatus: "registered", "registering" eller "notregistered".

SupportContact

SupportContact-resursen representerar en supportkontakt för en kunds prenumeration.

Property Type Beskrivning
supportTenantId sträng En GUID-formaterad sträng som anger supportkontaktens klient-ID.
supportMpnId sträng Kontaktens partneridentifierare.
name sträng Namnet på supportkontakten.
länkar ResourceLinks Länkarna relaterade till supportkontakten.
Attribut ResourceAttributes Metadataattributen. Innehåller "objectType": "SupportContact".

Överförbrukning

Överförbrukningsresursen representerar överförbrukningsprenumerationens överförbrukning kan tilldelas, oavsett om den är tilldelad och återförsäljaren tilldelad.

Property Type 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.
type sträng Typen av överförbrukning kan vara "Telefon Tjänster"
Översatsning boolean Ett värde som anger om överförbrukning är aktiverat.
länkar ResourceLinks De överförbrukningsrelaterade länkarna.
Attribut ResourceAttributes Metadataattributen. Innehåller "objectType": "Overage".

RegisterSubscription

RegisterSubscription-resursen 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.

Property Type 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"

RefundOption

RefundOption-resursen representerar ett möjligt återbetalningsalternativ för prenumerationen.

Property Type Beskrivning
type sträng Typ av återbetalning. De värden som stöds är "Partiella" och "fullständiga"
expiresAfter 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

AzureEntitlement-resursen representerar Azure-berättigandena för prenumerationen.

Property Type Beskrivning
ID sträng Berättigandeidentifieraren
friendlyName sträng Det egna namnet på berättigandet.
status sträng Status för berättigande.
subscriptionId sträng Prenumerationsidentifieraren som berättigandet tillhör.

SubscriptionLineItem

Ett radobjekt innehåller inköpsinformation för en viss prenumeration.

Property Typ Beskrivning
ID sträng Identifieraren för prenumerationsradsobjektet.
friendlyName sträng Det egna namnet på det prenumerationsradobjekt som definierats av partnern för att hjälpa till att skilja sig åt.
omfattning Definitionsområde Omfång anger var förmånerna gäller.
autoRenewEnabled Booleskt Hämtar ett värde som anger om prenumerationen förnyas automatiskt.
status sträng Prenumerationsstatus: "none", "active", "pending", "suspended", "expired", "disabled" eller "deleted".
purchaseCommitment Inköpsåtagande Det fasta beloppet som har checkats in för beräkningstjänster.

Omfattning

Omfång anger var förmånerna gäller.

Property Typ Beskrivning
type sträng Omfångstypen för ett köp: "Single", "Shared", "Resource group" eller "Management group".
subscriptionId sträng ID:t för Den Azure-plan som skulle användas för ett köp. Krävs för delat omfång.
entitlementId 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.
managementGroupId 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.
resourceGroupId 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 checkats in för beräkningstjänster.

Property Typ Beskrivning
belopp sträng Åtagandet för fast belopp.
Korn sträng Perioden för åtagandet.
currency sträng Valutan för åtagandet.