操作のキャンセル

2025-06-21

注

クラウドパートナーポータル API は統合されており、パートナーセンターで引き続き動作します。移行によって、小さな変化がもたらされます。「Cloud パートナーポータルの API リファレンス」の中に記載されている変更を確認し、パートナーセンターに移行した後も確実にコードが引き続き動作するようにしてください。 CPP APIは、パートナーセンターへの移行前にすでに統合されていた既存の製品にのみ使用すべきです。新しい製品には、パートナーセンター提出 APIを使用してください。

この API は、オファーで現在進行中の操作を取り消します。 Retrieve operations API を使用して、この API に渡す operationId を取得します。通常、取り消しは同期操作ですが、一部の複雑なシナリオでは、既存の操作を取り消すために新しい操作が必要になる場合があります。この場合、HTTP 応答本文には、ステータスのクエリに使用する操作の場所が含まれています。

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

URI パラメーター

名前	説明	データ型
パブリッシャーID	発行元識別子 (例: `contoso`	糸
offerId	オファー識別子	糸
APIバージョン	API の現在のバージョン	日付

名前	価値
コンテンツタイプ	application/json
認証	ベアラー YOUR TOKEN

ボディ例

リクエスト

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

要求本文のプロパティ

名前	説明
通知メール	公開操作の進行状況を通知する電子メール ID のコンマ区切りリスト。

[応答]

移行されたオファー

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

移行されていないオファー

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

応答ヘッダー

名前	価値
ロケーション	この操作のステータスを取得するための相対パス。

応答ステータスコード

コード	説明
200	OK 要求は正常に処理され、操作は同期的に取り消されます。
202	承認された。要求は正常に処理され、操作はキャンセル中です。キャンセル操作の場所は、応答ヘッダーで返されます。
400	要求が正しくない/形式が正しくありません。エラー応答本文は、より多くの情報を提供する可能性があります。
403	アクセスは許可されていません。クライアントは、要求で指定された名前空間にアクセスできません。
404	見つかりません。指定されたエンティティは存在しません。