Récupération des offres

Article
06/14/2024

Remarque

Les API de Portail Cloud Partner sont intégrées à Espace partenaires et continueront d’y fonctionner. La transition introduit de légères modifications. Passez en revue les changements répertoriés dans les informations de référence relatives aux API de Portail Cloud Partner pour vous assurer que votre code continue de fonctionner après la transition vers Espace partenaires. Les API du Portail Cloud Partner ne doivent être utilisées que pour les produits intégrés avant la transition vers l’Espace partenaires. Les nouveaux produits doivent employer les API de soumission à l’Espace partenaires.

Récupère une liste récapitulative des offres sous un espace de noms du serveur de publication.

GET https://cloudpartner.azure.com/api/publishers/<publisherId>/offers?api-version=2017-10-31

Paramètres d’URI

Nom	Description	Type de données
publisherId	Identificateur du serveur de publication, par exemple `contoso`	Chaîne
api-version	Dernière version de l’API	Date

Nom	Valeur
Type de contenu	`application/json`
Autorisation	`Bearer YOUR_TOKEN`

Exemple de corps

Response

  200 OK 
  [ 
      {  
          "offerTypeId": "microsoft-azure-virtualmachines",
          "publisherId": "contoso",
          "status": "published",
          "id": "059afc24-07de-4126-b004-4e42a51816fe",
          "version": 1,
          "definition": {
              "displayText": "Contoso Virtual Machine"
          },
          "changedTime":"2017-05-23T23:33:47.8802283Z"
      }
  ]

Propriétés du corps de réponse

Nom	Description
offerTypeId	Identifie le type d’offre
publisherId	L’identificateur qui identifie de façon unique ce serveur de publication
statut	État de l’offre. Pour la liste des valeurs possibles, consultez État de l’offre ci-dessous.
id	GUID qui identifie de façon unique l’offre dans l’espace de noms du serveur de publication.
version	Version actuelle de l’offre. La propriété de version ne peut pas être modifiée par le client. Elle est incrémentée après chaque publication.
Définition	Contient une vue résumée de la définition réelle de la charge de travail. Pour obtenir une définition détaillée, utilisez l’APIRécupérer une offre spécifique.
changedTime	Heure UTC de la dernière modification de l’offre

Codes d’état de réponse

Code	Description
200	`OK` : la requête a été correctement traitée et toutes les offres de l’éditeur ont été retournées au client.
400	`Bad/Malformed request` - Le corps de la réponse d’erreur peut contenir plus d’informations.
403	`Forbidden` : le client n’a pas accès à l’espace de noms spécifié.
404	`Not found` : l’entité spécifiée n’existe pas.

État de l’offre

Nom	Description
NeverPublished	L’offre n’a jamais été publiée.
NotStarted	L’offre est nouvelle, mais n’est pas démarrée.
WaitingForPublisherReview	L’offre est en attente d’approbation du serveur de publication.
Exécution	La soumission de l’offre est en cours de traitement.
Réussi	La soumission de l’offre a été traitée.
Annulée	La soumission de l’offre a été annulée.
Échec	La soumission de l’offre a échoué.

Partager via