Products - Transfer

Service:

Billing

API Version:

2019-10-01-preview

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 opłat cyklicznych i dla kont rozliczeniowych z typem umowy Umowa z Klientem Microsoft.

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

Nazwa	W	Wymagane	Typ	Opis
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, która ma być używana z żądaniem klienta. Bieżąca wersja to 2019-10-01-preview.

Treść żądania

Nazwa	Typ	Opis
destinationBillingProfileId	string	Identyfikator docelowego profilu rozliczeniowego.
destinationInvoiceSectionId	string	Identyfikator sekcji faktury docelowej.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Product	OK. Żądanie zakończyło się pomyślnie.
202 Accepted		Zaakceptowano Headers Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ OAuth2 usługi Azure Active Directory.

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

Scopes

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

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

Definicje

Nazwa	Opis
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.

Nazwa	Typ	Opis
currency	string	Waluta dla wartości kwoty.
value	number	Wartość kwoty.

BillingFrequency

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

Nazwa	Typ	Opis
Monthly	string
OneTime	string
UsageBased	string

ErrorDetails

Szczegóły błędu.

Nazwa	Typ	Opis
code	string	Kod błędu.
details	ErrorSubDetails[]	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.

Nazwa	Typ	Opis
error	ErrorDetails	Szczegóły błędu.

ErrorSubDetails

Nazwa	Typ	Opis
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.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.availabilityId	string	Dostępność produktu.
properties.billingFrequency	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 zakupiono produkt. Pole ma zastosowanie tylko do konta rozliczeniowego Microsoft Partner Agreement.
properties.customerId	string	Identyfikator klienta, dla którego zakupiono produkt. Pole ma zastosowanie tylko do 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	Amount	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	Reseller	Odsprzedawca dla tego produktu.
properties.skuDescription	string	Opis jednostki SKU produktu.
properties.skuId	string	Identyfikator jednostki SKU produktu.
properties.status	ProductStatusType	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.

Nazwa	Typ	Opis
Active	string
AutoRenew	string
Cancelled	string
Disabled	string
Expired	string
Expiring	string
Inactive	string
PastDue	string

Reseller

Szczegóły odsprzedawcy.

Nazwa	Typ	Opis
description	string	Nazwa odsprzedawcy.
resellerId	string	Identyfikator MPN odsprzedawcy.

TransferProductRequestProperties

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

Nazwa	Typ	Opis
destinationBillingProfileId	string	Identyfikator docelowego profilu rozliczeniowego.
destinationInvoiceSectionId	string	Identyfikator sekcji faktury docelowej.