purchase.mp.microsoft.com/v8.0/b2b/clawback/sastoken

[アーティクル]
06/20/2024

このエンドポイントは、クローバックイベントメッセージキューを認証してアクセスするための SAS トークンを生成するために使用されます。クローバックイベントメッセージキューの詳細については、「サービスからの払い戻しとチャージバックの管理」を参照してください。

前提条件

この API を使用するには、開発者パートナーマネージャーまたは Microsoft の連絡先の支援を受けて、オンボーディングプロセスを完了する必要があります。

サービスが Microsoft Store サービスへの認証に使用する Microsoft Entra アプリケーションクライアント ID とパートナーセンターの製品がリンクされます ( 「ユーザーストア ID/Microsoft Entra ID 認証を使用して製品を表示および管理するために必要な追加の構成」を参照してください)
待ち時間を短縮するために、クローバックイベントメッセージキューをホストする地理的リージョン。

オンボーディングの一環として、Azure Storage Queue が設定され、クローバックイベントメッセージキューとして Microsoft によってホストされます。導入スケジュールによっては、オンボーディングプロセスに最大 2 週間かかる場合があります。

注意

alert注: 製品の構成が行われておらず、パートナーセンターを通じて公開されていない場合、それらの製品の Clawback イベントは Azure Storage Queue に書き込まれません。

要求

要求の構文

メソッド	要求 URI
`GET`	`purchase.mp.microsoft.com/v8.0/b2b/clawback/sastoken`

要求ヘッダー

ヘッダー	型	説明
`Authorization`	`string`	必須。 Microsoft Entra ID サービスのアクセストークンは、 `Bearer`<token> という形式です。「Microsoft Entra ID アクセストークンの作成」を参照してください。
`Host`	`string`	値 `purchase.mp.microsoft.com` を設定する必要があります。

要求の例

POST https://purchase.mp.microsoft.com/v8.0/b2b/clawback/sastoken HTTP/1.1
Host: purchase.mp.microsoft.com
Authorization: Bearer [Microsoft Entra ID bearer token]

応答

応答の本文

応答本文は JSON になり、次の値で構成されます。

パラメーター	型	説明	必須
`expiresOn`	`DateTime`	SAS トークンの有効期限が切れる UTC 日時	はい
`uri`	`string`	ストレージリソース URI と SAS トークンを組み合わせて、クローバックメッセージキューにアクセスします。	はい

応答の例


HTTP/1.1 200 OK
Date: Thu, 08 Dec 2022 20:13:46 GMT
Content-Length: 243
Content-Type: application/json; charset=utf-8
ms-correlationid: 70e6f659-ceee-4050-bdf3-56ea3beefe23
ms-requestid: 8c80d7ff-73e2-4a5c-9aca-79059fbc1beb
ms-cv: tRscYtHLJHps.0
x-content-type-options: nosniff

{
    "expiresOn":"2022-12-09T02:13Z",
    "uri":"https://uluufeofsxh2k.queue.core.windows.net:443/gxhxcvb32lnk4?sv=2021-10-04&spr=https&st=2022-12-08T20%3A13%3A46Z&se=2022-12-09T02%3A13%3A46Z&sp=rp&sig=OneHfX99E820avICZvXJUF14IyDuv2BrvY0kj%2Ftxc70%3D"
}