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

[アーティクル]
10/15/2024

適用対象: パートナーセンター | 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 パラメーター

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

名前	タイプ	Required	説明
customer-ID	string	はい	顧客を識別する GUID 形式の文字列。
subscription-ID	string	はい	サブスクリプションを識別する GUID 形式の文字列。

要求ヘッダー

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

要求本文

なし。

要求の例

GET https://api.partnercenter.microsoft.com/v1/customers/0c39d6d5-c70d-4c55-bc02-f620844f3fd1/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/provisioningstatus HTTP/1.1
Accept: application/json, text/plain, */*
Authorization: Bearer <token>
MS-RequestId: d0e38dfd-a2c5-4a14-ac06-12d30f0ec54e
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
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: aaaa0000-bb11-2222-33cc-444444dddddd
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 分ごとに更新されます。

次の方法で共有