Compartilhar via

Controle de versão e suporte

  • Artigo

Este artigo fornece uma visão geral das políticas de controle de versão e de alteração interruptiva para as várias ferramentas de programação.

Informações sobre suporte e substituição

A API do Power Platform é a primeira ferramenta de programação a receber novas versões e recursos antes de outros SDKs, como o PowerShell, os Conectores de Gerenciamento e a CLI do Power Platform. À medida que uma nova versão da API REST for lançada, as versões anteriores serão desativadas. Microsoft declarará uma versão obsoleta pelo menos 12 meses antes de aposentar um ponto de extremidade da API. Quando uma versão é preterida, ela ainda recebe suporte "no estado em que se encontra". Se você enfrentar um problema com essa versão, solicitaremos que você mude para a versão disponível para o público geral no momento. Quando uma versão é desativada, ela não terá mais suporte e em breve será encerrada.

Ao incrementar o número da versão da API (por exemplo, de 2021-10-01 para 2022-04-01), Microsoft anuncia que a versão anterior disponível para o público em geral (neste exemplo, 2021-10-01) será imediatamente descontinuada e será descontinuada 12 meses após o anúncio. O mesmo tratamento é dado às versões preliminares públicas. Microsoft pode abrir exceções a esta política por questões de saúde e segurança do serviço.

Para cmdlets do PowerShell, as versões incrementais serão disponibilizadas para resolver pequenas correções de bugs. As versões principais serão incrementadas para corresponder às novas versões de API que ocorrerem.

Alterações interruptivas e compatíveis

Microsoft fornecerá detalhes das mudanças de programação nos planos de lançamento. Se as alterações não forem de natureza de falha, a versão da API permanecerá igual e a versão do PowerShell receberá um incremento de versão secundária. Se as alterações forem de natureza disruptiva, Microsoft incrementará a versão da API e a versão principal do PowerShell.

Aqui estão alguns exemplos de alterações da falha:

  • A URL ou solicitação/resposta fundamental é alterada.
  • Uma propriedade declarada é removida ou renomeada, ou seu tipo é alterado.
  • A API ou os parâmetros da API são removidos ou renomeados.
  • Um parâmetro de solicitação obrigatório é adicionado.

Aqui estão alguns exemplos de alterações sem falha:

  • As propriedades adicionadas são anuláveis ou têm um valor padrão.
  • Um membro é adicionado a uma enumeração.
  • A paginação é introduzida em coleções existentes.
  • Os códigos de erro são alterados.
  • A ordem das propriedades em solicitações ou respostas é alterada.

Versões disponíveis

Versão Tipo Referência Data de substituição Data de desativação
2022-03-01 – versão preliminar Versão preliminar pública 2022-03-01-prévia Ref N/D N/A
2020-10-01 Disponível para o público geral 2020-10-01 Referência N/A N/A

Nota

A versão 2020-10-01 disponível para o público geral da API do Power Platform é específica para gerenciamento de ambiente e também é comumente chamada de API da Plataforma de Aplicativos de Negócios (BAP). A funcionalidade deste conjunto de endpoints será disponibilizada nas versões mais recentes da API do Power Platform juntamente com muitos recursos adicionais após a versão 01/03/2022 – versão preliminar.

Próximas etapas

Agora que você entende a estratégia de controle de versão e suporte, vamos ver como se autenticar com a API do Microsoft Power Platform.