Managed Instances - Stop

Arrête le instance managé.

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

Paramètres URI

Nom Dans Obligatoire Type Description
managedInstanceName
path True

string

Nom de l'instance managée.

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

L’ID d’abonnement d’un abonnement Azure.

api-version
query True

string

Version de l’API à utiliser pour la requête.

Réponses

Nom Type Description
200 OK

ManagedInstance

Arrêt réussi de la instance managée.

202 Accepted

L’arrêt de la instance managée est en cours.

Other Status Codes

ErrorResponse

Réponses d’erreur : ***

  • 400 ManagementServiceStopManagedInstanceZoneRedundant : arrêtez l’exécution sur instance avec la redondance de zone activée.

  • 400 ManagementServiceStopManagedInstancePartOfFailoverGroup : arrêtez l’exécution sur le instance qui fait partie du groupe de basculement.

  • 400 NameAlreadyExists : le nom fourni existe déjà.

  • 400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature : l’utilisateur a tenté d’utiliser la fonctionnalité Start/Stop sans avoir l’abonnement dans la liste verte pour la fonctionnalité d’abonnement appropriée.

  • 400 ManagementServiceStopManagedInstanceNotSupportedOnSKU : l’opération d’arrêt n’est pas prise en charge sur la référence SKU donnée.

  • 400 InvalidServerName : nom de serveur non valide spécifié.

  • 400 StartStopOfManagedInstanceIsDisabled : démarrer et arrêter l’opération sur les instance managés n’est pas activé.

  • 400 InvalidIdentifier : l’identificateur contient null ou un caractère Unicode non valide.

  • 400 ManagementServiceStopManagedInstanceUsingMILink : arrêtez l’exécution sur le instance sur lequel Managed Instance lien est configuré.

  • 400 ManagementServiceStopManagedInstanceFeatureDisabled : l’utilisateur a tenté d’utiliser la fonctionnalité Arrêter Azure SQL Managed Instance, qui est désactivée.

  • 400 ManagementServiceStopManagedInstanceHostedOnRdfePlatform - Arrêt de l’exécution sur le instance qui ne s’exécute pas avec Feature Wave Novembre 2022

  • 404 ServerNotInSubscriptionResourceGroup : le serveur spécifié n’existe pas dans le groupe de ressources et l’abonnement spécifiés.

  • 404 SubscriptionDoesNotHaveServer : le serveur demandé est introuvable

  • 404 OperationIdNotFound : l’opération avec ID n’existe pas.

  • 404 ResourceNotFound : la ressource demandée est introuvable.

  • 404 OperationIdNotFound : l’opération avec ID n’existe pas.

  • 409 ManagementServiceStopManagedInstanceAlreadyInProgress : opération d’arrêt envoyée pour une opération à l’état d’arrêt/d’arrêt.

  • 409 ManagementServiceStopManagedInstanceConflictingOperation - Stop Azure SQL Managed Instance message d’opération en conflit.

  • 409 ManagementServiceStopManagedInstanceDroppedDuringStop : arrêtez l’exécution sur instance qui est à l’état de suppression ou supprimé entre-temps.

  • 409 SubscriptionDisabled : l’abonnement est désactivé.

  • 409 CannotCancelOperation : l’opération de gestion est dans un état qui ne peut pas être annulé.

  • 409 OperationCancelled : l’opération a été annulée par l’utilisateur.

  • 409 Opération interrompue : l’opération sur la ressource n’a pas pu être terminée, car elle a été interrompue par une autre opération sur la même ressource.

  • 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles.

  • 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles.

  • 500 OperationTimedOut : l’opération a expiré et a été automatiquement restaurée. Réessayez l’opération.

  • 503 TooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles.

Exemples

Stops the managed instance.

Sample Request

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/stoprg/providers/Microsoft.Sql/managedInstances/mitostop/stop?api-version=2023-08-01-preview

Sample Response

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "mitostop.1234567891234.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/stoprg/providers/Microsoft.Network/virtualNetworks/vnet1/subnets/subnet1",
    "state": "Stopped",
    "provisioningState": "Succeeded",
    "vCores": 8,
    "storageSizeInGB": 1024,
    "licenseType": "LicenseIncluded",
    "collation": "SQL_Latin1_General_CP1_CI_AS",
    "publicDataEndpointEnabled": false,
    "proxyOverride": "Default",
    "minimalTlsVersion": "1.2",
    "dnsZone": "1234567891234",
    "instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/stoprg/providers/Microsoft.Sql/instancePools/instancePool1",
    "maintenanceConfigurationId": "/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Maintenance/publicMaintenanceConfigurations/SQL_JapanEast_MI_1",
    "currentBackupStorageRedundancy": "Geo",
    "requestedBackupStorageRedundancy": "Geo",
    "servicePrincipal": {
      "principalId": "00000011-1111-2222-2222-123456789111",
      "clientId": "00000011-1111-2222-2222-123456789111",
      "tenantId": "00000011-1111-2222-2222-123456789111",
      "type": "SystemAssigned"
    },
    "externalGovernanceStatus": "Enabled",
    "hybridSecondaryUsage": "Passive",
    "authenticationMetadata": "Windows",
    "databaseFormat": "SQLServer2022"
  },
  "location": "japaneast",
  "tags": {
    "key": "value"
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/stoprg/providers/Microsoft.Sql/managedInstances/mitostop",
  "name": "mitostop",
  "type": "Microsoft.Sql/managedInstances"
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/stoprg/providers/Microsoft.Sql/locations/westeurope/stopManagedInstanceOperationResults/11111111-1111-1111-1111-111111111111
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/stoprg/providers/Microsoft.Sql/locations/westeurope/stopManagedInstanceAzureAsyncOperation/11111111-1111-1111-1111-111111111111

Définitions

Nom Description
AdministratorType

Type de l’administrateur de serveur.

AuthMetadataLookupModes

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

BackupStorageRedundancy

Type de compte de stockage utilisé pour stocker les 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.

FreemiumType

Météo ou pas Managed Instance est freemium.

HybridSecondaryUsage

Utilisation secondaire hybride. Les valeurs possibles sont « Active » (valeur par défaut) et « Passive » (le client utilise le secondaire comme récupération d’urgence passive).

HybridSecondaryUsageDetected

Utilisation secondaire hybride détectée. Les valeurs possibles sont « Active » (le client ne répond pas aux conditions requises pour utiliser le secondaire comme récupération d’urgence passive) et « Passive » (le client remplit les conditions requises pour utiliser le secondaire comme récupération d’urgence passive).

IdentityType

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.

ManagedInstance

Une instance managée Azure SQL.

ManagedInstanceDatabaseFormat

Spécifie le format interne des bases de données 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 incluant une nouvelle licence SQL) et « BasePrice » (prix AHB réduit pour apporter vos propres licences SQL).

ManagedInstancePecProperty

Une connexion de point de terminaison privé sous un instance managé

ManagedInstancePrivateEndpointConnectionProperties

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

ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride

Type de connexion utilisé pour la connexion au instance.

ManagedServerCreateMode

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.

PrincipalType

Type de principal de l’administrateur de serveur.

ProvisioningState

État d’approvisionnement des instance managés.

ResourceIdentity

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

ServicePrincipal

Configuration du principal de service du instance managé 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

Type de l’administrateur de serveur.

Nom Type Description
ActiveDirectory

string

AuthMetadataLookupModes

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

Nom Type Description
AzureAD

string

Paired

string

Windows

string

BackupStorageRedundancy

Type de compte de stockage utilisé pour stocker les sauvegardes pour cette instance. Les options sont Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) et GeoZone(GeoZoneRedundantStorage).

Nom Type Description
Geo

string

GeoZone

string

Local

string

Zone

string

ErrorAdditionalInfo

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

Nom Type Description
info

object

Informations supplémentaires

type

string

Type d’informations supplémentaires.

ErrorDetail

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

Réponse d’erreur

Nom Type Description
error

ErrorDetail

Objet error.

ExternalGovernanceStatus

État de la gouvernance externe.

Nom Type Description
Disabled

string

Enabled

string

FreemiumType

Météo ou pas Managed Instance est freemium.

Nom Type Description
Freemium

string

Regular

string

HybridSecondaryUsage

Utilisation secondaire hybride. Les valeurs possibles sont « Active » (valeur par défaut) et « Passive » (le client utilise le secondaire comme récupération d’urgence passive).

Nom Type Description
Active

string

Passive

string

HybridSecondaryUsageDetected

Utilisation secondaire hybride détectée. Les valeurs possibles sont « Active » (le client ne répond pas aux conditions requises pour utiliser le secondaire comme récupération d’urgence passive) et « Passive » (le client remplit les conditions requises pour utiliser le secondaire comme récupération d’urgence passive).

Nom Type Description
Active

string

Passive

string

IdentityType

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.

Nom Type Description
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

ManagedInstance

Une instance managée Azure SQL.

Nom Type Description
id

string

ID de la ressource

identity

ResourceIdentity

Identité Azure Active Directory du instance managé.

location

string

Emplacement de la ressource.

name

string

Nom de la ressource.

properties.administratorLogin

string

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

properties.administratorLoginPassword

string

Mot de passe de connexion administrateur (requis pour la création de instance managés).

properties.administrators

ManagedInstanceExternalAdministrator

Administrateur Azure Active Directory du instance. Cela ne peut être utilisé qu’au moment de instance création. Si elle est utilisée pour instance mise à jour, elle est ignorée ou génère une erreur. Pour les mises à jour, des API individuelles doivent être utilisées.

properties.authenticationMetadata

AuthMetadataLookupModes

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

properties.collation

string

Classement des instance managés.

properties.createTime

string

Spécifie le point dans le temps (format ISO8601) de la création Managed Instance.

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Type de compte de stockage utilisé pour stocker les 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 instance spécifiques à la version du moteur SQL.

properties.dnsZone

string

Zone DNS dans laquelle se trouve le instance managé.

properties.dnsZonePartner

string

ID de ressource d’un autre instance managé dont la zone DNS que cette instance managée partagera après sa création.

properties.externalGovernanceStatus

ExternalGovernanceStatus

État de la gouvernance externe.

properties.fullyQualifiedDomainName

string

Nom de domaine complet du instance managé.

properties.hybridSecondaryUsage

HybridSecondaryUsage

Utilisation secondaire hybride. Les valeurs possibles sont « Active » (valeur par défaut) et « Passive » (le client utilise le secondaire comme récupération d’urgence passive).

properties.hybridSecondaryUsageDetected

HybridSecondaryUsageDetected

Utilisation secondaire hybride détectée. Les valeurs possibles sont « Active » (le client ne répond pas aux conditions requises pour utiliser le secondaire comme récupération d’urgence passive) et « Passive » (le client remplit les conditions requises pour utiliser le secondaire comme récupération d’urgence passive).

properties.instancePoolId

string

ID du pool de instance auquel appartient ce serveur managé.

properties.isGeneralPurposeV2

boolean

Indique s’il s’agit ou non d’une variante GPv2 de usage général édition.

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

properties.minimalTlsVersion

string

Version TLS minimale. Valeurs autorisées : « None », « 1.0 », « 1.1 », « 1.2 »

properties.pricingModel

FreemiumType

Météo ou pas Managed Instance est freemium.

properties.primaryUserAssignedIdentityId

string

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 un instance managé.

properties.provisioningState

ProvisioningState

État d’approvisionnement des instance managés.

properties.proxyOverride

ManagedInstanceProxyOverride

Type de connexion utilisé pour la connexion au 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 les sauvegardes pour cette instance. Les options sont Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) et GeoZone(GeoZoneRedundantStorage).

properties.restorePointInTime

string

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.

properties.servicePrincipal

ServicePrincipal

Principal de service du instance managé.

properties.sourceManagedInstanceId

string

Identificateur de ressource de l’instance managée source associée à l’opération de création de ce instance.

properties.state

string

État du instance managé.

properties.storageIOps

integer

IOps de stockage. Valeur minimale : 300. Valeur maximale : 80000. Incréments de 1 IOps autorisés uniquement. La valeur maximale dépend de la famille de matériel sélectionnée et du nombre de vCores.

properties.storageSizeInGB

integer

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ériel sélectionnée et du nombre de vCores.

properties.storageThroughputMBps

integer

Le paramètre MBits/s de débit de stockage n’est pas pris en charge dans l’opération de création/mise à jour instance.

properties.subnetId

string

ID de ressource de sous-réseau pour le instance managé.

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

properties.totalMemoryMB

integer

Mémoire totale en Mo. Valeur minimale : 7168. Valeur maximale : 891328. Incréments de 1 Mo autorisés uniquement. La valeur maximale dépend de la famille de matériel sélectionnée et du nombre de vCores.

properties.vCores

integer

Nombre de vCores. Valeurs autorisées : 8, 16, 24, 32, 40, 64, 80.

properties.virtualClusterId

string

ID de ressource de cluster virtuel pour le Managed Instance.

properties.zoneRedundant

boolean

Indique si le multi-az est activé ou non.

sku

Sku

Référence SKU 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

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

Nom Type Description
AlwaysUpToDate

string

SQLServer2022

string

ManagedInstanceExternalAdministrator

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

SID (ID d’objet) de l’administrateur du serveur.

tenantId

string

ID de locataire de l’administrateur.

ManagedInstanceLicenseType

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

Nom Type Description
BasePrice

string

LicenseIncluded

string

ManagedInstancePecProperty

Une connexion de point de terminaison privé sous un instance managé

Nom Type Description
id

string

ID de la ressource

properties

ManagedInstancePrivateEndpointConnectionProperties

Propriétés de connexion de point de terminaison privé

ManagedInstancePrivateEndpointConnectionProperties

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

Nom Type Description
privateEndpoint

ManagedInstancePrivateEndpointProperty

Point de terminaison privé auquel appartient la connexion.

privateLinkServiceConnectionState

ManagedInstancePrivateLinkServiceConnectionStateProperty

État de la connexion de la connexion de point de terminaison privé.

provisioningState

string

État de la connexion de point de terminaison privé.

ManagedInstancePrivateEndpointProperty

Nom Type Description
id

string

ID de ressource du point de terminaison privé.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Nom Type Description
actionsRequired

string

Description de la connexion au service private link.

description

string

Description de la connexion au service private link.

status

string

La connexion au service de liaison privée status.

ManagedInstanceProxyOverride

Type de connexion utilisé pour la connexion au instance.

Nom Type Description
Default

string

Proxy

string

Redirect

string

ManagedServerCreateMode

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.

Nom Type Description
Default

string

PointInTimeRestore

string

PrincipalType

Type de principal de l’administrateur de serveur.

Nom Type Description
Application

string

Group

string

User

string

ProvisioningState

État d’approvisionnement des instance managés.

Nom Type Description
Canceled

string

Created

string

Failed

string

InProgress

string

Succeeded

string

ResourceIdentity

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

Nom Type Description
principalId

string

ID du principal Azure Active Directory.

tenantId

string

ID de locataire Azure Active Directory.

type

IdentityType

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.

userAssignedIdentities

<string,  UserIdentity>

ID de ressource des identités affectées par l’utilisateur à utiliser

ServicePrincipal

Configuration du principal de service du instance managé 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

Type de principal de service.

Nom Type Description
None

string

SystemAssigned

string

Sku

Référence SKU de ressource ARM.

Nom Type Description
capacity

integer

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, cela peut être capturé ici.

name

string

Nom de la référence SKU, généralement une lettre + un 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

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

Nom Type Description
clientId

string

ID client Azure Active Directory.

principalId

string

ID du principal Azure Active Directory.