Products - Transfer

Service:

Billing

API Version:

2019-10-01-preview

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

Nome	In	Necessario	Tipo	Descrizione
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

Nome	Tipo	Descrizione
destinationBillingProfileId	string	ID del profilo di fatturazione di destinazione.
destinationInvoiceSectionId	string	ID della sezione fattura di destinazione.

Risposte

Nome	Tipo	Descrizione
200 OK	Product	OK. La richiesta ha avuto esito positivo.
202 Accepted		Accettato Headers Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Risposta di errore che descrive perché l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

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

Scopes

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

TransferProduct

Sample Request

HTTP

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

Status code:

200

{
  "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"
  }
}

Status code:

202

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

Nome	Descrizione
Amount	Importo.
BillingFrequency	Frequenza in cui verrà fatturato il prodotto.
ErrorDetails	Dettagli dell'errore.
ErrorResponse	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	Prodotto.
ProductStatusType	Stato corrente del prodotto.
Reseller	Dettagli del rivenditore.
TransferProductRequestProperties	Proprietà del prodotto per avviare un trasferimento.

Amount

Importo.

Nome	Tipo	Descrizione
currency	string	Valuta per il valore dell'importo.
value	number	Valore quantità.

BillingFrequency

Frequenza in cui verrà fatturato il prodotto.

Nome	Tipo	Descrizione
Monthly	string
OneTime	string
UsageBased	string

ErrorDetails

Dettagli dell'errore.

Nome	Tipo	Descrizione
code	string	Codice di errore.
details	ErrorSubDetails[]	Dettagli secondari dell'errore.
message	string	Messaggio di errore che indica perché l'operazione non è riuscita.
target	string	Destinazione dell'errore specifico.

ErrorResponse

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

Nome	Tipo	Descrizione
error	ErrorDetails	Dettagli dell'errore.

ErrorSubDetails

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore che indica perché l'operazione non è riuscita.
target	string	Destinazione dell'errore specifico.

Product

Prodotto.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.availabilityId	string	Disponibilità del prodotto.
properties.billingFrequency	BillingFrequency	Frequenza in cui verrà fatturato il prodotto.
properties.billingProfileDisplayName	string	Nome del profilo di fatturazione a cui viene addebitato il prodotto.
properties.billingProfileId	string	ID del profilo di fatturazione a cui viene addebitato il prodotto.
properties.customerDisplayName	string	Nome del cliente per cui è stato acquistato il prodotto. Il campo è applicabile solo per Contratto Microsoft Partner account di fatturazione.
properties.customerId	string	ID del cliente per cui è 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 addebitato il prodotto.
properties.invoiceSectionId	string	ID della sezione della fattura a cui viene fatturato il prodotto.
properties.lastCharge	Amount	Gli addebiti dell'ultimo mese.
properties.lastChargeDate	string	Data dell'ultima carica.
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 dell'acquisto del prodotto.
properties.quantity	number	Quantità acquistata per il prodotto.
properties.reseller	Reseller	Rivenditore per questo prodotto.
properties.skuDescription	string	Descrizione dello sku del prodotto.
properties.skuId	string	ID sku del prodotto.
properties.status	ProductStatusType	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.

Nome	Tipo	Descrizione
Active	string
AutoRenew	string
Cancelled	string
Disabled	string
Expired	string
Expiring	string
Inactive	string
PastDue	string

Reseller

Dettagli del rivenditore.

Nome	Tipo	Descrizione
description	string	Nome del rivenditore.
resellerId	string	ID MPN del rivenditore.

TransferProductRequestProperties

Proprietà del prodotto per avviare un trasferimento.

Nome	Tipo	Descrizione
destinationBillingProfileId	string	ID del profilo di fatturazione di destinazione.
destinationInvoiceSectionId	string	ID della sezione fattura di destinazione.