Products - Transfer

Przenosi opłaty za produkt do nowej sekcji faktury. Nowa sekcja faktury musi należeć do tego samego profilu rozliczeniowego co istniejąca sekcja faktury. Ta operacja jest obsługiwana tylko w przypadku produktów zakupionych przy użyciu cyklicznej opłaty i kont rozliczeniowych z Umowa z Klientem Microsoft typu umowy.

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

Parametry identyfikatora URI

Name In Required Type Description
billingAccountName
path True
  • string

Identyfikator, który jednoznacznie identyfikuje konto rozliczeniowe.

billingProfileName
path True
  • string

Identyfikator, który jednoznacznie identyfikuje profil rozliczeniowy.

invoiceSectionName
path True
  • string

Identyfikator, który jednoznacznie identyfikuje sekcję faktury.

productName
path True
  • string

Identyfikator, który jednoznacznie identyfikuje produkt.

api-version
query True
  • string

Wersja interfejsu API do użycia z żądaniem klienta. Bieżąca wersja to 2019-10-01-preview.

Treść żądania

Name Type Description
destinationBillingProfileId
  • string

Identyfikator docelowego profilu rozliczeniowego.

destinationInvoiceSectionId
  • string

Identyfikator sekcji faktury docelowej.

Odpowiedzi

Name Type Description
200 OK

OK. Żądanie zakończyło się pomyślnie.

202 Accepted

Zaakceptowano

Headers

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

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

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 personifikacja konta użytkownika

Przykłady

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

Definicje

Amount

Kwota.

BillingFrequency

Częstotliwość naliczania opłat za produkt.

ErrorDetails

Szczegóły błędu.

ErrorResponse

Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie.

ErrorSubDetails
Product

Produkt.

ProductStatusType

Bieżący stan produktu.

Reseller

Szczegóły odsprzedawcy.

TransferProductRequestProperties

Właściwości produktu do zainicjowania transferu.

Amount

Kwota.

Name Type Description
currency
  • string

Waluta dla wartości kwoty.

value
  • number

Wartość kwoty.

BillingFrequency

Częstotliwość naliczania opłat za produkt.

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

ErrorDetails

Szczegóły błędu.

Name Type Description
code
  • string

Kod błędu.

details

Szczegóły podrzędne błędu.

message
  • string

Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.

target
  • string

Element docelowy określonego błędu.

ErrorResponse

Odpowiedź na błąd wskazuje, że usługa nie może przetworzyć żądania przychodzącego. Przyczyna jest podana w komunikacie o błędzie.

Name Type Description
error

Szczegóły błędu.

ErrorSubDetails

Name Type Description
code
  • string

Kod błędu.

message
  • string

Komunikat o błędzie wskazujący, dlaczego operacja nie powiodła się.

target
  • string

Element docelowy określonego błędu.

Product

Produkt.

Name Type Description
id
  • string

Identyfikator zasobu.

name
  • string

Nazwa zasobu.

properties.availabilityId
  • string

Dostępność produktu.

properties.billingFrequency

Częstotliwość naliczania opłat za produkt.

properties.billingProfileDisplayName
  • string

Nazwa profilu rozliczeniowego, do którego jest rozliczany produkt.

properties.billingProfileId
  • string

Identyfikator profilu rozliczeniowego, do którego jest rozliczany produkt.

properties.customerDisplayName
  • string

Nazwa klienta, dla którego produkt został zakupiony. Pole ma zastosowanie tylko dla konta rozliczeniowego Microsoft Partner Agreement.

properties.customerId
  • string

Identyfikator klienta, dla którego produkt został zakupiony. Pole ma zastosowanie tylko dla konta rozliczeniowego Microsoft Partner Agreement.

properties.displayName
  • string

Nazwa wyświetlana produktu.

properties.endDate
  • string

Data odnowienia lub anulowania produktu.

properties.invoiceSectionDisplayName
  • string

Nazwa sekcji faktury, do której jest rozliczany produkt.

properties.invoiceSectionId
  • string

Identyfikator sekcji faktury, do której jest rozliczany produkt.

properties.lastCharge

Opłaty za ostatni miesiąc.

properties.lastChargeDate
  • string

Data ostatniej opłaty.

properties.parentProductId
  • string

Identyfikator produktu nadrzędnego.

properties.productType
  • string

Opis typu produktu.

properties.productTypeId
  • string

Identyfikator typu produktu.

properties.purchaseDate
  • string

Data zakupu produktu.

properties.quantity
  • number

Ilość zakupiona dla produktu.

properties.reseller

Odsprzedawca dla tego produktu.

properties.skuDescription
  • string

Opis jednostki SKU produktu.

properties.skuId
  • string

Identyfikator jednostki SKU produktu.

properties.status

Bieżący stan produktu.

properties.tenantId
  • string

Identyfikator dzierżawy, w której jest używany produkt.

type
  • string

Typ zasobu.

ProductStatusType

Bieżący stan produktu.

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

Reseller

Szczegóły odsprzedawcy.

Name Type Description
description
  • string

Nazwa odsprzedawcy.

resellerId
  • string

Identyfikator MPN odsprzedawcy.

TransferProductRequestProperties

Właściwości produktu do zainicjowania transferu.

Name Type Description
destinationBillingProfileId
  • string

Identyfikator docelowego profilu rozliczeniowego.

destinationInvoiceSectionId
  • string

Identyfikator sekcji faktury docelowej.