Share via

Utilice la CLI de Azure para administrar su inventario de API

  • Artículo

En este artículo se muestra cómo utilizar los comandos az apic api de la CLI de Azure para agregar y configurar API en el inventario del centro de API. Utilice comandos en la CLI de Azure para programar operaciones para administrar su inventario de API y otros aspectos de su centro de API.

Requisitos previos

  • Un centro de API en la suscripción de Azure. Si aún no ha creado uno, consulte Inicio rápido: Creación del centro de API.

  • Para la CLI de Azure:

    Nota:

    Los comandos az apic requieren la extensión apic-extension CLI de Azure. Si no ha utilizado comandos az apic, la extensión se instala dinámicamente cuando ejecuta su primer comando az apic. Obtenga más información sobre las extensiones CLI de Azure.

Registro de API, versión de API y definición

Los siguientes pasos muestran cómo crear una API y asociar una única versión y definición de API. Para obtener más información sobre el modelo de datos del Centro de API de Azure, consulte Conceptos clave.

Creación de una API

Utilice el comando az apic api create para crear una API en su centro de API.

El siguiente ejemplo crea una API denominada Petstore API en el grupo de recursos myResourceGroup y el centro de API myAPICenter. La API es una API REST.

az apic api create  --resource-group myResourceGroup \
    --service myAPICenter --api-id petstore-api \
    --title "Petstore API" --type "rest"

Nota:

Después de crear una API, puede actualizar las propiedades de la API utilizando el comando az apic api update.

Crear una versión de la API

Utilice el comando az apic api version create para crear una versión para su API.

El siguiente ejemplo crea una versión de la API denominada v1-0-0 para la API petstore-api que creó en la sección anterior. La versión se establece en la fase de ciclo de vida de pruebas.

az apic api version create --resource-group myResourceGroup \
    --service myAPICenter --api-id petstore-api \
    --version-id v1-0-0 --title "v1-0-0" --lifecycle-stage "testing"

Crear definición de API y agregar archivo de especificaciones

Utilice los comandos az apic api definition para agregar una definición y un archivo de especificación adjunto para una versión de API.

Crear una definición

El siguiente ejemplo utiliza el comando az apic api definition create para crear una definición llamada openapi para la versión de la API petstore-api que creó en la sección anterior.

az apic api definition create --resource-group myResourceGroup \
    --service myAPICenter --api-id petstore-api \
    --version-id v1-0-0 --definition-id openapi --title "OpenAPI"

Importar un fichero de especificaciones

Importe un archivo de especificación a la definición utilizando el comando az apic api definition import-specification.

El siguiente ejemplo importa un archivo de especificación OpenAPI desde una URL de acceso público a la definición openapi que creó en el paso anterior. Las name y las propiedades version del recurso de especificación se pasan como JSON.

az apic api definition import-specification \
    --resource-group myResourceGroup --service myAPICenter \
    --api-id petstore-api --version-id v1-0-0 \
    --definition-id openapi --format "link" \
    --value 'https://petstore3.swagger.io/api/v3/openapi.json' \
    --specification '{"name":"openapi","version":"3.0.2"}'

Sugerencia

Puede importar el archivo de especificación en línea estableciendo el parámetro --format a inline y pasando el contenido del archivo utilizando el parámetro --value.

Exportar un fichero de especificaciones

Para exportar una especificación de API desde su centro de API a un archivo local, utilice el comando az apic api definition export-specification.

El siguiente ejemplo exporta el archivo de especificaciones de la definición de openapi que creó en la sección anterior a un archivo local denominado specificationFile.json.

az apic api definition export-specification \
    --resource-group myResourceGroup --service myAPICenter \
    --api-id petstore-api --version-id v1-0-0 \
    --definition-id openapi --file-name "/Path/to/specificationFile.json"

Registro de API a partir de un archivo de especificaciones de un solo paso

Puede registrar una API desde un archivo de especificación local en un solo paso utilizando el comando az apic api register. Con esta opción, se crean automáticamente una versión y una definición de API por defecto para la API.

El siguiente ejemplo registra una API en el centro de API myAPICenter a partir de un archivo de definición de OpenAPI local denominado specificationFile.json.

az apic api register --resource-group myResourceGroup \
    --service myAPICenter --api-location "/Path/to/specificationFile.json"
  • El comando establece las propiedades de la API, como el nombre y el tipo, a partir de los valores del archivo de definición.
  • De forma predeterminada, el comando establece la etapa del ciclo de vidade la API en diseño.
  • Crea una versión de la API por defecto denominada 1-0-0 y una definición por defecto denominada según el formato de la especificación (por ejemplo, openapi).

Una vez registrada una API, puede actualizar sus propiedades mediante los comandos az apic api update, az apic api version update y az apic api definition update.

Eliminar recursos de la API

Utilice el comando az apic api delete para eliminar una API y todos sus recursos de versión y definición. Por ejemplo:

az apic api delete \
    --resource-group myResoureGroup --service myAPICenter \
    --api-id petstore-api

Para eliminar versiones y definiciones individuales de la API, utilice az apic api version delete y az apic api definition delete, respectivamente.

Contenido relacionado