Abbrechen eines Vorgangs

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.

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

Anfordern

{
   "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
Location	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.

Freigeben über