Versiones y soporte técnico
Este artículo proporciona una descripción general de las políticas de control de versiones y cambios importantes para las diversas herramientas de programación.
Soporte e información de obsolescencia
La API de Power Platform es la primera herramienta de programación que recibe nuevas versiones y características antes que otros SDK como PowerShell, Management Connectors y Power Platform CLI. A medida que se publique una nueva versión de API de REST, se retirarán las versiones anteriores. Microsoft declarará una versión obsoleta al menos 12 meses antes de retirar una API punto de conexión. Cuando una versión está en desuso, todavía se admite tal cual. Si tiene algún problema con esa versión, le solicitaremos que pase a la versión actualmente disponible de forma general. Cuando se retira una versión, no es compatible y pronto se cerrará.
Al incrementar el número de versión de la API (por ejemplo, de 2021-10-01 a 2022-04-01), Microsoft anuncia que la versión anterior generalmente disponible (en este ejemplo, 2021-10-01) queda inmediatamente obsoleta y se retirará 12 meses después del anuncio. Se tiene el mismo tratamiento para las versiones preliminares públicas. Microsoft Podría hacer excepciones a esta política por cuestiones de seguridad y salud del servicio.
Para los cmdlets de PowerShell, las versiones incrementales estarán disponibles para resolver correcciones de errores menores. Las versiones principales se incrementarán para coincidir con las nuevas versiones de API que se produzcan.
Cambios compatibles e importantes
Microsoft Proporcionará detalles de los cambios de programabilidad en los planes de lanzamiento . Si los cambios son de naturaleza constante, la versión de la API seguirá siendo la misma y la versión de PowerShell recibirá un incremento de versión menor. Si los cambios son de naturaleza disruptiva, Microsoft incrementará la versión de la API y la versión principal de PowerShell.
Aquí hay algunos ejemplos de cambios importantes:
- Se cambia la URL o la solicitud / respuesta fundamental.
- Una propiedad declarada se elimina o cambia de nombre, o se cambia su tipo.
- La API o los parámetros de la API se eliminan o se les cambia el nombre.
- Se agrega un parámetro necesario.
Aquí hay algunos ejemplos de cambios no importantes:
- Se agregan propiedades que aceptan valores NULL o tienen un valor predeterminado.
- Se agrega un miembro a una enumeración.
- La paginación se introduce en las colecciones existentes.
- Los códigos de error se cambian.
- Se cambia el orden de las propiedades en las solicitudes o respuestas.
Versiones disponibles
| Versión | Tipo | Referencia | Fecha de desuso | Fecha de retirada |
|---|---|---|---|---|
| Versión preliminar de 01/03/2022 | Versión preliminar pública | 2022-03-01-vista previa Referencia | N/D | N/A |
| 01/10/2020 | Disponible en general | Referencia 2020-10-01 | N/A | N/A |
Nota
La versión de disponibilidad general 2020/10/01 de la API de Power Platform es específica para la gestión del entorno y también se conoce comúnmente como API de plataforma de aplicaciones empresariales (BAP). La funcionalidad de este conjunto de puntos de conexión estará disponible en las versiones más recientes de la API de Power Platform, junto con muchas características adicionales después de la versión 2022-03-01-preview.
Pasos siguientes
Ahora que comprende la estrategia de control de versiones y soporte, veamos cómo autenticarse con la API de Microsoft Power Platform.