Condividi tramite


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
billingAccountName
path True

string

ID che identifica in modo univoco un account di fatturazione.

billingSubscriptionName
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

BillingSubscription

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

  • Location: string
  • Retry-After: integer
Other Status Codes

ErrorResponse

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à.

AutoRenew

Indica se il rinnovo automatico è attivato o disattivato per un prodotto.

Beneficiary

Dettagli del beneficiario.

BillingSubscription

Proprietà di fatturazione di una sottoscrizione.

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.

BillingSubscriptionStatus

Stato della sottoscrizione. Questo campo non è disponibile per gli account di fatturazione del Contratto Enterprise

BillingSubscriptionStatusDetails

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.

createdByType

Tipo di identità che ha creato la risorsa.

ErrorAdditionalInfo

Informazioni aggiuntive sull'errore di gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

MoveBillingSubscriptionRequest

Richiedere parametri per trasferire la sottoscrizione di fatturazione.

NextBillingCycleDetails

Dettagli del ciclo di fatturazione del prodotto.

ProvisioningState

Stato di provisioning della risorsa durante un'operazione a esecuzione prolungata.

RenewalTermDetails

Dettagli per il prossimo periodo di rinnovo di una sottoscrizione.

Reseller

Dettagli del rivenditore.

SubscriptionEnrollmentAccountStatus

Stato dell'account di registrazione corrente della sottoscrizione. Questo campo è disponibile solo per il tipo di contratto Enterprise.

SubscriptionStatusReason

Motivo della sospensione di una sottoscrizione. Questo campo non è disponibile per gli account di fatturazione del Contratto Enterprise.

systemData

Metadati relativi alla creazione e all'ultima modifica della risorsa.

SystemOverrides

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

AutoRenew

Indica se il rinnovo automatico è attivato o disattivato per un prodotto.

properties.beneficiary

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

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

Amount

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

Amount

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

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

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.

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

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

RenewalTermDetails

Dettagli per il prossimo periodo di rinnovo di una sottoscrizione.

properties.reseller

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

BillingSubscriptionStatus

Stato della sottoscrizione. Questo campo non è disponibile per gli account di fatturazione del Contratto Enterprise

properties.subscriptionId

string

ID della sottoscrizione.

properties.suspensionReasonDetails

BillingSubscriptionStatusDetails[]

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

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

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

SubscriptionStatusReason

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

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

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

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

createdByType

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

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.