Products - Get By Customer

Usługa:: Billing

Wersja interfejsu API:: 2019-10-01-preview

Pobiera produkt według identyfikatora. Ta operacja jest obsługiwana tylko w przypadku kont rozliczeniowych z typem umowy Microsoft Partner Agreement.

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/products/{productName}?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.
customerName	path	True	string	Identyfikator, który jednoznacznie identyfikuje klienta.
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.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Product	OK. Żądanie zakończyło się pomyślnie.
Other Status Codes	ErrorResponse	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

Product

Przykładowe żądanie

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}/products/{productName}?api-version=2019-10-01-preview

Przykładowa odpowiedź

Kod stanu:: 200

{
  "id": "/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/customers/{customerName}/products/{productName}",
  "name": "{productName}",
  "type": "Microsoft.Billing/billingAccounts/customers/products",
  "properties": {
    "productTypeId": "A12345",
    "productType": "Subscription",
    "displayName": "AIP Dev",
    "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",
    "availabilityId": "AvailabilityId1",
    "parentProductId": "45000000-0000-0000-0000-0000000001242",
    "customerId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerName}",
    "customerDisplayName": "Customer 1",
    "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/11000000-0000-0000-0000-000000000000",
    "billingProfileDisplayName": "Contoso operations billing",
    "reseller": {
      "resellerId": "3b65b5a8-bd4f-4084-90e9-e1bd667a2b19",
      "description": "Reseller2"
    }
  }
}

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ć przychodzącego żądania. Przyczyna jest podana w komunikacie o błędzie.
ErrorSubDetails
Product	Produkt.
ProductStatusType	Bieżący stan produktu.
Reseller	Szczegóły odsprzedawcy.

Amount

Objekt

Kwota.

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

BillingFrequency

Wyliczanie

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

Wartość	Opis
OneTime
Monthly
UsageBased

ErrorDetails

Objekt

Szczegóły błędu.

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

Objekt

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

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

ErrorSubDetails

Objekt

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

Objekt

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 dla konta rozliczeniowego umowy Microsoft Partner Agreement.
properties.customerId	string	Identyfikator klienta, dla którego zakupiono produkt. Pole ma zastosowanie tylko dla konta rozliczeniowego umowy Microsoft Partner Agreement.
properties.displayName	string	Nazwa wyświetlana produktu.
properties.endDate	string (date-time)	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 (date-time)	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 (date-time)	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

Wyliczanie

Bieżący stan produktu.

Wartość	Opis
Active
Inactive
PastDue
Expiring
Expired
Disabled
Cancelled
AutoRenew

Reseller

Objekt

Szczegóły odsprzedawcy.

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