Agendar uma nova migração de comércio
Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para o Microsoft Cloud for US Government
Funções apropriadas: Administrador global | Agente administrativo | Agente de vendas
Este artigo descreve como agendar uma nova experiência de comércio.
Pré-requisitos
Credenciais, conforme descrito em Autenticação do Partner Center. Esse cenário oferece 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 espaço de trabalho Clientes, 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
).Um ID de assinatura atual
Solicitação REST
Sintaxe da solicitação
Método | URI da solicitação |
---|---|
POST | {baseURL}/v1/customers/{customer-tenant-id}/migrations/newcommerce/schedules |
Parâmetro do URI
Esta tabela lista os parâmetros de consulta necessários para criar uma nova migração de comércio.
Nome | Tipo | Necessário | Descrição |
---|---|---|---|
customer-tenant-id | string | Sim | Uma cadeia de caracteres formatada em 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
Esta tabela descreve as propriedades de assinatura no corpo da solicitação.
Propriedade | Tipo | Necessário | Descrição |
---|---|---|---|
currentSubscriptionId | string | Sim | Um identificador de assinatura que indica qual assinatura requer validação para migração. |
prazoDuração | Cadeia de caracteres | No | A duração do prazo pode ser especificada para ser alterada após a migração. |
faturamentoCiclo | Cadeia de caracteres | No | O ciclo de faturamento pode ser especificado para ser alterado após a migração. |
compraFullTerm | bool | Não | Um novo termo pode ser iniciado no NCE após a migração. |
quantidade | INT | 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 de término pode ser definida para se alinhar a uma assinatura OnlineServicesNCE não experimental existente ou a um mês de calendário. Há mais informações sobre como alinhar datas de término de assinatura aqui: Alinhar datas de término de assinatura no Partner Center |
targetDate | DATETIME | Obrigatório (se migrateOnRenewal for null/false) | Data de destino quando agendar a migração. Se targetDate for definido para a data especificada, o migrationOnRenewal poderá ser definido como null ou false. |
migrateOnRenewal | bool | Obrigatório (se targetDate for null) | Se o sinalizador for definido true para migrateOnRenewal, não será necessário especificar a targetDate para agendar uma migração. |
addOnMigrationSchedules | bool | Não | Inclui uma lista de assinaturas de AddOn a serem incluídas na migração agendada. |
Exemplo de solicitação
{
"currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
"quantity": 1,
"billingCycle": "monthly",
"purchaseFullTerm": false,
"termDuration": "P1Y",
"customTermEndDate": null,
"targetDate": "2023-08-09T00:00:00.000Z",
"addOnMigrations": [
{
"currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
"quantity": 17,
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"termDuration": "P1M",
"customTermEndDate": null
},
{
"currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
"quantity": 23,
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"termDuration": "P1Y",
"customTermEndDate": null
}
]
}
Resposta REST
Se bem-sucedido, esse método retorna 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 resposta
{
"id": "f016c025-a873-47af-8b52-2516fbef4c65",
"currentSubscriptionId": "2591295E-DDEB-425A-93F9-C1B4F5AD7FB6",
"quantity": 1,
"billingCycle": "monthly",
"purchaseFullTerm": false,
"termDuration": "P1Y",
"customTermEndDate": null,
"targetDate": "2023-08-09T00:00:00.000Z",
"addOnMigrations": [
{
"currentSubscriptionId": "5B882C48-53C6-46AF-B8A4-0691F19BAD94",
"quantity": 17,
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"termDuration": "P1M",
"customTermEndDate": null
},
{
"currentSubscriptionId": "C7D0DB12-9482-4297-8F09-190EB04F9C05",
"quantity": 23,
"billingCycle": "Monthly",
"purchaseFullTerm": false,
"termDuration": "P1Y",
"customTermEndDate": null
}
]
}
Confira também
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de