Uso de los perfiles de la versión de la API con GO en Azure Stack Hub

Artículo
10/30/2024

GO y perfiles de la versión

Un perfil es una combinación de diferentes tipos de recursos con distintas versiones de diferentes servicios. Los perfiles le ayudan a mezclar y combinar diferentes tipos de recursos y le ofrecen las siguientes ventajas:

Estabilidad para la aplicación mediante el bloqueo de versión específicas de API.
Compatibilidad de la aplicación tanto con Azure Stack Hub como con los centros de datos de Azure regionales.

En el SDK de Go, los perfiles están disponibles en la ruta de acceso de perfiles. Los números de versión de los perfiles se etiquetan con el formato AAAA-MM-DD. Por ejemplo, la versión del perfil de API de Azure Stack Hub es 2020-09-01 para la versión 2102 de Azure Stack Hub, o las versiones posteriores. Para importar un servicio determinado de un perfil, importe su módulo correspondiente del perfil. Por ejemplo, para importar el servicio Compute del perfil 2020-09-01, use el siguiente código:

import "github.com/Azure/azure-sdk-for-go/profiles/2020-09-01/compute/mgmt/compute"

Instalación del SDK de Azure para Go

Instale Git. Consulte Introducción: Instalación de Git.
Instale Go. Los perfiles de la API para Azure requieren la versión 1.9 de Go, o cualquier otra más reciente. Consulte Lenguaje de programación Go.

Profiles

Para usar otro perfil o versión del SDK, sustituya la fecha en una instrucción de importación, como github.com/Azure/azure-sdk-for-go/profiles/<date>/storage/mgmt/storage. Por ejemplo, para la versión 2008, el perfil es 2019-03-01 y la cadena se convierte en github.com/Azure/azure-sdk-for-go/profiles/2019-03-01/storage/mgmt/storage. Tenga en cuenta que a veces el equipo del SDK cambia el nombre de los paquetes, por lo que podría no funcionar simplemente reemplazar la fecha de una cadena por otra fecha. Consulte la tabla siguiente para ver la asociación de perfiles y versiones de Azure Stack.

Versión de Azure Stack	Perfil
2311	2020_09_01
2301	2020_09_01
2206	2020_09_01
2108	01-09-2020
2102	01-09-2020
2008	2019-03-01

Para más información sobre los perfiles de API y Azure Stack Hub, consulte Resumen de perfiles de API.

Consulte Perfiles del SDK de Go.

Subscription

Si aún no tiene una suscripción, cree una y guarde el ID. de suscripción para usarlo más adelante. Para más información sobre cómo crear una suscripción, vea este documento.

Entidad de servicio

Una entidad de servicio y su información de entorno asociada deben crearse y guardarse en algún lugar. Se recomienda la entidad de servicio con rol owner, pero en función del ejemplo, un rol contributor puede ser suficiente. Consulte el archivo LÉAME en el repositorio de ejemplo para conocer los valores necesarios. Puede leer estos valores en cualquier formato admitido por el lenguaje SDK, como desde un archivo JSON (que usan nuestros ejemplos). Dependiendo de la ejecución del ejemplo, no se pueden usar todos estos valores. Consulte el repositorio de ejemplo para obtener código de ejemplo actualizado o más información.

Id. de inquilino

Para buscar el directorio o el ID. de inquilino de Azure Stack Hub, siga las instrucciones de este artículo.

Registro de proveedores de recursos

Registre los proveedores de recursos necesarios siguiendo este documento. Estos proveedores de recursos serán necesarios en función de los ejemplos que quiera ejecutar. Por ejemplo, si quiere ejecutar un ejemplo de máquina virtual, se requiere el registro del proveedor de recursos Microsoft.Compute.

Punto de conexión del administrador de recursos de Azure Stack

Azure Resource Manager (ARM) es un marco de administración que permite a los administradores implementar, administrar y supervisar recursos de Azure. Azure Resource Manager puede controlar estas tareas como grupo, en vez de individualmente, en una sola operación. Puede obtener la información de metadatos en el punto de conexión de Resource Manager. El punto de conexión devuelve un archivo JSON con la información necesaria para ejecutar el código.

El valor de ResourceManagerEndpointUrl del Kit de desarrollo de Azure Stack (ASDK) es: https://management.local.azurestack.external/.
ResourceManagerEndpointUrl en un sistema integrado es: https://management.region.<fqdn>/, donde <fqdn> es el nombre de dominio completo.
Para recuperar los metadatos necesarios: <ResourceManagerUrl>/metadata/endpoints?api-version=1.0. Para las versiones de API disponibles, consulte Especificaciones de la API de REST de Azure. Por ejemplo, en la versión 2020-09-01 del perfil, puede cambiar api-version por 2019-10-01 para el proveedor de recursos microsoft.resources.

Ejemplo de JSON:

{
   "galleryEndpoint": "https://portal.local.azurestack.external:30015/",
   "graphEndpoint": "https://graph.windows.net/",
   "portal Endpoint": "https://portal.local.azurestack.external/",
   "authentication": 
      {
         "loginEndpoint": "https://login.windows.net/",
         "audiences": ["https://management.yourtenant.onmicrosoft.com/3cc5febd-e4b7-4a85-a2ed-1d730e2f5928"]
      }
}

Ejemplos

Consulte el repositorio de ejemplo para obtener código de ejemplo actualizado. La raíz README.md describe los requisitos generales y cada subdirectorio contiene un ejemplo específico con su propio README.md modo de ejecutar ese ejemplo.

Consulte aquí el ejemplo aplicable a la versión 2008 o el perfil 2019-03-01 de Azure Stack y posteriores.

Pasos siguientes

Más información acerca de los perfiles de API:

Compartir a través de