Nota
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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
A medida que se publica una nueva versión de la API REST, se retiran las versiones anteriores. Microsoft declara una versión en desuso al menos 12 meses antes de retirar un punto de conexión de API. Cuando una versión está en desuso, se admite as-is. Si tiene un problema con esa versión, le solicitamos que pase a la versión estable actualmente. Cuando se retira una versión, no se admite y pronto se apagará.
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.
Las distintas herramientas y SDK que se generan sobre Power Platform API, como la CLI de Power Platform, el conector admin V2 y PowerShell, se actualizan a las versiones de API más recientes por acción y son transparentes para los usuarios finales.
Cambios compatibles e importantes
Microsoft proporciona detalles de los cambios de programación en los planes de versión. Si los cambios no se rompen por naturaleza, la versión de la API sigue siendo la misma y la versión de PowerShell recibe un incremento de versión secundaria. Si los cambios son importantes por naturaleza, Microsoft incrementa 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.
Estos son ejemplos de cambios que no se rompen:
- 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 |
|---|---|---|---|---|
| 2024-10-01 | Estable | Referencia | N/D | N/D |
| Versión preliminar de 01/03/2022 | Versión preliminar pública | 2022-03-01-vista previa Referencia | 2025-03-01 | 2026-03-01 |
| 01/10/2020 | Disponible en general | Referencia 2020-10-01 | N/D | N/D |
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 está disponible en las versiones más recientes de Power Platform API 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.