Products - Transfer

Verschiebt die Gebühren eines Produkts in einen neuen Rechnungsabschnitt. Der neue Rechnungsabschnitt muss zum gleichen Abrechnungsprofil gehören wie der vorhandene Rechnungsabschnitt. Dieser Vorgang wird nur für Produkte unterstützt, die mit einer wiederkehrenden Gebühr und für Abrechnungskonten mit vertragstyp Microsoft-Kundenvereinbarung erworben werden.

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

URI-Parameter

Name In Required Type Description
billingAccountName
path True
  • string

Die ID, die ein Abrechnungskonto eindeutig identifiziert.

billingProfileName
path True
  • string

Die ID, die ein Abrechnungsprofil eindeutig identifiziert.

invoiceSectionName
path True
  • string

Die ID, die einen Rechnungsabschnitt eindeutig identifiziert.

productName
path True
  • string

Die ID, die ein Produkt eindeutig identifiziert.

api-version
query True
  • string

Die Version der API, die mit der Clientanforderung verwendet werden soll. Die aktuelle Version ist 2019-10-01-preview.

Anforderungstext

Name Type Description
destinationBillingProfileId
  • string

Die Zielabrechnungsprofil-ID.

destinationInvoiceSectionId
  • string

Die Zielrechnungsabschnitts-ID.

Antworten

Name Type Description
200 OK

OK. Die Anforderung ist erfolgreich.

202 Accepted

Akzeptiert

Headers

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

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Flow.

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

Scopes

Name Description
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

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

Definitionen

Amount

Der Betrag.

BillingFrequency

Die Häufigkeit, in der das Produkt in Rechnung gestellt wird.

ErrorDetails

Die Details des Fehlers.

ErrorResponse

Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

ErrorSubDetails
Product

Ein Produkt.

ProductStatusType

Der aktuelle Status des Produkts.

Reseller

Details des Händlers.

TransferProductRequestProperties

Die Eigenschaften des Produkts, um eine Übertragung zu initiieren.

Amount

Der Betrag.

Name Type Description
currency
  • string

Die Währung für den Betragswert.

value
  • number

Betragswert.

BillingFrequency

Die Häufigkeit, in der das Produkt in Rechnung gestellt wird.

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

ErrorDetails

Die Details des Fehlers.

Name Type Description
code
  • string

Fehlercode

details

Die Unterdetails des Fehlers.

message
  • string

Eine Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

target
  • string

Das Ziel des bestimmten Fehlers.

ErrorResponse

Fehlerantwort gibt an, dass der Dienst die eingehende Anforderung nicht verarbeiten kann. Der Grund wird in der Fehlermeldung angegeben.

Name Type Description
error

Die Details des Fehlers.

ErrorSubDetails

Name Type Description
code
  • string

Fehlercode

message
  • string

Eine Fehlermeldung, die angibt, warum der Vorgang fehlgeschlagen ist.

target
  • string

Das Ziel des bestimmten Fehlers.

Product

Ein Produkt.

Name Type Description
id
  • string

Ressourcen-ID.

name
  • string

Name der Ressource.

properties.availabilityId
  • string

Die Verfügbarkeit des Produkts.

properties.billingFrequency

Die Häufigkeit, in der das Produkt in Rechnung gestellt wird.

properties.billingProfileDisplayName
  • string

Der Name des Abrechnungsprofils, dem das Produkt in Rechnung gestellt wird.

properties.billingProfileId
  • string

Die ID des Abrechnungsprofils, dem das Produkt in Rechnung gestellt wird.

properties.customerDisplayName
  • string

Der Name des Kunden, für den das Produkt gekauft wurde. Das Feld gilt nur für Microsoft Partner-Vereinbarung Abrechnungskonto.

properties.customerId
  • string

Die ID des Kunden, für den das Produkt gekauft wurde. Das Feld gilt nur für Microsoft Partner-Vereinbarung Abrechnungskonto.

properties.displayName
  • string

Der Anzeigename des Produkts.

properties.endDate
  • string

Das Datum, an dem das Produkt verlängert oder abgebrochen wird.

properties.invoiceSectionDisplayName
  • string

Der Name des Rechnungsabschnitts, dem das Produkt in Rechnung gestellt wird.

properties.invoiceSectionId
  • string

Die ID des Rechnungsabschnitts, dem das Produkt in Rechnung gestellt wird.

properties.lastCharge

Die Gebühren für den letzten Monat.

properties.lastChargeDate
  • string

Das Datum der letzten Gebühr.

properties.parentProductId
  • string

Übergeordnete Produkt-ID.

properties.productType
  • string

Die Beschreibung des Produkttyps.

properties.productTypeId
  • string

Die ID des Produkttyps.

properties.purchaseDate
  • string

Das Datum, an dem das Produkt gekauft wurde.

properties.quantity
  • number

Die Menge, die für das Produkt erworben wurde.

properties.reseller

Händler für dieses Produkt.

properties.skuDescription
  • string

Die Sku-Beschreibung des Produkts.

properties.skuId
  • string

Die Sku-ID des Produkts.

properties.status

Der aktuelle Status des Produkts.

properties.tenantId
  • string

Die ID des Mandanten, in dem das Produkt verwendet wird.

type
  • string

Der Ressourcentyp.

ProductStatusType

Der aktuelle Status des Produkts.

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

Reseller

Details des Händlers.

Name Type Description
description
  • string

Der Name des Händlers.

resellerId
  • string

Die MPN-ID des Händlers.

TransferProductRequestProperties

Die Eigenschaften des Produkts, um eine Übertragung zu initiieren.

Name Type Description
destinationBillingProfileId
  • string

Die Zielabrechnungsprofil-ID.

destinationInvoiceSectionId
  • string

Die Zielrechnungsabschnitts-ID.