Managed Instances - Create Or Update

Service:: SQL Database

Version d'API:: 2025-01-01

Crée ou met à jour une instance managée.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}?api-version=2025-01-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
managedInstanceName	path	True	string	Nom de l’instance managée.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nom du groupe de ressources. Le nom ne respecte pas la casse.
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Corps de la demande

Nom	Obligatoire	Type	Description
location	True	string	Emplacement géographique où réside la ressource
identity		ResourceIdentity	L’identité Azure Active Directory de l’instance gérée.
properties.administratorLogin		string	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).
properties.administratorLoginPassword		string (password)	Mot de passe de connexion administrateur (requis pour la création d’une instance managée).
properties.administrators		ManagedInstanceExternalAdministrator	L’administrateur Azure Active Directory peut être utilisé lors de la création d’instances et lors des mises à jour, sauf pour la propriété azureADOnlyAuthentication. Pour mettre à jour la propriété azureADOnlyAuthentication, une API individuelle doit être utilisée.
properties.authenticationMetadata		AuthMetadataLookupModes	Mode de recherche des métadonnées d’authentification de l’instance managée.
properties.collation		string	Classement de l’instance managée.
properties.databaseFormat		ManagedInstanceDatabaseFormat	Spécifie le format interne des bases de données d’instance spécifiques à la version du moteur SQL.
properties.dnsZonePartner		string (arm-id)	ID de ressource d’une autre instance managée dont la zone DNS que cette instance managée partagera après la création.
properties.hybridSecondaryUsage		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).
properties.instancePoolId		string	ID du pool d’instances auquel appartient ce serveur managé.
properties.isGeneralPurposeV2		boolean	Indique s’il s’agit d’une variante GPv2 de l’édition Usage général.
properties.keyId		string	URI CMK de la clé à utiliser pour le chiffrement.
properties.licenseType		ManagedInstanceLicenseType	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).
properties.maintenanceConfigurationId		string	Spécifie l’ID de configuration de maintenance à appliquer à cette instance managée.
properties.managedInstanceCreateMode		ManagedServerCreateMode	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.
properties.memorySizeInGB		integer (int32)	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.
properties.minimalTlsVersion		string	Version TLS minimale. Valeurs autorisées : « None », « 1.0 », « 1.1 », « 1.2 »
properties.pricingModel		PricingModel	Modèle de tarification de Managed Instance.
properties.primaryUserAssignedIdentityId		string (arm-id)	ID de ressource d’une identité affectée par l’utilisateur à utiliser par défaut.
properties.proxyOverride		ManagedInstanceProxyOverride	Type de connexion utilisé pour la connexion à l’instance.
properties.publicDataEndpointEnabled		boolean	Indique si le point de terminaison de données public est activé ou non.
properties.requestedBackupStorageRedundancy		BackupStorageRedundancy	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)
properties.requestedLogicalAvailabilityZone		AvailabilityZoneType	Spécifie la zone de disponibilité logique à laquelle Managed Instance est épinglée.
properties.restorePointInTime		string (date-time)	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.
properties.servicePrincipal		ServicePrincipal	Principal de service de l’instance managée.
properties.sourceManagedInstanceId		string (arm-id)	Identificateur de ressource de l’instance managée source associée à l’opération de création de cette instance.
properties.storageIOps		integer (int32)	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.
properties.storageSizeInGB		integer (int32)	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.
properties.storageThroughputMBps		integer (int32)	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.
properties.subnetId		string (arm-id)	ID de ressource de sous-réseau pour l’instance managée.
properties.timezoneId		string	ID du fuseau horaire. Les valeurs autorisées sont des fuseaux horaires pris en charge par Windows. Windows conserve les détails des fuseaux horaires supportés, y compris l’identifiant, dans le registre sous KEY_LOCAL_MACHINE\LOGICIEL\Microsoft\Windows NT\CurrentVersion\Time Zones. Vous pouvez obtenir ces valeurs du registre via SQL Server en interrogeant SELECT NAME AS timezone_id DEPUIS 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".
properties.vCores		integer (int32)	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.
properties.zoneRedundant		boolean	Indique si la redondance de zone est activée ou non.
sku		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).
tags		object	Balises de ressource.

Réponses

Nom	Type	Description
200 OK	ManagedInstance	Opération de mise à jour de la ressource 'ManagedInstance' réussie
201 Created	ManagedInstance	Resource 'ManagedInstance' créer l’opération réussie En-têtes Location: string Retry-After: integer
202 Accepted		Exploitation des ressources acceptée. En-têtes Location: string Retry-After: integer
Other Status Codes	ErrorResponse	Réponse d’erreur inattendue.

Sécurité

azure_auth

Azure Active Directory OAuth2 Flow.

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

Create managed instance with all properties

Create managed instance with minimal properties

Create managed instance with all properties

Exemple de requête

HTTP

PUT https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2025-01-01

{
  "location": "Japan East",
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "PLACEHOLDER",
    "administrators": {
      "azureADOnlyAuthentication": true,
      "login": "bob@contoso.com",
      "principalType": "User",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "authenticationMetadata": "AzureAD",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "databaseFormat": "AlwaysUpToDate",
    "dnsZonePartner": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
    "hybridSecondaryUsage": "Passive",
    "instancePoolId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "minimalTlsVersion": "1.2",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "requestedLogicalAvailabilityZone": "1",
    "servicePrincipal": {
      "type": "SystemAssigned"
    },
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "timezoneId": "UTC",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose"
  },
  "tags": {
    "tagKey1": "TagValue1"
  }
}

Exemple de réponse

Code d’état:: 200

{
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "administrators": {
      "azureADOnlyAuthentication": true,
      "login": "bob@contoso.com",
      "principalType": "User",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "authenticationMetadata": "AzureAD",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "currentBackupStorageRedundancy": "Geo",
    "databaseFormat": "AlwaysUpToDate",
    "dnsZone": "1b4e2caff2530",
    "externalGovernanceStatus": "Enabled",
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "hybridSecondaryUsage": "Passive",
    "instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "minimalTlsVersion": "1.2",
    "provisioningState": "Creating",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "requestedLogicalAvailabilityZone": "1",
    "servicePrincipal": {
      "type": "SystemAssigned",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "principalId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "state": "Ready",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "timezoneId": "UTC",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 8,
    "family": "Gen5",
    "tier": "GeneralPurpose"
  },
  "tags": {
    "tagKey1": "TagValue1"
  }
}

Code d’état:: 201

{
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "administrators": {
      "azureADOnlyAuthentication": true,
      "login": "bob@contoso.com",
      "principalType": "User",
      "sid": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "authenticationMetadata": "AzureAD",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "currentBackupStorageRedundancy": "Geo",
    "databaseFormat": "AlwaysUpToDate",
    "dnsZone": "1b4e2caff2530",
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "hybridSecondaryUsage": "Passive",
    "instancePoolId": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/instancePools/pool1",
    "licenseType": "LicenseIncluded",
    "maintenanceConfigurationId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "minimalTlsVersion": "1.2",
    "provisioningState": "Creating",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "requestedLogicalAvailabilityZone": "1",
    "servicePrincipal": {
      "type": "SystemAssigned",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "principalId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111"
    },
    "state": "Ready",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "timezoneId": "UTC",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 8,
    "family": "Gen5",
    "tier": "GeneralPurpose"
  },
  "tags": {
    "tagKey1": "TagValue1"
  }
}

Code d’état:: 202

Create managed instance with minimal properties

Exemple de requête

HTTP

PUT https://management.azure.com/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance?api-version=2025-01-01

{
  "location": "Japan East",
  "properties": {
    "administratorLogin": "dummylogin",
    "administratorLoginPassword": "PLACEHOLDER",
    "licenseType": "LicenseIncluded",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose"
  }
}

Exemple de réponse

Code d’état:: 200

{
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "currentBackupStorageRedundancy": "Geo",
    "databaseFormat": "SQLServer2022",
    "dnsZone": "1b4e2caff2530",
    "externalGovernanceStatus": "Enabled",
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "hybridSecondaryUsage": "Passive",
    "licenseType": "LicenseIncluded",
    "provisioningState": "Creating",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "state": "Ready",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 8,
    "family": "Gen4",
    "tier": "GeneralPurpose"
  },
  "tags": {}
}

Code d’état:: 201

{
  "name": "testinstance",
  "type": "Microsoft.Sql/managedInstances",
  "id": "/subscriptions/20d7082a-0fc7-4468-82bd-542694d5042b/resourceGroups/testrg/providers/Microsoft.Sql/managedInstances/testinstance",
  "location": "japaneast",
  "properties": {
    "administratorLogin": "dummylogin",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "currentBackupStorageRedundancy": "Geo",
    "databaseFormat": "SQLServer2022",
    "dnsZone": "1b4e2caff2530",
    "externalGovernanceStatus": "Enabled",
    "fullyQualifiedDomainName": "testinstance.1b4e2caff2530.database.windows.net",
    "hybridSecondaryUsage": "Passive",
    "licenseType": "LicenseIncluded",
    "provisioningState": "Creating",
    "proxyOverride": "Redirect",
    "publicDataEndpointEnabled": false,
    "requestedBackupStorageRedundancy": "Geo",
    "state": "Ready",
    "storageSizeInGB": 1024,
    "subnetId": "/subscriptions/20D7082A-0FC7-4468-82BD-542694D5042B/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "vCores": 8
  },
  "sku": {
    "name": "GP_Gen5",
    "capacity": 8,
    "family": "Gen4",
    "tier": "GeneralPurpose"
  },
  "tags": {}
}

Code d’état:: 202

Définitions

Nom	Description
AdministratorType	Type de l’administrateur de serveur.
AuthMetadataLookupModes	Mode de recherche des métadonnées d’authentification de l’instance managée.
AvailabilityZoneType	Spécifie la zone de disponibilité à laquelle la base de données est épinglée.
BackupStorageRedundancy	Type de compte de stockage utilisé pour stocker des sauvegardes pour cette base de données.
createdByType	Type d’identité qui a créé la ressource.
ErrorAdditionalInfo	Informations supplémentaires sur l’erreur de gestion des ressources.
ErrorDetail	Détail de l’erreur.
ErrorResponse	Réponse d’erreur
ExternalGovernanceStatus	État de la gouvernance externe.
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).
HybridSecondaryUsageDetected	L’utilisation secondaire hybride a été détectée. Les valeurs possibles sont « Actives » (le client ne répond pas aux exigences d’utilisation de la récupération d’urgence passive) et « Passive » (le client répond aux exigences d’utilisation de la récupération d’urgence secondaire comme récupération d’urgence passive).
IdentityType	Type d’identité. Réglez cela sur « SystemAssigned » afin de créer et d'attribuer automatiquement un principal Azure Active Directory à la ressource.
ManagedInstance	Une instance gérée Azure SQL.
ManagedInstanceDatabaseFormat	Spécifie le format interne des bases de données d’instance spécifiques à la version du moteur SQL.
ManagedInstanceExternalAdministrator	Propriétés d’un administrateur Active Directory.
ManagedInstanceLicenseType	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).
ManagedInstancePecProperty	Connexion de point de terminaison privé sous une instance managée
ManagedInstancePrivateEndpointConnectionProperties	Propriétés d’une connexion de point de terminaison privé.
ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride	Type de connexion utilisé pour la connexion à l’instance.
ManagedServerCreateMode	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.
PricingModel	Modèle de tarification de Managed Instance.
PrincipalType	Type de principal de l’administrateur de serveur.
ProvisioningState	État d’approvisionnement ARM de l’exécution du travail.
ResourceIdentity	Configuration d’identité Azure Active Directory pour une ressource.
ServicePrincipal	Configuration du principal de service de l’instance managée pour une ressource.
ServicePrincipalType	Type de principal de service.
Sku	Référence SKU de ressource ARM.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.
UserIdentity	Configuration d’identité Azure Active Directory pour une ressource.

AdministratorType

Énumération

Type de l’administrateur de serveur.

Valeur	Description
ActiveDirectory	Active Directory

AuthMetadataLookupModes

Énumération

Mode de recherche des métadonnées d’authentification de l’instance managée.

Valeur	Description
AzureAD	AzureAD
Paired	Jumelé
Windows	Windows

AvailabilityZoneType

Énumération

Spécifie la zone de disponibilité à laquelle la base de données est épinglée.

Valeur	Description
NoPreference	Sans préférence
1	1
2	2
3	3

BackupStorageRedundancy

Énumération

Type de compte de stockage utilisé pour stocker des sauvegardes pour cette base de données.

Valeur	Description
Geo	Zone géographique
Local	Local
Zone	Zone
GeoZone	GeoZone

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
User
Application
ManagedIdentity
Key

ErrorAdditionalInfo

Objet

Informations supplémentaires sur l’erreur de gestion des ressources.

Nom	Type	Description
info	object	Informations supplémentaires.
type	string	Type d’informations supplémentaire.

ErrorDetail

Objet

Détail de l’erreur.

Nom	Type	Description
additionalInfo	ErrorAdditionalInfo[]	Informations supplémentaires sur l’erreur.
code	string	Code d’erreur.
details	ErrorDetail[]	Détails de l’erreur.
message	string	Message d’erreur.
target	string	Cible d’erreur.

ErrorResponse

Objet

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

ExternalGovernanceStatus

Énumération

État de la gouvernance externe.

Valeur	Description
Enabled	Activé
Disabled	Désactivé

HybridSecondaryUsage

Énumération

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).

Valeur	Description
Active	Activé
Passive	Passive

HybridSecondaryUsageDetected

Énumération

L’utilisation secondaire hybride a été détectée. Les valeurs possibles sont « Actives » (le client ne répond pas aux exigences d’utilisation de la récupération d’urgence passive) et « Passive » (le client répond aux exigences d’utilisation de la récupération d’urgence secondaire comme récupération d’urgence passive).

Valeur	Description
Active	Activé
Passive	Passive

IdentityType

Énumération

Type d’identité. Réglez cela sur « SystemAssigned » afin de créer et d'attribuer automatiquement un principal Azure Active Directory à la ressource.

Valeur	Description
None	Aucun
SystemAssigned	Attribué par le système
UserAssigned	UserAssigned
SystemAssigned,UserAssigned	SystemAssigned, UserAssigned

ManagedInstance

Objet

Une instance gérée Azure SQL.

Nom	Type	Description
id	string (arm-id)	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
identity	ResourceIdentity	L’identité Azure Active Directory de l’instance gérée.
location	string	Emplacement géographique où réside la ressource
name	string	Nom de la ressource
properties.administratorLogin	string	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).
properties.administratorLoginPassword	string (password)	Mot de passe de connexion administrateur (requis pour la création d’une instance managée).
properties.administrators	ManagedInstanceExternalAdministrator	L’administrateur Azure Active Directory peut être utilisé lors de la création d’instances et lors des mises à jour, sauf pour la propriété azureADOnlyAuthentication. Pour mettre à jour la propriété azureADOnlyAuthentication, une API individuelle doit être utilisée.
properties.authenticationMetadata	AuthMetadataLookupModes	Mode de recherche des métadonnées d’authentification de l’instance managée.
properties.collation	string	Classement de l’instance managée.
properties.createTime	string (date-time)	Précise le moment précis (ISO8601 format) de la création de la Managed Instance.
properties.currentBackupStorageRedundancy	BackupStorageRedundancy	Type de compte de stockage utilisé pour stocker des sauvegardes pour cette instance. Les options sont Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) et GeoZone(GeoZoneRedundantStorage)
properties.databaseFormat	ManagedInstanceDatabaseFormat	Spécifie le format interne des bases de données d’instance spécifiques à la version du moteur SQL.
properties.dnsZone	string	Zone DNS dans laquelle se trouve l’instance managée.
properties.dnsZonePartner	string (arm-id)	ID de ressource d’une autre instance managée dont la zone DNS que cette instance managée partagera après la création.
properties.externalGovernanceStatus	ExternalGovernanceStatus	État de la gouvernance externe.
properties.fullyQualifiedDomainName	string	Nom de domaine complet de l’instance managée.
properties.hybridSecondaryUsage	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).
properties.hybridSecondaryUsageDetected	HybridSecondaryUsageDetected	L’utilisation secondaire hybride a été détectée. Les valeurs possibles sont « Actives » (le client ne répond pas aux exigences d’utilisation de la récupération d’urgence passive) et « Passive » (le client répond aux exigences d’utilisation de la récupération d’urgence secondaire comme récupération d’urgence passive).
properties.instancePoolId	string	ID du pool d’instances auquel appartient ce serveur managé.
properties.isGeneralPurposeV2	boolean	Indique s’il s’agit d’une variante GPv2 de l’édition Usage général.
properties.keyId	string	URI CMK de la clé à utiliser pour le chiffrement.
properties.licenseType	ManagedInstanceLicenseType	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).
properties.maintenanceConfigurationId	string	Spécifie l’ID de configuration de maintenance à appliquer à cette instance managée.
properties.managedInstanceCreateMode	ManagedServerCreateMode	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.
properties.memorySizeInGB	integer (int32)	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.
properties.minimalTlsVersion	string	Version TLS minimale. Valeurs autorisées : « None », « 1.0 », « 1.1 », « 1.2 »
properties.pricingModel	PricingModel	Modèle de tarification de Managed Instance.
properties.primaryUserAssignedIdentityId	string (arm-id)	ID de ressource d’une identité affectée par l’utilisateur à utiliser par défaut.
properties.privateEndpointConnections	ManagedInstancePecProperty[]	Liste des connexions de point de terminaison privé sur une instance managée.
properties.provisioningState	ProvisioningState	État d’approvisionnement d’une instance managée.
properties.proxyOverride	ManagedInstanceProxyOverride	Type de connexion utilisé pour la connexion à l’instance.
properties.publicDataEndpointEnabled	boolean	Indique si le point de terminaison de données public est activé ou non.
properties.requestedBackupStorageRedundancy	BackupStorageRedundancy	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)
properties.requestedLogicalAvailabilityZone	AvailabilityZoneType	Spécifie la zone de disponibilité logique à laquelle Managed Instance est épinglée.
properties.restorePointInTime	string (date-time)	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.
properties.servicePrincipal	ServicePrincipal	Principal de service de l’instance managée.
properties.sourceManagedInstanceId	string (arm-id)	Identificateur de ressource de l’instance managée source associée à l’opération de création de cette instance.
properties.state	string	État de l’instance managée.
properties.storageIOps	integer (int32)	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.
properties.storageSizeInGB	integer (int32)	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.
properties.storageThroughputMBps	integer (int32)	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.
properties.subnetId	string (arm-id)	ID de ressource de sous-réseau pour l’instance managée.
properties.timezoneId	string	ID du fuseau horaire. Les valeurs autorisées sont des fuseaux horaires pris en charge par Windows. Windows conserve les détails des fuseaux horaires supportés, y compris l’identifiant, dans le registre sous KEY_LOCAL_MACHINE\LOGICIEL\Microsoft\Windows NT\CurrentVersion\Time Zones. Vous pouvez obtenir ces valeurs du registre via SQL Server en interrogeant SELECT NAME AS timezone_id DEPUIS 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".
properties.vCores	integer (int32)	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.
properties.virtualClusterId	string	ID de ressource du cluster virtuel pour la Managed Instance.
properties.zoneRedundant	boolean	Indique si la redondance de zone est activée ou non.
sku	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).
systemData	systemData	Azure Resource Manager : métadonnées contenant des informations createdBy et modifiedBy.
tags	object	Balises de ressource.
type	string	Type de la ressource. Par exemple : « Microsoft. Calcul/virtualMachines » ou « Microsoft. StorageAccounts"

ManagedInstanceDatabaseFormat

Énumération

Spécifie le format interne des bases de données d’instance spécifiques à la version du moteur SQL.

Valeur	Description
AlwaysUpToDate	ToujoursÀ jour
SQLServer2022	SQLServer2022
SQLServer2025	SQLServer2025

ManagedInstanceExternalAdministrator

Objet

Propriétés d’un administrateur Active Directory.

Nom	Type	Description
administratorType	AdministratorType	Type de l’administrateur de serveur.
azureADOnlyAuthentication	boolean	Azure Active Directory uniquement, authentification activée.
login	string	Nom de connexion de l’administrateur du serveur.
principalType	PrincipalType	Type de principal de l’administrateur de serveur.
sid	string (uuid)	SID (ID d’objet) de l’administrateur du serveur.
tenantId	string (uuid)	ID de locataire de l’administrateur.

ManagedInstanceLicenseType

Énumération

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).

Valeur	Description
LicenseIncluded	LicenceInclus
BasePrice	BasePrice

ManagedInstancePecProperty

Objet

Connexion de point de terminaison privé sous une instance managée

Nom	Type	Description
id	string	ID de la ressource
properties	ManagedInstancePrivateEndpointConnectionProperties	Propriétés de connexion de point de terminaison privé

ManagedInstancePrivateEndpointConnectionProperties

Objet

Propriétés d’une connexion de point de terminaison privé.

Nom	Type	Description
privateEndpoint	ManagedInstancePrivateEndpointProperty	Point de terminaison privé auquel la connexion appartient.
privateLinkServiceConnectionState	ManagedInstancePrivateLinkServiceConnectionStateProperty	État de connexion de la connexion de point de terminaison privé.
provisioningState	string	État de la connexion de point de terminaison privé.

ManagedInstancePrivateEndpointProperty

Objet

Nom	Type	Description
id	string	ID de ressource du point de terminaison privé.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Objet

Nom	Type	Description
actionsRequired	string	Description de la connexion du service private link.
description	string	Description de la connexion du service private link.
status	string	État de connexion du service de liaison privée.

ManagedInstanceProxyOverride

Énumération

Type de connexion utilisé pour la connexion à l’instance.

Valeur	Description
Proxy	Proxy
Redirect	Rediriger
Default	Par défaut

ManagedServerCreateMode

Énumération

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.

Valeur	Description
Default	Par défaut
PointInTimeRestore	PointInTimeRestore

PricingModel

Énumération

Modèle de tarification de Managed Instance.

Valeur	Description
Regular	Régulier
Freemium	Freemium

PrincipalType

Énumération

Type de principal de l’administrateur de serveur.

Valeur	Description
User	Utilisateur
Group	Groupe
Application	Application

ProvisioningState

Énumération

État d’approvisionnement ARM de l’exécution du travail.

Valeur	Description
Created	Créé
InProgress	En cours
Succeeded	Réussi
Failed	Échec
Canceled	Opération annulée

ResourceIdentity

Objet

Configuration d’identité Azure Active Directory pour une ressource.

Nom	Type	Description
principalId	string (uuid)	L’ID principal d’Azure Active Directory.
tenantId	string (uuid)	L’identifiant du locataire Azure Active Directory.
type	IdentityType	Type d’identité. Réglez cela sur « SystemAssigned » afin de créer et d'attribuer automatiquement un principal Azure Active Directory à la ressource.
userAssignedIdentities	<string, UserIdentity>	ID de ressource des identités affectées par l’utilisateur à utiliser

ServicePrincipal

Objet

Configuration du principal de service de l’instance managée pour une ressource.

Nom	Type	Description
clientId	string	L’ID client de l’application Azure Active Directory.
principalId	string	L’ID d’objet application Azure Active Directory.
tenantId	string	L’identifiant du locataire Azure Active Directory.
type	ServicePrincipalType	Type de principal de service.

ServicePrincipalType

Énumération

Type de principal de service.

Valeur	Description
None	Aucun
SystemAssigned	Attribué par le système

Sku

Objet

Référence SKU de ressource ARM.

Nom	Type	Description
capacity	integer (int32)	Capacité de la référence SKU particulière.
family	string	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.
name	string	Nom de la référence SKU, généralement une lettre + code numérique, par exemple P3.
size	string	Taille de la référence SKU particulière
tier	string	Niveau ou édition de la référence SKU particulière, par exemple De base, Premium.

systemData

Objet

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.

UserIdentity

Objet

Configuration d’identité Azure Active Directory pour une ressource.

Nom	Type	Description
clientId	string (uuid)	L’ID client Azure Active Directory.
principalId	string (uuid)	L’ID principal d’Azure Active Directory.

Partager via

Managed Instances - Create Or Update

Paramètres URI

Corps de la demande

Réponses

Sécurité

azure_auth

Étendues

Exemples

Create managed instance with all properties

Exemple de requête

Exemple de réponse

Create managed instance with minimal properties

Exemple de requête

Exemple de réponse

Définitions

AdministratorType

AuthMetadataLookupModes

AvailabilityZoneType

BackupStorageRedundancy

createdByType

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExternalGovernanceStatus

HybridSecondaryUsage

HybridSecondaryUsageDetected

IdentityType

ManagedInstance

ManagedInstanceDatabaseFormat

ManagedInstanceExternalAdministrator

ManagedInstanceLicenseType

ManagedInstancePecProperty

ManagedInstancePrivateEndpointConnectionProperties

ManagedInstancePrivateEndpointProperty

ManagedInstancePrivateLinkServiceConnectionStateProperty

ManagedInstanceProxyOverride

ManagedServerCreateMode

PricingModel

PrincipalType

ProvisioningState

ResourceIdentity

ServicePrincipal

ServicePrincipalType

Sku

systemData

UserIdentity