Obter um novo cronograma de migração de comércio
Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center for Microsoft Cloud for US Government
Este artigo descreve como obter um novo cronograma de migração de comércio.
Importante
Atualmente, essa API só está disponível no locatário da Sandbox.
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).Um ID de subscrição atual
Pedido REST
Há duas maneiras diferentes de os parceiros consultarem.
- Os parceiros podem consultar para obter um cronograma específico
- Os parceiros podem consultar para obter a lista de agendas para critérios específicos
Sintaxe da solicitação
| Método | Solicitar URI |
|---|---|
| GET | {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules/{scheduleID} |
Parâmetro URI
Esta tabela lista os parâmetros de consulta necessários para criar uma nova migração comercial.
| Nome | Tipo | Necessário | Descrição |
|---|---|---|---|
| ID do cliente-locatário | string | Sim | Uma cadeia de caracteres formatada em GUID que identifica o cliente. |
| Método | Solicitar URI |
|---|---|
| GET | {baseURL}/v1/migrations/newcommerce/schedules? CustomerTenantId={customer-tenant-id} |
Parâmetro URI
Esta tabela lista os parâmetros de consulta necessários para criar uma nova migração comercial. Qualquer um dos parâmetros de consulta pode ser usado.
| Nome | Tipo | Descrição |
|---|---|---|
| customerTenantId | string | Uma cadeia de caracteres formatada em GUID que identifica o cliente. |
| currentSubscriptionID | string | Uma cadeia de caracteres formatada em GUID que identifica a ID de Assinatura atual |
| externalReferenceID | string | Uma cadeia de caracteres formatada em GUID que identifica o lote de migração |
Cabeçalhos do pedido
Para obter mais informações, consulte Cabeçalhos REST do Partner Center.
Corpo da resposta
Esta tabela descreve as propriedades da assinatura na resposta.
| Propriedade | Tipo | Necessário | Descrição |
|---|---|---|---|
| currentSubscriptionId | string | Sim | Um identificador de assinatura que indica qual assinatura requer validação para migração. |
| termoDuração | string | Não | Duração do prazo aplicado à migração. |
| faturamentoCiclo | string | Não | Ciclo de faturamento aplicado à migração. |
| compraFullTerm | booleano | Não | Se a migração inicia um novo termo ou não. |
| quantidade | número inteiro | Não | A quantidade de licença para uma assinatura pode ser aumentada ou diminuída após a migração. |
| customTermEndDate | datetime | Não | Uma data final pode ser definida para se alinhar com uma assinatura ou mês de calendário do OnlineServices NCE existente que não seja de avaliação. Há mais informações sobre como alinhar as datas de término da assinatura aqui: Alinhar datas de término da assinatura no Partner Center |
| data-alvo | datetime | Não | Data de destino quando agendar a migração. |
| migrateOnRenewal | booleano | Não | Indica se o cronograma precisa acontecer na renovação |
| status | string | Não | Status da migração da agenda |
| createdTime | datetime | Não | Quando o cronograma foi criado |
| lastModifiedTime | datetime | Não | Quando o horário foi modificado pela última vez |
Resposta do REST
Se for bem-sucedido, esse método retornará detalhes das assinaturas que estão sendo migradas (objeto de migração) 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 com mais informações de depuração. Use uma ferramenta de rastreamento de rede para ler esse código, tipo de erro e mais parâmetros. Para obter a lista completa, consulte Códigos de erro REST do Partner Center.
Exemplos de respostas
[
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "c6105a9c-36cb-4f88-92ea-9573040725c4",
"subscriptionEndDate": "2023-07-19T00:00:00Z",
"status": "Created",
"customerTenantId": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
"quantity": 25,
"termDuration": "P1Y",
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"targetDate": "2022-10-30T00:00:00",
"createdTime": "2022-10-18T21:20:50.9668605+00:00",
"lastModifiedTime": "2022-10-18T21:29:32.8992819+00:00"
}
]