Microsoft Store ID キーの更新Renew a Microsoft Store ID key

Microsoft Store のキーを更新するには、以下のメソッドを使います。Use this method to renew a Microsoft Store key. Microsoft Store ID キーを生成する場合、キーは 90 日間有効です。When you generate a Microsoft Store ID key, the key is valid for 90 days. キーの有効期限が切れた後で、有効期限が切れたキーとこのメソッドを使用して新しいキーを再ネゴシエートできます。After the key expires, you can use the expired key to renegotiate a new key by using this method.

前提条件Prerequisites

このメソッドを使用するための要件:To use this method, you will need:

詳しくは、「サービスによる製品の権利の管理」をご覧ください。For more information, see Manage product entitlements from a service.

要求Request

要求の構文Request syntax

キーの種類Key type メソッドMethod 要求 URIRequest URI
コレクションCollections POSTPOST https://collections.mp.microsoft.com/v6.0/b2b/keys/renew
購入Purchase POSTPOST https://purchase.mp.microsoft.com/v6.0/b2b/keys/renew

要求ヘッダーRequest header

HeaderHeader 種類Type 説明Description
HostHost stringstring collections.mp.microsoft.com または purchase.mp.microsoft.com の値に設定する必要があります。Must be set to the value collections.mp.microsoft.com or purchase.mp.microsoft.com.
Content-LengthContent-Length numbernumber 要求の本文の長さ。The length of the request body.
Content-TypeContent-Type stringstring 要求と応答の種類を指定します。Specifies the request and response type. 現時点では、サポートされている唯一の値は application/json です。Currently, the only supported value is application/json.

要求本文Request body

パラメーターParameter 種類Type 説明Description 必須Required
serviceTicketserviceTicket stringstring Azure AD アクセス トークン。The Azure AD access token. Yes
keykey stringstring 有効期限が切れた Microsoft Store ID キー。The expired Microsoft Store ID key. Yes

要求の例Request example

POST https://collections.mp.microsoft.com/v6.0/b2b/keys/renew HTTP/1.1
Content-Length: 2774
Content-Type: application/json
Host: collections.mp.microsoft.com

{
    "serviceTicket": "eyJ0eXAiOiJKV1QiLCJhb….",
    "Key": "eyJ0eXAiOiJKV1QiLCJhbG…."
}

応答Response

応答本文Response body

パラメーターParameter 種類Type 説明Description
keykey stringstring 以降の Microsoft Store コレクション API または Microsoft Store 購入 API の呼び出しで使用できる、更新された Microsoft Store のキー。The refreshed Microsoft Store key that can be used in future calls to the Microsoft Store collections API or purchase API.

応答の例Response example

HTTP/1.1 200 OK
Content-Length: 1646
Content-Type: application/json
MS-CorrelationId: bfebe80c-ff89-4c4b-8897-67b45b916e47
MS-RequestId: 1b5fa630-d672-4971-b2c0-3713f4ea6c85
MS-CV: xu2HW6SrSkyfHyFh.0.0
MS-ServerId: 030011428
Date: Tue, 13 Sep 2015 07:31:12 GMT

{
    "key":"eyJ0eXAi….."
}

エラー コードError codes

コードCode エラーError 内部エラー コードInner error code 説明Description
401401 権限がありませんUnauthorized AuthenticationTokenInvalidAuthenticationTokenInvalid Azure AD アクセス トークンが無効です。The Azure AD access token is invalid. 場合によっては、ServiceError の詳細に追加情報が含まれていることがあります (トークンの有効期限切れや appid 要求の欠落など)。In some cases the details of the ServiceError will contain more information, such as when the token is expired or the appid claim is missing.
401401 権限がありませんUnauthorized InconsistentClientIdInconsistentClientId Microsoft Store ID キーの clientId 要求と Azure AD アクセス トークンの appid 要求が一致しません。The clientId claim in the Microsoft Store ID key and the appid claim in the Azure AD access token do not match.