查詢客戶的訂閱轉移資格

發行項
03/07/2025

如何取得符合轉移資格與否的客戶訂閱帳戶集合。

先決條件

合作夥伴中心身份驗證中所述的憑證。此案例支援使用獨立應用程式和 App+使用者認證進行驗證。
客戶標識碼（customer-tenant-id）。如果您不知道客戶的標識碼，您可以在合作夥伴中心中查閱。方法是先選取[客戶] 工作區，然後從客戶清單中選取客戶，最後選擇帳戶。在客戶的 [帳戶] 頁面上，於 [客戶帳戶資訊] 區段中尋找 Microsoft 識別碼。 Microsoft識別碼與客戶標識碼（customer-tenant-id）相同。

REST 要求

請求語法

方法	要求 URI
取得	{baseURL}/v1/customers/{customer-tenant-id}/transferseligibility?transferType={transfer-type} HTTP/1.1

URI 參數

下表列出取得所有訂用帳戶所需的查詢參數。

名字	類型	必填	描述
客戶租戶識別碼	字串	是的	識別客戶的 GUID 格式字串。
轉移類型	字串	是的	預期的傳輸類型。

要求標頭

如需詳細資訊，請參閱合作夥伴中心 REST 標頭。

請求主體

沒有。

要求範例

GET /v1/customers/aaaabbbb-0000-cccc-1111-dddd2222eeee/transferseligibility?transferType=directtoindirect HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 202b5e9a-ae82-4ab9-8a0a-f4e9e04eb14d
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Connection: Keep-Alive

REST 回應

如果成功，這個方法會在回應內文中傳回一組 TransferEligibility 資源。

回應成功和錯誤碼

每個回應都有一個 HTTP 狀態代碼，指出成功或失敗和其他偵錯資訊。使用網路追蹤工具來讀取此程式代碼、錯誤類型和其他參數。如需完整清單，請參閱合作夥伴中心 REST 錯誤碼。

回應範例

HTTP/1.1 200 OK
Content-Length: 73754
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 202b5e9a-ae82-4ab9-8a0a-f4e9e04eb14d
Date: Tue, 24 Mar 2020 23:43:25 GMT

[
  {
    "id": "548FA265-5F40-4765-9A6B-47826F72A4BF",
    "isEligible": false,
    "reason": "Subscription: 548FA265-5F40-4765-9A6B-47826F72A4BF is in state: Deleted"
  },
  {
    "id": "E2A3AEB3-70A7-42E3-930C-7519EEDDC45A",
    "isEligible": false,
    "reason": "Subscription: E2A3AEB3-70A7-42E3-930C-7519EEDDC45A is in state: Suspended"
  },
  {
    "id": "4B600A9A-DF56-4564-A75A-6CC6D2D0C9F9",
    "isEligible": false,
    "reason": "subscription is already part of another transfer request id : 31a06eac-c527-458a-a6b4-0de197a45996"
  },
  {
    "id": "D3350F46-AA29-4F6F-95A0-E3011988915C",
    "isEligible": true
  }
  {
    "id": "E82B2F4A-736A-4E2B-955C-C1A4C56C0171",
    "isEligible": true
  }
]

共用方式為