Risorse della sottoscrizione
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. |
SubscriptionLinks
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. |