Share via

Microsoft.Sql managedInstances 2020-02-02-preview

  • Article

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 d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Sql/managedInstances, ajoutez le Bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Sql/managedInstances@2020-02-02-preview' = {
  name: 'string'
  location: 'string'
  tags: {
    tagName1: 'tagValue1'
    tagName2: 'tagValue2'
  }
  sku: {
    capacity: int
    family: 'string'
    name: 'string'
    size: 'string'
    tier: 'string'
  }
  identity: {
    type: 'string'
  }
  properties: {
    administratorLogin: 'string'
    administratorLoginPassword: 'string'
    collation: 'string'
    dnsZonePartner: 'string'
    instancePoolId: 'string'
    licenseType: 'string'
    maintenanceConfigurationId: 'string'
    managedInstanceCreateMode: 'string'
    minimalTlsVersion: 'string'
    proxyOverride: 'string'
    publicDataEndpointEnabled: bool
    restorePointInTime: 'string'
    sourceManagedInstanceId: 'string'
    storageAccountType: 'string'
    storageSizeInGB: int
    subnetId: 'string'
    timezoneId: 'string'
    vCores: int
    zoneRedundant: bool
  }
}

Valeurs de propriétés

managedInstances

Nom Description Valeur
name Nom de la ressource string (obligatoire)

Limite de caractères : 1-63

Caractères valides :
Lettres minuscules, chiffres et traits d’union.

Ne peut pas commencer ou se terminer par un trait d’union.

Le nom de la ressource doit être unique dans Azure.
location Emplacement de la ressource. string (obligatoire)
tags Balises de ressource. Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
sku Référence SKU instance managée. Valeurs autorisées pour sku.name : GP_Gen4, GP_Gen5, BC_Gen4, BC_Gen5 Sku
identité Identité Azure Active Directory du instance managé. ResourceIdentity
properties Propriétés de ressource. ManagedInstanceProperties

ResourceIdentity

Nom Description Valeur
type Type d’identité. Définissez cette valeur sur « SystemAssigned » afin de créer et d’affecter automatiquement un principal Azure Active Directory pour la ressource. 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'

ManagedInstanceProperties

Nom Description Valeur
administratorLogin Nom d’utilisateur administrateur pour le instance managé. Ne peut être spécifié que lorsque le instance managé est en cours de création (et est requis pour la création). string
administratorLoginPassword Mot de passe de connexion administrateur (requis pour la création de instance managés). string
collation Classement des instance managés. string
dnsZonePartner ID de ressource d’un autre instance managé dont la zone DNS que cette instance managée partagera après sa création. string
instancePoolId ID du pool de instance auquel appartient ce serveur managé. string
licenseType Type de licence. Les valeurs possibles sont « LicenseIncluded » (prix normal incluant 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 la base de données.

Valeur par défaut : création de instance standard.

Restauration : crée un instance en restaurant un ensemble de sauvegardes à un point spécifique dans le temps. RestorePointInTime et SourceManagedInstanceId doivent être spécifiés.		 'Par défaut'
'PointInTimeRestore'
minimalTlsVersion Version TLS minimale. Valeurs autorisées : « None », « 1.0 », « 1.1 », « 1.2 » string
proxyOverride Type de connexion utilisé pour la connexion au instance. 'Par défaut'
'Proxy'
'Rediriger'
publicDataEndpointEnabled Indique si le point de terminaison de données public est activé ou non. bool
restorePointInTime Spécifie le point dans le temps (format ISO8601) de la base de données source qui sera restaurée pour créer la nouvelle base de données. string
sourceManagedInstanceId Identificateur de ressource de l’instance managée source associée à l’opération de création de ce instance. string
storageAccountType Type de compte de stockage utilisé pour stocker les sauvegardes pour cette instance. Les options sont LRS (LocalRedundantStorage), ZRS (ZoneRedundantStorage) et GRS (GeoRedundantStorage) 'GRS'
'LRS'
'ZRS'
storageSizeInGB Taille de stockage en Go. Valeur minimale : 32. Valeur maximale : 8192. Incréments de 32 Go autorisés uniquement. int
subnetId ID de ressource de sous-réseau pour le instance managé. 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\Time Zones.
Vous pouvez obtenir ces valeurs de Registre via SQL Server en interrogeant select name as timezone_id FROM sys.time_zone_info.
La liste des ID peut également être obtenue en exécutant [System.TimeZoneInfo] ::GetSystemTimeZones() dans PowerShell.
Un exemple d’ID de fuseau horaire valide est « Heure standard du Pacifique » ou « W. Heure standard de l’Europe ».		 string
vCores Nombre de vCores. Valeurs autorisées : 8, 16, 24, 32, 40, 64, 80. int
zoneRedundant Indique si le multi-az est activé ou non. bool

Sku

Nom Description Valeur
capacité Capacité de la référence SKU particulière. int
famille Si le service a différentes générations de matériel, pour la même référence SKU, cela peut être capturé ici. string
name Nom de la référence SKU, généralement une lettre + un code numérique, par exemple P3. string (obligatoire)
taille Taille de la référence SKU particulière string
Niveau Niveau ou édition de la référence SKU particulière, par exemple De base, Premium. string

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Déployer SQL Managed Instance avec la mise en réseau

Déployer sur Azure		 Déployer L’UDR et le groupe de sécurité réseau pour prendre en charge Azure SQL Managed Instance et déployer le Managed Instance
Créer UNE INSTANCE SQL à l’intérieur du nouveau réseau virtuel

Déployer sur Azure		 Déployez Azure Sql Database Managed Instance (SQL MI) dans de nouvelles Réseau virtuel.
Créer une instance SQL MI avec l’envoi configuré de journaux et de métriques

Déployer sur Azure		 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 une instance SQL MI avec jumpbox à l’intérieur d’un nouveau réseau virtuel

Déployer sur Azure		 Déployez Azure Sql Database Managed Instance (SQL MI) et JumpBox avec SSMS dans de nouveaux Réseau virtuel.
Créer une instance SQL MI avec une connexion point à site configurée

Déployer sur Azure		 Déployez Azure Sql Database Managed Instance (SQL MI) et la passerelle de réseau virtuel configurée pour la connexion point à site à l’intérieur du nouveau réseau virtuel.

Définition de ressources 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 d’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Sql/managedInstances, ajoutez le JSON suivant à votre modèle.

{
  "type": "Microsoft.Sql/managedInstances",
  "apiVersion": "2020-02-02-preview",
  "name": "string",
  "location": "string",
  "tags": {
    "tagName1": "tagValue1",
    "tagName2": "tagValue2"
  },
  "sku": {
    "capacity": "int",
    "family": "string",
    "name": "string",
    "size": "string",
    "tier": "string"
  },
  "identity": {
    "type": "string"
  },
  "properties": {
    "administratorLogin": "string",
    "administratorLoginPassword": "string",
    "collation": "string",
    "dnsZonePartner": "string",
    "instancePoolId": "string",
    "licenseType": "string",
    "maintenanceConfigurationId": "string",
    "managedInstanceCreateMode": "string",
    "minimalTlsVersion": "string",
    "proxyOverride": "string",
    "publicDataEndpointEnabled": "bool",
    "restorePointInTime": "string",
    "sourceManagedInstanceId": "string",
    "storageAccountType": "string",
    "storageSizeInGB": "int",
    "subnetId": "string",
    "timezoneId": "string",
    "vCores": "int",
    "zoneRedundant": "bool"
  }
}

Valeurs de propriétés

managedInstances

Nom Description Valeur
type Type de ressource 'Microsoft.Sql/managedInstances'
apiVersion Version de l’API de ressource « 2020-02-preview »
name Nom de la ressource chaîne (obligatoire)

Limite de caractères : 1-63

Caractères valides :
Lettres minuscules, chiffres et traits d’union.

Ne peut pas commencer ou se terminer par un trait d’union.

Le nom de la ressource doit être unique dans Azure.
location Emplacement de la ressource. chaîne (obligatoire)
tags Balises de ressource. Dictionnaire de noms et de valeurs d’étiquettes. Voir Balises dans les modèles
sku Référence SKU instance managée. Valeurs autorisées pour les sku.name : GP_Gen4, GP_Gen5, BC_Gen4, BC_Gen5 Sku
identité Identité Azure Active Directory du instance managé. ResourceIdentity
properties Propriétés de ressource. ManagedInstanceProperties

ResourceIdentity

Nom Description Valeur
type Type d’identité. Définissez ce paramètre sur « SystemAssigned » afin de créer et d’affecter automatiquement un principal Azure Active Directory pour la ressource. 'None'
'SystemAssigned'
'SystemAssigned,UserAssigned'
'UserAssigned'

ManagedInstanceProperties

Nom Description Valeur
administratorLogin Nom d’utilisateur administrateur pour le instance managé. Ne peut être spécifié que lorsque le instance managé est en cours de création (et est requis pour la création). string
administratorLoginPassword Mot de passe de connexion administrateur (requis pour la création de instance managés). string
collation Classement des instance managés. string
dnsZonePartner ID de ressource d’une autre instance managée dont cette instance managée partagera la zone DNS après sa création. string
instancePoolId ID du pool de instance auquel appartient ce serveur managé. 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 la base de données.

Par défaut : création de instance standard.

Restaurer : crée une instance en restaurant un ensemble de sauvegardes à un moment spécifique dans le temps. RestorePointInTime et SourceManagedInstanceId doivent être spécifiés.		 'Par défaut'
'PointInTimeRestore'
minimalTlsVersion Version tls minimale. Valeurs autorisées : 'None', '1.0', '1.1', '1.2' string
proxyOverride Type de connexion utilisé pour la connexion au instance. 'Par défaut'
'Proxy'
'Redirection'
publicDataEndpointEnabled Indique si le point de terminaison de données public est activé ou non. bool
restorePointInTime Spécifie le point dans le temps (format ISO8601) de la base de données source qui sera restaurée pour créer la nouvelle base de données. string
sourceManagedInstanceId Identificateur de ressource du instance managé source associé à l’opération de création de ce instance. string
storageAccountType Type de compte de stockage utilisé pour stocker les sauvegardes pour cette instance. Les options sont LRS (LocalRedundantStorage), ZRS (ZoneRedundantStorage) et GRS (GeoRedundantStorage) 'GRS'
'LRS'
'ZRS'
storageSizeInGB Taille de stockage en Go. Valeur minimale : 32. Valeur maximale : 8192. Incréments de 32 Go autorisés uniquement. int
subnetId ID de ressource de sous-réseau pour le instance managé. 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\Time Zones.
Vous pouvez obtenir ces valeurs de Registre via SQL Server en interrogeant SELECT name AS timezone_id FROM sys.time_zone_info.
La liste des ID peut également être obtenue 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 : 8, 16, 24, 32, 40, 64, 80. int
zoneRedundant Indique si le multi-az est activé ou non. bool

Sku

Nom Description Valeur
capacité Capacité de la référence SKU particulière. int
famille Si le service a différentes générations de matériel, pour la même référence SKU, cela peut être capturé ici. string
name Nom de la référence SKU, généralement une lettre + un code numérique, par exemple P3. chaîne (obligatoire)
taille Taille de la référence SKU particulière string
Niveau Niveau ou édition de la référence SKU particulière, par exemple De base, Premium. string

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle Description
Déployer SQL Managed Instance avec la mise en réseau

Déployer sur Azure		 Déployer UDR et NSG pour prendre en charge Azure SQL Managed Instance et déployer le Managed Instance
Créer SQL MI à l’intérieur du nouveau réseau virtuel

Déployer sur Azure		 Déployez Azure Sql Database Managed Instance (SQL MI) dans de nouveaux Réseau virtuel.
Créer SQL MI avec l’envoi configuré de journaux et de métriques

Déployer sur Azure		 Ce modèle vous permet de déployer SQL MI et d’autres ressources utilisées pour stocker des journaux et des 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éployer sur Azure		 Déployez Azure Sql Database Managed Instance (SQL MI) et JumpBox avec SSMS dans de nouvelles Réseau virtuel.
Créer une mi SQL avec une connexion point à site configurée

Déployer sur Azure		 Déployez Azure Sql Database Managed Instance (SQL MI) et la passerelle de réseau virtuel configurée pour la connexion point à site à l’intérieur du nouveau réseau virtuel.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource managedInstances peut être déployé avec des opérations qui ciblent :

  • Groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format des ressources

Pour créer une ressource Microsoft.Sql/managedInstances, ajoutez le Terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Sql/managedInstances@2020-02-02-preview"
  name = "string"
  location = "string"
  parent_id = "string"
  tags = {
    tagName1 = "tagValue1"
    tagName2 = "tagValue2"
  }
  identity {
    type = "string"
  }
  body = jsonencode({
    properties = {
      administratorLogin = "string"
      administratorLoginPassword = "string"
      collation = "string"
      dnsZonePartner = "string"
      instancePoolId = "string"
      licenseType = "string"
      maintenanceConfigurationId = "string"
      managedInstanceCreateMode = "string"
      minimalTlsVersion = "string"
      proxyOverride = "string"
      publicDataEndpointEnabled = bool
      restorePointInTime = "string"
      sourceManagedInstanceId = "string"
      storageAccountType = "string"
      storageSizeInGB = int
      subnetId = "string"
      timezoneId = "string"
      vCores = int
      zoneRedundant = bool
    }
    sku = {
      capacity = int
      family = "string"
      name = "string"
      size = "string"
      tier = "string"
    }
  })
}

Valeurs de propriétés

managedInstances

Nom Description Valeur
type Type de ressource « Microsoft.Sql/managedInstances@2020-02-02-preview »
name Nom de la ressource chaîne (obligatoire)

Limite de caractères : 1-63

Caractères valides :
Lettres minuscules, chiffres et traits d’union.

Ne peut pas commencer ou se terminer par un trait d’union.

Le nom de la ressource doit être unique dans Azure.
location Emplacement de la ressource. chaîne (obligatoire)
parent_id Pour effectuer un déploiement sur un groupe de ressources, utilisez l’ID de ce groupe de ressources. chaîne (obligatoire)
tags Balises de ressource. Dictionnaire de noms et de valeurs d’étiquettes.
sku Référence SKU instance managée. Valeurs autorisées pour sku.name : GP_Gen4, GP_Gen5, BC_Gen4, BC_Gen5 Sku
identité Identité Azure Active Directory du instance managé. ResourceIdentity
properties Propriétés de ressource. ManagedInstanceProperties

ResourceIdentity

Nom Description Valeur
type Type d’identité. Définissez cette valeur sur « SystemAssigned » afin de créer et d’affecter automatiquement un principal Azure Active Directory pour la ressource. « SystemAssigned »
« SystemAssigned,UserAssigned »
« UserAssigned »

ManagedInstanceProperties

Nom Description Valeur
administratorLogin Nom d’utilisateur administrateur pour le instance managé. Ne peut être spécifié que lorsque le instance managé est en cours de création (et est requis pour la création). string
administratorLoginPassword Mot de passe de connexion administrateur (requis pour la création de instance managés). string
collation Classement des instance managés. string
dnsZonePartner ID de ressource d’un autre instance managé dont la zone DNS que cette instance managée partagera après sa création. string
instancePoolId ID du pool de instance auquel appartient ce serveur managé. string
licenseType Type de licence. Les valeurs possibles sont « LicenseIncluded » (prix normal incluant 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 la base de données.

Valeur par défaut : création de instance standard.

Restauration : crée un instance en restaurant un ensemble de sauvegardes à un point spécifique dans le temps. RestorePointInTime et SourceManagedInstanceId doivent être spécifiés.		 « Par défaut »
« PointInTimeRestore »
minimalTlsVersion Version TLS minimale. Valeurs autorisées : « None », « 1.0 », « 1.1 », « 1.2 » string
proxyOverride Type de connexion utilisé pour la connexion au instance. « Par défaut »
« Proxy »
« Redirection »
publicDataEndpointEnabled Indique si le point de terminaison de données public est activé ou non. bool
restorePointInTime Spécifie le point dans le temps (format ISO8601) de la base de données source qui sera restaurée pour créer la nouvelle base de données. string
sourceManagedInstanceId Identificateur de ressource de l’instance managée source associée à l’opération de création de ce instance. string
storageAccountType Type de compte de stockage utilisé pour stocker les sauvegardes pour cette instance. Les options sont LRS (LocalRedundantStorage), ZRS (ZoneRedundantStorage) et GRS (GeoRedundantStorage) « GRS »
« LRS »
« ZRS »
storageSizeInGB Taille de stockage en Go. Valeur minimale : 32. Valeur maximale : 8192. Incréments de 32 Go autorisés uniquement. int
subnetId ID de ressource de sous-réseau pour le instance managé. 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\Time Zones.
Vous pouvez obtenir ces valeurs de Registre via SQL Server en interrogeant select name as timezone_id FROM sys.time_zone_info.
La liste des ID peut également être obtenue en exécutant [System.TimeZoneInfo] ::GetSystemTimeZones() dans PowerShell.
Un exemple d’ID de fuseau horaire valide est « Heure standard du Pacifique » ou « W. Heure standard de l’Europe ».		 string
vCores Nombre de vCores. Valeurs autorisées : 8, 16, 24, 32, 40, 64, 80. int
zoneRedundant Indique si le multi-az est activé ou non. bool

Sku

Nom Description Valeur
capacité Capacité de la référence SKU particulière. int
famille Si le service a différentes générations de matériel, pour la même référence SKU, cela peut être capturé ici. string
name Nom de la référence SKU, généralement une lettre + un code numérique, par exemple P3. string (obligatoire)
taille Taille de la référence SKU particulière string
Niveau Niveau ou édition de la référence SKU particulière, par exemple De base, Premium. string