Obter datas de término dos termos personalizados

2025-05-11

Aplica-se a: Partner Center | Partner Center operado pela 21Vianet | Partner Center para a Nuvem Microsoft para o Governo dos EUA

Os parceiros podem visualizar as datas de término personalizadas permitidas para assinaturas baseadas em licença NCE que estão comprando para seus clientes. Os parceiros podem exibir datas de término alinhadas com o final do mês ou com o período concomitante com assinaturas de clientes existentes.

As APIs só dão suporte ao cálculo de datas de término de prazo personalizadas para a compra de novas assinaturas e não para a renovação de assinaturas existentes.

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.
Um CustomerTenantId. Se você não souber a ID do cliente, poderá procurá-la no Partner Center selecionando a área de trabalho Clientes, depois 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.

Solicitação REST

Sintaxe da solicitação

Método	URI de solicitação
OBTER	{baseURL}/v1/customers/{customerId}/subscriptions/customTermEndDates

Cadeias de caracteres de consulta

Esta tabela lista as cadeias de caracteres de consulta necessárias para filtrar e recuperar datas de término de termo personalizadas.

Nome:	Obrigatório:	Descrição:
term_duration	Sim	Uma representação ISO 8601 da duração do prazo. Os valores atuais suportados são P1M (1 mês), P1Y (1 ano) e P3Y (3 anos).
term_start_date	Não	A data pretendida de compra. Isso não pode estar no passado.
target_coterm_subscription_id	Não	Uma cadeia de caracteres formatada em GUID que identifica a assinatura para coterm com.

Cabeçalhos da solicitação

Para mais informações, consulte os cabeçalhos REST do Partner Center. A resposta da API retorna um máximo de 300 registros de página. Se mais de 300 registros forem retornados em uma consulta inserida, um token de continuação será fornecido no cabeçalho de resposta. O token de continuação pode ser inserido no cabeçalho de uma solicitação a seguir para retornar registros de página adicionais consultados.

Corpo da solicitação

Nenhum.

Resposta REST

Se for bem-sucedido, esse método retornará detalhes das assinaturas que foram migradas (objeto de migração) no corpo da resposta. Isso inclui a ID de migração.

Códigos de erro e êxito 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 ver a lista completa, consulte Códigos de erro REST do Partner Center.

Exemplos de URL de solicitação

baseurl/v1/customers/94cd6638-11b6-4323-8c9f-6ae3088adc59/subscriptions/customTermEndDates?term_duration=P1M

Exemplos de respostas

 {
    "totalCount": 2,
    "items": [
        {
            "allowedCustomTermEndDateType": "calendarMonthAligned",
            "allowedCustomTermEndDate": "2023-07-31T00:00:00"
        },
        {
            "allowedCustomTermEndDateType": "subscriptionAligned",
            "cotermSubscriptionIds": [
               "5fcf618b-1daa-4604-da99-cc3e1c9ee422",
               "d30a9ff9-713e-4546-c97e-f06b9dcf6ef6"
            ],
            "allowedCustomTermEndDate": "2023-08-01T00:00:00"
        }
    ],
    "links": {
        "self": {
            "uri": "/customers/94cd6638-11b6-4323-8c9f-6ae3088adc59/subscriptions/customTermEndDates?term_duration=P1M",
            "method": "GET",
            "headers": []
        }
    },
    "attributes": {
        "objectType": "Collection"
    }
 }