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

아티클
11/21/2024

이 엔드포인트는 Clawback 이벤트 메시지 큐를 인증하고 액세스하기 위한 SAS 토큰을 생성하는 데 사용됩니다. Clawback 이벤트 메시지 큐에 대한 자세한 내용은 서비스에서 환불 및 지불 거절을 참조하세요.

필수 구성 요소

이 API를 사용하려면 개발자 파트너 관리자 또는 Microsoft 담당자의 도움을 받아 온보드 프로세스를 거쳐야 합니다.

서비스가 Microsoft Store Services 및 Partner Center에서 제품을 인증하는 데 사용할 Microsoft Entra 애플리케이션 클라이언트 ID가 연결됩니다(사용자 Store ID/Microsoft Entra ID 인증을 사용하여 제품을 보고 관리하는 데 필요한 추가 구성 참조).
지연 시간을 줄이기 위해 Clawback 이벤트 메시지 큐를 호스팅할 지리적 영역입니다.

온보딩의 일환으로 Microsoft는 Clawback 이벤트 메시지 큐로 Azure Storage Queue를 설정하고 호스팅합니다. 온보딩 프로세스는 배포 일정에 따라 최대 2주가 소요될 수 있습니다.

참고 항목

제품 구성이 완료되지 않고 파트너 센터를 통해 게시된 경우 해당 제품에 대한 Clawback 이벤트가 Azure Storage 큐에 기록되지 않습니다.

요청

요청 구문

메서드	요청 URI
`GET`	`purchase.mp.microsoft.com/v8.0/b2b/clawback/sastoken`

요청 헤더

헤더	형식	설명
`Authorization`	`string`	필수. `Bearer` < 토큰> 양식의 Microsoft Entra ID 서비스 액세스 토큰입니다. 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 토큰을 결합하여 Clawback 메시지 큐에 액세스합니다.	예

응답 예제


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"
}