拒絕轉移

注意

本主題僅適用於傳統授權型服務，不適用於新的商務體驗。 如需轉移新商務授權型訂閱的詳細資訊，請參閱 新的商務轉移主題。

必要條件

  • 憑證，如合作夥伴中心驗證所述。 此案例支援使用獨立應用程式和 App+使用者認證進行驗證。

  • 客戶識別碼 (customer-tenant-id)。 如果您不知道客戶的標識碼，您可以在合作夥伴中心中選取客戶工作區，然後從客戶清單中選取客戶，再選擇帳戶。 在客戶的 [帳戶] 頁面上，尋找 [客戶帳戶資訊] 區段中的 [Microsoft 識別碼]。 Microsoft 識別碼與客戶識別碼 (customer-tenant-id) 相同。

  • 現有傳輸的傳輸標識碼。

    適當的角色：管理代理 | 銷售代理

REST 要求

要求語法

方法 要求 URI
PATCH {baseURL}/v1/customers/{customer-id}/transfer/{transfer-id} HTTP/1.1

URI 參數

使用下列路徑參數來識別客戶，並指定要接受的轉移。

名稱 類型​​ 必要 描述
customer-id 字串 Yes 識別客戶的 GUID 格式客戶識別碼。
transfer-id 字串 Yes 用於識別傳輸的傳輸識別碼，其格式為 GUID。

要求標頭

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

請求主體

下表描述了請求主體中的TransferEntity屬性。

財產 類型​​ 必要 描述
識別碼 字串 否 在成功建立 transferEntity 後提供的 transferEntity 識別碼。
狀態 字串 否 transferEntity 的狀態。 若要拒絕傳輸，值會設定為「拒絕」

要求範例

PATCH /v1/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/ac4a9d22-ba07-444e-890f-cfe084eed498 HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 5b46e795-b661-428e-a2e7-f208b8d0d25c
Connection: keep-alive
Content-Length: 63

{"id":"ac4a9d22-ba07-444e-890f-cfe084eed498","status":"reject"}

REST 回應

如果成功，這個方法會在回應本文中傳回填入的TransferEntity資源。

回應成功和錯誤碼

每個回應都隨附 HTTP 狀態碼，會指出成功與否以及其他的偵錯資訊。 請使用網路追蹤工具來讀取此錯誤碼、錯誤類型和其他參數。 如需完整清單，請參閱錯誤碼。

回應範例

HTTP/1.1 200 OK
Content-Length: 1069
Content-Type: application/json; charset=utf-8
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: 5b46e795-b661-428e-a2e7-f208b8d0d25c
X-Locale: en-US
Date: Fri, 27 Mar 2020 17:50:33 GMT

{
  "id": "ac4a9d22-ba07-444e-890f-cfe084eed498",
  "status": "Reject",
  "createdTime": "2020-03-25T22:05:25.1057725Z",
  "lastModifiedTime": "2020-03-27T17:50:32Z",
  "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
  "partnertenantid": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
  "sourcePartnerName": "Test_Test_09092019GBL",
  "sourcePartnerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "targetPartnerName": "Test_Test_09032019GBL",
  "targetPartnerTenantId": "bbbbcccc-1111-dddd-2222-eeee3333ffff",
  "lastModifiedUser": "01a7548d-1136-4cf0-ba9a-300f921ffb22",
  "lineItems": [
    {
      "id": 0,
      "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
      "offerId": "13D32E13-A1B0-400D-96C0-4EAAA14DCED5",
      "billingCycle": "monthly",
      "friendlyName": "Dynamics 365 for Supply Chain Management Attach to Qualifying Dynamics 365 Base Offer (Qualified Offer)",
      "quantity": 20,
      "partnerIdOnRecord": "5139005",
      "addonItems": [

      ]
    }
  ],
  "links": {
    "self": {
      "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/ac4a9d22-ba07-444e-890f-cfe084eed498",
      "method": "GET",
      "headers": [

      ]
    }
  },
  "attributes": {
    "objectType": "TransferEntity"
  }
}
  • Last updated on