Compartir a través de

Referencia de la API de administración de Azure SQL Managed Instance

  • Artículo

Se aplica a: Azure SQL Managed Instance

Puede crear y administrar instancias administradas de Azure SQL Managed Instance mediante Azure Portal, PowerShell, la CLI de Azure, la API REST y Transact-SQL. En este artículo, puede encontrar información general sobre las funciones y la API que puede usar para crear y configurar instancias administradas.

Azure Portal: Creación de una instancia administrada

Para una guía de inicio rápido que muestra cómo crear una instancia administrada, consulte Guía de inicio rápido: Creación de una instancia administrada.

PowerShell: Creación y configuración de instancias administradas

Nota:

En este artículo se usa el módulo Az de PowerShell, que es el módulo de PowerShell que se recomienda para interactuar con Azure. Para empezar a trabajar con el módulo Az de PowerShell, consulte Instalación de Azure PowerShell. Para más información sobre cómo migrar al módulo Az de PowerShell, consulte Migración de Azure PowerShell de AzureRM a Az.

Importante

El módulo de Azure Resource Manager para PowerShell todavía es compatible con Azure SQL Database, pero todo el desarrollo futuro se realizará para el módulo Az.Sql. Para estos cmdlets, consulte AzureRM.Sql. Los argumentos para los comandos del módulo Az y los módulos AzureRM son esencialmente idénticos.

Para crear y administrar instancias administradas con Azure PowerShell, use los siguientes cmdlets de PowerShell. Si necesita instalar o actualizar PowerShell, consulte Instalación del módulo de Azure PowerShell.

Sugerencia

Para los scripts de ejemplo de PowerShell, consulte Script de inicio rápido: Creación de una instancia administrada mediante una biblioteca de PowerShell.

Cmdlet Descripción
New-AzSqlInstance Crea una instancia administrada.
Get-AzSqlInstance Devuelve información sobre una instancia administrada.
Set-AzSqlInstance Establece las propiedades de una instancia administrada.
Remove-AzSqlInstance Elimina una instancia administrada.
Get-AzSqlInstanceOperation Obtiene una lista de las operaciones de administración realizadas en la instancia administrada o en una operación específica.
Stop-AzSqlInstanceOperation Cancela la operación de administración específica realizada en la instancia administrada.
New-AzSqlInstanceDatabase Crea una base de datos de SQL Managed Instance.
Get-AzSqlInstanceDatabase Devuelve información sobre una base de datos de SQL Managed Instance.
Remove-AzSqlInstanceDatabase Elimina una base de datos de SQL Managed Instance.
Restore-AzSqlInstanceDatabase Restaura una base de datos de SQL Managed Instance.

CLI de Azure: Creación y configuración de instancias administradas

Para crear y configurar instancias administradas con la CLI de Azure, use los siguientes comandos de la CLI de Azure para SQL Managed Instance. Use Azure Cloud Shell para ejecutar la CLI de Azure en el explorador o instálela en Windows, Linux o macOS.

Sugerencia

Para consultar un artículo de inicio rápido acerca de la CLI de Azure, consulte Working with SQL Managed Instance using Azure CLI (Uso de Instancia administrada de Azure SQL Database mediante la CLI de Azure).

Cmdlet Descripción
az sql mi create Crea una instancia administrada.
az sql mi list Enumera las instancias administradas disponibles.
az sql mi show Obtiene los detalles de una instancia administrada.
az sql mi update Actualiza una instancia administrada.
az sql mi delete Elimina una instancia administrada.
az sql mi op list Obtiene una lista de las operaciones de administración realizadas en la instancia administrada.
az sql mi op show Obtiene la operación de administración específica realizada en la instancia administrada.
az sql mi op cancel Cancela la operación de administración específica realizada en la instancia administrada.
az sql midb create Crea una base de datos administrada.
az sql midb list Enumera las bases de datos administradas disponibles.
az sql midb restore Restaura una base de datos administrada.
az sql midb delete Elimina una base de datos administrada.

Transact-SQL: Creación y configuración de bases de datos de instancia

Para crear y configurar bases de datos de instancia después de crear la instancia administrada, use los comandos de T-SQL siguientes. Puede emitir estos comandos mediante Azure Portal, SQL Server Management Studio, Azure Data Studio, Visual Studio Code o cualquier otro programa que pueda conectarse a un servidor y pasar comandos de Transact-SQL.

Sugerencia

Para consultar artículos de inicio rápido que describan la configuración y conexión a una instancia administrada mediante SQL Server Management Studio en Microsoft Windows, consulte Inicio rápido: Configuración de una máquina virtual de Azure para conectarse a Azure SQL Managed Instance e Inicio rápido: Configuración de una conexión de punto a sitio a Azure SQL Managed Instance desde el entorno local.

Importante

No se puede crear ni eliminar una instancia administrada mediante Transact-SQL.

Get-Help Descripción
CREATE DATABASE Crea una nueva base de datos de instancia en SQL Managed Instance. Debe estar conectado a la base de datos master para crear una base de datos.
ALTER DATABASE Modifica una base de datos de instancia en SQL Managed Instance.

API REST: Creación y configuración de instancias administradas

Para crear y administrar instancias administradas, use estas solicitudes de la API REST.

Get-Help Descripción
SQL Managed Instance - Crear o Actualizar Crea o actualiza una instancia administrada.
SQL Managed Instance - Eliminar Elimina una instancia administrada.
SQL Managed Instance - Consultar Obtiene una instancia administrada.
SQL Managed Instance - Detener Detiene una instancia administrada.
SQL Managed Instance - Iniciar Inicia una instancia administrada
SQL Managed Instance - Listar Devuelve una lista de las instancias administradas de una suscripción.
SQL Managed Instance - Listar por grupo de recursos Devuelve una lista de las instancias administradas de un grupo de recursos.
SQL Managed Instance - Actualizar Actualiza una instancia administrada.
SQL Managed Instance operations - Listar por instancia administrada Obtiene una lista de las operaciones de administración realizadas en la instancia administrada.
Operaciones de SQL Managed Instance - Get Obtiene la operación de administración específica realizada en la instancia administrada.
Operaciones de SQL Managed Instance - Cancelar Cancela la operación de administración específica realizada en la instancia administrada.
Instancia administrada de SQL: programación de inicio o detención: crear o actualizar Crea o actualiza una programación de inicio y detención de la instancia administrada.
SQL Managed Instance - Programa de inicio/parada - Obtener Obtiene una programación de inicio y detención de instancia administrada existente.
Instancia administrada de SQL: programación de inicio y detención: elimina una programación de inicio y detención de instancia administrada existente.

Pasos siguientes