Abonnementsbronnen
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. |
SubscriptionLinks
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. |