Obter as transferências de um cliente

Como obter uma lista das transferências de um cliente.

Funções apropriadas: Agente administrativo | Agente de vendas

Pré-requisitos

• Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário dá suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.

• Uma ID do cliente (customer-tenant-id). Se você não souber a ID do cliente, poderá procurá-la no Partner Center selecionando o workspace Clientes, o cliente da lista de clientes e, em seguida, Conta. Na página Conta do cliente, procure a ID da Microsoft na seção Informações da Conta do Cliente. A ID da Microsoft é igual à ID do cliente (customer-tenant-id).

Sintaxe da solicitação

Método	URI da solicitação
GET	{baseURL}/v1/customers/{customer-tenant-id}/transfers HTTP/1.1

Parâmetro do URI

Esta tabela lista o parâmetro de consulta necessário para obter todas as assinaturas.

Nome	Digitar	Obrigatória	Descrição
id de locatário do cliente	string	Sim	Uma cadeia com formato de GUID que identifica o cliente.

Cabeçalhos da solicitação

Para obter mais informações, confira Cabeçalhos REST do Partner Center.

Corpo da solicitação

Nenhum.

Exemplo de solicitação

GET /v1/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: ca2cdd2c-7eb8-4a2e-cdd7-2848752e801a
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
Connection: Keep-Alive

Resposta REST

Se for bem-sucedido, esse método retornará uma lista de recursos TransferEntity no corpo da resposta.

Códigos de êxito e de erro de resposta

Cada resposta vem com um código de status HTTP que indica êxito ou falha e informações de depuração adicionais. Use uma ferramenta de rastreamento de rede para ler esse código, o tipo de erro e os parâmetros adicionais. Para obter a lista completa, confira Códigos de erro REST do Partner Center.

Exemplo de resposta

HTTP/1.1 200 OK
Content-Length: 13828
Content-Type: application/json
MS-CorrelationId: aaaa0000-bb11-2222-33cc-444444dddddd
MS-RequestId: ca2cdd2c-7eb8-4a2e-cdd7-2848752e801a
Date: Fri, 27 Mar 2020 17:50:34 GMT

[
  {
    "id": "ab724652-3442-4912-8615-61525bb9903d",
    "status": "Reject",
    "createdTime": "2019-10-09T22:44:13.5411441Z",
    "lastModifiedTime": "2020-02-20T21:27:59Z",
    "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
    "partnertenantid": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
    "sourcePartnerName": "Test_Test_09092019GBL",
    "sourcePartnerTenantId": "7c8db11f-1e5e-4472-8386-f0b627d1f3e1",
    "targetPartnerName": "Test_Test_09032019GBL",
    "targetPartnerTenantId": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
    "lastModifiedUser": "edc0524d-2e42-4619-af7e-349c015cfdfd",
    "lineItems": [
      {
        "id": 0,
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "offerId": "B4D4B7F4-4089-43B6-9C44-DE97B760FB11",
        "billingCycle": "monthly",
        "friendlyName": "Visio Online Plan 2",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "addonItems": [

        ]
      },
      {
        "id": 0,
        "subscriptionId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "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/ab724652-3442-4912-8615-61525bb9903d",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "objectType": "TransferEntity"
    }
  },
  {
    "id": "38a00d97-421c-4c33-8ae4-c8750604e02c",
    "status": "Complete",
    "createdTime": "2020-02-20T21:16:30.0149083Z",
    "lastModifiedTime": "2020-02-27T01:11:33Z",
    "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
    "partnertenantid": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
    "sourcePartnerName": "Test_Test_09092019GBL",
    "sourcePartnerTenantId": "7c8db11f-1e5e-4472-8386-f0b627d1f3e1",
    "targetPartnerName": "Test_Test_09032019GBL",
    "targetPartnerTenantId": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
    "lastModifiedUser": "edc0524d-2e42-4619-af7e-349c015cfdfd",
    "lineItems": [
      {
        "id": 0,
        "subscriptionId": "cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a",
        "offerId": "5E1087B6-246B-4503-B88A-B60BDF0B3840",
        "orderId": "5761e79a-f441-4a18-9902-83f9582ccff6",
        "billingCycle": "monthly",
        "friendlyName": "PowerApps per app plan",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "0",
        "status": "Complete",
        "addonItems": [

        ]
      },
      {
        "id": 0,
        "subscriptionId": "dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b",
        "offerId": "91FD106F-4B2C-4938-95AC-F54F74E9A239",
        "orderId": "9a088a06-dfe5-4f71-ba79-2711c313b634",
        "billingCycle": "monthly",
        "friendlyName": "Office 365 E1",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "1",
        "status": "Complete",
        "addonItems": [

        ]
      },
      {
        "id": 0,
        "subscriptionId": "eeee4efe-ff5f-aa6a-bb7b-cccccc8c8c8c",
        "offerId": "MS-AZR-0145P",
        "orderId": "6a9a544c-54c9-43e9-a863-b40c6f92d111",
        "billingCycle": "monthly",
        "friendlyName": "Microsoft Azure",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "2",
        "status": "Complete",
        "addonItems": [

        ]
      }
    ],
    "links": {
      "self": {
        "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/38a00d97-421c-4c33-8ae4-c8750604e02c",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "objectType": "TransferEntity"
    }
  },
  {
    "id": "d4f478d2-61e0-4550-b85d-c427abfe1e62",
    "status": "Complete",
    "createdTime": "2020-02-20T21:28:55.4245587Z",
    "lastModifiedTime": "2020-02-20T21:29:22Z",
    "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
    "partnertenantid": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
    "sourcePartnerName": "Test_Test_09092019GBL",
    "sourcePartnerTenantId": "7c8db11f-1e5e-4472-8386-f0b627d1f3e1",
    "targetPartnerName": "Test_Test_09032019GBL",
    "targetPartnerTenantId": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
    "lastModifiedUser": "edc0524d-2e42-4619-af7e-349c015cfdfd",
    "lineItems": [
      {
        "id": 0,
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "offerId": "B4D4B7F4-4089-43B6-9C44-DE97B760FB11",
        "orderId": "2340952e-af72-40e6-a106-e9b2aca99bb5",
        "billingCycle": "monthly",
        "friendlyName": "Visio Online Plan 2",
        "quantity": 2,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "0",
        "status": "Complete",
        "addonItems": [

        ]
      },
      {
        "id": 0,
        "subscriptionId": "ffff5f5f-aa6a-bb7b-cc8c-dddddd9d9d9d",
        "offerId": "F1A2FDB0-5CA8-475D-8CCC-9BB81C033DA5",
        "orderId": "5dd120ab-10a4-4bbf-b2bd-e52657431f85",
        "billingCycle": "monthly",
        "friendlyName": "Dynamics 365 for Project Service Automation (Qualified Offer) (250 seat minimum requirement)",
        "quantity": 250,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "1",
        "status": "Complete",
        "addonItems": [

        ]
      }
    ],
    "links": {
      "self": {
        "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/d4f478d2-61e0-4550-b85d-c427abfe1e62",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "objectType": "TransferEntity"
    }
  },
  {
    "id": "f10421cd-d4af-4939-82b9-cd0e75022759",
    "status": "PartiallyComplete",
    "createdTime": "2020-02-26T21:54:51.2901506Z",
    "lastModifiedTime": "2020-02-27T01:10:26Z",
    "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
    "partnertenantid": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
    "sourcePartnerName": "Test_Test_09092019GBL",
    "sourcePartnerTenantId": "7c8db11f-1e5e-4472-8386-f0b627d1f3e1",
    "targetPartnerName": "Test_Test_09032019GBL",
    "targetPartnerTenantId": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
    "lastModifiedUser": "edc0524d-2e42-4619-af7e-349c015cfdfd",
    "lineItems": [
      {
        "id": 0,
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "offerId": "B4D4B7F4-4089-43B6-9C44-DE97B760FB11",
        "billingCycle": "monthly",
        "friendlyName": "Visio Online Plan 2",
        "quantity": 2,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "0",
        "status": "Failed",
        "addonItems": [

        ],
        "transferError": "Subscription has already been transfered. Subscription: aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e"
      },
      {
        "id": 0,
        "subscriptionId": "aaaa6a6a-bb7b-cc8c-dd9d-eeeeee0e0e0e",
        "offerId": "1B4642E5-C69A-43EA-B4F6-F29BAE46227E",
        "orderId": "0e6793f0-3d9c-4749-b50d-1cf3527aa454",
        "billingCycle": "monthly",
        "friendlyName": "Dynamics 365 for Retail Attach to Qualifying Dynamics 365 Base Offer From SA From VL/DPL",
        "quantity": 20,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "1",
        "status": "Complete",
        "addonItems": [

        ]
      }
    ],
    "links": {
      "self": {
        "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/f10421cd-d4af-4939-82b9-cd0e75022759",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "objectType": "TransferEntity"
    }
  },
  {
    "id": "ddb933ad-02f4-4678-a09a-7fecca481acc",
    "status": "Reject",
    "createdTime": "2020-03-11T17:44:26.8841412Z",
    "lastModifiedTime": "2020-03-11T17:45:08Z",
    "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
    "partnertenantid": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
    "sourcePartnerName": "Test_Test_09092019GBL",
    "sourcePartnerTenantId": "7c8db11f-1e5e-4472-8386-f0b627d1f3e1",
    "targetPartnerName": "Test_Test_09032019GBL",
    "targetPartnerTenantId": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
    "lastModifiedUser": "01a7548d-1136-4cf0-ba9a-300f921ffb22",
    "lineItems": [
      {
        "id": 0,
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "offerId": "5B04B78C-FD36-4CF3-A7A5-3457991C8B79",
        "billingCycle": "monthly",
        "friendlyName": "Dynamics 365 Business Central Device",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "addonItems": [

        ]
      },
      {
        "id": 1,
        "subscriptionId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "offerId": "MS-AZR-0145P",
        "billingCycle": "monthly",
        "friendlyName": "Microsoft Azure",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "addonItems": [

        ]
      }
    ],
    "links": {
      "self": {
        "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/ddb933ad-02f4-4678-a09a-7fecca481acc",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "objectType": "TransferEntity"
    }
  },
  {
    "id": "0a25bd0e-e6c1-40ac-9e96-40b56d46e902",
    "status": "Complete",
    "createdTime": "2020-03-11T17:56:53.622599Z",
    "lastModifiedTime": "2020-03-11T17:58:00Z",
    "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
    "partnertenantid": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
    "sourcePartnerName": "Test_Test_09092019GBL",
    "sourcePartnerTenantId": "7c8db11f-1e5e-4472-8386-f0b627d1f3e1",
    "targetPartnerName": "Test_Test_09032019GBL",
    "targetPartnerTenantId": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
    "lastModifiedUser": "edc0524d-2e42-4619-af7e-349c015cfdfd",
    "lineItems": [
      {
        "id": 0,
        "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
        "offerId": "5B04B78C-FD36-4CF3-A7A5-3457991C8B79",
        "orderId": "42436b2f-d417-4642-bb76-feb697184100",
        "billingCycle": "monthly",
        "friendlyName": "Dynamics 365 Business Central Device",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "0",
        "status": "Complete",
        "addonItems": [

        ]
      },
      {
        "id": 1,
        "subscriptionId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "offerId": "MS-AZR-0145P",
        "orderId": "d9a1b396-ad2c-4283-a9fe-5490acd0ce7d",
        "billingCycle": "monthly",
        "friendlyName": "Microsoft Azure",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "1",
        "status": "Complete",
        "addonItems": [

        ]
      }
    ],
    "links": {
      "self": {
        "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/0a25bd0e-e6c1-40ac-9e96-40b56d46e902",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "objectType": "TransferEntity"
    }
  },
  {
    "id": "8dc673dd-d6a6-4739-9e8f-0b66bbf2a2c8",
    "status": "Complete",
    "createdTime": "2020-03-19T23:21:03.2754503Z",
    "lastModifiedTime": "2020-03-19T23:22:33Z",
    "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
    "partnertenantid": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
    "sourcePartnerName": "Test_Test_09092019GBL",
    "sourcePartnerTenantId": "7c8db11f-1e5e-4472-8386-f0b627d1f3e1",
    "targetPartnerName": "Test_Test_09032019GBL",
    "targetPartnerTenantId": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
    "lastModifiedUser": "3badf44d-fd41-4432-a17d-214e31f2d9ee",
    "lineItems": [
      {
        "id": 0,
        "subscriptionId": "cccc2c2c-dd3d-ee4e-ff5f-aaaaaa6a6a6a",
        "offerId": "3DD9350B-27D6-4501-93A4-C8D107F1DE47",
        "orderId": "31bfde4a-efca-49b2-b210-62973fb773db",
        "billingCycle": "monthly",
        "friendlyName": "Microsoft Flow Plan 1 (Qualified Offer)",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "0",
        "status": "Complete",
        "addonItems": [

        ]
      }
    ],
    "links": {
      "self": {
        "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/8dc673dd-d6a6-4739-9e8f-0b66bbf2a2c8",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "objectType": "TransferEntity"
    }
  },
  {
    "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": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
    "sourcePartnerName": "Test_Test_09092019GBL",
    "sourcePartnerTenantId": "7c8db11f-1e5e-4472-8386-f0b627d1f3e1",
    "targetPartnerName": "Test_Test_09032019GBL",
    "targetPartnerTenantId": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
    "lastModifiedUser": "01a7548d-1136-4cf0-ba9a-300f921ffb22",
    "lineItems": [
      {
        "id": 0,
        "subscriptionId": "bbbb1b1b-cc2c-dd3d-ee4e-ffffff5f5f5f",
        "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"
    }
  },
  {
    "id": "7b1ce5e6-5829-45c6-b3bb-89bfb791a69e",
    "status": "PartiallyComplete",
    "createdTime": "2020-03-25T22:20:38.8090876Z",
    "lastModifiedTime": "2020-03-25T22:24:35Z",
    "customerTenantId": "b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0",
    "partnertenantid": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
    "sourcePartnerName": "Test_Test_09092019GBL",
    "sourcePartnerTenantId": "7c8db11f-1e5e-4472-8386-f0b627d1f3e1",
    "targetPartnerName": "Test_Test_09032019GBL",
    "targetPartnerTenantId": "3a9a35ce-d5be-4814-ab58-4451c36fe157",
    "lastModifiedUser": "edc0524d-2e42-4619-af7e-349c015cfdfd",
    "lineItems": [
      {
        "id": 0,
        "subscriptionId": "dddd3d3d-ee4e-ff5f-aa6a-bbbbbb7b7b7b",
        "offerId": "5344C201-3099-44E5-B333-C3EB0401EDE0",
        "orderId": "21b92393-ffce-4bc7-87c5-62cfa897d8f9",
        "billingCycle": "annual",
        "friendlyName": "Dynamics 365 Customer Engagement Plan (36 mo)",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "0",
        "status": "Complete",
        "addonItems": [

        ]
      },
      {
        "id": 1,
        "subscriptionId": "eeee4efe-ff5f-aa6a-bb7b-cccccc8c8c8c",
        "offerId": "A4179D30-CC09-49F0-977E-DC2CB70B874F",
        "billingCycle": "annual",
        "friendlyName": "Project Online Essentials",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "1",
        "status": "Failed",
        "addonItems": [

        ],
        "transferError": "Subscription SyncState must be SyncComplete for the Subscription to be a source in a Subscription Ownership Transfer. Subscription: eeee4efe-ff5f-aa6a-bb7b-cccccc8c8c8c, current state: None"
      },
      {
        "id": 2,
        "subscriptionId": "ffff5f5f-aa6a-bb7b-cc8c-dddddd9d9d9d",
        "offerId": "1A90EE13-2CB4-4785-BB0F-542813F00A37",
        "orderId": "7414b8ea-c167-4cc4-bc8e-b43efc177a46",
        "billingCycle": "annual",
        "friendlyName": "Dynamics 365 Business Central Essential",
        "quantity": 1,
        "partnerIdOnRecord": "5139005",
        "transferGroupId": "2",
        "status": "Complete",
        "addonItems": [

        ]
      }
    ],
    "links": {
      "self": {
        "uri": "/customers/b67f0b00-f9e8-4c57-bcb5-0b8b95c6ccf0/transfers/7b1ce5e6-5829-45c6-b3bb-89bfb791a69e",
        "method": "GET",
        "headers": [

        ]
      }
    },
    "attributes": {
      "objectType": "TransferEntity"
    }
  }
]