Billing Subscriptions - Move
Sposta gli addebiti per una sottoscrizione a una nuova sezione della fattura. La nuova sezione della fattura deve appartenere allo stesso profilo di fatturazione della sezione della fattura esistente. Questa operazione è supportata per gli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions/{billingSubscriptionName}/move?api-version=2024-04-01
Parametri dell'URI
Nome | In | Necessario | Tipo | Descrizione |
---|---|---|---|---|
billing
|
path | True |
string |
ID che identifica in modo univoco un account di fatturazione. |
billing
|
path | True |
string |
ID che identifica in modo univoco una sottoscrizione. |
api-version
|
query | True |
string |
Versione dell'API da usare con la richiesta client. La versione corrente è 2024-04-01. |
Corpo della richiesta
Nome | Tipo | Descrizione |
---|---|---|
destinationEnrollmentAccountId |
string |
ID dell'account di registrazione di destinazione. |
destinationInvoiceSectionId |
string |
ID sezione della fattura di destinazione. |
Risposte
Nome | Tipo | Descrizione |
---|---|---|
200 OK |
Proprietà di fatturazione di una sottoscrizione. |
|
202 Accepted |
Risultato accettato dell'operazione che restituisce un'intestazione 'Location' di cui il client può eseguire il polling per visualizzare il risultato dell'operazione. Intestazioni
|
|
Other Status Codes |
Risposta di errore che descrive il motivo per cui l'operazione non è riuscita. |
Esempio
BillingSubscriptionMove
Esempio di richiesta
POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingSubscriptions/6b96d3f2-9008-4a9d-912f-f87744185aa3/move?api-version=2024-04-01
{
"destinationInvoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingProfiles/ea36e548-1505-41db-bebc-46fff3d37998/invoiceSections/Q7GV-UUVA-PJA-TGB"
}
Risposta di esempio
{
"id": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingSubscriptions/6b96d3f2-9008-4a9d-912f-f87744185aa3",
"name": "6b96d3f2-9008-4a9d-912f-f87744185aa3",
"properties": {
"billingProfileId": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingProfiles/ea36e548-1505-41db-bebc-46fff3d37998",
"billingProfileDisplayName": "Contoso operations billing",
"consumptionCostCenter": "ABC1234",
"displayName": "My Subscription",
"invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/billingProfiles/ea36e548-1505-41db-bebc-46fff3d37998/invoiceSections/Q7GV-UUVA-PJA-TGB",
"invoiceSectionDisplayName": "Contoso operations invoiceSection",
"skuId": "0001",
"skuDescription": "Microsoft Azure Plan",
"status": "Active",
"subscriptionId": "6b96d3f2-9008-4a9d-912f-f87744185aa3"
},
"type": "Microsoft.Billing/billingAccounts/billingSubscriptions"
}
Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/a1a9c77e-4cec-4a6c-a089-867d973a6074:a80d3b1f-c626-4e5e-82ed-1173bd91c838_2019-05-31/operationResults/moveBillingSubscription_11000000-0000-0000-0000-000000000000:22000000-0000-0000-0000-000000000000:6b96d3f2-9008-4a9d-912f-f87744185aa3:44000000-0000-0000-0000-000000000055:10000000-0000-0000-0000-000000000001?api-version=2020-12-15-privatepreview
Retry-After: 30
Definizioni
Nome | Descrizione |
---|---|
Amount |
Quantità. |
Auto |
Indica se il rinnovo automatico è attivato o disattivato per un prodotto. |
Beneficiary |
Dettagli del beneficiario. |
Billing |
Proprietà di fatturazione di una sottoscrizione. |
Billing |
Stato di un'operazione nella sottoscrizione. Quando None, non è in corso alcuna operazione. Quando LockedForUpdate, le operazioni di scrittura verranno bloccate nella sottoscrizione di fatturazione. Altro è il valore predefinito e potrebbe essere necessario fare riferimento alla versione più recente dell'API per altri dettagli. |
Billing |
Stato della sottoscrizione. Questo campo non è disponibile per gli account di fatturazione del Contratto Enterprise |
Billing |
Dettagli della sospensione per una sottoscrizione. Questo campo non è disponibile per gli account di fatturazione del Contratto Enterprise. |
Cancellation |
L'override dei criteri per la sottoscrizione indica se è consentito l'annullamento self-service o la riduzione del posto. |
created |
Tipo di identità che ha creato la risorsa. |
Error |
Informazioni aggiuntive sull'errore di gestione delle risorse. |
Error |
Dettagli dell'errore. |
Error |
Risposta di errore |
Move |
Richiedere parametri per trasferire la sottoscrizione di fatturazione. |
Next |
Dettagli del ciclo di fatturazione del prodotto. |
Provisioning |
Stato di provisioning della risorsa durante un'operazione a esecuzione prolungata. |
Renewal |
Dettagli per il prossimo periodo di rinnovo di una sottoscrizione. |
Reseller |
Dettagli del rivenditore. |
Subscription |
Stato dell'account di registrazione corrente della sottoscrizione. Questo campo è disponibile solo per il tipo di contratto Enterprise. |
Subscription |
Motivo della sospensione di una sottoscrizione. Questo campo non è disponibile per gli account di fatturazione del Contratto Enterprise. |
system |
Metadati relativi alla creazione e all'ultima modifica della risorsa. |
System |
Criteri imposti dal sistema che regolano il comportamento della sottoscrizione. |
Amount
Quantità.
Nome | Tipo | Descrizione |
---|---|---|
currency |
string |
Valuta per il valore dell'importo. |
value |
number |
Valore dell'importo. Ad esempio, se la valuta è USD, il valore 600 sarà $600,00. |
AutoRenew
Indica se il rinnovo automatico è attivato o disattivato per un prodotto.
Valore | Descrizione |
---|---|
Off | |
On |
Beneficiary
Dettagli del beneficiario.
Nome | Tipo | Descrizione |
---|---|---|
objectId |
string |
ID che identifica in modo univoco un utente in un tenant. |
tenantId |
string |
ID che identifica in modo univoco un tenant. |
BillingSubscription
Proprietà di fatturazione di una sottoscrizione.
Nome | Tipo | Descrizione |
---|---|---|
id |
string (arm-id) |
ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
name |
string |
Nome della risorsa |
properties.autoRenew |
Indica se il rinnovo automatico è attivato o disattivato per un prodotto. |
|
properties.beneficiary |
Beneficiario della sottoscrizione di fatturazione. |
|
properties.beneficiaryTenantId |
string |
Tenant di provisioning della sottoscrizione. |
properties.billingFrequency |
string |
Frequenza di fatturazione nel formato ISO8601 del prodotto nella sottoscrizione. Esempio: P1M, P3M, P1Y |
properties.billingPolicies |
object |
Dizionario dei criteri di fatturazione associati alla sottoscrizione. |
properties.billingProfileDisplayName |
string |
Nome del profilo di fatturazione. |
properties.billingProfileId |
string |
ID completo che identifica in modo univoco un profilo di fatturazione. |
properties.billingProfileName |
string |
ID che identifica in modo univoco un profilo di fatturazione. |
properties.consumptionCostCenter |
string |
Centro di costo applicato alla sottoscrizione. Questo campo è disponibile solo per le sottoscrizioni a consumo degli account di fatturazione del Contratto del cliente Microsoft o Enterprise Agreement Type. |
properties.customerDisplayName |
string |
Nome del cliente. |
properties.customerId |
string |
ID completo che identifica in modo univoco un cliente. |
properties.customerName |
string |
ID che identifica in modo univoco un cliente. |
properties.displayName |
string |
Nome della sottoscrizione di fatturazione. |
properties.enrollmentAccountDisplayName |
string |
Nome dell'account di registrazione associato alla sottoscrizione. Questo campo è disponibile solo per gli account di fatturazione tipo contratto Enterprise. |
properties.enrollmentAccountId |
string |
ID account di registrazione associato alla sottoscrizione. Questo campo è disponibile solo per gli account di fatturazione tipo contratto Enterprise. |
properties.enrollmentAccountSubscriptionDetails.enrollmentAccountStartDate |
string (date-time) |
L'account di registrazione e la data di inizio dell'associazione della sottoscrizione. Questo campo è disponibile solo per il tipo di contratto Enterprise. |
properties.enrollmentAccountSubscriptionDetails.subscriptionEnrollmentAccountStatus |
Stato dell'account di registrazione corrente della sottoscrizione. Questo campo è disponibile solo per il tipo di contratto Enterprise. |
|
properties.invoiceSectionDisplayName |
string |
Nome della sezione della fattura. |
properties.invoiceSectionId |
string |
ID completo che identifica in modo univoco una sezione della fattura. |
properties.invoiceSectionName |
string |
ID che identifica in modo univoco una sezione della fattura. |
properties.lastMonthCharges |
Addebiti dell'ultimo mese. Questo campo è disponibile solo per le sottoscrizioni basate sull'utilizzo degli account di fatturazione del Contratto del cliente Microsoft. |
|
properties.monthToDateCharges |
Addebiti per il mese corrente. Questo campo è disponibile solo per le sottoscrizioni basate sull'utilizzo degli account di fatturazione del Contratto del cliente Microsoft. |
|
properties.nextBillingCycleDetails |
Dettagli del ciclo di fatturazione successivo della sottoscrizione. |
|
properties.offerId |
string |
ID offerta per la sottoscrizione. Questo campo è disponibile solo per gli account di fatturazione o gli account di fatturazione del programma Microsoft Online Services con il tipo di contratto Enterprise Agreement. |
properties.operationStatus |
Stato di un'operazione nella sottoscrizione. Quando None, non è in corso alcuna operazione. Quando LockedForUpdate, le operazioni di scrittura verranno bloccate nella sottoscrizione di fatturazione. Altro è il valore predefinito e potrebbe essere necessario fare riferimento alla versione più recente dell'API per altri dettagli. |
|
properties.productCategory |
string |
Categoria del prodotto per cui viene acquistata la sottoscrizione. I valori possibili includono: AzureSupport, Hardware, ReservationOrder, SaaS, SavingsPlanOrder, Software, UsageBased, Other. |
properties.productType |
string |
Tipo di prodotto per il quale viene acquistata la sottoscrizione. |
properties.productTypeId |
string |
ID del prodotto per il quale viene acquistata la sottoscrizione. |
properties.provisioningState |
Stato di provisioning della risorsa durante un'operazione a esecuzione prolungata. |
|
properties.provisioningTenantId |
string |
Tenant in cui viene effettuato il provisioning della sottoscrizione. |
properties.purchaseDate |
string (date-time) |
Data di acquisto del prodotto nell'ora UTC. |
properties.quantity |
integer (int64) |
Quantità di licenze o unità di evasione per la sottoscrizione. |
properties.renewalTermDetails |
Dettagli per il prossimo periodo di rinnovo di una sottoscrizione. |
|
properties.reseller |
Rivenditore per questa sottoscrizione. I campi non sono disponibili per gli account di fatturazione del Contratto Microsoft Partner. |
|
properties.resourceUri |
string |
Identificatore univoco della risorsa collegata. |
properties.skuDescription |
string |
Descrizione SKU del prodotto per il quale viene acquistata la sottoscrizione. Questo campo è disponibile solo per gli account di fatturazione con tipo di contratto Microsoft Customer Agreement e Contratto Microsoft Partner. |
properties.skuId |
string |
ID SKU del prodotto per cui viene acquistata la sottoscrizione. Questo campo è disponibile solo per gli account di fatturazione del Contratto del cliente Microsoft. |
properties.status |
Stato della sottoscrizione. Questo campo non è disponibile per gli account di fatturazione del Contratto Enterprise |
|
properties.subscriptionId |
string |
ID della sottoscrizione. |
properties.suspensionReasonDetails |
Dettagli della sospensione per una sottoscrizione. Questo campo non è disponibile per gli account di fatturazione del Contratto Enterprise. |
|
properties.suspensionReasons |
string[] |
Motivo della sospensione di una sottoscrizione. Questo campo non è disponibile per gli account di fatturazione del Contratto Enterprise. |
properties.systemOverrides |
Criteri imposti dal sistema che regolano il comportamento della sottoscrizione. |
|
properties.termDuration |
string |
Durata nel formato ISO8601 per cui è possibile usare la sottoscrizione. Esempio: P1M, P3M, P1Y |
properties.termEndDate |
string (date-time) |
Data di fine del termine nell'ora UTC. |
properties.termStartDate |
string (date-time) |
Data di inizio del termine nell'ora UTC. |
systemData |
Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy. |
|
tags |
object |
Dizionario dei metadati associati alla risorsa. Potrebbe non essere popolato per tutti i tipi di risorse. Lunghezza massima chiave/valore supportata di 256 caratteri. Chiavi/valore non deve essere vuoto né null. Le chiavi non possono contenere <> % & \ ? / |
type |
string |
Tipo della risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts" |
BillingSubscriptionOperationStatus
Stato di un'operazione nella sottoscrizione. Quando None, non è in corso alcuna operazione. Quando LockedForUpdate, le operazioni di scrittura verranno bloccate nella sottoscrizione di fatturazione. Altro è il valore predefinito e potrebbe essere necessario fare riferimento alla versione più recente dell'API per altri dettagli.
Valore | Descrizione |
---|---|
LockedForUpdate | |
None | |
Other |
BillingSubscriptionStatus
Stato della sottoscrizione. Questo campo non è disponibile per gli account di fatturazione del Contratto Enterprise
Valore | Descrizione |
---|---|
Active | |
AutoRenew | |
Cancelled | |
Deleted | |
Disabled | |
Expired | |
Expiring | |
Failed | |
Other | |
Suspended | |
Unknown | |
Warned |
BillingSubscriptionStatusDetails
Dettagli della sospensione per una sottoscrizione. Questo campo non è disponibile per gli account di fatturazione del Contratto Enterprise.
Nome | Tipo | Descrizione |
---|---|---|
effectiveDate |
string (date-time) |
Data di validità della sospensione per una sottoscrizione. Questo campo non è disponibile per gli account di fatturazione del Contratto Enterprise. |
reason |
Motivo della sospensione di una sottoscrizione. Questo campo non è disponibile per gli account di fatturazione del Contratto Enterprise. |
Cancellation
L'override dei criteri per la sottoscrizione indica se è consentito l'annullamento self-service o la riduzione del posto.
Valore | Descrizione |
---|---|
Allowed | |
NotAllowed |
createdByType
Tipo di identità che ha creato la risorsa.
Valore | Descrizione |
---|---|
Application | |
Key | |
ManagedIdentity | |
User |
ErrorAdditionalInfo
Informazioni aggiuntive sull'errore di gestione delle risorse.
Nome | Tipo | Descrizione |
---|---|---|
info |
object |
Informazioni aggiuntive. |
type |
string |
Tipo di informazioni aggiuntive. |
ErrorDetail
Dettagli dell'errore.
Nome | Tipo | Descrizione |
---|---|---|
additionalInfo |
Informazioni aggiuntive sull'errore. |
|
code |
string |
Codice di errore. |
details |
Dettagli dell'errore. |
|
message |
string |
Messaggio di errore. |
target |
string |
Destinazione dell'errore. |
ErrorResponse
Risposta di errore
Nome | Tipo | Descrizione |
---|---|---|
error |
Oggetto error. |
MoveBillingSubscriptionRequest
Richiedere parametri per trasferire la sottoscrizione di fatturazione.
Nome | Tipo | Descrizione |
---|---|---|
destinationEnrollmentAccountId |
string |
ID dell'account di registrazione di destinazione. |
destinationInvoiceSectionId |
string |
ID sezione della fattura di destinazione. |
NextBillingCycleDetails
Dettagli del ciclo di fatturazione del prodotto.
Nome | Tipo | Descrizione |
---|---|---|
billingFrequency |
string |
Frequenza di fatturazione del prodotto nella sottoscrizione. |
ProvisioningState
Stato di provisioning della risorsa durante un'operazione a esecuzione prolungata.
Valore | Descrizione |
---|---|
Canceled | |
Failed | |
New | |
Pending | |
Provisioning | |
Succeeded |
RenewalTermDetails
Dettagli per il prossimo periodo di rinnovo di una sottoscrizione.
Nome | Tipo | Descrizione |
---|---|---|
billingFrequency |
string |
Frequenza di fatturazione nel formato ISO8601 del prodotto nella sottoscrizione. Esempio: P1M, P3M, P1Y |
productId |
string |
ID del prodotto per il quale viene acquistata la sottoscrizione. |
productTypeId |
string |
Tipo ID del prodotto per il quale viene acquistata la sottoscrizione. |
quantity |
integer (int64) |
Quantità di licenze o unità di evasione per la sottoscrizione. |
skuId |
string |
ID SKU del prodotto per cui viene acquistata la sottoscrizione. Questo campo è disponibile solo per gli account di fatturazione del Contratto del cliente Microsoft. |
termDuration |
string |
Durata nel formato ISO8601 per cui è possibile usare la sottoscrizione. Esempio: P1M, P3M, P1Y |
termEndDate |
string (date-time) |
Data di fine del termine nell'ora UTC. |
Reseller
Dettagli del rivenditore.
Nome | Tipo | Descrizione |
---|---|---|
description |
string |
Nome del rivenditore. |
resellerId |
string |
ID MPN del rivenditore. |
SubscriptionEnrollmentAccountStatus
Stato dell'account di registrazione corrente della sottoscrizione. Questo campo è disponibile solo per il tipo di contratto Enterprise.
Valore | Descrizione |
---|---|
Active | |
Cancelled | |
Deleted | |
Expired | |
Inactive | |
TransferredOut | |
Transferring |
SubscriptionStatusReason
Motivo della sospensione di una sottoscrizione. Questo campo non è disponibile per gli account di fatturazione del Contratto Enterprise.
Valore | Descrizione |
---|---|
Cancelled | |
Expired | |
None | |
Other | |
PastDue | |
PolicyViolation | |
SpendingLimitReached | |
SuspiciousActivity | |
Transferred |
systemData
Metadati relativi alla creazione e all'ultima modifica della risorsa.
Nome | Tipo | Descrizione |
---|---|---|
createdAt |
string (date-time) |
Timestamp della creazione della risorsa (UTC). |
createdBy |
string |
Identità che ha creato la risorsa. |
createdByType |
Tipo di identità che ha creato la risorsa. |
|
lastModifiedAt |
string (date-time) |
Timestamp dell'ultima modifica della risorsa (UTC) |
lastModifiedBy |
string |
Identità che ha modificato l'ultima volta la risorsa. |
lastModifiedByType |
Tipo di identità che ha modificato l'ultima volta la risorsa. |
SystemOverrides
Criteri imposti dal sistema che regolano il comportamento della sottoscrizione.
Nome | Tipo | Descrizione |
---|---|---|
cancellation |
L'override dei criteri per la sottoscrizione indica se è consentito l'annullamento self-service o la riduzione del posto. |
|
cancellationAllowedEndDate |
string (date-time) |
Data di fine in ora UTC entro la fine dell'annullamento self-service. |