Abbrechen eines Vorgangs

  • Artikel

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.

Diese API bricht einen Vorgang ab, der gerade für das Angebot ausgeführt wird. Verwenden Sie die API zum Abrufen von Vorgängen, um eine Vorgangs-ID (operationId) zu erhalten, die an diese API übergeben werden kann. Der Abbruch ist in der Regel ein synchroner Vorgang. In einigen komplexen Szenarien ist jedoch möglicherweise ein neuer Vorgang erforderlich, um eine vorhandene Operation abzubrechen. In diesem Fall enthält der HTTP-Antworttext den Ort des Vorgangs, der zum Abfragen des Status verwendet werden muss.

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

URI-Parameter

Name Beschreibung Datentyp
publisherId Herausgeber-ID (Beispiel: contoso) String
offerId Angebots-ID String
api-version Aktuelle Version der API Datum
Name Wert
Inhaltsart application/json
Autorisierung Bearer

Beispiel für Hauptteil

Anforderung

{
   "metadata": {
     "notification-emails": "jondoe@contoso.com"
    }
}

Eigenschaften des Anforderungstexts

Name Beschreibung
notification-emails Kommagetrennte Liste mit den E-Mail-IDs, die über den Fortschritt des Veröffentlichungsvorgangs benachrichtigt werden sollen.

Antwort

Migrierte Angebote

Location: /api/publishers/contoso/offers/contoso-offer/operations/56615b67-2185-49fe-80d2-c4ddf77bb2e8?api-version=2017-10-31

Nicht migrierte Angebote

Location: /api/operations/contoso$contoso-offer$2$preview?api-version=2017-10-31

Antwortheader

Name Wert
Standort Der relative Pfad für den Abruf des Status dieses Vorgangs.

Antwortstatuscodes

Code Beschreibung
200 OK: Die Anforderung wurde erfolgreich verarbeitet, und der Vorgang wird synchron abgebrochen.
202 Akzeptiert: Die Anforderung wurde erfolgreich verarbeitet, und der Vorgang wird abgebrochen. Der Ort des Abbruchvorgangs wird im Antwortheader zurückgegeben.
400 Ungültige/falsch formatierte Anforderung: Der Fehlerantworttext enthält ggf. weitere Informationen.
403 Zugriff verweigert: Der Client hat keinen Zugriff auf den in der Anforderung angegebenen Namespace.
404 Nicht gefunden: Die angegebene Entität ist nicht vorhanden.