Controle de versão e suporte
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. A Microsoft declarará uma versão como preterido pelo menos 12 meses antes de desativar um ponto de extremidade de 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), a Microsoft anuncia que a versão anterior disponível para o público geral (neste exemplo, 2021-10-01) está imediatamente preterida e será desativada 12 meses após o anúncio. O mesmo tratamento é dado às versões preliminares públicas. A Microsoft pode fazer exceções a essa política para problemas de integridade 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
A Microsoft fornecerá detalhes das alterações 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 de falha, a 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 – Referência da versão preliminar | N/D | N/A |
| 2020-10-01 | Disponível para o público geral | Ref 2020-10-01 | 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.