新しいコマース移行イベントを取得する

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

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

現在のサブスクリプション ID または移行 ID に基づいて移行イベントの詳細を取得する方法

前提条件

パートナーセンターの認証に関するページで説明している資格情報。このシナリオでは、スタンドアロンの App と App+User の両方の資格情報を使用した認証がサポートされています。

この API は、パートナーが選択したクエリ文字列に基づいて移行イベントを取得できます。選択したクエリ文字列には、次のオプションを含めることができます。

CustomerTenantId。顧客の ID がわからない場合は、[顧客] ワークスペースを選択し、顧客の一覧から顧客を選択し、[アカウント] を選択して、パートナーセンターで検索できます。顧客の [アカウント] ページで、[顧客アカウント情報] セクションで Microsoft ID を探します。 Microsoft ID は、顧客 ID と同じです。
CurrentSubscriptionId (移行されたサブスクリプションのレガシ ID)
MigrationId (現在のサブスクリプションに関連付けられている移行オブジェクトの ID)

REST 要求

要求の構文

認証方法	要求 URI
GET	{baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/events HTTP/1.1

クエリ文字列

次の表に、新しいコマース移行イベントを取得するために使用できるクエリ文字列を示します。現在のサブスクリプションに関連付けられている移行イベントを正常に取得するには、2 つの ID のうち少なくとも 1 つが必要です。移行 ID と現在のサブスクリプション ID の両方の入力は受け入れられますが、必須ではありません。

名前	説明
MigrationId	移行オブジェクトを識別する GUID 形式の文字列。
CurrentSubscriptionId	移行されたレガシサブスクリプションを識別する GUID 形式の文字列。

要求ヘッダー

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

要求本文

なし。

REST 応答

成功した場合、このメソッドは、応答本文で移行された現在のサブスクリプションのイベントの詳細を返します。

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

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

要求 URL の例

baseurl/v1/customers/948ebea1-0fe5-4e45-8f2e-900288b7883e/migrations/newcommerce/events?current_subscription_id=02DF825B-D0C9-40BE-8CB6-BAC895510D0A

応答例

[
    {
        "id": "6eb07675-ba1d-45c2-9d05-c693a4863427",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "948ebea1-0fe5-4e45-8f2e-900288b7883e",
        "createdTime": "2022-06-11T00:06:02.7529574Z",
        "eventName": "MigrationStarted"
    },
    {
        "id": "e828079b-c974-4822-977e-f12ac67380db",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "948ebea1-0fe5-4e45-8f2e-900288b7883e",
        "createdTime": "2022-06-11T00:06:21.526778Z",
        "eventName": "NewCommerceSubscriptionCreated"
    },
    {
        "id": "7dbdcbd5-7a87-4d9b-bf1f-d9298493e631",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "948ebea1-0fe5-4e45-8f2e-900288b7883e",
        "createdTime": "2022-06-11T00:08:08.5185085Z",
        "eventName": "NewCommerceSubscriptionProvisioned"
    },
    {
        "id": "71a3f753-55ca-461e-807d-f541685d5c8b",
        "newCommerceMigrationId": "e4c1c037-7c4c-42bd-bb41-dae2aa29ebcc",
        "currentSubscriptionId": "02df825b-d0c9-40be-8cb6-bac895510d0a",
        "customerTenantId": "948ebea1-0fe5-4e45-8f2e-900288b7883e",
        "createdTime": "2022-06-11T00:10:07.6947014Z",
        "eventName": "MigrationCompleted"
    }
]

次の方法で共有