Partager via

Ressources de produits

Ressources qui représentent des biens ou services purchasables. Inclut des ressources pour décrire le type de produit et la forme (SKU) et pour vérifier la disponibilité du produit dans un inventaire.

Produit

Représente un bon ou un service purchasable. Un produit lui-même n’est pas un élément purchasable.

Propriété Catégorie Descriptif
pièce d'identité Chaîne ID d’un produit.
titre Chaîne Titre du produit.
descriptif Chaîne Description du produit.
type de produit Type d’article Objet qui décrit les catégorisations de type de ce produit.
estProduitMicrosoft Bool Indique si le produit est un produit Microsoft.
Nom de l'éditeur Chaîne Nom de l’éditeur du produit s’il est disponible.
Liens ProductLinks Liens de ressources contenus dans le produit.

Type d'élément

Représente le type d’un produit.

Propriété Catégorie Descriptif
pièce d'identité Chaîne Identificateur de type.
nom d’affichage Chaîne Nom d'affichage d’un type d’élément.
Sous-type Type d’article Optionnel. Objet qui décrit une catégorisation de sous-type pour un type d’élément.

Contient une liste de liens pour un produit.

Propriété Catégorie Descriptif
SKU Lien Lien permettant d’accéder aux références SKU sous-jacentes.
Liens ResourceLinks Liens de ressources contenus dans une ressource.

Sku

Représente une unité de conservation de stock purchasable (SKU) sous un produit.

Propriété Catégorie Descriptif
pièce d'identité Chaîne ID de la référence SKU. L’ID est unique uniquement dans le contexte de son produit parent.
titre Chaîne Titre de la référence SKU.
descriptif Chaîne Description de la référence SKU.
ID de produit Chaîne ID du produit parent qui contient une référence SKU.
quantité minimale Int Quantité minimale autorisée pour l’achat.
quantité maximale Int Quantité maximale autorisée pour l’achat.
isTrial Bool Indique si une référence SKU est un élément d’évaluation.
cycles de facturation pris en charge Tableau de chaînes Liste des cycles de facturation pris en charge pour une référence SKU. Les valeurs prises en charge sont les noms de membres trouvés dans BillingCycleType.
prérequis d'achat Tableau de chaînes Liste des étapes ou actions requises avant l’achat d’un élément. Les valeurs prises en charge sont les suivantes :
« InventoryCheck » : indique que l’inventaire de l’élément doit être évalué avant de tenter d’acheter un article.
« AzureSubscriptionRegistration » : indique qu’un abonnement Azure est nécessaire et doit être inscrit avant de tenter d’acheter un élément.
variablesInventaire Tableau de chaînes Liste des variables nécessaires pour exécuter une vérification d’inventaire sur un élément. Les valeurs prises en charge sont les suivantes :
« CustomerId » : ID du client pour lequel l’achat serait destiné.
« AzureSubscriptionId » : ID de l’abonnement Azure qui serait utilisé pour un achat de réservation Azure.
« ArmRegionName » : région pour laquelle vérifier l’inventaire. Cette valeur doit correspondre à « ArmRegionName » des DynamicAttributes de la référence SKU.
variablesDeProvisionnement Tableau de chaînes Liste des variables qui doivent être fournies dans le contexte d’approvisionnement d’un élément de ligne de panier lors de l’achat d’un élément. Les valeurs prises en charge sont les suivantes :
Portée : portée d’un achat de réservation Azure : « Unique », « Partagé ».
« SubscriptionId » : ID de l’abonnement Azure qui serait utilisé pour un achat de réservation Azure.
« Duration » - Durée de la réservation Azure : « 1Year », « 3Year ».
dynamicAttributes paires clé/valeur Dictionnaire de propriétés dynamiques qui s’appliquent à un élément. Les propriétés d’un dictionnaire sont dynamiques et peuvent changer sans préavis. Les partenaires doivent éviter d'établir des dépendances fortes sur des clés particulières présentes dans la valeur d’une propriété.
Liens ResourceLinks Liens de ressources contenus dans la référence SKU.
AttestationProperties AttestationProperties Propriétés d’attestation pour un SKU.
typeDeConsommation Chaîne N’est disponible que si la référence SKU prend en charge la consommation telle que le dépassement.
propriétésDOffreSpécialisée Liste des propriétés d'offres spécialisées Est disponible uniquement si le produit est sous-type de SpecializedOffer.
engagement d'achat minimum Engagement d'achat minimum Montant fixe engagé pour les services de calcul.

Attributs de référence SKU dynamiques

Propriétés notables pertinentes pour les nouveaux produits et services basés sur des licences commerciales.

Remarque

Les nouvelles expériences commerciales pour les services basés sur des licences incluent de nombreuses nouvelles fonctionnalités et sont disponibles pour tous les Fournisseur de solutions Cloud (CSP). Pour plus d’informations, consultez la Vue d’ensemble des nouvelles expériences commerciales.

Propriété Catégorie Descriptif
hasConstraints Booléen Décrit si la référence SKU contient assetContraints
estUnModule Booléen Décrit si la référence SKU est un module complémentaire
prérequisSKU tableau de chaînes Décrit les produits et références SKU que le module complémentaire peut utiliser
upgradeTargetOffers tableau de chaînes Une liste de produits et de références SKU auxquels l’article peut être mis à niveau.
instructions de conversion Liste des instructions de conversion Liste des instructions applicables aux opérations de conversion

propriétésDOffreSpécialisée

Remarque

Les nouvelles expériences commerciales pour les services basés sur des licences incluent de nombreuses nouvelles fonctionnalités et sont disponibles pour tous les Fournisseur de solutions Cloud (CSP). Pour plus d’informations, consultez la Vue d’ensemble des nouvelles expériences commerciales.

Applicable uniquement aux sous-types de produits « SpecializedOffers »

Propriété Catégorie Descriptif
date de début Chaîne ID de terme auxquels les instructions s’appliquent
date de fin Chaîne Options qui définissent les renouvellements
politiques de tarification Liste des politiques de tarification Liste des stratégies qui définissent les types et valeurs de remise de promotion.

Engagement d'achat minimum

Attributs de la quantité minimale pouvant être engagée sur les services de calcul.

Propriété Catégorie Descriptif
grain Chaîne Période de l’engagement d’achat minimal.
code de devise Chaîne de<dictionnaire, chaîne> La « devise » et le « symbole » du montant minimal pouvant être validé.
quantité Int Montant minimal pouvant être engagé sur les services de calcul.

Politiques de Tarification

Décrire les types et valeurs de remise de promotion.

Propriété Catégorie Descriptif
type Chaîne Décrivez si la remise est basée sur des pourcentages ou des remises à taux fixe.
valeur Chaîne Définit le montant de la remise appliquée.

Disponibilité

Représente une configuration dans laquelle une référence SKU est disponible pour l’achat (par exemple, pays/région, devise et segment du secteur).

Propriété Catégorie Descriptif
pièce d'identité Chaîne Identifiant de cette disponibilité. Cet ID est unique uniquement dans le contexte de son produit parent et de sa référence SKU. Note Les ID de disponibilité peuvent changer au fil du temps. Les partenaires ne doivent compter que sur cette valeur dans un court intervalle de temps après sa récupération.
ID de produit Chaîne ID du produit qui contient cette disponibilité.
skuId Chaîne ID de la référence SKU qui contient cette disponibilité.
ID d'article du catalogue Chaîne Identificateur unique de cet élément dans le catalogue. Cet ID doit être renseigné dans les propriétés OrderLineItem.OfferId ou CartLineItem.CatalogItemId lors de l’achat de la référence SKU parente. Note Cet ID peut changer au fil du temps. Vous ne devez compter que sur cette valeur dans un court délai après sa récupération. Il doit être accessible uniquement et utilisé au moment de l’achat.
devise par défaut Chaîne Devise par défaut prise en charge pour cette disponibilité.
section Chaîne Segment du secteur pour cette disponibilité. Les valeurs prises en charge sont les suivantes : Commercial, Éducation, Gouvernement, Non Lucratif.
pays Chaîne Pays ou région (au format de code pays ISO) où cette disponibilité s’applique.
estAchetable Bool Indique si cette disponibilité est purchassable.
estRenouvelable Bool Indique si cette disponibilité est renouvelable.
Instructions de renouvellement RenewalInstruction Représente des instructions de renouvellement pour une disponibilité donnée.
produit Produit Le produit à laquelle cette disponibilité correspond.
Sku Sku La référence SKU à laquelle cette disponibilité correspond.
termes Tableau de ressources Termes Collection de termes applicables à cette disponibilité.
Liens ResourceLinks Les liens de ressources sont inclus dans les disponibilités.

Instruction de renouvellement

Remarque

Les nouvelles expériences commerciales pour les services basés sur des licences incluent de nombreuses nouvelles fonctionnalités et sont disponibles pour tous les Fournisseur de solutions Cloud (CSP). Pour plus d’informations, consultez la Vue d’ensemble des nouvelles expériences commerciales.

Représente des instructions de renouvellement pour une disponibilité donnée.

Propriété Catégorie Descriptif
identifiantsDeTermeApplicables Tableau de chaînes ID de terme auxquels les instructions s’appliquent
Options de renouvellement Tableau d'Option de Renouvellement Options qui définissent les renouvellements

Option de renouvellement

Remarque

Les nouvelles expériences commerciales pour les services basés sur des licences incluent de nombreuses nouvelles fonctionnalités et sont disponibles pour tous les Fournisseur de solutions Cloud (CSP). Pour plus d’informations, consultez la Vue d’ensemble des nouvelles expériences commerciales.

Représente des instructions de renouvellement pour une disponibilité donnée.

Propriété Catégorie Descriptif
renewToId Chaîne Représente le produit et la référence SKU à renouveler.
estRenouvelableAutomatiquement Bool Indique si la disponibilité peut être renouvelée automatiquement ou non

Terme

Représente un terme pour lequel la disponibilité peut être achetée.

Propriété Catégorie Descriptif
durée Chaîne Une représentation ISO 8601 de la durée du terme. Les valeurs prises en charge actuelles sont P1M (un mois), P1Y (un an) et P3Y (trois ans).
descriptif Chaîne Description du terme.
termLifeCycleState Chaîne Description du cycle de vie. Ces valeurs prises en charge incluent GA (généralement disponible), EndOfSale et EndofSaleWithConversions. Cette propriété n’est retournée que si includeLifeCycleState a la valeur true lors de l’appel de l’API get availability by id.

InventaireCheckRequest

Représente une demande de vérification de l’inventaire sur certains éléments de catalogue.

Propriété Catégorie Descriptif
éléments cibles Tableau d’éléments de stock Liste des éléments de catalogue évalués par la vérification de l’inventaire.
contexte d'inventaire Paires clé/valeur Dictionnaire de valeurs de contexte nécessaires pour effectuer les vérifications d’inventaire. Chaque référence SKU des produits détermine les valeurs (le cas échéant) nécessaires pour effectuer cette opération.
Liens ResourceLinks Liens de ressources contenus dans la demande de vérification de l’inventaire.

InventaireItem

Représente un élément unique dans une opération de vérification d’inventaire. Cette ressource est utilisée pour spécifier les éléments cibles dans une demande d’entrée et est également utilisée pour représenter les résultats de sortie de l’opération de vérification de l’inventaire.

Propriété Catégorie Descriptif
ID de produit Chaîne (Obligatoire) ID du produit.
skuId Chaîne ID du SKU. Cette valeur est facultative. Si cette valeur n’est pas fournie, toutes les références SKU sous le produit sont considérées comme des éléments cibles de l’opération de vérification de l’inventaire.
estRestreint Bool Indique si cet élément présente un inventaire restreint.
Restrictions Tableau de restrictions d'inventaire Détails des restrictions trouvées pour cet élément. Cette propriété est remplie uniquement si isRestricted = « true ».

Restriction d'inventaire

Représente les détails d’une restriction d’inventaire. Ces détails s’appliquent uniquement aux résultats de sortie de vérification de l’inventaire, et non aux demandes d’entrée.

Propriété Catégorie Descriptif
reasonCode Chaîne Code qui identifie la raison de la restriction.
descriptif Chaîne Description de la restriction d’inventaire.
Propriétés Paires clé/valeur Dictionnaire de propriétés qui peuvent fournir des détails supplémentaires sur la restriction.

Type de Cycle de Facturation

[Enum/dotnet/api/system.enum) avec des valeurs qui indiquent un type de cycle de facturation.

Valeur Poste Descriptif
Inconnu 0 Initialiseur d’énumération.
Tous les mois 1 Indique que le partenaire est facturé mensuellement.
Annuelle 2 Indique que le partenaire est facturé sur une base annuelle.
Aucun 3 Indique que le partenaire n’est pas facturé. Cette valeur peut être utilisée pour les éléments d’évaluation.
Jadis 4 Indique que le partenaire est facturé une seule fois.
Tous les trois ans 5 Indique que le partenaire est facturé tous les trois ans.

AttestationProperties

Représente un type d’attestation ainsi que s’il est requis pour l’achat.

Propriété Catégorie Descriptif
attestationType Chaîne Indique le type d’attestation. Les produits Windows 365 ont la valeur de Windows 365. Le texte d’attestation Windows 365 est « Je comprends que chaque personne utilisant Windows 365 Business avec Windows Hybrid Benefit doit également avoir une copie valide de Windows 10/11 Pro installée sur son appareil professionnel principal . »
appliquerAttestation Booléen Indique si l’attestation est requise pour l’achat.
  • Last updated on