Condividi tramite

Risorse della sottoscrizione

  • Articolo

Si applica a: Centro per i partner | Centro per i partner gestito da 21Vianet | Centro per i partner per Microsoft Cloud per il governo degli Stati Uniti

Una sottoscrizione consente a un cliente di usare un servizio per un determinato periodo di tempo. Non tutti i campi si applicano a tutte le sottoscrizioni. Molti campi si applicano solo in determinati punti del ciclo di vita, ad esempio se una sottoscrizione viene sospesa o annullata.

Abbonamento

Nota

La risorsa sottoscrizione ha un limite di frequenza di 500 richieste al minuto per identificatore del tenant.

La risorsa Sottoscrizione rappresenta il ciclo di vita di una sottoscrizione e include proprietà che definiscono gli stati durante il ciclo di vita della sottoscrizione.

Proprietà Type Descrizione
ID string L'identificatore della sottoscrizione.
offerId string Identificatore dell'offerta.
entitlementId string Identificatore entitlement (ID sottoscrizione di Azure).
offerName string Nome dell'offerta.
friendlyName string Nome descrittivo per la sottoscrizione definita dal partner per evitare ambiguità.
quantity number Quantità. Questa proprietà è impostata sul numero di licenze per la fatturazione basata su licenza.
unitType string Le unità che definiscono la quantità per la sottoscrizione: "Licenze", "Basato sull'utilizzo" o "Benefit".
parentSubscriptionId string Ottiene o imposta l'identificatore della sottoscrizione padre.
creationDate string Ottiene o imposta la data di creazione, in formato data/ora.
effectiveStartDate stringa in formato data e ora UTC Ottiene o imposta la data di inizio effettiva per questa sottoscrizione, in formato data/ora. Questa proprietà viene utilizzata per tornare alla data di una sottoscrizione migrata o per allinearla a un'altra.
commitmentEndDate stringa in formato data e ora UTC Data di fine dell'impegno per questa sottoscrizione, in formato data/ora. Per le sottoscrizioni che non sono modificabili automaticamente, questa proprietà rappresenta una data lontana in futuro. Le nuove date di fine commercio sono inclusive, ovvero la fine del termine è alla fine del giorno intero. Le date di fine legacy non sono incluse.
commitmentEndDateTime stringa in formato data e ora UTC Data e ora di fine dell'impegno per questa sottoscrizione, in formato data/ora. Per le sottoscrizioni che non sono modificabili automaticamente, questa proprietà rappresenta una data lontana in futuro.
stato string Stato della sottoscrizione: "none", "active", "pending", "suspended", "expired", "disabled" o "deleted".
autoRenewEnabled boolean Ottiene un valore che indica se la sottoscrizione viene rinnovata automaticamente.
billingType string Specifica la modalità di fatturazione della sottoscrizione: "none", "usage", "license" o "benefit".
billingCycle string Indica la frequenza con cui il partner viene fatturato per questo ordine. I valori supportati sono i nomi di membro presenti in BillingCycleType.
hasPurchasableAddons boolean Ottiene o imposta un valore che indica se la sottoscrizione dispone di componenti aggiuntivi acquistabili.
isTrial boolean Valore che indica se la sottoscrizione è una versione di valutazione.
isMicrosoftProduct boolean Valore che indica se la sottoscrizione è un prodotto Microsoft.
publisherName string Nome dell'editore.
actions matrice di stringhe Ottiene o imposta le azioni consentite. Valori possibili: "edit", "cancel"
partnerId string PartnerID del rivenditore di record, usato nel modello di partner indiretto.
suspensionReasons matrice di stringhe Sola lettura. Se la sottoscrizione è stata sospesa, indica perché.
contractType string Sola lettura. Tipo di contratto: "subscription", "productKey" o "redemptionCode".
refundOptions matrice di risorse RefundOption Sola lettura. Set di opzioni di rimborso disponibili per questa sottoscrizione.
scheduledNextTermInstructions scheduledNextTermInstructions Ottiene o imposta le istruzioni pianificate eseguite all'avvio del termine successivo.
nextChargeInstructions nextChargeInstructions Ottiene i dettagli per le istruzioni di fatturazione a termine successivo per le modifiche del ciclo di fatturazione in sospeso alla fine del periodo corrente.
collegamenti SubscriptionLinks Ottiene o imposta i collegamenti di sottoscrizione.
orderId string ID dell'ordine che è stato effettuato per iniziare la sottoscrizione.
termDuration string Rappresentazione ISO 8601 della durata del termine. I valori supportati correnti sono P1M (1 mese), P1Y (1 anno) e P3Y (3 anni).
Attributi ResourceAttributes Attributi di metadati corrispondenti alla sottoscrizione.
renewalTermDuration string Rappresentazione ISO 8601 della durata del termine. I valori supportati correnti sono P1M (1 mese) e P1Y (1 anno).
ProductType Itemtype Sola lettura. Il tipo di prodotto per cui la sottoscrizione è destinata.
consumptionType matrice di risorse di eccedenza Ottiene o imposta l'eccedenza per un determinato cliente.
promotionId string Identificatore di promozione se applicato alla sottoscrizione. Esempio di formato: "39NFJQT1PJQB:0001:39NFJQT1Q5KN"
CancellationAllowedUntilDate Data/Ora Ultima data per l'annullamento.
BillingCycleEndDate Data/Ora Ottiene o imposta la data di fine del ciclo di fatturazione per questa sottoscrizione, in formato data/ora.
BillingCycleEndDateTime Data/Ora Ottiene l'ora di fine del ciclo di fatturazione per questa sottoscrizione, in formato data e ora.
productOrderId string Identificatore per un acquisto di prodotto specifico, ad esempio prenotazioni o piano di risparmio di Azure.
lineItems SubscriptionLineItem Una voce contiene i dettagli di acquisto di una determinata sottoscrizione.

La risorsa SubscriptionLinks descrive la raccolta di collegamenti collegati a una risorsa di sottoscrizione.

Proprietà Type Descrizione
offerta Collegamento Ottiene o imposta l'offerta.
parentSubscription Collegamento Ottiene o imposta la sottoscrizione padre.
product Collegamento Ottiene il prodotto associato alla sottoscrizione.
sku Collegamento Ottiene lo SKU del prodotto associato alla sottoscrizione.
availability Collegamento Ottiene la disponibilità dello SKU del prodotto associata alla sottoscrizione.
activationLinks Collegamento Ottiene l'elenco dei collegamenti di attivazione associati alla sottoscrizione.
self Collegamento URI automatico.
next Collegamento Pagina successiva di elementi.
previous Collegamento Pagina precedente di elementi.

SubscriptionProvisioningStatus

La risorsa SubscriptionProvisioningStatus fornisce informazioni sullo stato di provisioning di una sottoscrizione.

Proprietà Type Descrizione
skuId string Stringa che identifica lo SKU del prodotto.
stato string Indica lo stato del provisioning: "esito positivo", "in sospeso" o "non riuscito".
quantity number Fornisce la quantità di sottoscrizione dopo il provisioning.
endDate stringa in formato data e ora UTC Data di fine della sottoscrizione.
Attributi ResourceAttributes Attributi dei metadati.

scheduledNextTermInstructions

La risorsa scheduledNextTermInstructions definisce le istruzioni da applicare all'inizio del termine successivo della sottoscrizione. Presente solo se vengono impostate modifiche pianificate o per tutte le sottoscrizioni di valutazione.

Proprietà Type Descrizione
product product Stringa con formattazione GUID che identifica lo SKU del prodotto.
quantity number Fornisce la quantità di sottoscrizione dopo il provisioning.
customTermEndDate stringa in formato data e ora UTC Data di fine personalizzata per la sottoscrizione allineata alla data di fine di un'altra sottoscrizione

Prodotto

La risorsa scheduledNextTermInstructions.product e gli attributi di una modifica pianificata verranno applicati al termine successivo.

Proprietà Type Descrizione
productId String ID di un prodotto.
skuId String Fornisce la quantità di sottoscrizione dopo il provisioning.
availabilityId String ID per questa disponibilità. Questo ID è univoco solo all'interno del contesto del prodotto padre e dello SKU. Nota Gli ID di disponibilità possono cambiare nel tempo. I partner devono basarsi solo su questo valore entro un breve intervallo di tempo dopo il recupero.
billingCycle String Indica la frequenza con cui il partner viene fatturato per questo ordine. I valori supportati sono i nomi di membro presenti in BillingCycleType.
termDuration String Rappresentazione ISO 8601 della durata del termine. I valori supportati correnti sono P1M (1 mese) e P1Y (1 anno).
promotionId String Identificatore di promozione da applicare per il termine pianificato successivo. Esempio di formato: "39NFJQT1PJQB:0001:39NFJQT1Q5KN".

nextChargeInstructions

La risorsa nextChargeInstructions definisce le istruzioni del ciclo di fatturazione applicate all'inizio del termine successivo della sottoscrizione. Presente solo quando le modifiche del ciclo di fatturazione in sospeso sono in sospeso.

Proprietà Type Descrizione
product product Stringa con formattazione GUID che identifica lo SKU del prodotto.
quantity number Fornisce la quantità di sottoscrizione dopo il provisioning.

SubscriptionRegistrationStatus

La risorsa SubscriptionRegistrationStatus descrive la raccolta di collegamenti collegati a una risorsa di sottoscrizione.

Proprietà Type Descrizione
subscriptionId string L'identificatore della sottoscrizione.
stato string Indica lo stato di registrazione: "registered", "registration" o "notregistered".

SupportContact

La risorsa SupportContact rappresenta un contatto di supporto per la sottoscrizione di un cliente.

Proprietà Type Descrizione
supportTenantId string Stringa con formato GUID che indica l'identificatore del tenant del contatto di supporto.
supportMpnId string Identificatore partner del contatto.
name string Nome del contatto di supporto.
collegamenti ResourceLinks Collegamenti correlati al contatto del supporto tecnico.
Attributi ResourceAttributes Attributi dei metadati. Contiene "objectType": " SupportContact".

Eccedenza

La risorsa di eccedenza rappresenta l'eccedenza della sottoscrizione a consumo può essere assegnata, indipendentemente dal fatto che sia assegnata e rivenditore assegnata.

Proprietà Type Descrizione
azureEntitlementId string Stringa con formato GUID che indica l'identificatore della sottoscrizione a consumo.
partnerId string Identificatore partner del rivenditore associato alla sottoscrizione.
type string Il tipo di eccedenza può essere "Telefono Services"
Eccedenza boolean Valore che indica se l'eccedenza è abilitata.
collegamenti ResourceLinks Collegamenti correlati all'eccedenza.
Attributi ResourceAttributes Attributi dei metadati. Contiene "objectType": "Overage".

RegisterSubscription

La risorsa RegisterSubscription restituisce un collegamento che può essere usato per eseguire una query sullo stato di registrazione di una sottoscrizione. Lo stato di registrazione viene restituito nel corpo della risposta di una richiesta accettata per registrare una sottoscrizione di Azure.

Proprietà Type Descrizione
httpResponseMessage oggetto Restituisce il codice di stato HTTP 202 "Accettato", con un'intestazione Location contenente un collegamento per eseguire una query sullo stato della registrazione. Ad esempio, "/customers/{customer-id}/subscriptions/{subscription-id}/registrationstatus"

RefundOption

La risorsa RefundOption rappresenta un'opzione di rimborso possibile per la sottoscrizione.

Proprietà Type Descrizione
type string Tipo di rimborso. I valori supportati sono "Partial" e "Full"
expiresAfter stringa in formato data e ora UTC Timestamp alla scadenza di questa opzione. Se null, l'operazione di rimborso non ha scadenza.

AzureEntitlement

La risorsa AzureEntitlement rappresenta i diritti di Azure per la sottoscrizione.

Proprietà Type Descrizione
ID string Identificatore entitlement
friendlyName string Nome descrittivo del diritto.
stato string Stato del diritto.
subscriptionId string Identificatore della sottoscrizione a cui appartiene l'entitlement.

SubscriptionLineItem

Una voce contiene i dettagli di acquisto di una determinata sottoscrizione.

Proprietà Tipo Descrizione
ID string Identificatore dell'elemento della riga della sottoscrizione.
friendlyName string Nome descrittivo per l'elemento della riga di sottoscrizione definito dal partner per evitare ambiguità.
ambito Scope L'ambito indica dove si applicano i vantaggi.
autoRenewEnabled Booleano Ottiene un valore che indica se la sottoscrizione viene rinnovata automaticamente.
stato string Stato della sottoscrizione: "none", "active", "pending", "suspended", "expired", "disabled" o "deleted".
purchaseCommitment Impegno di acquisto Importo fisso di cui è stato eseguito il commit nei servizi di calcolo.

Ambito

L'ambito indica dove si applicano i vantaggi.

Proprietà Tipo Descrizione
type string Tipo di ambito per un acquisto: "Single", "Shared", "Resource group" o "Management group".
subscriptionId string ID del piano di Azure che verrebbe usato per un acquisto. Obbligatorio per l'ambito condiviso.
entitlementId string ID della sottoscrizione di Azure che verrebbe usata per un acquisto. Obbligatorio per ambito singolo.
managementGroupId string ID del gruppo di gestione che verrebbe utilizzato per un acquisto. Questo ambito può essere selezionato solo tramite portale di Azure oggi, ma gli aggiornamenti riflettono nel PC.
resourceGroupId string ID del gruppo di risorse che verrebbe usato per un acquisto. Questo ambito può essere selezionato solo tramite portale di Azure oggi, ma gli aggiornamenti riflettono nel PC.

Impegno di acquisto

Importo fisso di cui è stato eseguito il commit nei servizi di calcolo.

Proprietà Tipo Descrizione
amount string Impegno fisso.
Grano string Periodo per l'impegno.
currency string Valuta dell'impegno.