サブスクリプションのプロビジョニング状態を取得する

  • [アーティクル]

適用対象: パートナー センター | 21Vianet が運営するパートナー センター | Microsoft Cloud for US Government のパートナー センター

顧客サブスクリプションのサブスクリプション プロビジョニング状態を取得する方法。

前提条件

  • パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、アプリとユーザーの資格情報を使用した認証のみがサポートされます。

  • 顧客 ID です (customer-tenant-id)。 顧客の ID がわからない場合は、[顧客] ワークスペースを選択し、顧客の一覧から顧客を選択し、[アカウント] を選択して、パートナー センターで検索できます。 顧客の [アカウント] ページで、[顧客アカウント情報] セクションで Microsoft ID を探します。 Microsoft ID は、顧客 ID (customer-tenant-id) と同じです。

  • サブスクリプション識別子。

  • この操作を実行するには、サブスクリプションに対する委任された管理者アクセス許可が必要です。

GDAP ロール

次の GDAP ロールのうち少なくとも 1 つが必要です。

  • ディレクトリ閲覧者
  • グローバル閲覧者

C#

サブスクリプションのプロビジョニング状態を取得するには、まず、顧客 ID で IAggregatePartner.Customers.ById メソッドを使用して顧客を識別します。 次に、サブスクリプション ID を使用して Subscriptions.ById メソッドを呼び出して、サブスクリプション操作へのインターフェイスを取得します。 次に、ProvisioningStatus プロパティを使用して、現在のサブスクリプションのプロビジョニング状態操作のインターフェイスを取得し、Get メソッドまたは GetAsync メソッドを呼び出して SubscriptionProvisioningStatus オブジェクトを取得します。

// IAggregatePartner partnerOperations.
// string customerId;
// string subscriptionId;

// Retrieve a subscription's provisioning status.
var provisioningStatus = partnerOperations.Customers.ById(customerId).Subscriptions.ById(subscriptionID).ProvisioningStatus.Get();

REST 要求

要求の構文

認証方法 要求 URI
GET {baseURL}/v1/customers/{customer-id}/subscriptions/{subscription-id}/provisioningstatus HTTP/1.1

URI パラメーター

顧客とサブスクリプションを識別するには、次のパス パラメーターを使用します。

名前 種類 必須 説明
customer-id string はい 顧客を識別する GUID 形式の文字列。
subscription-id string はい サブスクリプションを識別する GUID 形式の文字列。

要求ヘッダー

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

要求本文

[なし] :

要求の例

GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/34828C05-C16C-4D6F-9CFC-4D2650EF19A1/provisioningstatus HTTP/1.1
Accept: application/json, text/plain, */*
Authorization: Bearer <token>
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
X-Locale: en-US
Host: api.partnercenter.microsoft.com

REST 応答

成功した場合、応答本文には SubscriptionProvisioningStatus リソースが含まれます。

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

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

応答の例

HTTP/1.1 200 OK
Content-Length: 177
Content-Type: application/json; charset=utf-8
MS-CorrelationId: e937630b-8341-4d70-8f73-450d32ee0189
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CV: InswEQre402koceL.0
MS-ServerId: 030020344
Date: Thu, 20 Apr 2017 19:23:39 GMT

{
    "skuId": "6FD2C87F-B296-42F0-B197-1E91E994B900",
    "status": "success",
    "quantity": 5,
    "endDate": "2018-05-10T00:00:00Z",
    "attributes": {
        "objectType": "SubscriptionProvisioningStatus"
    }
}

解説

  • ライセンス変更の割り当て中に、SubscriptionProvisioningStatus の状態フィールドが "保留中" に設定されます。

  • 状態フィールドは 15 分ごとに更新されます。