Abonnementsresources
Van toepassing op: Partnercentrum | Partnercentrum beheerd door 21Vianet | Partnercentrum voor Microsoft Cloud for US Government
Met een abonnement kan een klant een service gedurende een bepaalde periode 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 waarmee de statussen gedurende de levenscyclus van het abonnement worden gedefinieerd.
| 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 de ondubbelzinnigheid te helpen oplossen. |
| quantity | getal | De hoeveelheid. Deze eigenschap is ingesteld op het aantal licenties voor facturering op basis van licenties. |
| unitType | tekenreeks | De eenheden die de hoeveelheid voor het abonnement definiëren: 'Licenties', 'Op gebruik gebaseerd' of 'Voordeel'. |
| parentSubscriptionId | tekenreeks | Hiermee wordt de bovenliggende abonnements-id opgehaald of ingesteld. |
| creationDate | tekenreeks | Hiermee wordt de aanmaakdatum opgehaald of ingesteld, in datum-/tijdnotatie. |
| effectiveStartDate | tekenreeks in UTC-datumtijdnotatie | Hiermee wordt de effectieve begindatum voor dit abonnement opgehaald of ingesteld, in datum-/tijdnotatie. Het wordt gebruikt om een gemigreerd abonnement te dateren of om het uit te lijnen met een ander abonnement. |
| commitmentEndDate | tekenreeks in UTC-datumtijdnotatie | De einddatum van de toezegging voor dit abonnement, in datum-/tijdnotatie. Voor abonnementen die niet automatisch kunnen worden hersteld, is dit een datum ver, ver weg in de toekomst. Einddatums zijn inclusief, wat betekent dat het einde van de termijn aan het einde van de volledige dag valt. |
| commitmentEndDateTime | tekenreeks in UTC-datumtijdnotatie | De einddatum en -tijd van de toezegging voor dit abonnement, in datum-/tijdnotatie. Voor abonnementen die niet automatisch kunnen worden hersteld, is dit een datum ver, ver weg in de toekomst. |
| status | tekenreeks | De abonnementsstatus: 'none', 'active', 'pending', 'suspended', 'expired', 'disabled' of 'deleted'. |
| autoRenewEnabled | booleaans | 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 order. Ondersteunde waarden zijn de namen van leden in BillingCycleType. |
| hasPurchasableAddons | booleaans | Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het abonnement invoegtoepassingen heeft die kunnen worden gekocht. |
| isTrial | booleaans | Een waarde die aangeeft of het abonnement een proefversie is. |
| isMicrosoftProduct | booleaans | Een waarde die aangeeft of het abonnement een Microsoft-product is. |
| publisherName | tekenreeks | De naam van de uitgever. |
| acties | tekenreeksmatrix | Hiermee worden de toegestane acties opgehaald of ingesteld. Mogelijke waarden: 'bewerken', 'annuleren' |
| partnerId | tekenreeks | De PartnerID van de reseller van de record, die wordt gebruikt in het indirecte partnermodel. |
| suspensionReasons | tekenreeksmatrix | Alleen-lezen. Als het abonnement is onderbroken, wordt aangegeven 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 begint. |
| nextChargeInstructions | nextChargeInstructions | Hiermee haalt u details op voor de factureringsinstructies voor de volgende termijn voor wijzigingen in de factureringscyclus die in behandeling zijn aan het einde van de huidige termijn. |
| Verwijzigingen | SubscriptionLinks | Hiermee worden de abonnementskoppelingen opgehaald of ingesteld. |
| Orderid | tekenreeks | De id van de order 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 overschrijdingsresources | Hiermee wordt overschrijding voor een bepaalde klant opgehaald of ingesteld. |
| promotionId | tekenreeks | De promotie-id als deze wordt toegepast op het abonnement. Voorbeeld van indeling: "39NFJQT1PJQB:0001:39NFJQT1Q5KN" |
| CancellationAllowedUntilDate | DateTime | De laatste annuleringsdatum. |
| BillingCycleEndDate | DateTime | Hiermee wordt de einddatum van de factureringscyclus voor dit abonnement opgehaald of ingesteld, in datum-/tijdnotatie. |
| BillingCycleEndDateTime | DateTime | Hiermee haalt u de einddatum van de factureringscyclus op voor dit abonnement, in datum-/tijdnotatie. |
| productOrderId | tekenreeks | Id voor een specifieke productaankoop (bijvoorbeeld Reserveringen of 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 | Beschrijving |
|---|---|---|
| offer | Koppeling | Haalt de aanbieding op of stelt deze in. |
| parentSubscription | Koppeling | Hiermee wordt het bovenliggende abonnement opgehaald of ingesteld. |
| product | Koppeling | Hiermee haalt u het product op dat is gekoppeld aan het abonnement. |
| sku | Koppeling | Hiermee haalt u de product-SKU op die is gekoppeld aan het abonnement. |
| availability | Koppeling | Hiermee haalt u de beschikbaarheid van de product-SKU op 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. |
| volgende | 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 | Beschrijving |
|---|---|---|
| skuId | tekenreeks | Een tekenreeks die de product-SKU identificeert. |
| status | tekenreeks | Geeft de inrichtingsstatus aan: 'geslaagd', 'in behandeling' of 'mislukt'. |
| quantity | getal | Geeft de hoeveelheid van het abonnement op na het inrichten. |
| endDate | tekenreeks in UTC-datumtijdnotatie | 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 | Beschrijving |
|---|---|---|
| product | Product | Een tekenreeks met GUID-indeling die de product-SKU identificeert. |
| quantity | getal | Geeft de hoeveelheid van het abonnement 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 resource scheduledNextTermInstructions.product en kenmerken van een geplande wijziging worden toegepast op de volgende termijn.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| productId | Tekenreeks | De id voor een product. |
| skuId | Tekenreeks | Geeft de hoeveelheid van het abonnement op na het inrichten. |
| availabilityId | Tekenreeks | De id voor deze beschikbaarheid. Deze id is alleen uniek binnen de context van het bovenliggende product en de bovenliggende SKU. Opmerking Beschikbaarheids-id's kunnen na verloop van tijd veranderen. Partners mogen alleen vertrouwen op deze waarde binnen een korte periode nadat ze deze hebben opgehaald. |
| billingCycle | Tekenreeks | Geeft de frequentie aan waarmee de partner wordt gefactureerd voor deze bestelling. Ondersteunde waarden zijn de namen van leden in BillingCycleType. |
| termDuration | Tekenreeks | Een ISO 8601-weergave van de duur van de term. De huidige ondersteunde waarden zijn P1M (1 maand) en P1Y (1 jaar). |
| promotionId | Tekenreeks | De promotie-id die moet worden toegepast voor de volgende geplande termijn. Indelingsvoorbeeld: "39NFJQT1PJQB:0001:39NFJQT1Q5KN". |
nextChargeInstructions
De resource nextChargeInstructions 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 | Beschrijving |
|---|---|---|
| product | Product | Een tekenreeks met GUID-indeling die de product-SKU identificeert. |
| quantity | getal | Geeft de hoeveelheid van het abonnement op na het inrichten. |
SubscriptionRegistrationStatus
De resource SubscriptionRegistrationStatus beschrijft de verzameling koppelingen die zijn gekoppeld aan een abonnementsresource.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| subscriptionId | tekenreeks | De abonnements-id. |
| status | tekenreeks | Geeft de registratiestatus aan: 'geregistreerd', 'registreren' of 'niet geregistreerd'. |
OndersteuningContact opnemen
De resource OndersteuningContact opnemen vertegenwoordigt een ondersteuningscontactpersoon voor het abonnement van een klant.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| supportTenantId | tekenreeks | Een tekenreeks met GUID-indeling die de tenant-id van de ondersteuningscontactpersoon aangeeft. |
| supportMpnId | tekenreeks | De partner-id van de contactpersoon. |
| naam | tekenreeks | De naam van de ondersteuningsmedewerker. |
| Verwijzigingen | ResourceLinks | De koppelingen met betrekking tot ondersteuningscontactpersonen. |
| kenmerken | ResourceAttributes | De metagegevenskenmerken. Bevat 'objectType': 'SupportContact'. |
Overschrijding
De overschrijdingsresource vertegenwoordigt de overschrijding van het verbruiksabonnement waaraan kan worden toegewezen, ongeacht of deze is toegewezen en de reseller die is toegewezen.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| azureEntitlementId | tekenreeks | Een tekenreeks met GUID-indeling die de abonnements-id voor verbruik aangeeft. |
| partnerId | tekenreeks | De partner-id van de reseller die aan het abonnement is gekoppeld. |
| type | tekenreeks | Het type overschrijding kan 'PhoneServices' zijn |
| Overage | booleaans | Een waarde die aangeeft of overschrijding is ingeschakeld. |
| Verwijzigingen | ResourceLinks | De overschrijdingsgerelateerde koppelingen. |
| kenmerken | ResourceAttributes | De metagegevenskenmerken. Bevat 'objectType': 'Overschrijding'. |
RegistrerenAbonnement
De resource RegisterSubscription 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 | Beschrijving |
|---|---|---|
| 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 | Beschrijving |
|---|---|---|
| type | tekenreeks | Het type restitutie. De ondersteunde waarden zijn 'Gedeeltelijk' en 'Volledig' |
| expiresAfter | tekenreeks in UTC-datum/tijdnotatie | Het tijdstempel wanneer deze optie verloopt. Als de restitutiebewerking null is, is deze niet verlopen. |
AzureEntitlement
De Resource AzureEntitlement 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.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| Id | tekenreeks | De id van het abonnementsregelitem. |
| Friendlyname | tekenreeks | De beschrijvende naam voor het abonnementsregelitem dat door de partner is gedefinieerd om te helpen bij het oplossen van de ondubbelzinnigheid. |
| scope | Scope | Bereik geeft aan waar voordelen van toepassing zijn. |
| autoRenewEnabled | Booleaans | 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.
| Eigenschap | 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 alleen worden geselecteerd via Azure Portal vandaag, maar updates worden weergegeven in de pc. |
| resourceGroupId | tekenreeks | De id van de resourcegroep die wordt gebruikt voor een aankoop. Dit bereik kan alleen worden geselecteerd via Azure Portal vandaag, maar updates worden weergegeven in de pc. |
Aankoopverplichting
Het vaste bedrag dat is vastgelegd voor rekenservices.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| bedrag | tekenreeks | De toezegging voor een vast bedrag. |
| Graan | tekenreeks | De periode voor de toezegging. |
| currency | tekenreeks | De valuta van de toezegging. |