Abonnementbronnen
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 Abonnement resource vertegenwoordigt de levenscyclus van een abonnement en bevat eigenschappen die de statussen gedurende de levenscyclus van het abonnement definiëren.
| Eigendom | Type | Beschrijving |
|---|---|---|
| ID | tekenreeks | De abonnements-id. |
| offerId | snaar | De aanbiedings-id. |
| bevoegdheidsId | string | De rechtentoewijzings-id (een Azure-abonnements-ID). |
| aanbiedingen naam | snaar | De naam van de aanbieding. |
| vriendelijkeNaam | tekenreeks | De vriendelijke naam voor het abonnement dat door de partner is gedefinieerd om verwarring te voorkomen. |
| hoeveelheid | getal | De hoeveelheid. Deze eigenschap is ingesteld op het aantal licenties voor facturering op basis van licenties. |
| typeEenheid | tekenreeks | De eenheden die hoeveelheid definiëren voor het abonnement: 'Licenties', 'Op gebruik gebaseerd' of 'Voordeel'. |
| ouderAbonnementId | tekenreeks | Hiermee haalt u de ouderabonnements-id op of stelt u deze in. |
| aanmaakdatum | tekenreeks | Hiermee haalt u de aanmaakdatum op of stelt u deze in datum-/tijdnotatie in. |
| ingangsdatum | string in de UTC-datum/tijdnotatie | Hiermee wordt de effectieve begindatum voor dit abonnement opgehaald of ingesteld in datum-tijdformaat. Deze eigenschap wordt gebruikt om een gemigreerd abonnement achteraf te dateren of om het af te stemmen met een ander. |
| einddatum verplichting | tekenreeks in UTC-datum-tijdformaat | 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. |
| einde datumtijd van verbintenis | tekenreeks in UTC-datum/tijdformaat | 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 | touwtje | De abonnementsstatus: "geen", "actief", "in behandeling", "opgeschort", "verlopen", "uitgeschakeld" of "verwijderd". |
| automatisch verlengen ingeschakeld | booleaans | Hiermee wordt een waarde opgehaald die aangeeft of het abonnement automatisch wordt verlengd. |
| factureringstype | draad | Hiermee geeft u op hoe het abonnement wordt gefactureerd: "geen", "gebruik", "licentie" of "voordeel". |
| billingCycle | snaar | Geeft de frequentie aan waarmee de partner wordt gefactureerd voor deze bestelling. Ondersteunde waarden zijn de lidnamen in BillingCycleType. |
| heeft koopbare uitbreidingen | booleaans | Hiermee wordt een waarde opgehaald of ingesteld die aangeeft of het abonnement invoegtoepassingen heeft die kunnen worden aangeschaft. |
| 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. |
| Naam uitgever | snaar | De naam van de uitgever. |
| Acties | reeks van tekenreeksen | Bepaalt of stelt de toegestane acties in. Mogelijke waarden: 'bewerken', 'annuleren' |
| partnerId | string | De PartnerID van de reseller van de record, die wordt gebruikt in het indirecte partnermodel. |
| schorsingsredenen | matrix van tekenreeksen | Alleenlezen. Als het abonnement is onderbroken, geeft u aan waarom. |
| contractType | snaar | Alleen lezen. Het type contract: "abonnement", "productcode" of "activationcode". |
| terugbetalingsopties | array van RefundOption bronnen | Alleen lezen. De set restitutieopties die beschikbaar zijn voor dit abonnement. |
| geplandeVolgendeTermijnInstructies | scheduledNextTermInstructions | Hiermee worden de geplande instructies opgehaald of ingesteld die worden uitgevoerd wanneer de volgende term wordt gestart. |
| volgende laad-instructies | volgendeOplaadInstructies | 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. |
| links | SubscriptionLinks | Hiermee haalt u de abonnementskoppelingen op of stelt u deze in. |
| bestelId | snaar | De id van de bestelling die is geplaatst om het abonnement te starten. |
| looptijd | snaar | 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. |
| duur van de verlengingstermijn | 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 | array van overschot middelen | Hiermee haalt u overschrijding voor een bepaalde klant op of stelt u deze in. |
| promotionId | snaar | De promotie-id als deze wordt toegepast op het abonnement. Voorbeeld van formaat: "39NFJQT1PJQB:0001:39NFJQT1Q5KN" |
| AnnuleringToegestaanTotDatum | Datum/tijd | De laatste datum voor annulering. |
| EinddatumFactureringscyclus | Datum/tijd | Hiermee wordt de einddatum van de factureringscyclus voor dit abonnement opgehaald of ingesteld in datum-/tijdnotatie. |
| BillingCycleEndDateTime | Datum/tijd | Hiermee haalt u de einddatum van de factureringscyclus voor dit abonnement op in datum-tijdnotatie. |
| productBestelId | string | Id voor een specifieke productaankoop (bijvoorbeeld Reserveringen of Een Azure-spaarplan). |
| lineItems | AbonneeRegelItem | Een regelitem bevat de aankoopgegevens van een bepaald abonnement. |
AbonnementLinks
De SubscriptionLinks resource beschrijft de verzameling koppelingen die zijn gekoppeld aan een abonnementsresource.
| Onroerend goed / Eigendom (depending on context) | Type | Beschrijving |
|---|---|---|
| aanbod | koppelen | Hiermee kunt u de aanbieding ophalen of instellen. |
| ouderabonnement | koppelen | Hiermee wordt het bovenliggende abonnement opgehaald of ingesteld. |
| product | koppelen | Het product dat bij het abonnement hoort, wordt opgehaald. |
| Sku | koppelen | Haalt de product-SKU op die is gekoppeld aan het abonnement. |
| beschikbaarheid | koppelen | Hiermee wordt de beschikbaarheid van de product-sku opgehaald die is gekoppeld aan het abonnement. |
| activationLinks | koppelen | Hiermee haalt u de lijst met activeringskoppelingen op die zijn gekoppeld aan het abonnement. |
| zelf | koppelen | De zelf-URI. |
| volgend | koppelen | De volgende pagina met artikelen. |
| vorig | koppelen | De vorige pagina met items. |
AbonnementVoorzieningsStatus
De resource SubscriptionProvisioningStatus bevat informatie over de provisioneringsstatus van een abonnement.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| skuId | tekenreeks | Een tekenreeks die de product-SKU identificeert. |
| status | string | Geeft de inrichtingsstatus aan: 'geslaagd', 'in behandeling' of 'mislukt'. |
| hoeveelheid | getal | Geeft de hoeveelheid abonnementen nadat deze zijn geconfigureerd. |
| einddatum | tekenreeks in UTC-datum- en tijdnotatie | De einddatum van het abonnement. |
| Kenmerken | ResourceAttributes | De metagegevenskenmerken. |
geplandeInstructiesVoorVolgendePeriode
De scheduledNextTermInstructions resource 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 in GUID-indeling die de product-SKU identificeert. |
| hoeveelheid | getal | Geeft het aantal abonnementen op na het inrichten. |
| customTermEndDate | tekenreeks in UTC-datum/tijdformaat | De aangepaste einddatum voor het abonnement wanneer deze is afgestemd op de einddatum van een ander abonnement |
Product
De scheduledNextTermInstructions.product hulpbron en attributen waarop een geplande wijziging van toepassing zal zijn bij de volgende termijn.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| ProductID | Snaar | De id voor een product. |
| skuId | Draad | Geeft het aantal abonnementen op na het inrichten. |
| beschikbaarheidsId | Snaar | De ID voor deze beschikbaarheid. Deze ID is alleen uniek binnen de context van het bovenliggende product , en SKU . Opmerking 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 | Snaar | Geeft de frequentie aan waarmee de partner wordt gefactureerd voor deze bestelling. Ondersteunde waarden zijn de ledennamen gevonden in BillingCycleType. |
| Looptijd | Snaar | Een ISO 8601-weergave van de duur van de term. De huidige ondersteunde waarden zijn P1M- (1 maand) en P1Y- (1 jaar). |
| promotionId | Snaar | De promotie-identificatie die van toepassing is op de volgende geplande termijn. Voorbeeld van indeling: '39NFJQT1PJQB:0001:39NFJQT1Q5KN'. |
nextChargeInstructions
De nextChargeInstructions 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 | Beschrijving |
|---|---|---|
| product | product | Een GUID-gestyleerde tekenreeks die het product-SKU identificeert. |
| hoeveelheid | getal | Geeft het aantal abonnementen op na het inrichten. |
Abonnementsregistratiestatus
De SubscriptionRegistrationStatus resource beschrijft de verzameling koppelingen die zijn gekoppeld aan een abonnementsresource.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| abonnementId | string | De abonnements-id. |
| status | snaar | Geeft de registratiestatus aan: 'geregistreerd', 'registreren' of 'niet geregistreerd'. |
Ondersteuningscontact
De SupportContact resource vertegenwoordigt een ondersteuningsmedewerker voor het abonnement van een klant.
| Eigendom | Type | Beschrijving |
|---|---|---|
| supportTenantId | string | Een tekenreeks met GUID-indeling die de tenant-id van de ondersteuningsmedewerker aangeeft. |
| supportMpnId | snaar | Partner-ID van de contactpersoon. |
| naam | snaar | De naam van de ondersteuningsmedewerker. |
| links | ResourceLinks - | De met ondersteuning gerelateerde contactkoppelingen. |
| Kenmerken | ResourceAttributes | De metagegevenskenmerken. Bevat 'objectType': 'SupportContact'. |
Overschot
De overschrijding resource vertegenwoordigt mogelijk de overschrijding van het verbruiksabonnement, ongeacht of deze is toegewezen en de toegewezen reseller.
| Eigenschap | Type | Beschrijving |
|---|---|---|
| azureEntitlementId | snaar | Een tekenreeks in GUID-indeling die de identificatie van het verbruiksabonnement aangeeft. |
| partnerId | snaar | De partner-id van de reseller die is gekoppeld aan het abonnement. |
| soort | touwtje | Het type overschrijding kan 'PhoneServices' zijn |
| overschot | booleaans | Een waarde die aangeeft of overschrijding is ingeschakeld. |
| koppelingen | ResourceLinks | De overschrijdingsgerelateerde koppelingen. |
| Kenmerken | ResourceAttributes | De metagegevenskenmerken. Bevat 'objectType': 'Overschrijding'. |
AbonnementRegistreren
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 | 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" |
Teruggaveoptie
De RefundOption resource vertegenwoordigt een mogelijke restitutieoptie voor het abonnement.
| Eigendom | Type | Beschrijving |
|---|---|---|
| soort | tekenreeks | Het type restitutie. De ondersteunde waarden zijn Gedeeltelijk en Volledig |
| vervaltNa | tekenreeks in UTC-datum/tijd formaat | 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.
| Eigendom | Type | Beschrijving |
|---|---|---|
| ID | reeks | De toekennings-ID |
| vriendelijke naam | koord | De vriendelijke naam van het recht. |
| status | snaar | De status van de aanspraak. |
| subscriptionId | snaar | De abonnementsidentificatie waaraan de toewijzing gekoppeld is. |
Abonnementsregelitem
Een regelitem bevat de aankoopgegevens van een bepaald abonnement.
| Eigenschap | type | beschrijving |
|---|---|---|
| ID-kaart | snaar | De item-id van de abonnementsregel. |
| vriendelijke naam | string | De vriendelijke naam voor het regelitem van het abonnement dat door de partner is gedefinieerd om verwarring te voorkomen. |
| reikwijdte | Omvang | Bereik geeft aan waar voordelen van toepassing zijn. |
| automatischVernieuwenIngeschakeld | Booleaans | Hiermee wordt een waarde opgehaald die aangeeft of het abonnement automatisch wordt verlengd. |
| status | snaar | De abonnementsstatus: 'geen', 'actief', 'in behandeling', 'geschorst', 'verlopen', 'uitgeschakeld' of 'verwijderd'. |
| aankoopverplichting | aankoopverplichting | Het vaste bedrag dat is vastgelegd voor rekenservices. |
Draagwijdte
Bereik geeft aan waar voordelen van toepassing zijn.
| Eigenschap | type | Beschrijving |
|---|---|---|
| type | tekenreeks | Het bereiktype voor een aankoop: 'Enkel', 'Gedeeld', 'Resourcegroep' of 'Beheergroep'. |
| abonnementId | snaar | De id van het Azure-abonnement dat wordt gebruikt voor een aankoop. Vereist voor gedeeld bereik. |
| rechtId | snaar | De id van het Azure-abonnement dat wordt gebruikt voor een aankoop. Vereist voor één bereik. |
| beheerGroepId | koord | De ID van de beheergroep die zou worden gebruikt voor een aankoop. Dit bereik kan momenteel alleen worden geselecteerd via Azure Portal, maar updates worden weergegeven op pc. |
| resourceGroupId | koord | De ID van de resourcegroep die zal worden 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.
| Kenmerk | type | Beschrijving |
|---|---|---|
| aantal | snaar / tekenreeks | De toezegging voor vast bedrag. |
| graan | snaar | De periode voor de toezegging. |
| valuta | tekenreeks | De valuta van de toezegging. |