Products - Transfer

Sposta gli addebiti di un prodotto in 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 solo per i prodotti acquistati con un addebito ricorrente e per gli account di fatturazione con tipo di contratto Contratto del cliente Microsoft.

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/products/{productName}/transfer?api-version=2019-10-01-preview

Parametri dell'URI

Name In Required Type Description
billingAccountName
path True
  • string

ID che identifica in modo univoco un account di fatturazione.

billingProfileName
path True
  • string

ID che identifica in modo univoco un profilo di fatturazione.

invoiceSectionName
path True
  • string

ID che identifica in modo univoco una sezione della fattura.

productName
path True
  • string

ID che identifica in modo univoco un prodotto.

api-version
query True
  • string

Versione dell'API da usare con la richiesta client. La versione corrente è 2019-10-01-preview.

Corpo della richiesta

Name Type Description
destinationBillingProfileId
  • string

ID del profilo di fatturazione di destinazione.

destinationInvoiceSectionId
  • string

ID sezione della fattura di destinazione.

Risposte

Name Type Description
200 OK

OK. La richiesta ha avuto esito positivo.

202 Accepted

Accettato

Headers

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

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Azure Active Directory Flow OAuth2.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation rappresentare l'account utente

Esempio

TransferProduct

Sample Request

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileName}/invoiceSections/{invoiceSectionName}/products/{productName}/transfer?api-version=2019-10-01-preview

{
  "destinationInvoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{newBillingProfileName}/invoiceSections/{newInvoiceSectionName}",
  "destinationBillingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{newBillingProfileName}"
}

Sample Response

{
  "id": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingProfiles/{newBillingProfileName}/invoiceSections/{newInvoiceSectionName}/products/{productName}",
  "name": "{productName}",
  "type": "Microsoft.Billing/products",
  "properties": {
    "productTypeId": "A12345",
    "productType": "Subscription",
    "displayName": "Test Product",
    "status": "Active",
    "purchaseDate": "2018-05-01T17:32:28Z",
    "lastCharge": {
      "currency": "USD",
      "value": 5000
    },
    "lastChargeDate": "2018-06-15T17:32:28Z",
    "billingFrequency": "Monthly",
    "quantity": 4,
    "skuId": "0001",
    "skuDescription": "Enterprise Agreement Development",
    "tenantId": "515a6d36-aaf8-4ca2-a5e8-c45deb0c5cce",
    "availabilityId": "AvailabilityId1",
    "parentProductId": "45000000-0000-0000-0000-0000000001242",
    "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{newBillingProfileName}/invoiceSections/{newInvoiceSectionName}",
    "invoiceSectionDisplayName": "Contoso operations invoiceSection",
    "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/11000000-0000-0000-0000-000000000000",
    "billingProfileDisplayName": "Contoso operations billing"
  }
}
Location: https://management.azure.com/providers/Microsoft.Billing/operationResults/44000000-0000-0000-0000-000000000000?api-version=2019-10-01-preview
Retry-After: 60
OData-EntityId: 44000000-0000-0000-0000-000000000000

Definizioni

Amount

Importo.

BillingFrequency

Frequenza con cui verrà fatturato il prodotto.

ErrorDetails

Dettagli dell'errore.

ErrorResponse

La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

ErrorSubDetails
Product

Un prodotto.

ProductStatusType

Stato corrente del prodotto.

Reseller

Dettagli del rivenditore.

TransferProductRequestProperties

Proprietà del prodotto per avviare un trasferimento.

Amount

Importo.

Name Type Description
currency
  • string

Valuta per il valore dell'importo.

value
  • number

Valore di importo.

BillingFrequency

Frequenza con cui verrà fatturato il prodotto.

Name Type Description
Monthly
  • string
OneTime
  • string
UsageBased
  • string

ErrorDetails

Dettagli dell'errore.

Name Type Description
code
  • string

Codice di errore.

details

Dettagli secondari dell'errore.

message
  • string

Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

target
  • string

Destinazione dell'errore specifico.

ErrorResponse

La risposta di errore indica che il servizio non è in grado di elaborare la richiesta in ingresso. Il motivo viene fornito nel messaggio di errore.

Name Type Description
error

Dettagli dell'errore.

ErrorSubDetails

Name Type Description
code
  • string

Codice di errore.

message
  • string

Messaggio di errore che indica il motivo per cui l'operazione non è riuscita.

target
  • string

Destinazione dell'errore specifico.

Product

Un prodotto.

Name Type Description
id
  • string

ID risorsa.

name
  • string

Nome risorsa.

properties.availabilityId
  • string

Disponibilità del prodotto.

properties.billingFrequency

Frequenza con cui verrà fatturato il prodotto.

properties.billingProfileDisplayName
  • string

Nome del profilo di fatturazione a cui viene fatturato il prodotto.

properties.billingProfileId
  • string

ID del profilo di fatturazione a cui viene fatturato il prodotto.

properties.customerDisplayName
  • string

Nome del cliente per il quale è stato acquistato il prodotto. Il campo è applicabile solo per Contratto Microsoft Partner account di fatturazione.

properties.customerId
  • string

ID del cliente per il quale è stato acquistato il prodotto. Il campo è applicabile solo per Contratto Microsoft Partner account di fatturazione.

properties.displayName
  • string

Nome visualizzato del prodotto.

properties.endDate
  • string

Data in cui il prodotto verrà rinnovato o annullato.

properties.invoiceSectionDisplayName
  • string

Nome della sezione della fattura a cui viene fatturato il prodotto.

properties.invoiceSectionId
  • string

ID della sezione della fattura a cui viene fatturato il prodotto.

properties.lastCharge

Addebiti per l'ultimo mese.

properties.lastChargeDate
  • string

Data dell'ultimo addebito.

properties.parentProductId
  • string

ID prodotto padre.

properties.productType
  • string

Descrizione del tipo di prodotto.

properties.productTypeId
  • string

ID del tipo di prodotto.

properties.purchaseDate
  • string

Data di acquisto del prodotto.

properties.quantity
  • number

Quantità acquistata per il prodotto.

properties.reseller

Rivenditore per questo prodotto.

properties.skuDescription
  • string

Descrizione sku del prodotto.

properties.skuId
  • string

ID SKU del prodotto.

properties.status

Stato corrente del prodotto.

properties.tenantId
  • string

ID del tenant in cui viene usato il prodotto.

type
  • string

Tipo di risorsa.

ProductStatusType

Stato corrente del prodotto.

Name Type Description
Active
  • string
AutoRenew
  • string
Cancelled
  • string
Disabled
  • string
Expired
  • string
Expiring
  • string
Inactive
  • string
PastDue
  • string

Reseller

Dettagli del rivenditore.

Name Type Description
description
  • string

Nome del rivenditore.

resellerId
  • string

ID MPN del rivenditore.

TransferProductRequestProperties

Proprietà del prodotto per avviare un trasferimento.

Name Type Description
destinationBillingProfileId
  • string

ID del profilo di fatturazione di destinazione.

destinationInvoiceSectionId
  • string

ID sezione della fattura di destinazione.