Abonnementsbronnen

  • Artikel

Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud voor de Amerikaanse overheid

Met een abonnement kan een klant gedurende een bepaalde periode een service gebruiken. Niet alle velden zijn van toepassing op alle abonnementen. Veel velden zijn alleen van toepassing op bepaalde punten in de levenscyclus, bijvoorbeeld als een abonnement wordt onderbroken of geannuleerd.

Abonnement

Notitie

De abonnementsresource heeft een frequentielimiet van 500 aanvragen per minuut per tenant-id.

De abonnementsresource vertegenwoordigt de levenscyclus van een abonnement en bevat eigenschappen die de statussen gedurende de levenscyclus van het abonnement definiëren.

Eigenschap Type Beschrijving
Id tekenreeks De abonnements-id.
offerId tekenreeks De aanbiedings-id.
entitlementId tekenreeks De rechten-id (een Azure-abonnements-id).
offerName tekenreeks De naam van de aanbieding.
Friendlyname tekenreeks De beschrijvende naam voor het abonnement dat door de partner is gedefinieerd om te helpen ondubbelzinnig te zijn.
quantity Nummer De hoeveelheid. Deze eigenschap is ingesteld op het aantal licenties voor facturering op basis van licenties.
unitType tekenreeks De eenheden die hoeveelheid definiëren voor het abonnement: 'Licenties', 'Op gebruik gebaseerd' of 'Voordeel'.
parentSubscriptionId tekenreeks Hiermee haalt u de bovenliggende abonnements-id op of stelt u deze in.
creationDate tekenreeks Hiermee haalt u de aanmaakdatum op of stelt u deze in datum-/tijdnotatie in.
effectiveStartDate tekenreeks in utc-datum/tijdnotatie Hiermee wordt de effectieve begindatum voor dit abonnement opgehaald of ingesteld in datum-/tijdnotatie. Deze eigenschap wordt gebruikt om een gemigreerd abonnement te laten teruggaan of om het uit te lijnen met een ander.
commitmentEndDate tekenreeks in utc-datum/tijdnotatie De einddatum van de toezegging voor dit abonnement, in datum-/tijdnotatie. Voor abonnementen die niet automatisch kunnen worden hersteld, vertegenwoordigt deze eigenschap een datum ver weg in de toekomst. Nieuwe handelseinddatums zijn inclusief, wat betekent dat het einde van de termijn aan het einde van de volledige dag staat. Verouderde einddatums zijn niet inclusief.
commitmentEndDateTime tekenreeks in utc-datum/tijdnotatie De einddatum en -tijd van de toezegging voor dit abonnement, in datum-tijdnotatie. Voor abonnementen die niet automatisch kunnen worden hersteld, vertegenwoordigt deze eigenschap een datum ver weg in de toekomst.
status tekenreeks De abonnementsstatus: 'none', 'active', 'pending', 'suspended', 'expired', 'disabled' of 'deleted'.
autoRenewEnabled boolean Hiermee wordt een waarde opgehaald die aangeeft of het abonnement automatisch wordt verlengd.
billingType tekenreeks Hiermee geeft u op hoe het abonnement wordt gefactureerd: 'none', 'usage', 'license' of 'benefit'.
billingCycle tekenreeks Geeft de frequentie aan waarmee de partner wordt gefactureerd voor deze bestelling. Ondersteunde waarden zijn de ledennamen in BillingCycleType.
hasPurchasableAddons boolean Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het abonnement invoegtoepassingen heeft die kunnen worden aangeschaft.
isTrial boolean Een waarde die aangeeft of het abonnement een proefversie is.
isMicrosoftProduct boolean Een waarde die aangeeft of het abonnement een Microsoft-product is.
publisherName tekenreeks De naam van de uitgever.
acties matrix tekenreeksen Hiermee haalt u de toegestane acties op of stelt u deze in. Mogelijke waarden: 'bewerken', 'annuleren'
partnerId tekenreeks De PartnerID van de reseller van de record, die wordt gebruikt in het indirecte partnermodel.
suspensionReasons matrix tekenreeksen Alleen-lezen. Als het abonnement is onderbroken, geeft u aan waarom.
contractType tekenreeks Alleen-lezen. Het type contract: 'subscription', 'productKey' of 'redemptionCode'.
refundOptions matrix van RefundOption-resources Alleen-lezen. De set restitutieopties die beschikbaar zijn voor dit abonnement.
scheduledNextTermInstructions scheduledNextTermInstructions Hiermee worden de geplande instructies opgehaald of ingesteld die worden uitgevoerd wanneer de volgende term wordt gestart.
nextChargeInstructions nextChargeInstructions Hiermee haalt u details op voor de volgende factureringsinstructies voor wijzigingen in de factureringscyclus die in behandeling zijn aan het einde van de huidige termijn.
koppelingen SubscriptionLinks Hiermee haalt u de abonnementskoppelingen op of stelt u deze in.
orderId tekenreeks De id van de bestelling die is geplaatst om het abonnement te starten.
termDuration tekenreeks Een ISO 8601-weergave van de duur van de term. De huidige ondersteunde waarden zijn P1M (1 maand), P1Y (1 jaar) en P3Y (3 jaar).
kenmerken ResourceAttributes De metagegevenskenmerken die overeenkomen met het abonnement.
renewalTermDuration tekenreeks Een ISO 8601-weergave van de duur van de term. De huidige ondersteunde waarden zijn P1M (1 maand) en P1Y (1 jaar).
ProductType ItemType Alleen-lezen. Het type product waarvoor het abonnement is bedoeld.
consumptionType matrix van overschrijdingsbronnen Hiermee haalt u overschrijding voor een bepaalde klant op of stelt u deze in.
promotionId tekenreeks De promotie-id als deze wordt toegepast op het abonnement. Voorbeeld van indeling: "39NFJQT1PJQB:0001:39NFJQT1Q5KN"
CancellationAllowedUntilDate Datum en tijd De laatste datum voor annulering.
BillingCycleEndDate Datum en tijd Hiermee wordt de einddatum van de factureringscyclus voor dit abonnement opgehaald of ingesteld in datum-/tijdnotatie.
BillingCycleEndDateTime Datum en tijd Hiermee haalt u de einddatum van de factureringscyclus voor dit abonnement op in datum-tijdnotatie.
productOrderId tekenreeks Id voor een specifieke productaankoop (bijvoorbeeld Reserveringen of Een Azure-spaarplan).
lineItems SubscriptionLineItem Een regelitem bevat de aankoopgegevens van een bepaald abonnement.

De SubscriptionLinks-resource beschrijft de verzameling koppelingen die zijn gekoppeld aan een abonnementsresource .

Eigenschap Type Description
offer Koppeling Hiermee haalt u de aanbieding op of stelt u deze in.
parentSubscription Koppeling Hiermee wordt het bovenliggende abonnement opgehaald of ingesteld.
product Koppeling Hiermee wordt het product opgehaald dat is gekoppeld aan het abonnement.
sku Koppeling Hiermee wordt de product-sKU opgehaald die is gekoppeld aan het abonnement.
availability Koppeling Hiermee wordt de beschikbaarheid van de product-sKU opgehaald die is gekoppeld aan het abonnement.
activationLinks Koppeling Hiermee haalt u de lijst met activeringskoppelingen op die zijn gekoppeld aan het abonnement.
Zelf Koppeling De zelf-URI.
next Koppeling De volgende pagina met items.
Vorige Koppeling De vorige pagina met items.

SubscriptionProvisioningStatus

De Resource SubscriptionProvisioningStatus bevat informatie over de inrichtingsstatus van een abonnement.

Eigenschap Type Description
skuId tekenreeks Een tekenreeks die de product-SKU identificeert.
status tekenreeks Geeft de inrichtingsstatus aan: 'geslaagd', 'in behandeling' of 'mislukt'.
quantity Nummer Geeft het aantal abonnementen op na het inrichten.
endDate tekenreeks in utc-datum/tijdnotatie De einddatum van het abonnement.
kenmerken ResourceAttributes De metagegevenskenmerken.

scheduledNextTermInstructions

De resource scheduledNextTermInstructions definieert de instructies die moeten worden toegepast aan het begin van de volgende termijn van het abonnement. Alleen aanwezig als geplande wijzigingen zijn ingesteld of voor alle proefabonnementen.

Eigenschap Type Description
product product Een tekenreeks met GUID-indeling die de product-SKU identificeert.
quantity Nummer Geeft het aantal abonnementen op na het inrichten.
customTermEndDate tekenreeks in utc-datum/tijdnotatie De aangepaste einddatum voor het abonnement wanneer deze is afgestemd op de einddatum van een ander abonnement

Product

De geplandeNextTermInstructions.productresource en -kenmerken zijn van toepassing op de volgende term.

Eigenschap Type Description
productId String De id voor een product.
skuId String Geeft het aantal abonnementen op na het inrichten.
availabilityId String De id voor deze beschikbaarheid. Deze id is alleen uniek binnen de context van het bovenliggende product en de SKU. Let op: beschikbaarheids-id's kunnen na verloop van tijd veranderen. Partners mogen deze waarde slechts binnen een korte periode vertrouwen nadat ze deze hebben opgehaald.
billingCycle String Geeft de frequentie aan waarmee de partner wordt gefactureerd voor deze bestelling. Ondersteunde waarden zijn de ledennamen in BillingCycleType.
termDuration String Een ISO 8601-weergave van de duur van de term. De huidige ondersteunde waarden zijn P1M (1 maand) en P1Y (1 jaar).
promotionId String De promotie-id die moet worden toegepast voor de volgende geplande termijn. Voorbeeld van indeling: '39NFJQT1PJQB:0001:39NFJQT1Q5KN'.

nextChargeInstructions

De volgendeChargeInstructions-resource definieert de instructies voor de factureringscyclus die worden toegepast aan het begin van de volgende termijn van het abonnement. Alleen aanwezig wanneer wijzigingen in de factureringscyclus in behandeling zijn.

Eigenschap Type Description
product product Een tekenreeks met GUID-indeling die de product-SKU identificeert.
quantity Nummer Geeft het aantal abonnementen op na het inrichten.

SubscriptionRegistrationStatus

De Resource SubscriptionRegistrationStatus beschrijft de verzameling koppelingen die zijn gekoppeld aan een abonnementsresource.

Eigenschap Type Description
subscriptionId tekenreeks De abonnements-id.
status tekenreeks Geeft de registratiestatus aan: 'geregistreerd', 'registreren' of 'niet geregistreerd'.

SupportContact

De resource SupportContact vertegenwoordigt een ondersteuningsmedewerker voor het abonnement van een klant.

Eigenschap Type Description
supportTenantId tekenreeks Een tekenreeks met GUID-indeling die de tenant-id van de ondersteuningsmedewerker aangeeft.
supportMpnId tekenreeks De partner-id van de contactpersoon.
name tekenreeks De naam van de ondersteuningsmedewerker.
koppelingen ResourceLinks De contact met de ondersteuningsmedewerker gerelateerde koppelingen.
kenmerken ResourceAttributes De metagegevenskenmerken. Bevat 'objectType': 'SupportContact'.

Overschrijding

De overschrijdingsresource vertegenwoordigt mogelijk de overschrijding van het verbruiksabonnement, of deze is toegewezen en de toegewezen reseller.

Eigenschap Type Description
azureEntitlementId tekenreeks Een tekenreeks met GUID-indeling die de id van het verbruiksabonnement aangeeft.
partnerId tekenreeks De partner-id van de reseller die is gekoppeld aan het abonnement.
type tekenreeks Het type overschrijding kan 'Telefoon Services' zijn
Overage boolean Een waarde die aangeeft of overschrijding is ingeschakeld.
koppelingen ResourceLinks De overschrijdingsgerelateerde koppelingen.
kenmerken ResourceAttributes De metagegevenskenmerken. Bevat 'objectType': 'Overschrijding'.

RegisterSubscription

De RegisterSubscription-resource retourneert een koppeling die kan worden gebruikt om de registratiestatus van een abonnement op te vragen. De registratiestatus wordt geretourneerd in de antwoordtekst van een geaccepteerde aanvraag om een Azure-abonnement te registreren.

Eigenschap Type Description
httpResponseMessage object Retourneert HTTP-statuscode 202 'Geaccepteerd', met een locatieheader met een koppeling om een query uit te voeren op de registratiestatus. Bijvoorbeeld "/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus"

RefundOption

De Resource RefundOption vertegenwoordigt een mogelijke restitutieoptie voor het abonnement.

Eigenschap Type Description
type tekenreeks Het type restitutie. De ondersteunde waarden zijn Gedeeltelijk en Volledig
expiresAfter tekenreeks in utc-datum/tijdnotatie De tijdstempel wanneer deze optie verloopt. Als null is, heeft de restitutiebewerking geen vervaldatum.

AzureEntitlement

De AzureEntitlement-resource vertegenwoordigt de Azure-rechten voor het abonnement.

Eigenschap Type Beschrijving
Id tekenreeks De rechten-id
Friendlyname tekenreeks De beschrijvende naam van het recht.
status tekenreeks De status van het recht.
subscriptionId tekenreeks De abonnements-id waartoe het recht behoort.

SubscriptionLineItem

Een regelitem bevat de aankoopgegevens van een bepaald abonnement.

Eigenschappen Type Beschrijving
Id tekenreeks De item-id van de abonnementsregel.
Friendlyname tekenreeks De beschrijvende naam voor het regelitem van het abonnement dat door de partner is gedefinieerd om te helpen ondubbelzinnig te zijn.
bereik Scope Bereik geeft aan waar voordelen van toepassing zijn.
autoRenewEnabled Booleaanse waarde Hiermee wordt een waarde opgehaald die aangeeft of het abonnement automatisch wordt verlengd.
status tekenreeks De abonnementsstatus: 'none', 'active', 'pending', 'suspended', 'expired', 'disabled' of 'deleted'.
purchaseCommitment Aankoopverplichting Het vaste bedrag dat is vastgelegd voor rekenservices.

Bereik

Bereik geeft aan waar voordelen van toepassing zijn.

Eigenschappen Type Beschrijving
type tekenreeks Het bereiktype voor een aankoop: 'Enkel', 'Gedeeld', 'Resourcegroep' of 'Beheergroep'.
subscriptionId tekenreeks De id van het Azure-abonnement dat wordt gebruikt voor een aankoop. Vereist voor gedeeld bereik.
entitlementId tekenreeks De id van het Azure-abonnement dat wordt gebruikt voor een aankoop. Vereist voor één bereik.
managementGroupId tekenreeks De id van de beheergroep die wordt gebruikt voor een aankoop. Dit bereik kan momenteel alleen worden geselecteerd via Azure Portal, maar updates worden weergegeven op pc.
resourceGroupId tekenreeks De id van de resourcegroep die wordt gebruikt voor een aankoop. Dit bereik kan momenteel alleen worden geselecteerd via Azure Portal, maar updates worden weergegeven op pc.

Aankoopverplichting

Het vaste bedrag dat is vastgelegd voor rekenservices.

Eigenschappen Type Beschrijving
Bedrag tekenreeks De toezegging voor vast bedrag.
Graan tekenreeks De periode voor de toezegging.
valuta tekenreeks De valuta van de toezegging.