超過分の更新

[アーティクル]
09/25/2024

適用対象

パートナーセンター

適切なロール

管理エージェント

Note

ライセンスベースのサービスの新しいコマースエクスペリエンスには、多くの新機能が含まれており、すべてのクラウドソリューションプロバイダー (CSP) で利用できます。詳細については、新しいコマースエクスペリエンスの概要を参照してください。

特定の顧客の超過分を従量課金サブスクリプションに設定するために使用されます。 false に設定することで、超過分を削除するためにも使用できます。超過分により、お客様は、指定された制限を超えてサービスを使用する場合、サービスを引き続き使用できます。超過分は、従量課金制サブスクリプションの超過分が発生することを定義します。

前提条件

パートナーセンターの認証に関するページで説明している資格情報。このシナリオでは、スタンドアロンアプリとアプリ + ユーザーの両方の資格情報を使った認証がサポートされています。
顧客 ID です (customer-tenant-id)。顧客の ID がわからない場合は、パートナーセンターで [顧客] ワークスペースを選び、顧客一覧から顧客を選び、[アカウント] を選んで調べることができます。お客様のアカウントページで、[顧客のアカウント情報] セクションの Microsoft ID を探します。 Microsoft ID は、顧客 ID (customer-tenant-id) と同じです。
顧客に対して購入された、少なくとも 1 つの対象となる超過分サブスクリプション。

REST 要求

[PUT] /customers/{customer-tenant-id}/subscriptions/overage

要求の構文

認証方法	要求 URI
PUT	{baseURL}/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1

URI パラメーター

顧客の超過分を返すには、次のクエリパラメーターを使用します。

名前	タイプ	Required	説明
customer-tenant-id	guid	年	顧客のテナントに対応する GUID。

要求ヘッダー

詳細については、「パートナーセンター REST ヘッダー」を参照してください。

要求本文

名前	種類	説明
azureEntitlementId	guid	超過分の従量課金サブスクリプションを定義する GUID。
partnerId	guid	間接リセラーの PartnerID。 2 層モデル (間接プロバイダー) にのみ適用されます。
overageEnabled	bool	特定の従量課金サブスクリプションに対して超過分を有効にする必要があるかどうかを示します。

要求の例

PUT https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/overage HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
X-Locale: en-US

{
    "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
    "partnerId": "5357563",
    "overageEnabled": true
}

REST 応答

成功した場合、このメソッドは顧客の超過分を返します。

応答の成功とエラーのコード

各応答には、成功または失敗を示す HTTP ステータスコードと、追加のデバッグ情報が付属しています。このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワークトレースツールを使用します。完全な一覧については、エラーコードに関するページを参照してください。

応答の例

HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT

{
    "azureEntitlementId": "ea1c26b7-8c99-42bb-ba7d-c535831fae8e",
    "partnerId": "5357563",
    "type": "PhoneServices",
    "overageEnabled": true,
    "links": {
        "overage": {
            "uri": "/customers/f62cf10b-8f76-4fc4-9774-c5291f8faf86/subscriptions/overage",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Overage"
    }
}

次の方法で共有