Versões e suporte

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

Informações de suporte e preterimento

A API do Power Platform é a primeira ferramenta de programação a receber novas versões e funcionalidades antes de outros SDKs, como o PowerShell, os Conectores de Gestão e CLI do Power Platform. À medida que for lançada uma nova versão da API REST, as versões anteriores serão extintas. Microsoft declarará uma versão preterida pelo menos 12 meses antes de desativar uma API ponto final. Quando uma versão é preterida, continua a ser suportada como está. Se enfrentar um problema com essa versão, iremos pedir-lhe que mude para a versão geralmente disponível atualmente. Quando uma versão é extinta, não é suportada e será desligada em breve.

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 ao público (neste exemplo, 2021-10-01) foi imediatamente descontinuada e será desativada 12 meses após o anúncio. As versões de pré-visualização públicas seguem o mesmo tratamento. Microsoft pode abrir exceções a esta política para problemas de integridade e segurança do serviço.

Para os cmdlets do PowerShell, serão disponibilizadas versões incrementais para resolver pequenas correções de erros. As versões principais serão incrementadas de forma a corresponderem às novas versões da API que ocorrem.

Alterações compatíveis e interruptivas

Microsoft fornecerá detalhes das alterações de programação nos planos de lançamento. Se as alterações forem de natureza não interruptiva, a versão da API permanecerá a mesma e a versão PowerShell receberá um pequeno incremento de versão. Se as alterações estiverem a quebrar na natureza, Microsoft incrementará a versão da API e a versão principal do PowerShell.

Seguem-se alguns exemplos de alterações interruptivas:

• É alterado o URL ou o pedido/resposta fundamental.
• Uma propriedade declarada é removida ou é-lhe mudado o nome, ou o respetivo tipo é alterado.
• A API ou os parâmetros da API são removidos ou os nomes são mudados.
• É adicionado um parâmetro de pedido obrigatório.

Seguem-se alguns exemplos de alterações não interruptivas:

• São adicionadas propriedades que são anuláveis ou têm um valor predefinido.
• É adicionado um membro a uma enumeração.
• O paging é introduzido nas coleções existentes.
• Os códigos de erro são alterados.
• A ordem das propriedades nos pedidos ou nas respostas é alterada.

Versões disponíveis

Passos seguintes

Agora que compreende a estratégia de versões e suporte, vamos aprender a fazer a autenticação com a API do Microsoft Power Platform.

• Autenticação (pré-visualização) - para a versão pré-visualização pública
• Autenticação (legado) - para a versão geralmente disponível