Obtenir la liste de produits (par pays/région)
S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government
Vous pouvez utiliser les méthodes suivantes pour obtenir une collection de produits disponibles dans un pays/région particulier.
Prérequis
Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification d’application et d’application+utilisateur autonomes.
Pays/région.
C#
Pour obtenir la liste des produits :
Utilisez votre collection IAggregatePartner.Products pour sélectionner le pays/la région à l’aide de la méthode ByCountry().
Sélectionnez l’affichage catalogue à l’aide de la méthode ByTargetView().
(Facultatif) Sélectionnez l’étendue de réservation à l’aide de la méthode ByReservationScope().
(Facultatif) Sélectionnez le segment cible à l’aide de la méthode ByTargetSegment().
Appelez la méthode Get() ou GetAsync() pour renvoyer la collection.
IAggregatePartner partnerOperations;
// Get the products for the specified catalog view.
ResourceCollection<Products> products = partnerOperations.Products.ByCountry("US").ByTargetView("MicrosoftAzure").Get();
// Get the products filtered by target view and target segment.
ResourceCollection<Products> products = partnerOperations.Products.ByCountry("US").ByTargetView("MicrosoftAzure").ByTargetSegment("commercial").Get();
// Get the products for Azure reservations which are applicable to Microsoft Azure (MS-AZR-0145P) subscriptions only.
ResourceCollection<Product> products = partnerOperations.Products.ByCountry("US").ByTargetView("AzureReservations").Get();
// Get the products for Azure reservations which are applicable to Azure plans only.
ResourceCollection<Product> products = partnerOperations.Products.ByCountry("US").ByTargetView("AzureReservations").ByReservationScope("AzurePlan").Get();
Java
Le Kit de développement logiciel (SDK) Java de l’Espace partenaires peut être utilisé pour gérer les ressources de l’Espace partenaires. Il s’agit d’un projet open source géré par la communauté partenaire et non officiellement pris en charge par Microsoft. Si vous rencontrez un problème, vous pouvez obtenir de l’aide auprès de la communauté ou le signaler dans GitHub.
Pour obtenir la liste des produits :
Utilisez votre fonction IAggregatePartner.getProducts pour sélectionner le pays à l’aide de la fonction byCountry().
Sélectionnez l’affichage catalogue à l’aide de la fonction byTargetView().
(Facultatif) Sélectionnez le segment cible à l’aide de la fonction byTargetSegment().
Appelez la fonction get() pour renvoyer la collection.
// IAggregatePartner partnerOperations;
// Get the products for the specified catalog view.
ResourceCollection<Products> products = partnerOperations.getProducts().byCountry("US").byTargetView("Azure").get();
// Get the products filtered by target view and target segment.
ResourceCollection<Products> products = partnerOperations.getProducts().byCountry("US").byTargetView("Azure").byTargetSegment("commercial").get();
PowerShell
Le module PowerShell de l’Espace partenaires peut être utilisé pour gérer les ressources de l’Espace partenaires. Il s’agit d’un projet open source géré par la communauté partenaire et non officiellement pris en charge par Microsoft. Si vous rencontrez un problème, vous pouvez obtenir de l’aide auprès de la communauté ou le signaler dans GitHub.
Pour obtenir la liste des produits :
Exécutez la commande Get-PartnerProduct.
Sélectionnez le catalogue en spécifiant le paramètre Catalogue .
(Facultatif) Sélectionnez le segment cible en spécifiant le paramètre Segment .
Get-PartnerProduct -Catalog 'Azure' -Segment 'commercial'
Demande REST
Syntaxe de la requête
| Méthode | URI de demande |
|---|---|
| GET | {baseURL}/v1/products ?country={country}&targetView={targetView}&targetSegment={targetSegment} HTTP/1.1 |
Paramètres d’URI
Utilisez le chemin d’accès et les paramètres de requête suivants pour obtenir une liste de produits.
| Nom | Type | Requise | Description |
|---|---|---|---|
| country | string | Oui | ID du pays/de la région. |
| targetView | string | Oui | Identifie l’affichage cible du catalogue. Les valeurs prises en charge sont les suivantes : Azure, qui inclut tous les éléments Azure AzureReservations, qui inclut tous les éléments de réservation Azure AzureReservationsVM, qui inclut tous les éléments de réservation de machine virtuelle AzureReservationsSQL, qui inclut tous les éléments de réservation SQL AzureReservationsCosmosDb, qui inclut tous les éléments de réservation de base de données Cosmos MicrosoftAzure, qui inclut des éléments pour les abonnements Microsoft Azure (MS-AZR-0145P) et les plans Azure OnlineServices, qui inclut tous les éléments de service en ligne tels que les services basés sur des licences traditionnelles et les nouveaux services commerciaux basés sur des licences. Logiciel, qui inclut tous les éléments logiciels SoftwareSUSELinux, qui inclut tous les éléments SUSE Linux logiciels SoftwarePerpetual, qui inclut tous les éléments logiciels perpétuels SoftwareSubscriptions, qui inclut tous les éléments d’abonnement logiciel SpecializedOffers, qui comprend des offres spécialisées qui ont été mises à la disposition de certains partenaires MarketplaceSaaS, qui inclut toutes les offres de la Place de marché commerciale publiées par des éditeurs de logiciels indépendants (ISV) |
| targetSegment | string | Non | Identifie le segment cible. Vue pour différents publics cibles. Les valeurs prises en charge sont les suivantes : Commercial education government Sans but lucratif |
| reservationScope | string | Non | Lors de l’interrogation d’une liste de produits pour les réservations Azure, spécifiez reservationScope=AzurePlan la liste des produits applicables aux plans Azure. Excluez ce paramètre pour obtenir la liste des produits pour les réservations Azure, qui s’appliquent aux abonnements Microsoft Azure (MS-AZR-0145P). |
En-têtes de requête
Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.
Corps de la demande
Aucun.
Exemples de requête
Produits par pays
Suivez cet exemple pour obtenir la liste des produits par pays pour les abonnements Microsoft Azure (MS-AZR-0145P) et les plans Azure.
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=MicrosoftAzure HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Réservations de machines virtuelles Azure (plan Azure)
Suivez cet exemple pour obtenir la liste des produits par pays pour les réservations de machines virtuelles Azure applicables aux plans Azure.
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=AzureAzureReservationsVM&reservationScope=AzurePlan HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Réservations de machines virtuelles Azure pour les abonnements Microsoft Azure (MS-AZR-0145P)
Suivez cet exemple pour obtenir la liste des produits par pays pour les réservations de machines virtuelles Azure applicables aux abonnements Microsoft Azure (MS-AZR-0145P).
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=AzureReservationsVM HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Nouveaux 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.
Suivez cet exemple pour obtenir la liste des produits par pays pour les nouveaux services basés sur des licences commerciales dans le cadre de la nouvelle expérience commerciale technical preview. Les nouveaux services basés sur des licences commerciales seront identifiés par les valeurs ID et displayNames d’OnlineServicesNCE. Consultez l’exemple de réponse ci-dessous.
GET https://api.partnercenter.microsoft.com/v1/products?country=US&targetView=OnlineServices HTTP/1.1
Authorization: Bearer
Accept: application/json
MS-RequestId: 031160b2-b0b0-4d40-b2b1-aaa9bb84211d
MS-CorrelationId: 7c1f6619-c176-4040-a88f-2c71f3ba4533
Réponse REST
Si elle réussit, le corps de la réponse contient une collection de ressources Product.
Codes d’erreur et de réussite de la réponse
Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez les codes d’erreur de l’Espace partenaires.
Cette méthode retourne les codes d’erreur suivants :
| Code d’état HTTP | Code d’erreur | Description |
|---|---|---|
| 403 | 400030 | L’accès au targetSegment demandé n’est pas autorisé. |
| 403 | 400036 | L’accès à targetView demandé n’est pas autorisé. |
Exemple de réponse pour les réservations de machines virtuelles Azure (plan Azure)
{
"totalCount": 19,
"items": [
{
"id": "DZH318Z0BQ3Q",
"title": "Virtual Machines DSv2 Series",
"description": "Dsv2-series instances are the latest generation of D-series instances that will carry more powerful CPUs which are on average about 35% faster than D-series instances, and carry the same memory and disk configurations as the D-series. Dsv2-series instances are based on the latest generation 2.4 GHz Intel Xeon® E5-2673 v3 (Haswell) processor, and with Intel Turbo Boost Technology 2.0 can go to 3.2 GHz.",
"productType": {
"id": "Azure",
"displayName": "Azure",
"subType": {
"id": "VirtualMachines",
"displayName": "VirtualMachines"
}
},
"isMicrosoftProduct": true,
"publisherName": "Microsoft",
"links": {
"skus": {
"uri": "/products/DZH318Z0BQ3Q/skus?country=US",
"method": "GET",
"headers": []
},
"self": {
"uri": "/products/DZH318Z0BQ3Q?country=US",
"method": "GET",
"headers": []
}
}
},
...
],
"links": {
"self": {
"uri": "/products?country=US&targetView=Azure",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}
Exemple de réponse pour les nouveaux 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.
{
"totalCount": 19,
"items": [{
"id": "CFQ7TTC0LH18",
"title": "Microsoft 365 Business Basic",
"description": "Best for businesses that need professional email, cloud file storage, and online meetings & chat. Desktop versions of Office apps like Excel, Word, and PowerPoint not included. For businesses with up to 300 employees.",
"productType": {
"id": "OnlineServicesNCE",
"displayName": "OnlineServicesNCE"
},
"isMicrosoftProduct": true,
"publisherName": "Microsoft Corporation",
"links": {
"skus": {
"uri": "/products/CFQ7TTC0LH18/skus?country=US",
"method": "GET",
"headers": []
},
"self": {
"uri": "/products/CFQ7TTC0LH18?country=US",
"method": "GET",
"headers": []
}
}
},
...
],
"links": {
"self": {
"uri": "/products?country=US&targetView=OnlineServices",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}
Commentaires
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultez https://aka.ms/ContentUserFeedback.
Envoyer et afficher des commentaires pour