Abrufen von Angeboten

Artikel
06/14/2024

Hinweis

Die Cloud-Partnerportal-APIs sind in Partner Center integriert und funktionieren auch weiterhin. Der Übergang führt zu kleineren Änderungen. Beachten Sie die in der Cloud-Partnerportal-API-Referenz aufgeführten Änderungen, um sicherzustellen, dass Ihr Code nach dem Übergang zu Partner Center weiterhin funktioniert. CPP-APIs sollten nur für vorhandene Produkte verwendet werden, die bereits vor dem Übergang zu Partner Center integriert wurden. Neue Produkte sollten die Partner Center-APIs für die Übermittlung verwenden.

Ruft eine zusammengefasste Liste der Angebote unter einem Herausgebernamespace ab.

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

URI-Parameter

Name	Beschreibung	Datentyp
publisherId	Herausgeber-ID, z.B. `contoso`	String
api-version	Neueste Version der API	Datum

Name	Wert
Inhaltsart	`application/json`
Autorisierung	`Bearer YOUR_TOKEN`

Beispiel für Hauptteil

Antwort

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

Eigenschaften für Antworthauptteil

Name	Beschreibung
offerTypeId	Gibt den Typ des Angebots an
publisherId	Bezeichner, der den Herausgeber eindeutig identifiziert
status	Status des Angebots. Die Liste der möglichen Werte finden Sie weiter unten unter Angebotsstatus.
id	GUID, die das Angebot im Herausgebernamespace eindeutig identifiziert.
version	Aktuelle Version des Angebots. Die Versionseigenschaft kann vom Client nicht geändert werden. Sie wird nach jeder Veröffentlichung inkrementiert.
definition	Enthält eine zusammengefasste Ansicht der tatsächlichen Definition der Workload. Für eine ausführliche Definition verwenden Sie die API zum Abrufen eines bestimmten Angebots.
changedTime	Uhrzeit (UTC), zu der das Angebot letztmalig geändert wurde

Antwortstatuscodes

Code	Beschreibung
200	`OK`: Die Anforderung wurde erfolgreich verarbeitet, und alle Angebote unter dem Herausgeber wurden an den Client zurückgegeben.
400	`Bad/Malformed request` - Der Textkörper der Fehlerantwort kann weitere Informationen enthalten.
403	`Forbidden` – der Client hat keinen Zugriff auf den angegebenen Namespace.
404	`Not found`: Die angegebene Entität ist nicht vorhanden.

Angebotsstatus

Name	Beschreibung
NeverPublished	Das Angebot wurde nie veröffentlicht.
NotStarted	Angebot ist neu, aber nicht gestartet.
WaitingForPublisherReview	Das Angebot wartet auf die Herausgebergenehmigung.
Wird ausgeführt	Die Angebotsübermittlung wird verarbeitet.
Erfolgreich	Die Verarbeitung der Angebotsübermittlung ist abgeschlossen.
Storniert	Die Angebotsübermittlung wurde abgebrochen.
Fehler	Fehler bei der Angebotsübermittlung.

Freigeben über