切り替えを取得する
適用対象
- パートナー センター
適切なロール
- グローバル管理者
- 管理エージェント
注意
ライセンスベースのサービスの新しいコマース エクスペリエンスには、多くの新機能が含まれており、すべてのクラウド ソリューション プロバイダー (CSP) で利用できます。 詳細については、新しいコマース エクスペリエンスの概要を参照してください。
特定の顧客とサブスクリプションの移行履歴を取得するために使用されます。 履歴には、移行のために処理されたすべてのイベントが含まれます。 これは、新しいコマース ライセンスベースのサブスクリプション移行のみをサポートします。
前提条件
パートナー センターの認証に関するページで説明している資格情報。 このシナリオでは、スタンドアロンの App と App+User の両方の資格情報を使用した認証がサポートされています。
顧客 ID です (
customer-tenant-id
)。 顧客の ID がわからない場合は、 パートナー センター で [顧客] ワークスペースを選択し、 次に顧客 の一覧から顧客を探し、[ アカウント] を選択します。 お客様のアカウント ページで、 [顧客のアカウント情報] セクションの Microsoft ID を探します。 Microsoft ID は、顧客 ID (customer-tenant-id
) と同じです。移行されたサブスクリプションの 1 つのサブスクリプション ID。
REST 要求
[GET] customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions
要求の構文
認証方法 | 要求 URI |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1 |
URI パラメーター
次のクエリ パラメーターを使用して、適格な遷移を返します。
名前 | 型 | 必須 | 説明 |
---|---|---|---|
customer-tenant-id | guid | Y | 顧客のテナントに対応する GUID。 |
subscription-id | guid | Y | 初期サブスクリプションに対応する GUID。 |
operation-id | guid | × | 遷移を一意に識別し、その状態を追跡するための GUID。 |
要求ヘッダー
詳細については、「パートナー センター REST ヘッダー」を参照してください。
[要求本文]
なし
要求の例
GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{subscription-id}/transitions HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
X-Locale: en-US
REST 応答
成功した場合、指定されたサブスクリプションの切り替え履歴が返されます。
応答の成功とエラーのコード
各応答には、成功または失敗を示す HTTP ステータス コードと、追加のデバッグ情報が付属しています。 このコード、エラーの種類、追加のパラメーターを読み取るには、ネットワーク トレース ツールを使用します。 完全な一覧については、エラー コードに関するページを参照してください。
応答の例
HTTP/1.1 200 OK
Content-Length: 138
Content-Type: application/json
MS-CorrelationId: 81b08ffe-4cf8-49cd-82db-5c2fb0a8e132
MS-RequestId: 18752a69-1aa1-4ef7-8f9d-eb3681b2d70a
Date: Fri, 26 Feb 2021 20:42:26 GMT
{
"transition": [
{
"operationId": "1caf8ec7-62cc-4ab5-b35d-572d2a62974c",
"FromCatalogItemId": "CFQ7TTC0LDPB:0001:CFQ7TTC0LGNT",
"ToCatalogItemId": "CFQ7TTC0LF8S:0001:CFQ7TTC0K9G9",
"quantity": 1,
"transitionType": "transition_with_license_transfer",
"Events": [
{
"name": "Conversion",
"status": "Started ",
"timestamp": "2021-01-08T18:01:14.7488618Z",
"attributes":
{
"objectType": "TransitionEvent"
}
},
{
"name": "Conversion",
"status": "Completed",
"timestamp": "2021-01-08T18:37:41.591855Z",
"attributes":
{
"objectType": "TransitionEvent"
}
}
],
"attributes":
{
"objectType": "Transition"
}
}
],
"attributes":
{
"objectType": "Collection"
}
}
フィードバック
https://aka.ms/ContentUserFeedback」を参照してください。
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「フィードバックの送信と表示