Partager via


Managed Instances - Start

Démarre l’instance managée.

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

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

ID d’abonnement qui identifie 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

Démarrage réussi de l’instance managée.

202 Accepted

Le démarrage de l’instance managée est en cours.

En-têtes

Location: string

Other Status Codes

ErrorResponse

Réponses d’erreur : ***

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

  • 400 InvalidServerName - Nom du serveur non valide spécifié.

  • 400 ManagementServiceStartManagedInstanceNotSupportedOnSKU : l’opération de démarrage n’est pas prise en charge sur la référence SKU donnée.

  • 400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature - L’utilisateur a tenté d’utiliser la fonctionnalité Start/Stop sans avoir l’abonnement autorisé pour la fonctionnalité d’abonnement appropriée.

  • 400 StartStopOfManagedInstanceIsDisabled : l’opération de démarrage et d’arrêt sur l’instance managée n’est pas activée.

  • 400 ManagementServiceStartManagedInstanceTriggeredWhileStartInProgress : l’utilisateur a tenté de démarrer Azure SQL Managed Instance qui n’est pas à l’état Arrêté.

  • 400 ManagementServiceStartManagedInstanceFeatureDisabled : l’utilisateur a tenté d’utiliser la fonctionnalité Démarrer Azure SQL Managed Instance, qui est désactivée.

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

  • 400 InvalidServerName - Nom du serveur non valide spécifié.

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

  • 400 TokenTooLong : le jeton fourni est trop long.

  • 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 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à 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.

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

  • 503 TooManyRequests : demandes au-delà des requêtes maximales pouvant être traitées par les ressources disponibles.

Exemples

Starts the managed instance.

Exemple de requête

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

Exemple de réponse

{
  "sku": {
    "name": "GP_Gen5",
    "tier": "GeneralPurpose",
    "capacity": 8,
    "family": "Gen5"
  },
  "properties": {
    "fullyQualifiedDomainName": "mitostart.1234567891234.database.windows.net",
    "administratorLogin": "dummylogin",
    "subnetId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/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": "1234567891234",
    "instancePoolId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/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/startrg/providers/Microsoft.Sql/managedInstances/mitostart",
  "name": "mitostart",
  "type": "Microsoft.Sql/managedInstances"
}
Location: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/locations/westeurope/startManagedInstanceOperationResults/11111111-1111-1111-1111-111111111111
Azure-AsyncOperation: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/startrg/providers/Microsoft.Sql/locations/westeurope/startManagedInstanceAzureAsyncOperation/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 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).

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

Type de l’administrateur de serveur.

Valeur Description
ActiveDirectory

AuthMetadataLookupModes

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

Valeur Description
AzureAD
Paired
Windows

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)

Valeur Description
Geo
Local
Zone
GeoZone

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émentaire.

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 d’erreur.

ExternalGovernanceStatus

État de la gouvernance externe.

Valeur Description
Enabled
Disabled

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

Valeur Description
Active
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).

Valeur Description
Active
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.

Valeur Description
None
SystemAssigned
UserAssigned
SystemAssigned,UserAssigned

ManagedInstance

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

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

Valeur Description
AlwaysUpToDate
SQLServer2022

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 (uuid)

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

tenantId

string (uuid)

ID de locataire de l’administrateur.

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

Valeur Description
LicenseIncluded
BasePrice

ManagedInstancePecProperty

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

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

Nom Type Description
id

string

ID de ressource du point de terminaison privé.

ManagedInstancePrivateLinkServiceConnectionStateProperty

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

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

Valeur Description
Proxy
Redirect
Default

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.

Valeur Description
Default
PointInTimeRestore

PricingModel

Modèle de tarification de Managed Instance.

Valeur Description
Regular
Freemium

PrincipalType

Type de principal de l’administrateur de serveur.

Valeur Description
User
Group
Application

ProvisioningState

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

Valeur Description
Created
InProgress
Succeeded
Failed
Canceled

ResourceIdentity

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

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

Type de principal de service.

Valeur Description
None
SystemAssigned

Sku

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

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.