Abrufen des Angebotsstatus

Artikel
03/06/2025

Anmerkung

Die Cloud Partner Portal-APIs sind in Partner Center integriert und arbeiten weiterhin. Der Übergang führt zu kleinen Änderungen. Überprüfen Sie die in Cloud Partner Portal-API-Referenz aufgeführten Änderungen, um sicherzustellen, dass Ihr Code nach dem Übergang zum Partner Center weiterhin funktioniert. CPP-APIs sollten nur für vorhandene Produkte verwendet werden, die bereits vor dem Übergang zum Partner Center integriert wurden; neue Produkte sollten Partner Center-Übermittlungs-APIs verwenden.

Ruft den aktuellen Status des Angebots ab.

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

URI-Parameter

Name	Beschreibung	Datentyp
publisherId	Herausgeberbezeichner, z. B. `Contoso`	Schnur
offerId	GUID, die das Angebot eindeutig identifiziert	Schnur
API-Version	Neueste Version der API	Datum

Name	Wert
Inhaltstyp	`application/json`
Ermächtigung	`Bearer YOUR_TOKEN`

Beispiel für Textkörper

Antwort

  {
      "status": "succeeded",
      "messages": [],
      "steps": [
      {
          "estimatedTimeFrame": "< 15 min",
          "id": "displaydummycertify",
          "stepName": "Validate Pre-Requisites",
          "description": "Offer settings provided are validated.",
          "status": "complete",
          "messages": [
              {
                  "messageHtml": "Step completed.",
                  "level": "information",
                  "timestamp": "2018-03-16T17:50:45.7215661Z"
              }
          ],       
          "progressPercentage": 100
      },
      {
          "estimatedTimeFrame": "~2-3 days",
          "id": "displaycertify",
          "stepName": "Certification",
          "description": "Your offer is analyzed by our certification systems for issues.",
          "status": "notStarted",
          "messages": [],
          "progressPercentage": 0
      },
      {
          "estimatedTimeFrame": "< 1 day",
          "id": "displayprovision",
          "stepName": "Provisioning",
          "description": "Your virtual machine is being replicated in our production systems.",
          "status": "notStarted",
          "messages": [],
          "progressPercentage": 0
      },
      {
          "estimatedTimeFrame": "< 1 hour",
          "id": "displaypackage",
          "stepName": "Packaging and Lead Generation Registration",
          "description": "Your virtual machine is being packaged for customers. Additionally, lead systems are being configured and set up.",
          "status": "notStarted",
          "messages": [],
          "progressPercentage": 0
      },
      {
          "estimatedTimeFrame": "< 1 hour",
          "id": "publisher-signoff",
          "stepName": "Publisher signoff",
          "description": "Offer is available to preview. Ensure that everything looks good before making your offer live.",
          "status": "complete",
          "messages": [],
          "progressPercentage": 0
      },
      {
          "estimatedTimeFrame": "~2-5 days",
          "id": "live",
          "stepName": "Live",
          "description": "Offer is publicly visible and is available for purchase.",
          "status": "complete",
          "messages": [],
          "progressPercentage": 0
      }
      ],
      "previewLinks": [],
      liveLinks": [],
  }

Eigenschaften des Antworttexts

Name	Beschreibung
Status	Der Status des Angebots. Eine Liste der möglichen Werte finden Sie unter Angebotsstatus weiter unten.
Meldungen	Array von Nachrichten, die dem Angebot zugeordnet sind
Schritte	Array der Schritte, die das Angebot während einer Angebotsveröffentlichung durchläuft
estimatedTimeFrame	Schätzung der Zeit, die es dauern würde, um diesen Schritt im benutzerfreundlichen Format abzuschließen
id	Bezeichner des Schritts
stepName	Name des Schritts
Beschreibung	Beschreibung des Schritts
Status	Status des Schritts. Eine Liste der möglichen Werte finden Sie unter Schrittstatus weiter unten.
Meldungen	Array von Nachrichten im Zusammenhang mit dem Schritt
processPercentage	Prozentsatz der Fertigstellung des Schritts
previewLinks	derzeit nicht implementiert
liveLinks	derzeit nicht implementiert
notificationEmails	Veraltet für Angebote, die zum Partner Center migriert wurden. Benachrichtigungs-E-Mails für migrierte Angebote werden an die unter den Kontaktinformationen des Verkäufers in den Kontoeinstellungen angegebene E-Mail gesendet. Bei nicht migrierten Angeboten werden durch Kommas getrennte Liste der E-Mail-Adressen benachrichtigt, die über den Fortschritt des Vorgangs benachrichtigt werden sollen.

Antwortstatuscodes

Code-	Beschreibung
200	`OK` – Die Anforderung wurde erfolgreich verarbeitet, und der aktuelle Status des Angebots wurde zurückgegeben.
400	`Bad/Malformed request` – Der Textkörper der Fehlerantwort enthält möglicherweise weitere Informationen.
404	`Not found` – Die angegebene Entität ist nicht vorhanden.

Angebotsstatus

Name	Beschreibung
NeverPublished	Das Angebot wurde nie veröffentlicht.
NotStarted	Angebot ist neu und nicht gestartet.
WaitingForPublisherReview	Das Angebot wartet auf die Genehmigung des Herausgebers.
Ausgeführte	Die Angebotsübermittlung wird verarbeitet.
Gelungen	Die Angebotsübermittlung hat die Verarbeitung abgeschlossen.
Abgebrochen	Die Angebotsübermittlung wurde abgebrochen.
Misslungen	Fehler bei der Angebotsübermittlung.

Schrittstatus

Name	Beschreibung
NotStarted	Schritt wurde nicht gestartet.
InProgress	Schritt wird ausgeführt.
WaitingForPublisherReview	Schritt wartet auf die Genehmigung des Herausgebers.
WaitingForApproval	Schritt wartet auf die Prozessgenehmigung.
Gesperrt	Schritt wird blockiert.
Zurückgewiesen	Schritt wird abgelehnt.
Vollständig	Schritt ist abgeschlossen.
Abgebrochen	Schritt wurde abgebrochen.

Freigeben über