Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
- Latest
- 2024-11-01-preview
- 2024-05-01-preview
- 2023-08-01
- 2023-08-01-preview
- 2023-05-01-preview
- 2023-02-01-preview
- 2022-11-01-preview
- 2022-08-01-preview
- 2022-05-01-preview
- 2022-02-01-preview
- 2021-11-01
- 2021-11-01-preview
- 2021-08-01-preview
- 2021-05-01-preview
- 2021-02-01-preview
- 2020-11-01-preview
- 2020-08-01-preview
- 2020-02-02-preview
- 2018-06-01-preview
- 2015-05-01-preview
Définition de ressource Bicep
Le type de ressource managedInstances peut être déployé avec des opérations qui ciblent :
Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.
Format de ressource
Pour créer une ressource Microsoft.Sql/managedInstances, ajoutez le bicep suivant à votre modèle.
resource symbolicname 'Microsoft.Sql/managedInstances@2024-11-01-preview' = {
scope: resourceSymbolicName or scope
identity: {
type: 'string'
userAssignedIdentities: {
{customized property}: {}
}
}
location: 'string'
name: 'string'
properties: {
administratorLogin: 'string'
administratorLoginPassword: 'string'
administrators: {
administratorType: 'string'
azureADOnlyAuthentication: bool
login: 'string'
principalType: 'string'
sid: 'string'
tenantId: 'string'
}
authenticationMetadata: 'string'
collation: 'string'
databaseFormat: 'string'
dnsZonePartner: 'string'
hybridSecondaryUsage: 'string'
instancePoolId: 'string'
isGeneralPurposeV2: bool
keyId: 'string'
licenseType: 'string'
maintenanceConfigurationId: 'string'
managedInstanceCreateMode: 'string'
memorySizeInGB: int
minimalTlsVersion: 'string'
pricingModel: 'string'
primaryUserAssignedIdentityId: 'string'
proxyOverride: 'string'
publicDataEndpointEnabled: bool
requestedBackupStorageRedundancy: 'string'
requestedLogicalAvailabilityZone: 'string'
restorePointInTime: 'string'
servicePrincipal: {
type: 'string'
}
sourceManagedInstanceId: 'string'
storageIOps: int
storageSizeInGB: int
storageThroughputMBps: int
subnetId: 'string'
timezoneId: 'string'
vCores: int
zoneRedundant: bool
}
sku: {
capacity: int
family: 'string'
name: 'string'
size: 'string'
tier: 'string'
}
tags: {
{customized property}: 'string'
}
}
Valeurs de propriété
Microsoft.Sql/managedInstances
| Name | Description | Value |
|---|---|---|
| identity | Identité Azure Active Directory de l’instance managée. | ResourceIdentity |
| location | Emplacement des ressources. | chaîne (obligatoire) |
| name | Nom de la ressource | chaîne (obligatoire) |
| properties | Propriétés de ressource. | ManagedInstanceProperties |
| portée | Utilisez-la lors de la création d’une ressource dans une étendue différente de l’étendue de déploiement. | Définissez cette propriété sur le nom symbolique d’une ressource pour appliquer la ressource d’extension . |
| sku | Référence SKU d’instance managée. Valeurs autorisées pour sku.name : GP_Gen5 (Usage général, série Standard) ; GP_G8IM (à usage général, série Premium) ; GP_G8IH (à usage général, mémoire optimisée pour la série Premium) ; BC_Gen5 (Critique pour l’entreprise, Standard-Series) ; BC_G8IM (Critique pour l’entreprise, série Premium) ; BC_G8IH (Critique pour l’entreprise, mémoire optimisée pour la série Premium). | Sku |
| tags | Balises de ressources | Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | Type de l’administrateur de serveur. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Authentification Azure Active Directory uniquement activée. | bool |
| login | Nom de connexion de l’administrateur du serveur. | string |
| principalType | Type de principal de l’administrateur de serveur. | 'Application' 'Group' 'User' |
| sid | SID (ID d’objet) de l’administrateur du serveur. | string Constraints: Longueur minimale = 36 Longueur maximale = 36 Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | ID de locataire de l’administrateur. | string Constraints: Longueur minimale = 36 Longueur maximale = 36 Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Description | Value |
|---|---|---|
| administratorLogin | Nom d’utilisateur administrateur de l’instance managée. Peut être spécifié uniquement lorsque l’instance managée est en cours de création (et est requise pour la création). | string |
| administratorLoginPassword | Mot de passe de connexion administrateur (requis pour la création d’une instance managée). | string Constraints: Valeur sensible. Passez en tant que paramètre sécurisé. |
| administrators | L’administrateur Azure Active Directory peut être utilisé lors de la création et des mises à jour d’instance, à l’exception de la propriété azureADOnlyAuthentication. Pour mettre à jour la propriété azureADOnlyAuthentication, une API individuelle doit être utilisée. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | Mode de recherche des métadonnées d’authentification de l’instance managée. | 'AzureAD' 'Paired' 'Windows' |
| collation | Classement de l’instance managée. | string |
| databaseFormat | Spécifie le format interne des bases de données d’instance spécifiques à la version du moteur SQL. | 'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025' |
| dnsZonePartner | ID de ressource d’une autre instance managée dont la zone DNS que cette instance managée partagera après la création. | string |
| hybridSecondaryUsage | Utilisation secondaire hybride. Les valeurs possibles sont « Active » (valeur par défaut) et « Passive » (le client utilise le réplica secondaire comme récupération d’urgence passive). | 'Active' 'Passive' |
| instancePoolId | ID du pool d’instances auquel appartient ce serveur managé. | string |
| isGeneralPurposeV2 | Indique s’il s’agit d’une variante GPv2 de l’édition Usage général. | bool |
| keyId | URI CMK de la clé à utiliser pour le chiffrement. | string |
| licenseType | Type de licence. Les valeurs possibles sont « LicenseIncluded » (prix normal inclus d’une nouvelle licence SQL) et « BasePrice » (prix AHB réduit pour apporter vos propres licences SQL). | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | Spécifie l’ID de configuration de maintenance à appliquer à cette instance managée. | string |
| managedInstanceCreateMode | Spécifie le mode de création de base de données. Valeur par défaut : création d’une instance régulière. Restauration : crée une instance en restaurant un ensemble de sauvegardes à un point précis dans le temps. RestorePointInTime et SourceManagedInstanceId doivent être spécifiés. |
'Default' 'PointInTimeRestore' |
| memorySizeInGB | Taille de la mémoire en Go. Valeur minimale : 28. Valeur maximale : 870. Les valeurs minimale et maximale dépendent du nombre de vCores et du niveau de service. Pour en savoir plus sur les limites de ressources : https://aka.ms/mi-resource-limits-api. | int |
| minimalTlsVersion | Version TLS minimale. Valeurs autorisées : « None », « 1.0 », « 1.1 », « 1.2 » | string |
| pricingModel | Modèle de tarification de Managed Instance. | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | ID de ressource d’une identité affectée par l’utilisateur à utiliser par défaut. | string |
| proxyOverride | Type de connexion utilisé pour la connexion à l’instance. | 'Default' 'Proxy' 'Redirect' |
| publicDataEndpointEnabled | Indique si le point de terminaison de données public est activé ou non. | bool |
| requestedBackupStorageRedundancy | Type de compte de stockage à utiliser pour stocker des sauvegardes pour cette instance. Les options sont Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) et GeoZone(GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zone' |
| requestedLogicalAvailabilityZone | Spécifie la zone de disponibilité logique à laquelle Managed Instance est épinglé. | '1' '2' '3' 'NoPreference' |
| restorePointInTime | Spécifie le point dans le temps (format ISO8601) de la base de données source qui sera restauré pour créer la nouvelle base de données. | string |
| servicePrincipal | Principal de service de l’instance managée. | ServicePrincipal |
| sourceManagedInstanceId | Identificateur de ressource de l’instance managée source associée à l’opération de création de cette instance. | string |
| storageIOps | E/S de stockage. Valeur minimale : 300. Valeur maximale : 8 0000. Incréments de 1 IOps autorisés uniquement. La valeur maximale dépend de la famille de matériels sélectionnée et du nombre de vCores. | int |
| storageSizeInGB | Taille de stockage en Go. Valeur minimale : 32. Valeur maximale : 32768. Incréments de 32 Go autorisés uniquement. La valeur maximale dépend de la famille de matériels sélectionnée et du nombre de vCores. | int |
| storageThroughputMBps | Le paramètre MBits/s du débit de stockage n’est pas pris en charge dans l’opération de création/mise à jour de l’instance. | int |
| subnetId | ID de ressource de sous-réseau pour l’instance managée. | string |
| timezoneId | ID du fuseau horaire. Les valeurs autorisées sont des fuseaux horaires pris en charge par Windows. Windows conserve les détails sur les fuseaux horaires pris en charge, y compris l’ID, dans le Registre sous KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fuseaux horaires. Vous pouvez obtenir ces valeurs de Registre via SQL Server en interrogeant le nom SELECT AS timezone_id FROM sys.time_zone_info. Vous pouvez également obtenir la liste des ID en exécutant [System.TimeZoneInfo] ::GetSystemTimeZones() dans PowerShell. Un exemple d’ID de fuseau horaire valide est « Pacific Standard Time » ou « W. Heure standard de l’Europe". |
string |
| vCores | Nombre de vCores. Valeurs autorisées : 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Les vCores pris en charge dépendent de la famille de matériel et du niveau de service sélectionnés. | int |
| zoneRedundant | Indique si la redondance de zone est activée ou non. | bool |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| type | Type d’identité. Définissez cette valeur sur « SystemAssigned » pour créer et affecter automatiquement un principal Azure Active Directory pour la ressource. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | ID de ressource des identités affectées par l’utilisateur à utiliser | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ServicePrincipal
| Name | Description | Value |
|---|---|---|
| type | Type de principal de service. | 'None' 'SystemAssigned' |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Capacité de la référence SKU particulière. | int |
| family | Si le service a différentes générations de matériel, pour la même référence SKU, vous pouvez le capturer ici. | string |
| name | Nom de la référence SKU, généralement une lettre + code numérique, par exemple P3. | chaîne (obligatoire) |
| size | Taille de la référence SKU particulière | string |
| tier | Niveau ou édition de la référence SKU particulière, par exemple De base, Premium. | string |
TrackedResourceTags
| Name | Description | Value |
|---|
UserIdentity
| Name | Description | Value |
|---|
Exemples d’utilisation
Modules vérifiés Azure
Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.
| Module | Description |
|---|---|
| SQL Managed Instance | Module de ressources AVM pour SQL Managed Instance |
Exemples de démarrage rapide Azure
Les modèles de démarrage rapide Azure suivants contiennent des exemples Bicep pour le déploiement de ce type de ressource.
| Fichier Bicep | Description |
|---|---|
| Créer SQL MI à l’intérieur du nouveau réseau virtuel | Déployez Azure Sql Database Managed Instance (SQL MI) dans un nouveau réseau virtuel. |
Définition de ressource de modèle ARM
Le type de ressource managedInstances peut être déployé avec des opérations qui ciblent :
Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.
Format de ressource
Pour créer une ressource Microsoft.Sql/managedInstances, ajoutez le code JSON suivant à votre modèle.
{
"type": "Microsoft.Sql/managedInstances",
"apiVersion": "2024-11-01-preview",
"name": "string",
"identity": {
"type": "string",
"userAssignedIdentities": {
"{customized property}": {
}
}
},
"location": "string",
"properties": {
"administratorLogin": "string",
"administratorLoginPassword": "string",
"administrators": {
"administratorType": "string",
"azureADOnlyAuthentication": "bool",
"login": "string",
"principalType": "string",
"sid": "string",
"tenantId": "string"
},
"authenticationMetadata": "string",
"collation": "string",
"databaseFormat": "string",
"dnsZonePartner": "string",
"hybridSecondaryUsage": "string",
"instancePoolId": "string",
"isGeneralPurposeV2": "bool",
"keyId": "string",
"licenseType": "string",
"maintenanceConfigurationId": "string",
"managedInstanceCreateMode": "string",
"memorySizeInGB": "int",
"minimalTlsVersion": "string",
"pricingModel": "string",
"primaryUserAssignedIdentityId": "string",
"proxyOverride": "string",
"publicDataEndpointEnabled": "bool",
"requestedBackupStorageRedundancy": "string",
"requestedLogicalAvailabilityZone": "string",
"restorePointInTime": "string",
"servicePrincipal": {
"type": "string"
},
"sourceManagedInstanceId": "string",
"storageIOps": "int",
"storageSizeInGB": "int",
"storageThroughputMBps": "int",
"subnetId": "string",
"timezoneId": "string",
"vCores": "int",
"zoneRedundant": "bool"
},
"sku": {
"capacity": "int",
"family": "string",
"name": "string",
"size": "string",
"tier": "string"
},
"tags": {
"{customized property}": "string"
}
}
Valeurs de propriété
Microsoft.Sql/managedInstances
| Name | Description | Value |
|---|---|---|
| apiVersion | Version de l’API | '2024-11-01-preview' |
| identity | Identité Azure Active Directory de l’instance managée. | ResourceIdentity |
| location | Emplacement des ressources. | chaîne (obligatoire) |
| name | Nom de la ressource | chaîne (obligatoire) |
| properties | Propriétés de ressource. | ManagedInstanceProperties |
| sku | Référence SKU d’instance managée. Valeurs autorisées pour sku.name : GP_Gen5 (Usage général, série Standard) ; GP_G8IM (à usage général, série Premium) ; GP_G8IH (à usage général, mémoire optimisée pour la série Premium) ; BC_Gen5 (Critique pour l’entreprise, Standard-Series) ; BC_G8IM (Critique pour l’entreprise, série Premium) ; BC_G8IH (Critique pour l’entreprise, mémoire optimisée pour la série Premium). | Sku |
| tags | Balises de ressources | Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles |
| type | Type de ressource | 'Microsoft.Sql/managedInstances' |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | Type de l’administrateur de serveur. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Authentification Azure Active Directory uniquement activée. | bool |
| login | Nom de connexion de l’administrateur du serveur. | string |
| principalType | Type de principal de l’administrateur de serveur. | 'Application' 'Group' 'User' |
| sid | SID (ID d’objet) de l’administrateur du serveur. | string Constraints: Longueur minimale = 36 Longueur maximale = 36 Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | ID de locataire de l’administrateur. | string Constraints: Longueur minimale = 36 Longueur maximale = 36 Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Description | Value |
|---|---|---|
| administratorLogin | Nom d’utilisateur administrateur de l’instance managée. Peut être spécifié uniquement lorsque l’instance managée est en cours de création (et est requise pour la création). | string |
| administratorLoginPassword | Mot de passe de connexion administrateur (requis pour la création d’une instance managée). | string Constraints: Valeur sensible. Passez en tant que paramètre sécurisé. |
| administrators | L’administrateur Azure Active Directory peut être utilisé lors de la création et des mises à jour d’instance, à l’exception de la propriété azureADOnlyAuthentication. Pour mettre à jour la propriété azureADOnlyAuthentication, une API individuelle doit être utilisée. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | Mode de recherche des métadonnées d’authentification de l’instance managée. | 'AzureAD' 'Paired' 'Windows' |
| collation | Classement de l’instance managée. | string |
| databaseFormat | Spécifie le format interne des bases de données d’instance spécifiques à la version du moteur SQL. | 'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025' |
| dnsZonePartner | ID de ressource d’une autre instance managée dont la zone DNS que cette instance managée partagera après la création. | string |
| hybridSecondaryUsage | Utilisation secondaire hybride. Les valeurs possibles sont « Active » (valeur par défaut) et « Passive » (le client utilise le réplica secondaire comme récupération d’urgence passive). | 'Active' 'Passive' |
| instancePoolId | ID du pool d’instances auquel appartient ce serveur managé. | string |
| isGeneralPurposeV2 | Indique s’il s’agit d’une variante GPv2 de l’édition Usage général. | bool |
| keyId | URI CMK de la clé à utiliser pour le chiffrement. | string |
| licenseType | Type de licence. Les valeurs possibles sont « LicenseIncluded » (prix normal inclus d’une nouvelle licence SQL) et « BasePrice » (prix AHB réduit pour apporter vos propres licences SQL). | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | Spécifie l’ID de configuration de maintenance à appliquer à cette instance managée. | string |
| managedInstanceCreateMode | Spécifie le mode de création de base de données. Valeur par défaut : création d’une instance régulière. Restauration : crée une instance en restaurant un ensemble de sauvegardes à un point précis dans le temps. RestorePointInTime et SourceManagedInstanceId doivent être spécifiés. |
'Default' 'PointInTimeRestore' |
| memorySizeInGB | Taille de la mémoire en Go. Valeur minimale : 28. Valeur maximale : 870. Les valeurs minimale et maximale dépendent du nombre de vCores et du niveau de service. Pour en savoir plus sur les limites de ressources : https://aka.ms/mi-resource-limits-api. | int |
| minimalTlsVersion | Version TLS minimale. Valeurs autorisées : « None », « 1.0 », « 1.1 », « 1.2 » | string |
| pricingModel | Modèle de tarification de Managed Instance. | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | ID de ressource d’une identité affectée par l’utilisateur à utiliser par défaut. | string |
| proxyOverride | Type de connexion utilisé pour la connexion à l’instance. | 'Default' 'Proxy' 'Redirect' |
| publicDataEndpointEnabled | Indique si le point de terminaison de données public est activé ou non. | bool |
| requestedBackupStorageRedundancy | Type de compte de stockage à utiliser pour stocker des sauvegardes pour cette instance. Les options sont Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) et GeoZone(GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zone' |
| requestedLogicalAvailabilityZone | Spécifie la zone de disponibilité logique à laquelle Managed Instance est épinglé. | '1' '2' '3' 'NoPreference' |
| restorePointInTime | Spécifie le point dans le temps (format ISO8601) de la base de données source qui sera restauré pour créer la nouvelle base de données. | string |
| servicePrincipal | Principal de service de l’instance managée. | ServicePrincipal |
| sourceManagedInstanceId | Identificateur de ressource de l’instance managée source associée à l’opération de création de cette instance. | string |
| storageIOps | E/S de stockage. Valeur minimale : 300. Valeur maximale : 8 0000. Incréments de 1 IOps autorisés uniquement. La valeur maximale dépend de la famille de matériels sélectionnée et du nombre de vCores. | int |
| storageSizeInGB | Taille de stockage en Go. Valeur minimale : 32. Valeur maximale : 32768. Incréments de 32 Go autorisés uniquement. La valeur maximale dépend de la famille de matériels sélectionnée et du nombre de vCores. | int |
| storageThroughputMBps | Le paramètre MBits/s du débit de stockage n’est pas pris en charge dans l’opération de création/mise à jour de l’instance. | int |
| subnetId | ID de ressource de sous-réseau pour l’instance managée. | string |
| timezoneId | ID du fuseau horaire. Les valeurs autorisées sont des fuseaux horaires pris en charge par Windows. Windows conserve les détails sur les fuseaux horaires pris en charge, y compris l’ID, dans le Registre sous KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fuseaux horaires. Vous pouvez obtenir ces valeurs de Registre via SQL Server en interrogeant le nom SELECT AS timezone_id FROM sys.time_zone_info. Vous pouvez également obtenir la liste des ID en exécutant [System.TimeZoneInfo] ::GetSystemTimeZones() dans PowerShell. Un exemple d’ID de fuseau horaire valide est « Pacific Standard Time » ou « W. Heure standard de l’Europe". |
string |
| vCores | Nombre de vCores. Valeurs autorisées : 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Les vCores pris en charge dépendent de la famille de matériel et du niveau de service sélectionnés. | int |
| zoneRedundant | Indique si la redondance de zone est activée ou non. | bool |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| type | Type d’identité. Définissez cette valeur sur « SystemAssigned » pour créer et affecter automatiquement un principal Azure Active Directory pour la ressource. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | ID de ressource des identités affectées par l’utilisateur à utiliser | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ServicePrincipal
| Name | Description | Value |
|---|---|---|
| type | Type de principal de service. | 'None' 'SystemAssigned' |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Capacité de la référence SKU particulière. | int |
| family | Si le service a différentes générations de matériel, pour la même référence SKU, vous pouvez le capturer ici. | string |
| name | Nom de la référence SKU, généralement une lettre + code numérique, par exemple P3. | chaîne (obligatoire) |
| size | Taille de la référence SKU particulière | string |
| tier | Niveau ou édition de la référence SKU particulière, par exemple De base, Premium. | string |
TrackedResourceTags
| Name | Description | Value |
|---|
UserIdentity
| Name | Description | Value |
|---|
Exemples d’utilisation
Modèles de démarrage rapide Azure
Les modèles de démarrage rapide Azure suivants déployer ce type de ressource.
| Template | Description |
|---|---|
|
Créer SQL MI à l’intérieur du nouveau réseau virtuel |
Déployez Azure Sql Database Managed Instance (SQL MI) dans un nouveau réseau virtuel. |
|
créer sql MI avec l’envoi configuré de journaux et de métriques |
Ce modèle vous permet de déployer SQL MI et des ressources supplémentaires utilisées pour stocker les journaux et les métriques (espace de travail de diagnostic, compte de stockage, event Hub). |
|
Créer sql MI avec jumpbox à l’intérieur d’un nouveau réseau virtuel |
Déployez Azure Sql Database Managed Instance (SQL MI) et JumpBox avec SSMS dans un nouveau réseau virtuel. |
|
Créer un mi SQL avec une connexion point à site configurée |
Déployez Azure Sql Database Managed Instance (SQL MI) et la passerelle de réseau virtuel configurée pour une connexion point à site à l’intérieur du nouveau réseau virtuel. |
|
Déployer SQL Managed Instance avec mise en réseau |
Déployer UDR et NSG pour prendre en charge Azure SQL Managed Instance et déployer Managed Instance |
Définition de ressource Terraform (fournisseur AzAPI)
Le type de ressource managedInstances peut être déployé avec des opérations qui ciblent :
Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.
Format de ressource
Pour créer une ressource Microsoft.Sql/managedInstances, ajoutez le terraform suivant à votre modèle.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.Sql/managedInstances@2024-11-01-preview"
name = "string"
parent_id = "string"
identity {
type = "string"
identity_ids = [
"string"
]
}
location = "string"
tags = {
{customized property} = "string"
}
body = {
properties = {
administratorLogin = "string"
administratorLoginPassword = "string"
administrators = {
administratorType = "string"
azureADOnlyAuthentication = bool
login = "string"
principalType = "string"
sid = "string"
tenantId = "string"
}
authenticationMetadata = "string"
collation = "string"
databaseFormat = "string"
dnsZonePartner = "string"
hybridSecondaryUsage = "string"
instancePoolId = "string"
isGeneralPurposeV2 = bool
keyId = "string"
licenseType = "string"
maintenanceConfigurationId = "string"
managedInstanceCreateMode = "string"
memorySizeInGB = int
minimalTlsVersion = "string"
pricingModel = "string"
primaryUserAssignedIdentityId = "string"
proxyOverride = "string"
publicDataEndpointEnabled = bool
requestedBackupStorageRedundancy = "string"
requestedLogicalAvailabilityZone = "string"
restorePointInTime = "string"
servicePrincipal = {
type = "string"
}
sourceManagedInstanceId = "string"
storageIOps = int
storageSizeInGB = int
storageThroughputMBps = int
subnetId = "string"
timezoneId = "string"
vCores = int
zoneRedundant = bool
}
sku = {
capacity = int
family = "string"
name = "string"
size = "string"
tier = "string"
}
}
}
Valeurs de propriété
Microsoft.Sql/managedInstances
| Name | Description | Value |
|---|---|---|
| identity | Identité Azure Active Directory de l’instance managée. | ResourceIdentity |
| location | Emplacement des ressources. | chaîne (obligatoire) |
| name | Nom de la ressource | chaîne (obligatoire) |
| parent_id | ID de la ressource à laquelle appliquer cette ressource d’extension. | chaîne (obligatoire) |
| properties | Propriétés de ressource. | ManagedInstanceProperties |
| sku | Référence SKU d’instance managée. Valeurs autorisées pour sku.name : GP_Gen5 (Usage général, série Standard) ; GP_G8IM (à usage général, série Premium) ; GP_G8IH (à usage général, mémoire optimisée pour la série Premium) ; BC_Gen5 (Critique pour l’entreprise, Standard-Series) ; BC_G8IM (Critique pour l’entreprise, série Premium) ; BC_G8IH (Critique pour l’entreprise, mémoire optimisée pour la série Premium). | Sku |
| tags | Balises de ressources | Dictionnaire de noms et de valeurs d’étiquettes. |
| type | Type de ressource | « Microsoft.Sql/managedInstances@2024-11-01-preview » |
ManagedInstanceExternalAdministrator
| Name | Description | Value |
|---|---|---|
| administratorType | Type de l’administrateur de serveur. | 'ActiveDirectory' |
| azureADOnlyAuthentication | Authentification Azure Active Directory uniquement activée. | bool |
| login | Nom de connexion de l’administrateur du serveur. | string |
| principalType | Type de principal de l’administrateur de serveur. | 'Application' 'Group' 'User' |
| sid | SID (ID d’objet) de l’administrateur du serveur. | string Constraints: Longueur minimale = 36 Longueur maximale = 36 Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
| tenantId | ID de locataire de l’administrateur. | string Constraints: Longueur minimale = 36 Longueur maximale = 36 Modèle = ^[0-9a-fA-F]{8}-([0-9a-fA-F]{4}-){3}[0-9a-fA-F]{12}$ |
ManagedInstanceProperties
| Name | Description | Value |
|---|---|---|
| administratorLogin | Nom d’utilisateur administrateur de l’instance managée. Peut être spécifié uniquement lorsque l’instance managée est en cours de création (et est requise pour la création). | string |
| administratorLoginPassword | Mot de passe de connexion administrateur (requis pour la création d’une instance managée). | string Constraints: Valeur sensible. Passez en tant que paramètre sécurisé. |
| administrators | L’administrateur Azure Active Directory peut être utilisé lors de la création et des mises à jour d’instance, à l’exception de la propriété azureADOnlyAuthentication. Pour mettre à jour la propriété azureADOnlyAuthentication, une API individuelle doit être utilisée. | ManagedInstanceExternalAdministrator |
| authenticationMetadata | Mode de recherche des métadonnées d’authentification de l’instance managée. | 'AzureAD' 'Paired' 'Windows' |
| collation | Classement de l’instance managée. | string |
| databaseFormat | Spécifie le format interne des bases de données d’instance spécifiques à la version du moteur SQL. | 'AlwaysUpToDate' 'SQLServer2022' 'SQLServer2025' |
| dnsZonePartner | ID de ressource d’une autre instance managée dont la zone DNS que cette instance managée partagera après la création. | string |
| hybridSecondaryUsage | Utilisation secondaire hybride. Les valeurs possibles sont « Active » (valeur par défaut) et « Passive » (le client utilise le réplica secondaire comme récupération d’urgence passive). | 'Active' 'Passive' |
| instancePoolId | ID du pool d’instances auquel appartient ce serveur managé. | string |
| isGeneralPurposeV2 | Indique s’il s’agit d’une variante GPv2 de l’édition Usage général. | bool |
| keyId | URI CMK de la clé à utiliser pour le chiffrement. | string |
| licenseType | Type de licence. Les valeurs possibles sont « LicenseIncluded » (prix normal inclus d’une nouvelle licence SQL) et « BasePrice » (prix AHB réduit pour apporter vos propres licences SQL). | 'BasePrice' 'LicenseIncluded' |
| maintenanceConfigurationId | Spécifie l’ID de configuration de maintenance à appliquer à cette instance managée. | string |
| managedInstanceCreateMode | Spécifie le mode de création de base de données. Valeur par défaut : création d’une instance régulière. Restauration : crée une instance en restaurant un ensemble de sauvegardes à un point précis dans le temps. RestorePointInTime et SourceManagedInstanceId doivent être spécifiés. |
'Default' 'PointInTimeRestore' |
| memorySizeInGB | Taille de la mémoire en Go. Valeur minimale : 28. Valeur maximale : 870. Les valeurs minimale et maximale dépendent du nombre de vCores et du niveau de service. Pour en savoir plus sur les limites de ressources : https://aka.ms/mi-resource-limits-api. | int |
| minimalTlsVersion | Version TLS minimale. Valeurs autorisées : « None », « 1.0 », « 1.1 », « 1.2 » | string |
| pricingModel | Modèle de tarification de Managed Instance. | 'Freemium' 'Regular' |
| primaryUserAssignedIdentityId | ID de ressource d’une identité affectée par l’utilisateur à utiliser par défaut. | string |
| proxyOverride | Type de connexion utilisé pour la connexion à l’instance. | 'Default' 'Proxy' 'Redirect' |
| publicDataEndpointEnabled | Indique si le point de terminaison de données public est activé ou non. | bool |
| requestedBackupStorageRedundancy | Type de compte de stockage à utiliser pour stocker des sauvegardes pour cette instance. Les options sont Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) et GeoZone(GeoZoneRedundantStorage) | 'Geo' 'GeoZone' 'Local' 'Zone' |
| requestedLogicalAvailabilityZone | Spécifie la zone de disponibilité logique à laquelle Managed Instance est épinglé. | '1' '2' '3' 'NoPreference' |
| restorePointInTime | Spécifie le point dans le temps (format ISO8601) de la base de données source qui sera restauré pour créer la nouvelle base de données. | string |
| servicePrincipal | Principal de service de l’instance managée. | ServicePrincipal |
| sourceManagedInstanceId | Identificateur de ressource de l’instance managée source associée à l’opération de création de cette instance. | string |
| storageIOps | E/S de stockage. Valeur minimale : 300. Valeur maximale : 8 0000. Incréments de 1 IOps autorisés uniquement. La valeur maximale dépend de la famille de matériels sélectionnée et du nombre de vCores. | int |
| storageSizeInGB | Taille de stockage en Go. Valeur minimale : 32. Valeur maximale : 32768. Incréments de 32 Go autorisés uniquement. La valeur maximale dépend de la famille de matériels sélectionnée et du nombre de vCores. | int |
| storageThroughputMBps | Le paramètre MBits/s du débit de stockage n’est pas pris en charge dans l’opération de création/mise à jour de l’instance. | int |
| subnetId | ID de ressource de sous-réseau pour l’instance managée. | string |
| timezoneId | ID du fuseau horaire. Les valeurs autorisées sont des fuseaux horaires pris en charge par Windows. Windows conserve les détails sur les fuseaux horaires pris en charge, y compris l’ID, dans le Registre sous KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Fuseaux horaires. Vous pouvez obtenir ces valeurs de Registre via SQL Server en interrogeant le nom SELECT AS timezone_id FROM sys.time_zone_info. Vous pouvez également obtenir la liste des ID en exécutant [System.TimeZoneInfo] ::GetSystemTimeZones() dans PowerShell. Un exemple d’ID de fuseau horaire valide est « Pacific Standard Time » ou « W. Heure standard de l’Europe". |
string |
| vCores | Nombre de vCores. Valeurs autorisées : 4, 6, 8, 10, 12, 16, 20, 24, 32, 40, 48, 56, 64, 80, 96, 128. Les vCores pris en charge dépendent de la famille de matériel et du niveau de service sélectionnés. | int |
| zoneRedundant | Indique si la redondance de zone est activée ou non. | bool |
ResourceIdentity
| Name | Description | Value |
|---|---|---|
| type | Type d’identité. Définissez cette valeur sur « SystemAssigned » pour créer et affecter automatiquement un principal Azure Active Directory pour la ressource. | 'None' 'SystemAssigned' 'SystemAssigned,UserAssigned' 'UserAssigned' |
| userAssignedIdentities | ID de ressource des identités affectées par l’utilisateur à utiliser | ResourceIdentityUserAssignedIdentities |
ResourceIdentityUserAssignedIdentities
| Name | Description | Value |
|---|
ServicePrincipal
| Name | Description | Value |
|---|---|---|
| type | Type de principal de service. | 'None' 'SystemAssigned' |
Sku
| Name | Description | Value |
|---|---|---|
| capacity | Capacité de la référence SKU particulière. | int |
| family | Si le service a différentes générations de matériel, pour la même référence SKU, vous pouvez le capturer ici. | string |
| name | Nom de la référence SKU, généralement une lettre + code numérique, par exemple P3. | chaîne (obligatoire) |
| size | Taille de la référence SKU particulière | string |
| tier | Niveau ou édition de la référence SKU particulière, par exemple De base, Premium. | string |
TrackedResourceTags
| Name | Description | Value |
|---|
UserIdentity
| Name | Description | Value |
|---|
Exemples d’utilisation
Modules vérifiés Azure
Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.
| Module | Description |
|---|---|
| SQL Managed Instance | Module de ressources AVM pour SQL Managed Instance |