Control de versións e compatibilidade
Este artigo ofrece unha visión xeral das políticas de control de versións e modificacións desestabilizadoras das distintas ferramentas de programación.
Información de compatibilidade e desfase
A API de Power Platform é a primeira ferramenta de programación que recibe novas versións e funcións antes que outros SDK como PowerShell, Management Connectors e CLI de Power Platform. Cando se lanza unha nova versión da API REST, retiraranse as versións anteriores. Microsoft declarará unha versión obsoleta polo menos 12 meses antes de que retire un extremo da API. Cando unha versión está obsoleta, aínda se admite tal como está. Se atopa algún problema con esa versión, solicitarémoslle que pase á versión dispoñible actualmente. Cando se retira unha versión, non é compatible e desactivarase en breve.
Ao incrementar o número de versión da API (por exemplo, de 2021-10-01 a 2022-04-01), Microsoft anuncia que a versión anterior xeralmente dispoñible (neste exemplo, 2021-10-01) está obsoleta de inmediato e retirarase 12 meses despois do anuncio. O mesmo tratamento tense para as versións preliminares públicas. Microsoft pode facer excepcións a esta política por problemas de seguridade e estado do servizo.
Para os cmdlets de PowerShell, as versións incrementais estarán dispoñibles para resolver pequenas correccións de erros. As versións principais incrementaranse para que coincidan coas novas versións da API que se producen.
Cambios compatibles e desestabilizadores
Microsoft proporcionará detalles sobre os cambios de programación nos plans de lanzamento. Se os cambios son de natureza non desestabilizadora, a versión da API seguirá sendo a mesma e a versión de PowerShell recibirá un incremento de versión leve. Se os cambios son de natureza desestabilizadora, Microsoft incrementará a versión da API e a versión principal de PowerShell.
Aquí ten exemplos de cambios desestabilizadores:
- Cambia o URL ou a solicitude/resposta fundamental.
- Quítase ou renoméase unha propiedade declarada ou cambia o seu tipo.
- Elimínanse ou renoméanse os parámetros da API ou a API.
- Engádese un parámetro de solicitude requirido.
Aquí ten exemplos de cambios non desestabilizadores:
- Engádense propiedades que son anulables ou teñen un valor predeterminado.
- Engádese un membro a unha enumeración.
- O paxinamento introdúcese nas coleccións existentes.
- Cámbianse os códigos de erro.
- Cambia a orde das propiedades nas solicitudes ou respostas.
Versións dispoñibles
| Versión | Tipo | Referencia | Data de obsolescencia | Data de posta fóra de servizo |
|---|---|---|---|---|
| 03-01-2022-versión-preliminar | Versión preliminar pública | 2022-03-01-preview Ref | N/D | N/D |
| 10-01-2020 | Dispoñible de xeito xeral | 10-01-2020 Ref. | N/D | N/D |
Nota
A versión xeralmente dispoñible 2020-10-01 da API de Power Platform é específica para a xestión do ambiente e tamén se coñece habitualmente como API da Plataforma de Aplicacións Empresariais (BAP). A funcionalidade deste conxunto de puntos finais estará dispoñible nas versións máis recentes da API de Power Platform xunto con moitas funcións adicionais despois da versión preliminar de 2022-03-01.
Pasos seguintes
Agora que comprende a estratexia de control de versións e compatibilidade imos ver como autenticarse coa API de Microsoft Power Platform.