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 na autenticação do Partner Center. Este cenário oferece suporte à autenticação com credenciais autônomas de Aplicativo e Aplicativo+Usuário.
Um ID de cliente (
customer-tenant-id
). Se não souber o ID do cliente, pode procurá-lo no Partner Center selecionando a área de trabalho Clientes e, em seguida, o cliente na 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 é a mesma que a ID do cliente (customer-tenant-id
).
Sintaxe da solicitação
Método | URI do pedido |
---|---|
GET | {baseURL}/v1/customers/{customer-tenant-id}/transferências HTTP/1.1 |
Parâmetro URI
Esta tabela lista o parâmetro de consulta necessário para obter todas as assinaturas.
Nome | Type | Obrigatório | Description |
---|---|---|---|
ID do cliente-locatário | string | Sim | Uma cadeia de caracteres formatada em GUID que identifica o cliente. |
Cabeçalhos do pedido
Para obter mais informações, consulte Cabeçalhos REST do Partner Center.
Corpo do pedido
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 do REST
Se bem-sucedido, esse método retorna uma lista de recursos TransferEntity no corpo da resposta.
Códigos de sucesso e erro de resposta
Cada resposta vem com um código de status HTTP que indica sucesso ou falha e informações adicionais de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e parâmetros adicionais. Para obter a lista completa, consulte 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": "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": "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": "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": "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": "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": "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": "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": "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": "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": "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": "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": "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": "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": "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": "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": "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": "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": "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"
}
}
]