Administración de perfiles de la versión de API en Azure Stack Hub

  • Artículo

Los perfiles de la API especifican el proveedor de recursos de Azure y la versión de la API para los puntos de conexión REST de Azure. Puede crear clientes personalizados en distintos idiomas mediante perfiles de API. Cada cliente utiliza un perfil de API para ponerse en contacto con el proveedor de recursos correcto y la versión de API para Azure Stack Hub.

Puede crear una aplicación para trabajar con los proveedores de recursos de Azure sin tener que saber exactamente qué versión de cada API de proveedor de recursos es compatible con Azure Stack Hub. Solo tiene que alinear la aplicación con un perfil para que el SDK vuelva a la versión de la API correcta.

Este tema le ayudará a:

  • Conocer los perfiles de API para Azure Stack Hub.
  • Aprender a utilizar los perfiles de la API para desarrollar soluciones.
  • Ver dónde obtener guías específicas del código.

Resumen de perfiles de API

  • Los perfiles de API se utilizan para representar un conjunto de proveedores de recursos de Azure y sus versiones de API.
  • Los perfiles de API se crearon para que pueda crear plantillas por varias nubes de Azure. Los perfiles proporcionan una interfaz compatible y estable.
  • Los perfiles se publican cuatro veces al año.
  • Se utilizan tres perfiles de convenciones de nomenclatura:
    • más reciente
      Contiene las versiones más recientes de la API publicadas en la versión global de Azure.
    • yyyy-mm-dd-hybrid
      Esta versión de publicación semestral se centra en la estabilidad y coherencia entre varias nubes. Este perfil tiene como objetivo la compatibilidad óptima de Azure Stack Hub.
    • yyyy-mm-dd-profile
      Equilibra la estabilidad óptima y las últimas características.

Compatibilidad con perfiles de API de Azure y Azure Stack Hub

Los perfiles de API de Azure más recientes no son compatibles con Azure Stack Hub. Use las siguientes convenciones de nomenclatura para identificar los perfiles que va a usar para las soluciones de Azure Stack Hub:

más reciente
Este perfil tiene la versión de API más actualizada que se encuentra en todo Azure, pero no funciona en Azure Stack Hub. El perfil latest tiene el mayor número de cambios importantes. Asimismo, deja de lado la estabilidad y la compatibilidad con otras nubes. Si intenta usar las versiones de API más actualizadas, latest es el perfil que debe usar.

Yyyy-mm-dd-hybrid
Este perfil se publica en marzo y septiembre de cada año. Tiene una estabilidad óptima y compatibilidad con varias nubes, y está diseñado para tener como destino todo Azure y Azure Stack Hub. Las versiones de API de Azure que se enumeran en este perfil son las mismas que las que aparecen en Azure Stack Hub. Use este perfil para desarrollar código para soluciones de nube híbrida.

yyyy-mm-dd-profile
Este perfil se publica para la versión global de Azure en junio y diciembre. No funciona con Azure Stack Hub y, normalmente, incorporará muchos cambios importantes. Si bien equilibra una estabilidad óptima con las últimas características, la diferencia entre latest y este perfil es que latest siempre consta de las últimas versiones de la API, independientemente de cuándo se haya lanzado esta. Por ejemplo, si se crea una nueva versión de API para Compute API mañana, esa versión de API se mostrará en latest, pero no en yyyy-mm-dd-profile, dado que este perfil ya existe. yyyy-mm-dd-profile cubre las versiones más actualizadas lanzadas antes de junio o diciembre.

Perfiles de la API de Azure Resource Manager

Azure Stack Hub no utiliza la versión mas reciente de las versiones de API que se encuentran en todo Azure. Al crear una solución, debe encontrar la versión de API para cada proveedor de recursos en Azure que sea compatible con Azure Stack Hub.

En lugar de investigar cada proveedor de recursos y la versión concreta admitida por Azure Stack Hub, puede usar un perfil de API. El perfil especifica un conjunto de proveedores de recursos y las versiones de API. El SDK o una herramienta integrada con el SDK, devolverá el valor de api-version de destino especificada en el perfil. Con los perfiles de la API, puede especificar una versión de perfil que se aplique a toda una plantilla. Azure Resource Manager selecciona la versión correcta del recurso en tiempo de ejecución.

Los perfiles de API funcionan con herramientas que utilizan Azure Resource Manager, como PowerShell, CLI de Azure, código proporcionado en el SDK y Microsoft Visual Studio. Las herramientas y los SDK pueden usar perfiles para leer la versión de los módulos y las bibliotecas que se van incluir al compilar una aplicación.

Por ejemplo, si utiliza PowerShell para crear una cuenta de almacenamiento con el proveedor de recursos Microsoft.Storage, que admite api-version 2016-03-30 y una máquina virtual que utiliza el proveedor de recursos Microsoft.Compute con api-version 2015-12-01, debe buscar qué módulo de PowerShell admite 2016-03-30 para Storage y qué módulo admite 2015-02-01 para Compute e instalarlos. En su lugar, puede usar un perfil. Use el cmdlet Install-Profile <profilename> y PowerShell carga la versión correcta de los módulos.

De forma similar, al usar el SDK de Python para compilar una aplicación basada en Python, puede especificar el perfil. El SDK carga los módulos correctos para los proveedores de recursos que ha especificado en el script.

Como desarrollador, esto significa que puede centrarse en escribir la solución. En lugar de investigar qué versiones de API, qué proveedor de recursos y qué nube funcionan juntos, puede usar un perfil y saber qué código va a funcionar en todas las nubes que lo admiten.

Ejemplos de código de perfil de API

Puede encontrar ejemplos de código que le ayudarán a integrar la solución con el idioma que prefiera con Azure Stack Hub mediante el uso de perfiles. Actualmente, puede encontrar guía y ejemplos para los siguientes idiomas:

  • .NET
    Use el perfil de la API de .NET para obtener la versión más reciente y más estable de cada tipo de recurso de un paquete de proveedor de recursos. Para más información, consulte Uso de perfiles de la versión de API con .NET en Azure Stack Hub.
  • PowerShell
    Use el módulo Az.Bootstrapper disponible en la Galería de PowerShell para obtener los cmdlets de PowerShell necesarios para trabajar con los perfiles de la versión de la API. Para más información, consulte el artículo sobre el uso de perfiles de versión de API para PowerShell. Use el módulo AzureRM.Bootstrapper disponible en la Galería de PowerShell para obtener los cmdlets de PowerShell necesarios para trabajar con los perfiles de la versión de la API. Para más información, consulte el artículo sobre el uso de perfiles de versión de API para PowerShell.
  • CLI de Azure
    Actualice la configuración del entorno para usar el perfil de la versión de API específico de Azure Stack Hub. Para más información, consulte el artículo Uso de los perfiles de la versión de la API con la CLI de Azure.
  • Go
    En el SDK de Go, un perfil es una combinación de diferentes tipos de recursos con distintas versiones de diferentes servicios. Los perfiles están disponibles en la ruta de acceso profiles/ con su versión en formato AAAA-MM-DD. Para más información, consulte el artículo sobre el uso de perfiles de versión de API para Go.
  • Ruby
    El SDK de Ruby para Resource Manager de Azure Stack Hub proporciona herramientas que facilitan la creación y administración de infraestructuras. Proveedores de recursos en el SDK incluye Compute, Redes virtuales y opciones de almacenamiento con el lenguaje Ruby. Para obtener información, vea Uso de los perfiles de la versión de la API con Ruby.
  • Python
    El SDK de Python admite los perfiles de la versión de la API para su uso con diferentes plataformas en la nube, como Azure Stack Hub y Azure global. Use los perfiles de la API para crear soluciones para una nube híbrida. Para obtener información, vea Usar perfiles de la versión de la API con Python.
  • Node.js
    El SDK de Node.js para Resource Manager de Azure Stack Hub proporciona herramientas que le ayudan a crear y administrar su infraestructura. Para obtener más información, consulte Uso de los perfiles de la versión de la API con Node.js.

Pasos siguientes