Obtenir la liste de produits (par pays/région)

Article
09/27/2024

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

Aucune.

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: aaaa0000-bb11-2222-33cc-444444dddddd

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: aaaa0000-bb11-2222-33cc-444444dddddd

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: aaaa0000-bb11-2222-33cc-444444dddddd

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: aaaa0000-bb11-2222-33cc-444444dddddd

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

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

Partager via

Obtenir la liste de produits (par pays/région)

Prérequis

C#

Java

PowerShell

Demande REST

Syntaxe de la requête

Paramètres d’URI

En-têtes de requête

Corps de la demande

Exemples de requête

Produits par pays

Réservations de machines virtuelles Azure (plan Azure)

Réservations de machines virtuelles Azure pour les abonnements Microsoft Azure (MS-AZR-0145P)

Nouveaux services basés sur des licences commerciales

Réponse REST

Codes d’erreur et de réussite de la réponse

Exemple de réponse pour les réservations de machines virtuelles Azure (plan Azure)

Exemple de réponse pour les nouveaux services basés sur des licences commerciales

Commentaires

Ressources supplémentaires