Nota
O acceso a esta páxina require autorización. Pode tentar iniciar sesión ou modificar os directorios.
O acceso a esta páxina require autorización. Pode tentar modificar os directorios.
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 medida que se lanza unha nova versión da API REST, as versións anteriores son retiradas. Microsoft declara unha versión obsoleta polo menos 12 meses antes de retirar un punto final da API. Cando unha versión está obsoleta, está soportada as-is. Se tes algún problema con esa versión, solicitámosche que pases á versión actualmente estable. Cando unha versión se retira, non está soportada e pronto será apagada.
Ao aumentar 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) queda inmediatamente obsoleta 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 cuestións de saúde e seguridade do servizo.
As varias ferramentas e SDK que se xeran sobre a API de Power Platform, como Power Platform CLI, o conector Admin V2 e PowerShell, actualízanse ás versións máis recentes da API por acción e son transparentes para os usuarios finais.
Cambios compatibles e desestabilizadores
Microsoft proporciona detalles dos cambios de programabilidade nos plans de lanzamento. Se os cambios son de natureza ininterrompida, a versión da API segue sendo a mesma e a versión de PowerShell recibe un incremento de versión menor. Se os cambios están rompendo na natureza, Microsoft incrementa 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í tes exemplos de cambios ininterrompidos:
- 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 |
|---|---|---|---|---|
| 2024-10-01 | Estable | Referencia | N/D | N/D |
| 03-01-2022-versión-preliminar | Versión preliminar pública | 2022-03-01-preview Ref | 2025-03-01 | 2026-03-01 |
| 10-01-2020 | Dispoñible de xeito xeral | 2020-10-01 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 está dispoñible nas versións máis recentes da API de Power Platform xunto con moitas funcións adicionais despois da versión 2022-03-01-preview.
Pasos seguintes
Agora que comprende a estratexia de control de versións e compatibilidade imos ver como autenticarse coa API de Microsoft Power Platform.