Managed Instances - Start

Avvia l'istanza gestita.

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

Parametri dell'URI

Nome In Necessario Tipo Descrizione
managedInstanceName
path True

string

Nome dell'istanza gestita.

resourceGroupName
path True

string

Nome del gruppo di risorse contenente la risorsa. È possibile ottenere questo valore dall'API di Gestione risorse di Azure o dal portale.

subscriptionId
path True

string

ID sottoscrizione che identifica una sottoscrizione di Azure.

api-version
query True

string

Versione dell'API da usare per la richiesta.

Risposte

Nome Tipo Descrizione
200 OK

ManagedInstance

Avviato correttamente l'istanza gestita.

202 Accepted

L'avvio dell'istanza gestita è in corso.

Other Status Codes

ErrorResponse

Risposte agli errori: **

  • 400 ManagementServiceStartManagedInstanceTriggeredWhileStartInProgress : l'utente ha tentato di avviare Istanza gestita di SQL di Azure non nello stato Arrestato.

  • 400 NameAlreadyExists - Il nome specificato esiste già.

  • 400 ManagementServiceStartStopManagedInstanceSubscriptionNotEnabledForFeature - L'utente ha tentato di usare la funzionalità Start/Stop senza avere la sottoscrizione consentita per la funzionalità di sottoscrizione appropriata.

  • 400 ManagementServiceStartManagedInstanceNotSupportedOnSKU - L'operazione di avvio non è supportata nello SKU specificato.

  • 400 InvalidServerName - Nome server non valido specificato.

  • 400 StartStopOfManagedInstanceIsDisabled - L'operazione di avvio e arresto nell'istanza gestita non è abilitata.

  • 400 InvalidIdentifier: l'identificatore contiene NULL o un carattere unicode non valido.

  • 400 ManagementServiceStartManagedInstanceFeatureDisabled - Utente ha tentato di usare la funzionalità Start Istanza gestita di SQL di Azure, disabilitata.

  • 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati.

  • 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato

  • 404 OperationIdNotFound: l'operazione con ID non esiste.

  • 404 ResourceNotFound : la risorsa richiesta non è stata trovata.

  • 404 OperationIdNotFound: l'operazione con ID non esiste.

  • 409 SubscriptionDisabled : la sottoscrizione è disabilitata.

  • 409 CannotCancelOperation: l'operazione di gestione è in uno stato che non può essere annullato.

  • 409 OperationCancelled: l'operazione è stata annullata dall'utente.

  • 409 Operazione interrotta: impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa.

  • 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.

  • 429 SubscriptionTooManyRequests - Richieste oltre le richieste massime che possono essere elaborate dalle risorse disponibili.

  • 500 OperationTimedOut: l'operazione viene timeout e viene eseguito automaticamente il rollback. Ripetere l'operazione.

  • 503 TooManyRequests : richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili.

Esempio

Starts the managed instance.

Sample Request

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

Sample Response

{
  "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

Definizioni

Nome Descrizione
AdministratorType

Tipo dell'amministratore di sever.

AuthMetadataLookupModes

Modalità di ricerca dei metadati di autenticazione dell'istanza gestita.

BackupStorageRedundancy

Tipo di account di archiviazione usato per archiviare i backup per questa istanza. Le opzioni sono Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

ErrorDetail

Dettagli dell'errore.

ErrorResponse

Risposta di errore

ExternalGovernanceStatus

Stato della governance esterna.

FreemiumType

Il tempo o meno Istanza gestita è freemium.

HybridSecondaryUsage

Utilizzo secondario ibrido. I valori possibili sono "Active" (valore predefinito) e "Passivo" (il cliente usa il database secondario come ripristino di emergenza passivo).

HybridSecondaryUsageDetected

Utilizzo secondario ibrido rilevato. I valori possibili sono "Active" (il cliente non soddisfa i requisiti per l'uso del ripristino di emergenza passivo) e "Passivo" (il cliente soddisfa i requisiti per l'uso secondario come ripristino di emergenza passivo).

IdentityType

Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa.

ManagedInstance

Istanza gestita Azure SQL.

ManagedInstanceDatabaseFormat

Specifica il formato interno dei database di istanza specifici della versione del motore SQL.

ManagedInstanceExternalAdministrator

Proprietà di un amministratore di Active Directory.

ManagedInstanceLicenseType

Tipo di licenza. I valori possibili sono 'LicenseIncluded' (prezzo normale incluso di una nuova licenza SQL) e 'BasePrice' (prezzo AHB scontato per portare le proprie licenze SQL).

ManagedInstancePecProperty

Connessione endpoint privato in un'istanza gestita

ManagedInstancePrivateEndpointConnectionProperties

Proprietà di una connessione endpoint privato.

ManagedInstancePrivateEndpointProperty
ManagedInstancePrivateLinkServiceConnectionStateProperty
ManagedInstanceProxyOverride

Tipo di connessione usato per la connessione all'istanza.

ManagedServerCreateMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione di istanze regolari.

Ripristino: crea un'istanza ripristinando un set di backup in un momento specifico. È necessario specificare RestorePointInTime e SourceManagedInstanceId.

PrincipalType

Tipo di entità dell'amministratore di sever.

ProvisioningState

Stato di provisioning dell'istanza gestita.

ResourceIdentity

Configurazione delle identità di Azure Active Directory per una risorsa.

ServicePrincipal

Configurazione dell'entità servizio dell'istanza gestita per una risorsa.

ServicePrincipalType

Tipo di entità servizio.

Sku

SKU di risorsa arm.

UserIdentity

Configurazione delle identità di Azure Active Directory per una risorsa.

AdministratorType

Tipo dell'amministratore di sever.

Nome Tipo Descrizione
ActiveDirectory

string

AuthMetadataLookupModes

Modalità di ricerca dei metadati di autenticazione dell'istanza gestita.

Nome Tipo Descrizione
AzureAD

string

Paired

string

Windows

string

BackupStorageRedundancy

Tipo di account di archiviazione usato per archiviare i backup per questa istanza. Le opzioni sono Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)

Nome Tipo Descrizione
Geo

string

GeoZone

string

Local

string

Zone

string

ErrorAdditionalInfo

Informazioni aggiuntive sulla gestione delle risorse.

Nome Tipo Descrizione
info

object

Informazioni aggiuntive.

type

string

Tipo di informazioni aggiuntive.

ErrorDetail

Dettagli dell'errore.

Nome Tipo Descrizione
additionalInfo

ErrorAdditionalInfo[]

Informazioni aggiuntive sull'errore.

code

string

Codice di errore.

details

ErrorDetail[]

Dettagli dell'errore.

message

string

Messaggio di errore.

target

string

Destinazione dell'errore.

ErrorResponse

Risposta di errore

Nome Tipo Descrizione
error

ErrorDetail

Oggetto error.

ExternalGovernanceStatus

Stato della governance esterna.

Nome Tipo Descrizione
Disabled

string

Enabled

string

FreemiumType

Il tempo o meno Istanza gestita è freemium.

Nome Tipo Descrizione
Freemium

string

Regular

string

HybridSecondaryUsage

Utilizzo secondario ibrido. I valori possibili sono "Active" (valore predefinito) e "Passivo" (il cliente usa il database secondario come ripristino di emergenza passivo).

Nome Tipo Descrizione
Active

string

Passive

string

HybridSecondaryUsageDetected

Utilizzo secondario ibrido rilevato. I valori possibili sono "Active" (il cliente non soddisfa i requisiti per l'uso del ripristino di emergenza passivo) e "Passivo" (il cliente soddisfa i requisiti per l'uso secondario come ripristino di emergenza passivo).

Nome Tipo Descrizione
Active

string

Passive

string

IdentityType

Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa.

Nome Tipo Descrizione
None

string

SystemAssigned

string

SystemAssigned,UserAssigned

string

UserAssigned

string

ManagedInstance

Istanza gestita Azure SQL.

Nome Tipo Descrizione
id

string

ID risorsa.

identity

ResourceIdentity

Identità di Azure Active Directory dell'istanza gestita.

location

string

Percorso della risorsa.

name

string

Nome risorsa.

properties.administratorLogin

string

Nome utente amministratore per l'istanza gestita. È possibile specificare solo quando l'istanza gestita viene creata (ed è necessaria per la creazione).

properties.administratorLoginPassword

string

Password di accesso amministratore (richiesta per la creazione di istanze gestite).

properties.administrators

ManagedInstanceExternalAdministrator

Amministratore di Azure Active Directory dell'istanza. Questa operazione può essere usata solo in fase di creazione dell'istanza. Se usato per l'aggiornamento dell'istanza, verrà ignorato o verrà generato un errore. Per gli aggiornamenti delle singole API sarà necessario usare.

properties.authenticationMetadata

AuthMetadataLookupModes

Modalità di ricerca dei metadati di autenticazione dell'istanza gestita.

properties.collation

string

Regole di confronto dell'istanza gestita.

properties.createTime

string

Specifica il periodo di tempo (ISO8601 formato) della creazione di Istanza gestita.

properties.currentBackupStorageRedundancy

BackupStorageRedundancy

Tipo di account di archiviazione usato per archiviare i backup per questa istanza. Le opzioni sono Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)

properties.databaseFormat

ManagedInstanceDatabaseFormat

Specifica il formato interno dei database di istanza specifici della versione del motore SQL.

properties.dnsZone

string

Zona DNS in cui si trova l'istanza gestita.

properties.dnsZonePartner

string

ID risorsa di un'altra istanza gestita la cui zona DNS verrà condivisa dopo la creazione.

properties.externalGovernanceStatus

ExternalGovernanceStatus

Stato della governance esterna.

properties.fullyQualifiedDomainName

string

Nome di dominio completo dell'istanza gestita.

properties.hybridSecondaryUsage

HybridSecondaryUsage

Utilizzo secondario ibrido. I valori possibili sono "Active" (valore predefinito) e "Passivo" (il cliente usa il database secondario come ripristino di emergenza passivo).

properties.hybridSecondaryUsageDetected

HybridSecondaryUsageDetected

Utilizzo secondario ibrido rilevato. I valori possibili sono "Active" (il cliente non soddisfa i requisiti per l'uso del ripristino di emergenza passivo) e "Passivo" (il cliente soddisfa i requisiti per l'uso secondario come ripristino di emergenza passivo).

properties.instancePoolId

string

Id del pool di istanze a cui appartiene questo server gestito.

properties.isGeneralPurposeV2

boolean

Indipendentemente dal fatto che si tratti di una variante GPv2 di per utilizzo generico edizione.

properties.keyId

string

URI CMK della chiave da usare per la crittografia.

properties.licenseType

ManagedInstanceLicenseType

Tipo di licenza. I valori possibili sono 'LicenseIncluded' (prezzo normale incluso di una nuova licenza SQL) e 'BasePrice' (prezzo AHB scontato per portare le proprie licenze SQL).

properties.maintenanceConfigurationId

string

Specifica l'ID di configurazione della manutenzione da applicare a questa istanza gestita.

properties.managedInstanceCreateMode

ManagedServerCreateMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione di istanze regolari.

Ripristino: crea un'istanza ripristinando un set di backup in un momento specifico. È necessario specificare RestorePointInTime e SourceManagedInstanceId.

properties.minimalTlsVersion

string

Versione TLS minima. Valori consentiti: 'Nessuno', '1.0', '1.1', '1.2'

properties.pricingModel

FreemiumType

Il tempo o meno Istanza gestita è freemium.

properties.primaryUserAssignedIdentityId

string

ID risorsa di un'identità assegnata dall'utente da usare per impostazione predefinita.

properties.privateEndpointConnections

ManagedInstancePecProperty[]

Elenco delle connessioni endpoint private in un'istanza gestita.

properties.provisioningState

ProvisioningState

Stato di provisioning dell'istanza gestita.

properties.proxyOverride

ManagedInstanceProxyOverride

Tipo di connessione usato per la connessione all'istanza.

properties.publicDataEndpointEnabled

boolean

Se l'endpoint dati pubblico è abilitato o meno.

properties.requestedBackupStorageRedundancy

BackupStorageRedundancy

Tipo di account di archiviazione da usare per archiviare i backup per questa istanza. Le opzioni sono Local (LocalRedundantStorage), Zone (ZoneRedundantStorage), Geo (GeoRedundantStorage) e GeoZone(GeoZoneRedundantStorage)

properties.restorePointInTime

string

Specifica il tempo (ISO8601 formato) del database di origine che verrà ripristinato per creare il nuovo database.

properties.servicePrincipal

ServicePrincipal

Entità servizio dell'istanza gestita.

properties.sourceManagedInstanceId

string

Identificatore di risorsa dell'istanza gestita di origine associata all'operazione di creazione di questa istanza.

properties.state

string

Stato dell'istanza gestita.

properties.storageIOps

integer

Operazioni di IOps di archiviazione. Valore minimo: 300. Valore massimo: 80000. Incrementi di 1 operazioni di IOps consentite solo. Il valore massimo dipende dalla famiglia hardware selezionata e dal numero di vCore.

properties.storageSizeInGB

integer

Dimensioni di archiviazione in GB. Valore minimo: 32. Valore massimo: 16384. Incrementi di 32 GB consentiti solo. Il valore massimo dipende dalla famiglia hardware selezionata e dal numero di vCore.

properties.storageThroughputMBps

integer

Il parametro MBps della velocità effettiva di archiviazione non è supportato nell'operazione di creazione/aggiornamento dell'istanza.

properties.subnetId

string

ID risorsa subnet per l'istanza gestita.

properties.timezoneId

string

ID del fuso orario. I valori consentiti sono fusi orari supportati da Windows. Windows mantiene i dettagli sui fuso orario supportati, inclusi l'ID, nel Registro di sistema in KEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows NT\CurrentVersion\Time Zones. È possibile ottenere tali valori del Registro di sistema tramite SQL Server eseguendo query su SELECT name AS timezone_id FROM sys.time_zone_info. È anche possibile ottenere un elenco di ID eseguendo [System.TimeZoneInfo]::GetSystemTimeZones() in PowerShell. Un esempio di ID fuso orario valido è "Pacific Standard Time" o "W. Ora standard dell'Europa".

properties.totalMemoryMB

integer

Memoria totale in MB. Valore minimo: 7168. Valore massimo: 891328. Incrementi di 1 MB consentiti solo. Il valore massimo dipende dalla famiglia hardware selezionata e dal numero di vCore.

properties.vCores

integer

Numero di vCore. Valori consentiti: 8, 16, 24, 32, 40, 64, 80.

properties.virtualClusterId

string

ID risorsa cluster virtuale per il Istanza gestita.

properties.zoneRedundant

boolean

Se il multi-az è abilitato o meno.

sku

Sku

SKU dell'istanza gestita. Valori consentiti per sku.name: GP_Gen5, GP_G8IM, GP_G8IH, BC_Gen5, BC_G8IM, BC_G8IH

tags

object

Tag di risorse.

type

string

Tipo di risorsa.

ManagedInstanceDatabaseFormat

Specifica il formato interno dei database di istanza specifici della versione del motore SQL.

Nome Tipo Descrizione
AlwaysUpToDate

string

SQLServer2022

string

ManagedInstanceExternalAdministrator

Proprietà di un amministratore di Active Directory.

Nome Tipo Descrizione
administratorType

AdministratorType

Tipo dell'amministratore di sever.

azureADOnlyAuthentication

boolean

Solo autenticazione di Azure Active Directory abilitata.

login

string

Nome di accesso dell'amministratore del server.

principalType

PrincipalType

Tipo di entità dell'amministratore di sever.

sid

string

SID (ID oggetto) dell'amministratore del server.

tenantId

string

ID tenant dell'amministratore.

ManagedInstanceLicenseType

Tipo di licenza. I valori possibili sono 'LicenseIncluded' (prezzo normale incluso di una nuova licenza SQL) e 'BasePrice' (prezzo AHB scontato per portare le proprie licenze SQL).

Nome Tipo Descrizione
BasePrice

string

LicenseIncluded

string

ManagedInstancePecProperty

Connessione endpoint privato in un'istanza gestita

Nome Tipo Descrizione
id

string

ID risorsa.

properties

ManagedInstancePrivateEndpointConnectionProperties

Proprietà di connessione dell'endpoint privato

ManagedInstancePrivateEndpointConnectionProperties

Proprietà di una connessione endpoint privato.

Nome Tipo Descrizione
privateEndpoint

ManagedInstancePrivateEndpointProperty

Endpoint privato a cui appartiene la connessione.

privateLinkServiceConnectionState

ManagedInstancePrivateLinkServiceConnectionStateProperty

Stato della connessione dell'endpoint privato.

provisioningState

string

Stato della connessione endpoint privato.

ManagedInstancePrivateEndpointProperty

Nome Tipo Descrizione
id

string

ID risorsa dell'endpoint privato.

ManagedInstancePrivateLinkServiceConnectionStateProperty

Nome Tipo Descrizione
actionsRequired

string

Descrizione della connessione al servizio collegamento privato.

description

string

Descrizione della connessione al servizio collegamento privato.

status

string

Stato di connessione del servizio di collegamento privato.

ManagedInstanceProxyOverride

Tipo di connessione usato per la connessione all'istanza.

Nome Tipo Descrizione
Default

string

Proxy

string

Redirect

string

ManagedServerCreateMode

Specifica la modalità di creazione del database.

Impostazione predefinita: creazione di istanze regolari.

Ripristino: crea un'istanza ripristinando un set di backup in un momento specifico. È necessario specificare RestorePointInTime e SourceManagedInstanceId.

Nome Tipo Descrizione
Default

string

PointInTimeRestore

string

PrincipalType

Tipo di entità dell'amministratore di sever.

Nome Tipo Descrizione
Application

string

Group

string

User

string

ProvisioningState

Stato di provisioning dell'istanza gestita.

Nome Tipo Descrizione
Canceled

string

Created

string

Failed

string

InProgress

string

Succeeded

string

ResourceIdentity

Configurazione delle identità di Azure Active Directory per una risorsa.

Nome Tipo Descrizione
principalId

string

ID entità di Azure Active Directory.

tenantId

string

ID tenant di Azure Active Directory.

type

IdentityType

Tipo di identità. Impostare questa opzione su "SystemAssigned" per creare e assegnare automaticamente un'entità di Azure Active Directory per la risorsa.

userAssignedIdentities

<string,  UserIdentity>

ID risorsa delle identità assegnate dall'utente da usare

ServicePrincipal

Configurazione dell'entità servizio dell'istanza gestita per una risorsa.

Nome Tipo Descrizione
clientId

string

ID client dell'applicazione Azure Active Directory.

principalId

string

ID oggetto dell'applicazione Azure Active Directory.

tenantId

string

ID tenant di Azure Active Directory.

type

ServicePrincipalType

Tipo di entità servizio.

ServicePrincipalType

Tipo di entità servizio.

Nome Tipo Descrizione
None

string

SystemAssigned

string

Sku

SKU di risorsa arm.

Nome Tipo Descrizione
capacity

integer

Capacità dello SKU specifico.

family

string

Se il servizio ha generazioni diverse di hardware, per lo stesso SKU, è possibile acquisire qui.

name

string

Il nome dello SKU, in genere, una lettera + Codice Numero, ad esempio P3.

size

string

Dimensioni dello SKU specifico

tier

string

Livello o edizione dello SKU specifico, ad esempio Basic, Premium.

UserIdentity

Configurazione delle identità di Azure Active Directory per una risorsa.

Nome Tipo Descrizione
clientId

string

ID client di Azure Active Directory.

principalId

string

ID entità di Azure Active Directory.