Informations de référence sur l’API de gestion pour Azure SQL Managed Instance

  • Article

S’applique à :Azure SQL Managed Instance

Vous pouvez créer et configurer des instances managées d’Azure SQL Managed Instance via le portail Azure, PowerShell, Azure CLI, l’API REST et Transact-SQL. Dans cet article, vous trouverez une vue d’ensemble des fonctions et de l’API que vous pouvez utiliser pour créer et configurer des instances managées.

Portail Azure : Créer une instance managée

Pour un guide de démarrage rapide vous expliquant comment créer une instance managée, consultez Démarrage rapide : Créer une instance managée.

PowerShell : Créer et configurer des instances managées

Notes

Cet article utilise le module Azure Az PowerShell, qui est le module PowerShell recommandé pour interagir avec Azure. Pour démarrer avec le module Az PowerShell, consulter Installer Azure PowerShell. Pour savoir comment migrer vers le module Az PowerShell, consultez Migrer Azure PowerShell depuis AzureRM vers Az.

Important

Le module PowerShell Azure Resource Manager est toujours pris en charge par Azure SQL Database, mais tous les développements futurs sont destinés au module Az.Sql. Pour ces cmdlets, voir AzureRM.Sql. Les arguments des commandes dans le module Az sont sensiblement identiques à ceux des modules AzureRM.

Pour créer et gérer des instances managées avec Azure PowerShell, utilisez les applets de commande PowerShell suivantes. Si vous devez installer ou mettre à niveau PowerShell, consultez la section relative à l’installation du module Azure PowerShell.

Conseil

Pour obtenir des exemples de scripts PowerShell, consultez Script de démarrage rapide : Créer une instance managée à l’aide de la bibliothèque PowerShell.

Applet de commande Description
New-AzSqlInstance Crée une instance managée.
Get-AzSqlInstance Retourne des informations sur une instance managée.
Set-AzSqlInstance Définit les propriétés d’une instance managée.
Remove-AzSqlInstance Supprime une instance managée.
Get-AzSqlInstanceOperation Obtient une liste des opérations de gestion effectuées sur l’instance gérée ou l’opération spécifique.
Stop-AzSqlInstanceOperation Annule l’opération de gestion spécifique effectuée sur l’instance gérée.
Nouvelle AzSqlInstanceDatabase Crée une base de données SQL Managed Instance.
Get-AzSqlInstanceDatabase Retourne des informations sur une base de données Azure SQL Managed Instance.
Nouvelle AzSqlInstanceDatabase Supprime une base de données SQL Managed Instance.
Restore-AzSqlInstanceDatabase Restaure une base de données SQL Managed Instance.

Azure CLI : Créer et configurer des instances managées

Pour créer et configurer des instances managées avec Azure CLI, utilisez les commandes Azure CLI pour SQL Managed Instance suivantes. Utilisez Azure Cloud Shell pour exécuter l’interface de ligne de commande Azure dans votre navigateur ou l’installer sur macOS, Linux ou Windows.

Conseil

Pour un guide de démarrage rapide Azure CLI, consultez Working with SQL Managed Instance using Azure CLI.

Applet de commande Description
az sql mi create Crée une instance managée.
az sql mi list Liste les instances managées disponibles.
az sql mi show Obtient les détails concernant une instance managée.
az sql mi update Met à jour une instance managée.
az sql mi delete Supprime une instance managée.
az sql mi op list Obtient une liste des opérations de gestion effectuées sur l’instance gérée.
az sql mi op show Obtient l’opération de gestion spécifique effectuée sur l’instance managée.
az sql mi op cancel Annule l’opération de gestion spécifique effectuée sur l’instance gérée.
az sql midb create Crée une base de données managée.
az sql midb list Liste les bases de données managées disponibles.
az sql midb restore Restaure une base de données managée.
az sql midb delete Supprime une base de données managée.

Transact-SQL : Créer et configurer des bases de données d’instance

Pour créer et configurer des bases de données d’instance après avoir créé l’instance managée, utilisez les commandes T-SQL suivantes. Vous pouvez émettre ces commandes en utilisant le portail Azure, SQL Server Management Studio, Azure Data Studio et Visual Studio Code ou tout autre programme pouvant se connecter à un serveur et transmettre des commandes Transact-SQL.

Conseil

Pour des guides de démarrage rapide vous expliquant comment configurer une instance managée et vous y connecter en utilisant SQL Server Management Studio sur Microsoft Windows, consultez Démarrage rapide : Configurer la machine virtuelle Azure pour qu’elle se connecte à Azure SQL Managed Instance et Démarrage rapide : Configurer une connexion point à site à Azure SQL Managed Instance à partir d’un emplacement local.

Important

Vous ne pouvez pas créer ou supprimer une instance managée à l’aide de Transact-SQL.

Commande Description
CREATE DATABASE Crée une base de données d’instance dans SQL Managed Instance. Vous devez être connecté à la base de données master pour créer une base de données.
ALTER DATABASE Modifie une base de données d’instance dans SQL Managed Instance.

API REST : Créer et configurer des instances managées

Pour créer et configurer des instances managées, utilisez ces requêtes d’API REST.

Commande Description
SQL Managed Instance : créer ou mettre à jour Crée ou met à jour une instance managée.
SQL Managed Instance : supprimer Supprime une instance managée.
SQL Managed Instance : obtenir Obtient une instance managée.
SQL Managed Instance : arrêter Arrêter une Managed Instance
SQL Managed Instance : démarrer Démarrer une Managed Instance
SQL Managed Instance : lister Retourne la liste des instances managées d’un abonnement.
SQL Managed Instance : lister par groupe de ressources Retourne la liste des instances managées d’un groupe de ressources.
SQL Managed Instance : mettre à jour Met à jour une instance managée.
Opérations SQL Managed Instance : lister par Managed Instance Obtient une liste des opérations de gestion effectuées sur l’instance gérée.
Opérations SQL Managed Instance : obtenir Obtient l’opération de gestion spécifique effectuée sur l’instance managée.
Opérations SQL Managed Instance : annuler Annule l’opération de gestion spécifique effectuée sur l’instance gérée.
SQL Managed Instance : démarrer/arrêter la planification ; créer ou mettre à jour Cette action crée ou met à jour une planification de démarrage et d'arrêt de la Managed Instance.
SQL Managed Instance : démarrer/arrêter la planification ; obtenir Cette action lance le démarrage et arrête la planification de la Managed Instance.
SQL Managed Instance : démarrer/arrêter la planification ; supprimer Cette action annule un démarrage en cours et arrête la planification de la Managed Instance.

Étapes suivantes