Managed Instances - List By Resource Group

Référence

Service:: SQL Database

Version d'API:: 2023-08-01

Obtient une liste d’instances managées dans un groupe de ressources.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances?api-version=2023-08-01

Avec des paramètres facultatifs:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances?$expand={$expand}&api-version=2023-08-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
subscriptionId	path	True	string	ID d’abonnement qui identifie un abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser pour la requête.
$expand	query		string	Ressources enfants à inclure dans la réponse.

Réponses

Nom	Type	Description
200 OK	ManagedInstanceListResult	Récupération réussie de la liste des instances managées.
Other Status Codes	ErrorResponse	Réponses d’erreur : *** 400 SubnetMissingRequiredDelegation : le sous-réseau sélectionné n’est pas délégué pour SQL Managed Instance. 400 ManagementServiceManagedServerDisabled - L’opération a échoué depuis que Managed Instance '{0}' est désactivé. Activez Managed Instance et réessayez. 400 MiGeoRestoreWithWrongBackupStorageRedundancy : Geo-Restore n’est pas autorisé pour les instances managées avec la redondance du stockage de sauvegarde LRS/ZRS. 400 LastBackupNameHasNewline - N’utilisez pas de caractères interdits ('\n', '\r') dans lastBackupName. 400 LastBackupNameHasNonAsciiCharacter : l’opération a été abandonnée, car le paramètre « LastBackupName » contient des caractères non valides. Seuls les caractères ASCII sont autorisés. 400 ProvisioningDisabled - Affiche le message d’erreur de l’autorisation d’opération de ressources tel qu’il est, sans modification 400 LRSCutoverDatabaseDoesNotExist : l’opération a été abandonnée, car le nom de la base de données spécifié dans la requête ne correspond à aucun nom de base de données sur le serveur spécifié. 400 LRSCutoverDatabaseNotInRestoringState : l’opération a été abandonnée, car la base de données spécifiée n’est pas en état de restauration. 400 LRSCutoverDatabaseAlreadyRestored : l’opération a été abandonnée, car la base de données spécifiée a déjà été restaurée. 400 LRSCutoverAlreadyInitiated : l’opération a été abandonnée, car un basculement pour la base de données spécifiée est déjà en cours. 400 ManagementServiceFeatureDisabled : l’utilisateur a tenté d’utiliser une fonctionnalité désactivée. 400 AadOnlyAuthenticationIsEnabled : l’authentification Azure Active Directory uniquement est activée. Contactez votre administrateur système. 400 UpdatedInstanceAndBackupRedundancy : la redondance de zone d’instance et la redondance du stockage de sauvegarde ne peuvent pas être mises à jour dans la même requête. 400 DeleteOfManagedInstanceIsDisabled : l’opération de suppression de l’instance managée est désactivée. 400 RequestCantLandOnPaaSv2Platform : la demande doit atterrir sur la plateforme PaaSv2, mais PaaSv2 n’est pas activée. 400 CustomMaintenanceWindowIsDisabled : la fenêtre de maintenance personnalisée n’est pas activée. 400 DeleteOfVersion2VirtualClusterIsDisabled : la suppression du cluster virtuel avec la version 2 n’est pas activée. 400 DeleteOfVirtualClusterIsDisabled : la suppression du cluster virtuel n’est pas activée. 400 MICantBeMovedFromOrToInstancePool : l’instance managée existante ne peut pas être déplacée vers le pool d’instances managées. 400 DnsRefreshOnVirtualClusterIsDisabled : l’actualisation des enregistrements DNS sur le cluster virtuel n’est pas activée. 404 SubscriptionNotFound : l’abonnement demandé est introuvable. 404 ManagedInstanceNotInSubscriptionResourceGroup - L’instance managée spécifiée n’existe pas dans le groupe de ressources et l’abonnement spécifiés. 404 SubscriptionNotFound : l’abonnement demandé est introuvable. 404 ServerNotInSubscription : le serveur spécifié n’existe pas sur l’abonnement spécifié. 404 ResourceNotFound : la ressource demandée est introuvable. 409 MiCreateFailedNonDelegatedSubnet : l’utilisateur a essayé de déployer Managed Instance ou un pool Managed Instance dans un sous-réseau qui n’est pas délégué à Microsoft.Sql/managedInstances. 409 InstancePoolBusy - Un pool d’instances est occupé avec une autre opération en cours 409 ConflictingManagedInstanceOperation : une opération est en cours pour l’instance managée. 409 BackupRedundancyUpdateAndInstanceRedundancyConflict : l’instance est multi-az, mais le stockage de sauvegarde est mis à jour de la zone redondante vers la non-zone redondante. 409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress : impossible de mettre à jour la redondance d’instance, car la mise à jour de la redondance du stockage de sauvegarde est en cours. 409 InstanceRedundancyUpdateAndBackupRedundancyConflict : le stockage de sauvegarde n’est pas redondant interzone, mais la redondance d’instance est mise à jour vers une redondance interzone. 409 BackupRedundancyUpdateConflict : impossible de mettre à jour la redondance du stockage de sauvegarde, car une mise à jour de redondance du stockage de sauvegarde est déjà en cours. 409 MiDropFailedOnAuthLocks : l’utilisateur a essayé de supprimer la dernière instance managée dans le sous-réseau qui a appliqué le verrou sur les ressources. 412 InstanceNotReadyForBackupRedundancyUpdate : impossible de mettre à jour la redondance du stockage de sauvegarde, car l’instance n’est pas prête. 429 SubscriptionTooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 429 ConflictingSubscriptionOperation : une opération est actuellement en cours pour l’abonnement. 503 TooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 503 TooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 503 TooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles. 504 RequestTimeout : la demande de service a dépassé le délai d’expiration autorisé. 504 RequestTimeout : la demande de service a dépassé le délai d’expiration autorisé.

Nom

Type

Description

200 OK

ManagedInstanceListResult

Récupération réussie de la liste des instances managées.

Other Status Codes

ErrorResponse

Réponses d’erreur : ***

400 SubnetMissingRequiredDelegation : le sous-réseau sélectionné n’est pas délégué pour SQL Managed Instance.
400 ManagementServiceManagedServerDisabled - L’opération a échoué depuis que Managed Instance '{0}' est désactivé. Activez Managed Instance et réessayez.
400 MiGeoRestoreWithWrongBackupStorageRedundancy : Geo-Restore n’est pas autorisé pour les instances managées avec la redondance du stockage de sauvegarde LRS/ZRS.
400 LastBackupNameHasNewline - N’utilisez pas de caractères interdits ('\n', '\r') dans lastBackupName.
400 LastBackupNameHasNonAsciiCharacter : l’opération a été abandonnée, car le paramètre « LastBackupName » contient des caractères non valides. Seuls les caractères ASCII sont autorisés.
400 ProvisioningDisabled - Affiche le message d’erreur de l’autorisation d’opération de ressources tel qu’il est, sans modification
400 LRSCutoverDatabaseDoesNotExist : l’opération a été abandonnée, car le nom de la base de données spécifié dans la requête ne correspond à aucun nom de base de données sur le serveur spécifié.
400 LRSCutoverDatabaseNotInRestoringState : l’opération a été abandonnée, car la base de données spécifiée n’est pas en état de restauration.
400 LRSCutoverDatabaseAlreadyRestored : l’opération a été abandonnée, car la base de données spécifiée a déjà été restaurée.
400 LRSCutoverAlreadyInitiated : l’opération a été abandonnée, car un basculement pour la base de données spécifiée est déjà en cours.
400 ManagementServiceFeatureDisabled : l’utilisateur a tenté d’utiliser une fonctionnalité désactivée.
400 AadOnlyAuthenticationIsEnabled : l’authentification Azure Active Directory uniquement est activée. Contactez votre administrateur système.
400 UpdatedInstanceAndBackupRedundancy : la redondance de zone d’instance et la redondance du stockage de sauvegarde ne peuvent pas être mises à jour dans la même requête.
400 DeleteOfManagedInstanceIsDisabled : l’opération de suppression de l’instance managée est désactivée.
400 RequestCantLandOnPaaSv2Platform : la demande doit atterrir sur la plateforme PaaSv2, mais PaaSv2 n’est pas activée.
400 CustomMaintenanceWindowIsDisabled : la fenêtre de maintenance personnalisée n’est pas activée.
400 DeleteOfVersion2VirtualClusterIsDisabled : la suppression du cluster virtuel avec la version 2 n’est pas activée.
400 DeleteOfVirtualClusterIsDisabled : la suppression du cluster virtuel n’est pas activée.
400 MICantBeMovedFromOrToInstancePool : l’instance managée existante ne peut pas être déplacée vers le pool d’instances managées.
400 DnsRefreshOnVirtualClusterIsDisabled : l’actualisation des enregistrements DNS sur le cluster virtuel n’est pas activée.
404 SubscriptionNotFound : l’abonnement demandé est introuvable.
404 ManagedInstanceNotInSubscriptionResourceGroup - L’instance managée spécifiée n’existe pas dans le groupe de ressources et l’abonnement spécifiés.
404 SubscriptionNotFound : l’abonnement demandé est introuvable.
404 ServerNotInSubscription : le serveur spécifié n’existe pas sur l’abonnement spécifié.
404 ResourceNotFound : la ressource demandée est introuvable.
409 MiCreateFailedNonDelegatedSubnet : l’utilisateur a essayé de déployer Managed Instance ou un pool Managed Instance dans un sous-réseau qui n’est pas délégué à Microsoft.Sql/managedInstances.
409 InstancePoolBusy - Un pool d’instances est occupé avec une autre opération en cours
409 ConflictingManagedInstanceOperation : une opération est en cours pour l’instance managée.
409 BackupRedundancyUpdateAndInstanceRedundancyConflict : l’instance est multi-az, mais le stockage de sauvegarde est mis à jour de la zone redondante vers la non-zone redondante.
409 InstanceRedundancyUpdateWhileBackupRedundancyUpdateInProgress : impossible de mettre à jour la redondance d’instance, car la mise à jour de la redondance du stockage de sauvegarde est en cours.
409 InstanceRedundancyUpdateAndBackupRedundancyConflict : le stockage de sauvegarde n’est pas redondant interzone, mais la redondance d’instance est mise à jour vers une redondance interzone.
409 BackupRedundancyUpdateConflict : impossible de mettre à jour la redondance du stockage de sauvegarde, car une mise à jour de redondance du stockage de sauvegarde est déjà en cours.
409 MiDropFailedOnAuthLocks : l’utilisateur a essayé de supprimer la dernière instance managée dans le sous-réseau qui a appliqué le verrou sur les ressources.
412 InstanceNotReadyForBackupRedundancyUpdate : impossible de mettre à jour la redondance du stockage de sauvegarde, car l’instance n’est pas prête.
429 SubscriptionTooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.
429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.
429 SubscriptionTooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.
429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.
429 SubscriptionTooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.
429 ConflictingSubscriptionOperation : une opération est actuellement en cours pour l’abonnement.
503 TooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.
503 TooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.
503 TooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.
504 RequestTimeout : la demande de service a dépassé le délai d’expiration autorisé.
504 RequestTimeout : la demande de service a dépassé le délai d’expiration autorisé.

Exemples

List managed instances by resource group

List managed instances by resource group with $expand=administrators/activedirectory

List managed instances by resource group

Exemple de requête

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances?api-version=2023-08-01

Exemple de réponse

Code d’état:: 200

{
  "value": [
    {
      "location": "japaneast",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
      "name": "testinstance1",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "GP_Gen5",
        "tier": "GeneralPurpose",
        "capacity": 8,
        "family": "Gen5"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance1.1b4e2caff2530.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
        "state": "Ready",
        "provisioningState": "Succeeded",
        "vCores": 8,
        "storageSizeInGB": 1024,
        "licenseType": "LicenseIncluded",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "minimalTlsVersion": "1.2",
        "dnsZone": "1b4e2caff2530",
        "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo",
        "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-999999999999",
        "externalGovernanceStatus": "Enabled",
        "hybridSecondaryUsage": "Passive",
        "authenticationMetadata": "Windows",
        "pricingModel": "Regular",
        "createTime": "2022-11-01T01:01:01.011Z",
        "databaseFormat": "SQLServer2022"
      }
    },
    {
      "location": "japaneast",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance2",
      "name": "testinstance2",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "BC_Gen5",
        "tier": "BusinessCritical",
        "capacity": 16,
        "family": "Gen5"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance2.2c3d1bdae3412.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
        "state": "Ready",
        "provisioningState": "Succeeded",
        "vCores": 16,
        "storageSizeInGB": 1024,
        "licenseType": "Full",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "minimalTlsVersion": "1.2",
        "dnsZone": "2c3d1bdae3412",
        "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo",
        "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-444444444444",
        "externalGovernanceStatus": "Enabled",
        "hybridSecondaryUsage": "Passive",
        "authenticationMetadata": "Windows",
        "pricingModel": "Regular",
        "createTime": "2022-11-01T01:01:01.011Z",
        "databaseFormat": "SQLServer2022"
      }
    }
  ]
}

List managed instances by resource group with $expand=administrators/activedirectory

Exemple de requête

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances?api-version=2023-08-01

Exemple de réponse

Code d’état:: 200

{
  "value": [
    {
      "location": "japaneast",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance1",
      "name": "testinstance1",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "GP_Gen5",
        "tier": "GeneralPurpose",
        "capacity": 8,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance1.1b4e2caff2530.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
        "state": "Ready",
        "provisioningState": "Succeeded",
        "vCores": 8,
        "storageSizeInGB": 1024,
        "licenseType": "LicenseIncluded",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "minimalTlsVersion": "1.2",
        "dnsZone": "1b4e2caff2530",
        "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo",
        "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-999999999999",
        "administrators": {
          "principalType": "User",
          "login": "bob@contoso.com",
          "sid": "00000011-1111-2222-2222-123456789111",
          "tenantId": "00000011-1111-2222-2222-123456789111",
          "azureADOnlyAuthentication": true
        },
        "hybridSecondaryUsage": "Passive",
        "authenticationMetadata": "Windows",
        "externalGovernanceStatus": "Enabled",
        "pricingModel": "Regular",
        "createTime": "2022-11-01T01:01:01.011Z",
        "databaseFormat": "SQLServer2022"
      }
    },
    {
      "location": "japaneast",
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Test1/providers/Microsoft.Sql/managedInstances/testinstance2",
      "name": "testinstance2",
      "type": "Microsoft.Sql/managedInstances",
      "sku": {
        "name": "BC_Gen5",
        "tier": "BusinessCritical",
        "capacity": 16,
        "family": "Gen4"
      },
      "properties": {
        "fullyQualifiedDomainName": "testinstance2.2c3d1bdae3412.database.windows.net",
        "administratorLogin": "dummylogin",
        "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Network/virtualNetworks/vnet2/subnets/subnet2",
        "state": "Ready",
        "provisioningState": "Succeeded",
        "vCores": 16,
        "storageSizeInGB": 1024,
        "licenseType": "Full",
        "collation": "SQL_Latin1_General_CP1_CI_AS",
        "publicDataEndpointEnabled": false,
        "proxyOverride": "Default",
        "minimalTlsVersion": "1.2",
        "dnsZone": "2c3d1bdae3412",
        "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_2",
        "currentBackupStorageRedundancy": "Geo",
        "requestedBackupStorageRedundancy": "Geo",
        "virtualClusterId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/testrg/providers/Microsoft.Sql/virtualClusters/vc-5555555-6666-7777-8888-444444444444",
        "administrators": {
          "principalType": "User",
          "login": "bob@contoso.com",
          "sid": "00000011-1111-2222-2222-123456789111",
          "tenantId": "00000011-1111-2222-2222-123456789111",
          "azureADOnlyAuthentication": true
        },
        "externalGovernanceStatus": "Enabled",
        "hybridSecondaryUsage": "Passive",
        "authenticationMetadata": "Windows",
        "pricingModel": "Regular",
        "createTime": "2022-11-01T01:01:01.011Z",
        "databaseFormat": "SQLServer2022"
      }
    }
  ]
}

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.
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)
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é. Définissez cette valeur sur « SystemAssigned » pour créer et affecter automatiquement un principal Azure Active Directory pour la ressource.
ManagedInstance	Instance managé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).
ManagedInstanceListResult	Liste des instances managées.
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 d’une instance managée.
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.
UserIdentity	Configuration d’identité Azure Active Directory pour une ressource.

AdministratorType

Énumération

Type de l’administrateur de serveur.

Valeur	Description
ActiveDirectory

AuthMetadataLookupModes

Énumération

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

Valeur	Description
AzureAD
Paired
Windows

BackupStorageRedundancy

Énumération

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)

Valeur	Description
Geo
GeoZone
Local
Zone

ErrorAdditionalInfo

Object

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

Object

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

Object

Réponse d’erreur

Nom	Type	Description
error	ErrorDetail	Objet d’erreur.

ExternalGovernanceStatus

Énumération

État de la gouvernance externe.

Valeur	Description
Disabled
Enabled

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
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
Passive

IdentityType

Énumération

Type d’identité. Définissez cette valeur sur « SystemAssigned » pour créer et affecter automatiquement un principal Azure Active Directory pour la ressource.

Valeur	Description
None
SystemAssigned
SystemAssigned,UserAssigned
UserAssigned

ManagedInstance

Object

Instance managée Azure SQL.

Nom	Type	Description
id	string	ID de ressource.
identity	ResourceIdentity	Identité Azure Active Directory de l’instance managée.
location	string	Emplacement des ressources.
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	Mot de passe de connexion administrateur (requis pour la création d’une instance managée).
properties.administrators	ManagedInstanceExternalAdministrator	Administrateur Azure Active Directory de l’instance. Cela ne peut être utilisé qu’au moment de la création d’instance. Si elle est utilisée pour la mise à jour d’instance, elle est ignorée ou entraîne une erreur. Pour les mises à jour, les API individuelles doivent être utilisées.
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)	Spécifie le point dans le temps (format ISO8601) de la création de 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.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.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)	IOps 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 : 16384. 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 des 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".
properties.vCores	integer (int32)	Nombre de vCores. Valeurs autorisées : 8, 16, 24, 32, 40, 64, 80.
properties.virtualClusterId	string	ID de ressource de cluster virtuel pour Managed Instance.
properties.zoneRedundant	boolean	Indique si le multi-az est activé ou non.
sku	Sku	Référence SKU d’instance managée. Valeurs autorisées pour sku.name : GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH
tags	object	Balises de ressource.
type	string	Type de ressource.

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
SQLServer2022

ManagedInstanceExternalAdministrator

Object

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

Nom	Type	Description
administratorType	AdministratorType	Type de l’administrateur de serveur.
azureADOnlyAuthentication	boolean	Authentification Azure Active Directory uniquement 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
BasePrice
LicenseIncluded

ManagedInstanceListResult

Object

Liste des instances managées.

Nom	Type	Description
nextLink	string	Lien pour récupérer la page suivante des résultats.
value	ManagedInstance[]	Tableau de résultats.

ManagedInstancePecProperty

Object

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

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

ManagedInstancePrivateEndpointConnectionProperties

Object

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

Object

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

ManagedInstancePrivateLinkServiceConnectionStateProperty

Object

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
Default
Proxy
Redirect

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
PointInTimeRestore

PricingModel

Énumération

Modèle de tarification de Managed Instance.

Valeur	Description
Freemium
Regular

PrincipalType

Énumération

Type de principal de l’administrateur de serveur.

Valeur	Description
Application
Group
User

ProvisioningState

Énumération

État d’approvisionnement d’une instance managée.

Valeur	Description
Canceled
Created
Failed
InProgress
Succeeded

ResourceIdentity

Object

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

Nom	Type	Description
principalId	string (uuid)	ID du principal Azure Active Directory.
tenantId	string (uuid)	ID de locataire Azure Active Directory.
type	IdentityType	Type d’identité. Définissez cette valeur sur « SystemAssigned » pour créer et affecter automatiquement un principal Azure Active Directory pour la ressource.
userAssignedIdentities	<string, UserIdentity>	ID de ressource des identités affectées par l’utilisateur à utiliser

ServicePrincipal

Object

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

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

ServicePrincipalType

Énumération

Type de principal de service.

Valeur	Description
None
SystemAssigned

Sku

Object

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.

UserIdentity

Object

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

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

Partager via

Managed Instances - List By Resource Group

Paramètres URI

Réponses

Exemples

List managed instances by resource group

Exemple de requête

Exemple de réponse

List managed instances by resource group with $expand=administrators/activedirectory

Exemple de requête

Exemple de réponse

Définitions

AdministratorType

AuthMetadataLookupModes

BackupStorageRedundancy

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExternalGovernanceStatus

HybridSecondaryUsage

HybridSecondaryUsageDetected

IdentityType

ManagedInstance

ManagedInstanceDatabaseFormat

ManagedInstanceExternalAdministrator

ManagedInstanceLicenseType

ManagedInstanceListResult

ManagedInstancePecProperty

ManagedInstancePrivateEndpointConnectionProperties

ManagedInstancePrivateEndpointProperty

ManagedInstancePrivateLinkServiceConnectionStateProperty

ManagedInstanceProxyOverride

ManagedServerCreateMode

PricingModel

PrincipalType

ProvisioningState

ResourceIdentity

ServicePrincipal

ServicePrincipalType

Sku

UserIdentity

Ressources supplémentaires