Compartilhar via


Obter uma migração de assinatura de novo comércio

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para o Microsoft Cloud for US Government

Como obter uma migração de uma assinatura para o New Commerce Experience para marcar migração status

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á pesquisá-la no Partner Center selecionando o workspace 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 é igual à ID do cliente (customer-tenant-id).

  • Uma ID de assinatura atual

Solicitação REST

Sintaxe da solicitação

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

Parâmetro do URI

Esta tabela lista os parâmetros de consulta necessários para criar uma migração de comércio.

Nome Type Obrigatório Descrição
customer-tenant-id string Sim Uma cadeia com formato de GUID que identifica o cliente.
migration-id string Sim Uma cadeia com formato de GUID que identifica o cliente.

Cabeçalhos de solicitação

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

Corpo da solicitação

Nenhum.

Resposta REST

Se tiver êxito, esse método retornará detalhes das Assinaturas que estão sendo migradas (objeto de migração) 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.

Exemplos de respostas

{
    "id": "f46fbd87-b204-40e5-b891-d0879ca3bf62",
    "startedTime": "2021-10-13T16:30:32.1446219Z",
    "completedTime": "2021-10-13T16:35:40.3844713Z",
    "currentSubscriptionId": "5C77DC7F-BE2C-4306-A3B5-0EBB4365D7FC",
    "status": "Completed",
    "customerTenantId": "75c5e79e-7e9f-429f-b772-ed3d38768f7c",
    "catalogItemId": "CFQ7TTC0LF8Q:0001:CFQ7TTC0KJ4N",
    "newCommerceSubscriptionId": "8adde5ce-52e3-47b5-c49c-df9c210bd5df",
    "newCommerceOrderId": "8672a13e9197",
    "subscriptionEndDate": "2022-10-13T00:00:00Z",
    "quantity": 1,
    "termDuration": "P1Y",
    "billingCycle": "Monthly",
    "purchaseFullTerm": false
}