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á en desuso una versión al menos 12 meses antes de retirar un punto de conexión de API. 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 en desuso y se retirará 12 meses después del anuncio. Se tiene el mismo tratamiento para las versiones preliminares públicas. Microsoft puede hacer excepciones a esta directiva por problemas de estado y seguridad 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 se rompen en la naturaleza, Microsoft incrementará la versión de 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-preview Ref | N/D | N/A |
| 01/10/2020 | Disponible en general | 2020-10-01 Ref | 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.