Products - Get By Customer

Service:

Billing

Version d'API:

2019-10-01-preview

Obtient un produit par ID. L’opération est prise en charge uniquement pour les comptes de facturation avec le type contrat Partenaire Microsoft.

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

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
billingAccountName	path	True	string	ID qui identifie de façon unique un compte de facturation.
customerName	path	True	string	ID qui identifie de façon unique un client.
productName	path	True	string	ID qui identifie de façon unique un produit.
api-version	query	True	string	Version de l’API à utiliser avec la demande cliente. La version actuelle est 2019-10-01-preview.

Réponses

Nom	Type	Description
200 OK	Product	D’ACCORD. La demande a réussi.
Other Status Codes	ErrorResponse	Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

Product

Exemple de requête

HTTP

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

Exemple de réponse

Code d’état:

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

Définitions

Nom	Description
Amount	Montant.
BillingFrequency	Fréquence à laquelle le produit sera facturé.
ErrorDetails	Détails de l’erreur.
ErrorResponse	La réponse d’erreur indique que le service n’est pas en mesure de traiter la requête entrante. La raison est fournie dans le message d’erreur.
ErrorSubDetails
Product	Un produit.
ProductStatusType	État actuel du produit.
Reseller	Détails du revendeur.

Amount

Object

Montant.

Nom	Type	Description
currency	string	Devise de la valeur de montant.
value	number	Valeur de la quantité.

BillingFrequency

Énumération

Fréquence à laquelle le produit sera facturé.

Valeur	Description
OneTime
Monthly
UsageBased

ErrorDetails

Object

Détails de l’erreur.

Nom	Type	Description
code	string	Code d’erreur.
details	ErrorSubDetails[]	Sous-détails de l’erreur.
message	string	Message d’erreur indiquant pourquoi l’opération a échoué.
target	string	Cible de l’erreur particulière.

ErrorResponse

Object

La réponse d’erreur indique que le service n’est pas en mesure de traiter la requête entrante. La raison est fournie dans le message d’erreur.

Nom	Type	Description
error	ErrorDetails	Détails de l’erreur.

ErrorSubDetails

Object

Nom	Type	Description
code	string	Code d’erreur.
message	string	Message d’erreur indiquant pourquoi l’opération a échoué.
target	string	Cible de l’erreur particulière.

Product

Object

Un produit.

Nom	Type	Description
id	string	ID de ressource.
name	string	Nom de la ressource.
properties.availabilityId	string	Disponibilité du produit.
properties.billingFrequency	BillingFrequency	Fréquence à laquelle le produit sera facturé.
properties.billingProfileDisplayName	string	Nom du profil de facturation auquel le produit est facturé.
properties.billingProfileId	string	ID du profil de facturation auquel le produit est facturé.
properties.customerDisplayName	string	Nom du client pour lequel le produit a été acheté. Le champ s’applique uniquement au compte de facturation du Contrat partenaire Microsoft.
properties.customerId	string	ID du client pour lequel le produit a été acheté. Le champ s’applique uniquement au compte de facturation du Contrat partenaire Microsoft.
properties.displayName	string	Nom complet du produit.
properties.endDate	string (date-time)	Date à laquelle le produit sera renouvelé ou annulé.
properties.invoiceSectionDisplayName	string	Nom de la section de facture à laquelle le produit est facturé.
properties.invoiceSectionId	string	ID de la section de facture à laquelle le produit est facturé.
properties.lastCharge	Amount	Les frais du mois dernier.
properties.lastChargeDate	string (date-time)	Date de la dernière charge.
properties.parentProductId	string	ID de produit parent.
properties.productType	string	Description du type de produit.
properties.productTypeId	string	ID du type de produit.
properties.purchaseDate	string (date-time)	Date à laquelle le produit a été acheté.
properties.quantity	number	Quantité achetée pour le produit.
properties.reseller	Reseller	Revendeur pour ce produit.
properties.skuDescription	string	Description de la référence SKU du produit.
properties.skuId	string	ID de référence sku du produit.
properties.status	ProductStatusType	État actuel du produit.
properties.tenantId	string	ID du locataire dans lequel le produit est utilisé.
type	string	Type de ressource.

ProductStatusType

Énumération

État actuel du produit.

Valeur	Description
Active
Inactive
PastDue
Expiring
Expired
Disabled
Cancelled
AutoRenew

Reseller

Object

Détails du revendeur.

Nom	Type	Description
description	string	Nom du revendeur.
resellerId	string	ID MPN du revendeur.